remesh docs advertise an IntrinsicGeometryInterface& overload the code doesn't have

Open
#247 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
57/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Quiet
Tech stack
cpp
Domain
documentation

Research direction

Compare the remeshing page with include/geometrycentral/surface/remeshing.h at the reported revision, then inspect the implementation's use of vertexPositions and faceNormal. Confirm whether the documented IntrinsicGeometryInterface overload is intended; done means the docs and available declarations no longer disagree, or the intended API change is clearly identified for follow-up.

Written by the indexing model from the issue text.

Description

Version: master @ 1e8e43d2 (and the docs site as of 2026-06-01).

The remeshing docs (https://geometry-central.net/surface/algorithms/remeshing/)
show:

void remesh(ManifoldSurfaceMesh& mesh, IntrinsicGeometryInterface& geom, RemeshOptions options = defaultRemeshOptions);
void remesh(ManifoldSurfaceMesh& mesh, IntrinsicGeometryInterface& geom, MutationManager& mm, RemeshOptions options = defaultRemeshOptions);

But include/geometrycentral/surface/remeshing.h (unchanged since
2022-12-09) declares only VertexPositionGeometry& overloads, and the
implementation uses geom.vertexPositions[...] / geom.faceNormal(...)
(smoothing to circumcenters, computing split midpoints in 3D) — so it
genuinely requires an embedded geometry and cannot run on a bare
IntrinsicGeometryInterface.

So either the docs are aspirational/stale, or an intended
IntrinsicGeometryInterface& overload was never merged. Either way the
documented signature won't compile against the current code. (Context: we
were hoping to remesh an intrinsic triangulation directly; the docs implied
it was supported.)

Dominant language
C++
Stars
1.3k
Forks
183
PR merge metrics
No merged PRs in 30d

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from nmwsharp/geometry-central

All issues in nmwsharp/geometry-central

Similar issues

More C++ issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.