vtkCleanPolyData Class Reference
#include <vtkCleanPolyData.h>
Inheritance diagram for vtkCleanPolyData:
[legend]Collaboration diagram for vtkCleanPolyData:
[legend]List of all members.
Detailed Description
merge duplicate points, and/or remove unused points and/or remove degenerate cells
vtkCleanPolyData is a filter that takes polygonal data as input and generates polygonal data as output. vtkCleanPolyData can merge duplicate points (within specified tolerance and if enabled), eliminate points that are not used, and if enabled, transform degenerate cells into appropriate forms (for example, a triangle is converted into a line if two points of triangle are merged).
Conversion of degenerate cells is controlled by the flags ConvertLinesToPoints, ConvertPolysToLines, ConvertStripsToPolys which act cumulatively such that a degenerate strip may become a poly. The full set is Line with 1 points -> Vert (if ConvertLinesToPoints) Poly with 2 points -> Line (if ConvertPolysToLines) Poly with 1 points -> Vert (if ConvertPolysToLines && ConvertLinesToPoints) Strp with 3 points -> Poly (if ConvertStripsToPolys) Strp with 2 points -> Line (if ConvertStripsToPolys && ConvertPolysToLines) Strp with 1 points -> Vert (if ConvertStripsToPolys && ConvertPolysToLines && ConvertLinesToPoints)
If tolerance is specified precisely=0.0, then vtkCleanPolyData will use the vtkMergePoints object to merge points (which is faster). Otherwise the slower vtkPointLocator is used. Before inserting points into the point locator, this class calls a function OperateOnPoint which can be used (in subclasses) to further refine the cleaning process. See vtkQuantizePolyDataPoints.
Note that merging of points can be disabled. In this case, a point locator will not be used, and points that are not used by any cells will be eliminated, but never merged.
- Warning:
- Merging points can alter topology, including introducing non-manifold forms. The tolerance should be chosen carefully to avoid these problems. Subclasses should handle OperateOnBounds as well as OperateOnPoint to ensure that the locator is correctly initialized (i.e. all modified points must lie inside modified bounds).
- See also:
- vtkQuantizePolyDataPoints
- Tests:
- vtkCleanPolyData (Tests)
Definition at line 69 of file vtkCleanPolyData.h.
Member Typedef Documentation
Constructor & Destructor Documentation
| vtkCleanPolyData::vtkCleanPolyData |
( |
|
) |
[protected] |
|
| vtkCleanPolyData::~vtkCleanPolyData |
( |
|
) |
[protected] |
|
Member Function Documentation
| void vtkCleanPolyData::PrintSelf |
( |
ostream & |
os, |
|
|
vtkIndent |
indent |
|
) |
[virtual] |
|
|
|
Methods invoked by print to print information about the object including superclasses. Typically not called by the user (use Print() instead) but used in the hierarchical print process to combine the output of several classes.
Reimplemented from vtkPolyDataAlgorithm.
Reimplemented in vtkQuantizePolyDataPoints. |
| virtual const char* vtkCleanPolyData::GetClassName |
( |
|
) |
[virtual] |
|
| static int vtkCleanPolyData::IsTypeOf |
( |
const char * |
type |
) |
[static] |
|
|
|
Return 1 if this class type is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeRevisionMacro found in vtkSetGet.h.
Reimplemented from vtkPolyDataAlgorithm.
Reimplemented in vtkQuantizePolyDataPoints. |
| virtual int vtkCleanPolyData::IsA |
( |
const char * |
type |
) |
[virtual] |
|
|
|
Return 1 if this class is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeRevisionMacro found in vtkSetGet.h.
Reimplemented from vtkPolyDataAlgorithm.
Reimplemented in vtkQuantizePolyDataPoints. |
|
|
By default ToleranceIsAbsolute is false and Tolerance is a fraction of Bounding box diagonal, if true, AbsoluteTolerance is used when adding points to locator (merging)
Reimplemented from vtkPolyDataAlgorithm.
Reimplemented in vtkQuantizePolyDataPoints. |
| virtual void vtkCleanPolyData::SetToleranceIsAbsolute |
( |
int |
|
) |
[virtual] |
|
|
|
By default ToleranceIsAbsolute is false and Tolerance is a fraction of Bounding box diagonal, if true, AbsoluteTolerance is used when adding points to locator (merging) |
| virtual void vtkCleanPolyData::ToleranceIsAbsoluteOn |
( |
|
) |
[virtual] |
|
|
|
By default ToleranceIsAbsolute is false and Tolerance is a fraction of Bounding box diagonal, if true, AbsoluteTolerance is used when adding points to locator (merging) |
| virtual void vtkCleanPolyData::ToleranceIsAbsoluteOff |
( |
|
) |
[virtual] |
|
|
|
By default ToleranceIsAbsolute is false and Tolerance is a fraction of Bounding box diagonal, if true, AbsoluteTolerance is used when adding points to locator (merging) |
| virtual int vtkCleanPolyData::GetToleranceIsAbsolute |
( |
|
) |
[virtual] |
|
|
|
By default ToleranceIsAbsolute is false and Tolerance is a fraction of Bounding box diagonal, if true, AbsoluteTolerance is used when adding points to locator (merging) |
| virtual void vtkCleanPolyData::SetTolerance |
( |
double |
|
) |
[virtual] |
|
|
|
Specify tolerance in terms of fraction of bounding box length. |
| virtual double vtkCleanPolyData::GetTolerance |
( |
|
) |
[virtual] |
|
|
|
Specify tolerance in terms of fraction of bounding box length. |
| virtual void vtkCleanPolyData::SetAbsoluteTolerance |
( |
double |
|
) |
[virtual] |
|
|
|
Specify tolerance in absolute terms |
| virtual double vtkCleanPolyData::GetAbsoluteTolerance |
( |
|
) |
[virtual] |
|
|
|
Specify tolerance in absolute terms |
| virtual void vtkCleanPolyData::SetConvertLinesToPoints |
( |
int |
|
) |
[virtual] |
|
|
|
Turn on/off conversion of degenerate lines to points |
| virtual void vtkCleanPolyData::ConvertLinesToPointsOn |
( |
|
) |
[virtual] |
|
|
|
Turn on/off conversion of degenerate lines to points |
| virtual void vtkCleanPolyData::ConvertLinesToPointsOff |
( |
|
) |
[virtual] |
|
|
|
Turn on/off conversion of degenerate lines to points |
| virtual int vtkCleanPolyData::GetConvertLinesToPoints |
( |
|
) |
[virtual] |
|
|
|
Turn on/off conversion of degenerate lines to points |
| virtual void vtkCleanPolyData::SetConvertPolysToLines |
( |
int |
|
) |
[virtual] |
|
|
|
Turn on/off conversion of degenerate polys to lines |
| virtual void vtkCleanPolyData::ConvertPolysToLinesOn |
( |
|
) |
[virtual] |
|
|
|
Turn on/off conversion of degenerate polys to lines |
| virtual void vtkCleanPolyData::ConvertPolysToLinesOff |
( |
|
) |
[virtual] |
|
|
|
Turn on/off conversion of degenerate polys to lines |
| virtual int vtkCleanPolyData::GetConvertPolysToLines |
( |
|
) |
[virtual] |
|
|
|
Turn on/off conversion of degenerate polys to lines |
| virtual void vtkCleanPolyData::SetConvertStripsToPolys |
( |
int |
|
) |
[virtual] |
|
|
|
Turn on/off conversion of degenerate strips to polys |
| virtual void vtkCleanPolyData::ConvertStripsToPolysOn |
( |
|
) |
[virtual] |
|
|
|
Turn on/off conversion of degenerate strips to polys |
| virtual void vtkCleanPolyData::ConvertStripsToPolysOff |
( |
|
) |
[virtual] |
|
|
|
Turn on/off conversion of degenerate strips to polys |
| virtual int vtkCleanPolyData::GetConvertStripsToPolys |
( |
|
) |
[virtual] |
|
|
|
Turn on/off conversion of degenerate strips to polys |
| virtual void vtkCleanPolyData::SetPointMerging |
( |
int |
|
) |
[virtual] |
|
|
|
Set/Get a boolean value that controls whether point merging is performed. If on, a locator will be used, and points laying within the appropriate tolerance may be merged. If off, points are never merged. By default, merging is on. |
| virtual int vtkCleanPolyData::GetPointMerging |
( |
|
) |
[virtual] |
|
|
|
Set/Get a boolean value that controls whether point merging is performed. If on, a locator will be used, and points laying within the appropriate tolerance may be merged. If off, points are never merged. By default, merging is on. |
| virtual void vtkCleanPolyData::PointMergingOn |
( |
|
) |
[virtual] |
|
|
|
Set/Get a boolean value that controls whether point merging is performed. If on, a locator will be used, and points laying within the appropriate tolerance may be merged. If off, points are never merged. By default, merging is on. |
| virtual void vtkCleanPolyData::PointMergingOff |
( |
|
) |
[virtual] |
|
|
|
Set/Get a boolean value that controls whether point merging is performed. If on, a locator will be used, and points laying within the appropriate tolerance may be merged. If off, points are never merged. By default, merging is on. |
|
|
Set/Get a spatial locator for speeding the search process. By default an instance of vtkMergePoints is used. |
|
|
Set/Get a spatial locator for speeding the search process. By default an instance of vtkMergePoints is used. |
| void vtkCleanPolyData::CreateDefaultLocator |
( |
vtkPolyData * |
input = 0 |
) |
|
|
|
|
Create default locator. Used to create one when none is specified. |
| void vtkCleanPolyData::ReleaseLocator |
( |
void |
|
) |
|
|
| unsigned long int vtkCleanPolyData::GetMTime |
( |
|
) |
[virtual] |
|
|
|
Get the MTime of this object also considering the locator.
Reimplemented from vtkObject. |
| virtual void vtkCleanPolyData::OperateOnPoint |
( |
double |
in[3], |
|
|
double |
out[3] |
|
) |
[virtual] |
|
| virtual void vtkCleanPolyData::OperateOnBounds |
( |
double |
in[6], |
|
|
double |
out[6] |
|
) |
[virtual] |
|
| virtual void vtkCleanPolyData::SetPieceInvariant |
( |
int |
|
) |
[virtual] |
|
| virtual int vtkCleanPolyData::GetPieceInvariant |
( |
|
) |
[virtual] |
|
| virtual void vtkCleanPolyData::PieceInvariantOn |
( |
|
) |
[virtual] |
|
| virtual void vtkCleanPolyData::PieceInvariantOff |
( |
|
) |
[virtual] |
|
|
|
This is called by the superclass. This is the method you should override.
Reimplemented from vtkPolyDataAlgorithm. |
|
|
This is called by the superclass. This is the method you should override.
Reimplemented from vtkPolyDataAlgorithm. |
Member Data Documentation
The documentation for this class was generated from the following file:
Generated on Mon Jan 21 23:37:35 2008 for VTK by
1.4.3-20050530