Man Page for vtkGeometryFilter
Table of Contents

NAME

vtkGeometryFilter - extract geometry from data (or convert data to polygonal type)

SYNOPSIS


#include "/opt/vtk-c++/graphics/vtkGeometryFilter.h"

class VTK_EXPORT vtkGeometryFilter : public vtkDataSetToPolyDataFilter

vtkGeometryFilter();
~vtkGeometryFilter();
static vtkGeometryFilter *New() {return new vtkGeometryFilter;};
const char *GetClassName() {return "vtkGeometryFilter";};
void PrintSelf(ostream& os, vtkIndent indent);
void SetPointClipping(int);
int GetPointClipping();
void PointClippingOn();
void PointClippingOff();
void SetCellClipping(int);
int GetCellClipping();
void CellClippingOn();
void CellClippingOff();
void SetExtentClipping(int);
int GetExtentClipping();
void ExtentClippingOn();
void ExtentClippingOff();
void SetPointMinimum(int);
int GetPointMinimum();
void SetPointMaximum(int);
int GetPointMaximum();
void SetCellMinimum(int);
int GetCellMinimum();
void SetCellMaximum(int);
int GetCellMaximum();
void SetExtent(float xMin, float xMax, float yMin, float yMax, float zMin, float zMax);
void SetExtent(float *extent);
float *GetExtent() { return this->Extent;};
void SetMerging(int);
int GetMerging();
void MergingOn();
void MergingOff();
void SetLocator(vtkPointLocator *locator);
void SetLocator(vtkPointLocator& locator) {this->SetLocator(&locator);};
vtkPointLocator *GetLocator();
void CreateDefaultLocator();

DESCRIPTION

vtkGeometryFilter is a general-purpose filter to extract geometry (and associated data) from any type of dataset. Geometry is obtained as follows: all 0D, 1D, and 2D cells are extracted. All 2D faces that are used by only one 3D cell (i.e., boundary faces) are extracted. It also is possible to specify conditions on point ids, cell ids, and on bounding box (referred to as "Extent") to control the extraction process.

This filter also may be used to convert any type of data to polygonal type. The conversion process may be less than satisfactory for some 3D datasets. For example, this filter will extract the outer surface of a volume or structured grid dataset. (For structured data you may want to use

vtkStructuredPointsGeometryFilter,
vtkStructuredGridGeometryFilter, vtkUnstructuredGridGeometryFilter, vtkRectilinearGridGeometryFilter, or vtkExtractVOI.)

CAVEATS

 When vtkGeometryFilter extracts cells (or boundaries of cells) it will (by default) merge duplicate vertices. This may cause problems in some cases. For example, if you've run vtkPolyDataNormals to generate normals, which may split meshes and create duplicate vertices, vtkGeometryFilter will merge these points back together. Turn merging off to prevent this from occuring.

SEE ALSO

vtkStructuredPointsGeometryFilter
vtkStructuredGridGeometryFilter vtkExtractGeometry vtkExtractVOI

SUMMARY

 void SetPointClipping(int)
Turn on/off selection of geometry by point id.

void SetCellClipping(int)
Turn on/off selection of geometry by cell id.

void SetExtentClipping(int)
Turn on/off selection of geometry via bounding box.

void SetPointMinimum(int)
Specify the minimum point id for point id selection.

void SetPointMaximum(int)
Specify the maximum point id for point id selection.

void SetCellMinimum(int)
Specify the minimum cell id for point id selection.

void SetCellMaximum(int)
Specify the maximum cell id for point id selection.

void SetMerging(int)
Turn on/off merging of coincident points. Note that is merging is on, points with different point attributes (e.g., normals) are merged, which may cause rendering artifacts.

vtkGeometryFilter()
Construct with all types of clipping turned off.

void SetExtent(float xMin, float xMax, float yMin,
float yMax, float zMin, float zMax)
Specify a (xmin,xmax, ymin,ymax, zmin,zmax) bounding box to clip data.

void SetExtent(float *extent)
Specify a (xmin,xmax, ymin,ymax, zmin,zmax) bounding box to clip data.

void SetLocator(vtkPointLocator *locator)
Specify a spatial locator for merging points. By default an instance of vtkMergePoints is used.

Table of Contents