Skip to content


This section demonstrates using Polyscope with DGtal for digital geometry processing. See this repository for a sample project configuration, CMAKE build system, and a quick demo!

Adding a surface

These snippets are from the example here. See that code for full setup and template definitions!

// Initialize polyscope

// ... surface setup here, see full example...
// create the surface
auto primalSurface = SH3::makePrimalPolygonalSurface(c2i, surface);

// Convert faces to appropriate indexed format
std::vector<std::vector<unsigned long>> faces;
for(auto &face: primalSurface->allFaces())
  faces.push_back(primalSurface->verticesAroundFace( face ));

// Register pointels as a point cloud
polyscope::registerPointCloud("Pointels", primalSurface->positions());

// Register surface with quadrilateral faces
auto digsurf = polyscope::registerSurfaceMesh("Primal surface", 
                 primalSurface->positions(), faces);

// Set appearance parameters

// Show the gui

The resulting surface:

DGtal surface

Computing surface quantities

// Compute some differential quantities
params("r-radius", 5.0);
auto normals   = SHG3::getCTrivialNormalVectors(surface, surfels, params);
auto normalsTrivial   = SHG3::getTrivialNormalVectors(K,surfels);
auto normalsII = SHG3::getIINormalVectors(binary_image, surfels, params);
auto Mcurv     = SHG3::getIIMeanCurvatures(binary_image, surfels, params);
auto Gcurv     = SHG3::getIIGaussianCurvatures(binary_image, surfels, params);

// Surfel area measure
std::vector<double> areaMeasure(surfels.size());
for(auto i=0; i < areaMeasure.size(); ++i)
  areaMeasure[i] = normalsTrivial[i].dot(normalsII[i]);

// Add quantities for visualization 
digsurf->addFaceVectorQuantity("Trivial normal vectors", normalsTrivial);
digsurf->addFaceVectorQuantity("CTrivial normal vectors", normals);
digsurf->addFaceVectorQuantity("II normal vectors", normalsII);
digsurf->addFaceScalarQuantity("II mean curvature", Mcurv);
digsurf->addFaceScalarQuantity("II Gaussian curvature", Gcurv);
digsurf->addFaceScalarQuantity("Surfel area measure", areaMeasure);

// Show the gui

The resulting curvatures:

DGtal curvature

The resulting normal vectors:

DGtal vectors