extract polygonal data based on geometric connectivity More...

#include <vtkPolyDataConnectivityFilter.h>

Inheritance diagram for vtkPolyDataConnectivityFilter:

Collaboration diagram for vtkPolyDataConnectivityFilter:

Public Types
typedef vtkPolyDataAlgorithm	Superclass
Public Member Functions
virtual int	IsA (const char *type)
vtkPolyDataConnectivityFilter *	NewInstance () const
void	PrintSelf (ostream &os, vtkIndent indent)
void	InitializeSeedList ()
void	AddSeed (int id)
void	DeleteSeed (int id)
void	InitializeSpecifiedRegionList ()
void	AddSpecifiedRegion (int id)
void	DeleteSpecifiedRegion (int id)
int	GetNumberOfExtractedRegions ()

virtual vtkIdTypeArray *	GetRegionSizes ()

virtual void	SetScalarConnectivity (int)
virtual int	GetScalarConnectivity ()
virtual void	ScalarConnectivityOn ()
virtual void	ScalarConnectivityOff ()

virtual void	SetFullScalarConnectivity (int)
virtual int	GetFullScalarConnectivity ()
virtual void	FullScalarConnectivityOn ()
virtual void	FullScalarConnectivityOff ()

virtual void	SetScalarRange (double, double)
void	SetScalarRange (double[2])
virtual double *	GetScalarRange ()
virtual void	GetScalarRange (double &, double &)
virtual void	GetScalarRange (double[2])

virtual void	SetExtractionMode (int)
virtual int	GetExtractionMode ()
void	SetExtractionModeToPointSeededRegions ()
void	SetExtractionModeToCellSeededRegions ()
void	SetExtractionModeToLargestRegion ()
void	SetExtractionModeToSpecifiedRegions ()
void	SetExtractionModeToClosestPointRegion ()
void	SetExtractionModeToAllRegions ()
const char *	GetExtractionModeAsString ()

virtual void	SetClosestPoint (double, double, double)
virtual void	SetClosestPoint (double[3])
virtual double *	GetClosestPoint ()
virtual void	GetClosestPoint (double data[3])

virtual void	SetColorRegions (int)
virtual int	GetColorRegions ()
virtual void	ColorRegionsOn ()
virtual void	ColorRegionsOff ()

virtual void	SetMarkVisitedPointIds (int)
virtual int	GetMarkVisitedPointIds ()
virtual void	MarkVisitedPointIdsOn ()
virtual void	MarkVisitedPointIdsOff ()

virtual vtkIdList *	GetVisitedPointIds ()
Static Public Member Functions
static int	IsTypeOf (const char *type)
static vtkPolyDataConnectivityFilter *	SafeDownCast (vtkObjectBase *o)
static vtkPolyDataConnectivityFilter *	New ()
Protected Member Functions
virtual vtkObjectBase *	NewInstanceInternal () const
	vtkPolyDataConnectivityFilter ()
	~vtkPolyDataConnectivityFilter ()
int	RequestData (vtkInformation , vtkInformationVector , vtkInformationVector )
int	IsScalarConnected (vtkIdType cellId)
void	TraverseAndMark ()
Protected Attributes
int	ColorRegions
int	ExtractionMode
vtkIdList *	Seeds
vtkIdList *	SpecifiedRegionIds
vtkIdTypeArray *	RegionSizes
double	ClosestPoint [3]
int	ScalarConnectivity
int	FullScalarConnectivity
double	ScalarRange [2]
vtkDataArray *	CellScalars
vtkIdList *	NeighborCellPointIds
vtkIdType *	Visited
vtkIdType *	PointMap
vtkDataArray *	NewScalars
vtkIdType	RegionNumber
vtkIdType	PointNumber
vtkIdType	NumCellsInRegion
vtkDataArray *	InScalars
vtkPolyData *	Mesh
vtkIdList *	Wave
vtkIdList *	Wave2
vtkIdList *	PointIds
vtkIdList *	CellIds
vtkIdList *	VisitedPointIds
int	MarkVisitedPointIds

Detailed Description

extract polygonal data based on geometric connectivity

vtkPolyDataConnectivityFilter is a filter that extracts cells that share common points and/or satisfy a scalar threshold criterion. (Such a group of cells is called a region.) The filter works in one of six ways: 1) extract the largest (most points) connected region in the dataset; 2) extract specified region numbers; 3) extract all regions sharing specified point ids; 4) extract all regions sharing specified cell ids; 5) extract the region closest to the specified point; or 6) extract all regions (used to color regions).

This filter is specialized for polygonal data. This means it runs a bit faster and is easier to construct visualization networks that process polygonal data.

The behavior of vtkPolyDataConnectivityFilter can be modified by turning on the boolean ivar ScalarConnectivity. If this flag is on, the connectivity algorithm is modified so that cells are considered connected only if 1) they are geometrically connected (share a point) and 2) the scalar values of the cell's points falls in the scalar range specified. If ScalarConnectivity and FullScalarConnectivity is ON, all the cell's points must lie in the scalar range specified for the cell to qualify as being connected. If FullScalarConnectivity is OFF, any one of the cell's points may lie in the user specified scalar range for the cell to qualify as being connected.

This use of ScalarConnectivity is particularly useful for selecting cells for later processing.

See also:: vtkConnectivityFilter

Tests:: vtkPolyDataConnectivityFilter (Tests)

Definition at line 69 of file vtkPolyDataConnectivityFilter.h.

Member Typedef Documentation

typedef vtkPolyDataAlgorithm vtkPolyDataConnectivityFilter::Superclass

Reimplemented from vtkPolyDataAlgorithm.

Definition at line 72 of file vtkPolyDataConnectivityFilter.h.

Constructor & Destructor Documentation

vtkPolyDataConnectivityFilter::vtkPolyDataConnectivityFilter ( ) [protected]

vtkPolyDataConnectivityFilter::~vtkPolyDataConnectivityFilter ( ) [protected]

Member Function Documentation

static int vtkPolyDataConnectivityFilter::IsTypeOf ( const char * name ) [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 vtkTypeMacro found in vtkSetGet.h.

Reimplemented from vtkPolyDataAlgorithm.

virtual int vtkPolyDataConnectivityFilter::IsA ( const char * name ) [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 vtkTypeMacro found in vtkSetGet.h.

Reimplemented from vtkPolyDataAlgorithm.

static vtkPolyDataConnectivityFilter* vtkPolyDataConnectivityFilter::SafeDownCast ( vtkObjectBase * o ) [static]

Reimplemented from vtkPolyDataAlgorithm.

virtual vtkObjectBase* vtkPolyDataConnectivityFilter::NewInstanceInternal ( ) const [protected, virtual]

Reimplemented from vtkPolyDataAlgorithm.

vtkPolyDataConnectivityFilter* vtkPolyDataConnectivityFilter::NewInstance ( ) const

Reimplemented from vtkPolyDataAlgorithm.

void vtkPolyDataConnectivityFilter::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.

virtual vtkIdTypeArray* vtkPolyDataConnectivityFilter::GetRegionSizes ( ) [virtual]

Obtain the array containing the region sizes of the extracted regions

static vtkPolyDataConnectivityFilter* vtkPolyDataConnectivityFilter::New ( ) [static]

Construct with default extraction mode to extract largest regions.

Reimplemented from vtkPolyDataAlgorithm.

virtual void vtkPolyDataConnectivityFilter::SetScalarConnectivity ( int ) [virtual]

Turn on/off connectivity based on scalar value. If on, cells are connected only if they share points AND one of the cells scalar values falls in the scalar range specified.

virtual int vtkPolyDataConnectivityFilter::GetScalarConnectivity ( ) [virtual]

Turn on/off connectivity based on scalar value. If on, cells are connected only if they share points AND one of the cells scalar values falls in the scalar range specified.

virtual void vtkPolyDataConnectivityFilter::ScalarConnectivityOn ( ) [virtual]

Turn on/off connectivity based on scalar value. If on, cells are connected only if they share points AND one of the cells scalar values falls in the scalar range specified.

virtual void vtkPolyDataConnectivityFilter::ScalarConnectivityOff ( ) [virtual]

Turn on/off connectivity based on scalar value. If on, cells are connected only if they share points AND one of the cells scalar values falls in the scalar range specified.

virtual void vtkPolyDataConnectivityFilter::SetFullScalarConnectivity ( int ) [virtual]

Turn on/off the use of Fully connected scalar connectivity. This is off by default. The flag is used only if ScalarConnectivity is on. If FullScalarConnectivity is ON, all the cell's points must lie in the scalar range specified for the cell to qualify as being connected. If FullScalarConnectivity is OFF, any one of the cell's points may lie in the user specified scalar range for the cell to qualify as being connected.

virtual int vtkPolyDataConnectivityFilter::GetFullScalarConnectivity ( ) [virtual]

Turn on/off the use of Fully connected scalar connectivity. This is off by default. The flag is used only if ScalarConnectivity is on. If FullScalarConnectivity is ON, all the cell's points must lie in the scalar range specified for the cell to qualify as being connected. If FullScalarConnectivity is OFF, any one of the cell's points may lie in the user specified scalar range for the cell to qualify as being connected.

virtual void vtkPolyDataConnectivityFilter::FullScalarConnectivityOn ( ) [virtual]

Turn on/off the use of Fully connected scalar connectivity. This is off by default. The flag is used only if ScalarConnectivity is on. If FullScalarConnectivity is ON, all the cell's points must lie in the scalar range specified for the cell to qualify as being connected. If FullScalarConnectivity is OFF, any one of the cell's points may lie in the user specified scalar range for the cell to qualify as being connected.

virtual void vtkPolyDataConnectivityFilter::FullScalarConnectivityOff ( ) [virtual]

Turn on/off the use of Fully connected scalar connectivity. This is off by default. The flag is used only if ScalarConnectivity is on. If FullScalarConnectivity is ON, all the cell's points must lie in the scalar range specified for the cell to qualify as being connected. If FullScalarConnectivity is OFF, any one of the cell's points may lie in the user specified scalar range for the cell to qualify as being connected.

virtual void vtkPolyDataConnectivityFilter::SetScalarRange	(	double	,
		double
	)		`[virtual]`

Set the scalar range to use to extract cells based on scalar connectivity.

void vtkPolyDataConnectivityFilter::SetScalarRange ( double [2] )

Set the scalar range to use to extract cells based on scalar connectivity.

virtual double* vtkPolyDataConnectivityFilter::GetScalarRange ( ) [virtual]

Set the scalar range to use to extract cells based on scalar connectivity.

virtual void vtkPolyDataConnectivityFilter::GetScalarRange	(	double &	,
		double &
	)		`[virtual]`

Set the scalar range to use to extract cells based on scalar connectivity.

virtual void vtkPolyDataConnectivityFilter::GetScalarRange ( double [2] ) [virtual]

Set the scalar range to use to extract cells based on scalar connectivity.

virtual void vtkPolyDataConnectivityFilter::SetExtractionMode ( int ) [virtual]