CGAL 5.4.1 - 3D Mesh Generation
CGAL::Labeled_image_mesh_domain_3< Image, BGT > Class Template Reference

#include <CGAL/Labeled_image_mesh_domain_3.h>

Definition

Deprecated:
The class template Labeled_image_mesh_domain_3 is deprecated since CGAL-4.13, in favor of the class template Labeled_mesh_domain_3 and its static function Labeled_mesh_domain_3::create_labeled_image_mesh_domain().

The class Labeled_image_mesh_domain_3 implements a domain described by a 3D labeled image. A 3D labeled image is a grid of voxels, where each voxel is associated with an index (a subdomain index) characterizing the subdomain in which the voxel lies. This class is a model of the concept MeshDomain_3. The domain to be discretized is the union of voxels that have an non-default index (different from the default constructed value of the type Image::Type).

This class includes a member function that provides, by interpolation, the index of the subdomain in which any query point lies. An intersection between a segment and bounding surfaces is detected when both segment endpoints are associated with different values of subdomain indices. The intersection is then constructed by bisection. The bisection stops when the query segment is shorter than a given error bound e. This error bound is given by e=d \( \times\)bound where d is the length of the diagonal of the bounding box (in world coordinates) and bound is the argument passed to the constructor of Labeled_image_mesh_domain_3.

Template Parameters
Imageis the type of the input image. This parameter must be CGAL::Image_3.
BGTis a geometric traits class which provides the basic operations to implement intersection tests and intersection computations through a bisection method. This parameter must be instantiated with a model of the concept BisectionGeometricTraits_3.
Is Model Of:
MeshDomain_3

An executable that uses Labeled_image_mesh_domain_3 must be linked with the CGAL_ImageIO library.

See also
BisectionGeometricTraits_3
CGAL::make_mesh_3().

Creation

 Labeled_Image_mesh_domain_3 (const Image &image, const BGT::FT &error_bound=FT(1e-3))
 Construction from an image. More...
 

Member Function Documentation

◆ Labeled_Image_mesh_domain_3()

template<typename Image , typename BGT >
CGAL::Labeled_image_mesh_domain_3< Image, BGT >::Labeled_Image_mesh_domain_3 ( const Image &  image,
const BGT::FT &  error_bound = FT(1e-3) 
)

Construction from an image.

The parameter error_bound is relative to the size of the image.