CGAL::Gray_level_image_3<FT, Point>

Definition

A 3D gray image is a tri-dimensional array that associates a scalar value to each triple of integer (x, y, z) in the range of the image. A trilinear interpolation algorithm provides a map f : R 3 R .

The class Gray_level_image_3<FT, Point> is a 3D gray image loader and a model of the concept ImplicitFunction. An object of the class Gray_level_image_3<FT, Point> is created with a parameter iso and then its operator() implements the function sign of (f(p) - iso), for p in R 3. Plugging such a function in the creation of the Implicit_surface_3 object given as parameter to make_surface_mesh yields a mesh approximating the level with value iso in the input 3D gray image.

Gray_level_image_3<FT, Point> provides an interface with an auxiliary library called CGALimageIO. An executable that uses Gray_level_image_3<FT, Point> must be linked with the CGALimageIO library. This library is shipped with CGAL and will be linked automatically by any makefile created by the script cgal_create_makefile.

The library CGALimageIO and therefore Gray_level_image_3<FT, Point> support several types of 3D images: INRIMAGE (extension .inr[.gz]), GIS (extension .dim, of .ima[.gz]), and ANALYZE (extension .hdr, or .img[.gz]).

#include <CGAL/Gray_level_image_3.h>

Is Model for the Concepts

ImplicitFunction

Types

Gray_level_image_3<FT, Point>::FT
the numerical type FT


Gray_level_image_3<FT, Point>::FT
the point type Point

Creation

Gray_level_image_3<FT, Point> image ( const char* filename, FT iso_value);
filename is the path to a file of a type supported by ImageIO.
iso_value is an isovalue of f.

See Also

ImplicitFunction,
Implicit_surface_3<Traits, Function>,
make_surface_mesh