Executive supporting composite datasets. More...

#include <vtkCompositeDataPipeline.h>

Inheritance diagram for vtkCompositeDataPipeline:

Collaboration diagram for vtkCompositeDataPipeline:

Public Types
typedef vtkStreamingDemandDrivenPipeline	Superclass
Public Member Functions
virtual int	IsA (const char *type)
vtkCompositeDataPipeline *	NewInstance () const
void	PrintSelf (ostream &os, vtkIndent indent)
vtkDataObject *	GetCompositeOutputData (int port)

vtkDataObject *	GetCompositeInputData (int port, int index, vtkInformationVector **inInfoVec)
Static Public Member Functions
static vtkCompositeDataPipeline *	New ()
static int	IsTypeOf (const char *type)
static vtkCompositeDataPipeline *	SafeDownCast (vtkObjectBase *o)
static vtkInformationIntegerKey *	LOAD_REQUESTED_BLOCKS ()
static vtkInformationObjectBaseKey *	COMPOSITE_DATA_META_DATA ()
static vtkInformationIntegerVectorKey *	UPDATE_COMPOSITE_INDICES ()
static vtkInformationIntegerVectorKey *	COMPOSITE_INDICES ()
Protected Member Functions
virtual vtkObjectBase *	NewInstanceInternal () const
	vtkCompositeDataPipeline ()
	~vtkCompositeDataPipeline ()
virtual int	ForwardUpstream (vtkInformation *request)
virtual int	ForwardUpstream (int i, int j, vtkInformation *request)
virtual void	CopyDefaultInformation (vtkInformation request, int direction, vtkInformationVector inInfoVec, vtkInformationVector outInfoVec)
virtual void	CopyFromDataToInformation (vtkDataObject dobj, vtkInformation inInfo)
virtual void	PushInformation (vtkInformation *)
virtual void	PopInformation (vtkInformation *)
virtual int	ExecuteDataObject (vtkInformation request, vtkInformationVector inInfo, vtkInformationVector outInfo)
virtual int	ExecuteData (vtkInformation request, vtkInformationVector inInfoVec, vtkInformationVector outInfoVec)
virtual void	ExecuteDataStart (vtkInformation request, vtkInformationVector inInfoVec, vtkInformationVector outInfoVec)
virtual int	NeedToExecuteData (int outputPort, vtkInformationVector *inInfoVec, vtkInformationVector outInfoVec)
virtual int	CheckCompositeData (vtkInformation request, int port, vtkInformationVector inInfoVec, vtkInformationVector outInfoVec)
virtual void	ExecuteSimpleAlgorithm (vtkInformation request, vtkInformationVector inInfoVec, vtkInformationVector outInfoVec, int compositePort)
vtkDataObject *	ExecuteSimpleAlgorithmForBlock (vtkInformationVector *inInfoVec, vtkInformationVector outInfoVec, vtkInformation inInfo, vtkInformation outInfo, vtkInformation request, vtkDataObject dobj)
bool	ShouldIterateOverInput (int &compositePort)
virtual int	InputTypeIsValid (int port, int index, vtkInformationVector **inInfoVec)
virtual void	ResetPipelineInformation (int port, vtkInformation *)
virtual void	MarkOutputsGenerated (vtkInformation request, vtkInformationVector inInfoVec, vtkInformationVector outInfoVec)
int	NeedToExecuteBasedOnCompositeIndices (vtkInformation *outInfo)

vtkCompositeDataSet *	CreateOutputCompositeDataSet (vtkCompositeDataSet *input, int compositePort)
Protected Attributes
int	InLocalLoop
vtkInformation *	InformationCache
vtkInformation *	GenericRequest
vtkInformation *	DataObjectRequest
vtkInformation *	InformationRequest
vtkInformation *	UpdateExtentRequest
vtkInformation *	DataRequest
int	SuppressResetPipelineInformation

Detailed Description

Executive supporting composite datasets.

vtkCompositeDataPipeline is an executive that supports the processing of composite dataset. It supports algorithms that are aware of composite dataset as well as those that are not. Type checking is performed at run time. Algorithms that are not composite dataset-aware have to support all dataset types contained in the composite dataset. The pipeline execution can be summarized as follows:

REQUEST_INFORMATION: The producers have to provide information about the contents of the composite dataset in this pass. Sources that can produce more than one piece (note that a piece is different than a block; each piece consistes of 0 or more blocks) should set MAXIMUM_NUMBER_OF_PIECES to -1.

REQUEST_UPDATE_EXTENT: This pass is identical to the one implemented in vtkStreamingDemandDrivenPipeline

REQUEST_DATA: This is where the algorithms execute. If the vtkCompositeDataPipeline is assigned to a simple filter, it will invoke the vtkStreamingDemandDrivenPipeline passes in a loop, passing a different block each time and will collect the results in a composite dataset.

See also:: vtkCompositeDataSet

Examples:: vtkCompositeDataPipeline (Examples)

Tests:: vtkCompositeDataPipeline (Tests)

Definition at line 63 of file vtkCompositeDataPipeline.h.

Member Typedef Documentation

typedef vtkStreamingDemandDrivenPipeline vtkCompositeDataPipeline::Superclass

Reimplemented from vtkStreamingDemandDrivenPipeline.

Reimplemented in vtkThreadedStreamingPipeline.

Definition at line 68 of file vtkCompositeDataPipeline.h.

Constructor & Destructor Documentation

vtkCompositeDataPipeline::vtkCompositeDataPipeline ( ) [protected]

vtkCompositeDataPipeline::~vtkCompositeDataPipeline ( ) [protected]

Member Function Documentation

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

Create an object with Debug turned off, modified time initialized to zero, and reference counting on.

Reimplemented from vtkStreamingDemandDrivenPipeline.

Reimplemented in vtkThreadedStreamingPipeline.

static int vtkCompositeDataPipeline::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 vtkStreamingDemandDrivenPipeline.

Reimplemented in vtkThreadedStreamingPipeline.

virtual int vtkCompositeDataPipeline::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 vtkStreamingDemandDrivenPipeline.

Reimplemented in vtkThreadedStreamingPipeline.

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

Reimplemented from vtkStreamingDemandDrivenPipeline.

Reimplemented in vtkThreadedStreamingPipeline.

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

Reimplemented from vtkStreamingDemandDrivenPipeline.

Reimplemented in vtkThreadedStreamingPipeline.

vtkCompositeDataPipeline* vtkCompositeDataPipeline::NewInstance ( ) const

Reimplemented from vtkStreamingDemandDrivenPipeline.

Reimplemented in vtkThreadedStreamingPipeline.

void vtkCompositeDataPipeline::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 vtkStreamingDemandDrivenPipeline.

Reimplemented in vtkThreadedStreamingPipeline.

vtkDataObject* vtkCompositeDataPipeline::GetCompositeOutputData ( int port )

Returns the data object stored with the DATA_OBJECT() in the output port

vtkDataObject* vtkCompositeDataPipeline::GetCompositeInputData	(	int	port,
		int	index,
		vtkInformationVector **	inInfoVec
	)

Returns the data object stored with the DATA_OBJECT() in the input port

static vtkInformationIntegerKey* vtkCompositeDataPipeline::LOAD_REQUESTED_BLOCKS ( ) [static]

An integer key that indicates to the source to load all requested blocks specified in UPDATE_COMPOSITE_INDICES.

static vtkInformationObjectBaseKey* vtkCompositeDataPipeline::COMPOSITE_DATA_META_DATA ( ) [static]

COMPOSITE_DATA_META_DATA is a key placed in the output-port information by readers/sources producing composite datasets. This meta-data provides information about the structure of the composite dataset and things like data-bounds etc. *** THIS IS AN EXPERIMENTAL FEATURE. IT MAY CHANGE WITHOUT NOTICE ***

static vtkInformationIntegerVectorKey* vtkCompositeDataPipeline::UPDATE_COMPOSITE_INDICES ( ) [static]

UPDATE_COMPOSITE_INDICES is a key placed in the request to request a set of composite indices from a reader/source producing composite dataset. Typically, the reader publishes its structure using COMPOSITE_DATA_META_DATA() and then the sink requests blocks of interest using UPDATE_COMPOSITE_INDICES(). Note that UPDATE_COMPOSITE_INDICES has to be sorted vector with increasing indices. *** THIS IS AN EXPERIMENTAL FEATURE. IT MAY CHANGE WITHOUT NOTICE ***

static vtkInformationIntegerVectorKey* vtkCompositeDataPipeline::COMPOSITE_INDICES ( ) [static]

COMPOSITE_INDICES() is put in the output information by the executive if the request has UPDATE_COMPOSITE_INDICES() using the generated composite dataset's structure. Note that COMPOSITE_INDICES has to be sorted vector with increasing indices. *** THIS IS AN EXPERIMENTAL FEATURE. IT MAY CHANGE WITHOUT NOTICE ***

virtual int vtkCompositeDataPipeline::ForwardUpstream ( vtkInformation * request ) [protected, virtual]

Reimplemented from vtkExecutive.

Reimplemented in vtkThreadedStreamingPipeline.

virtual int vtkCompositeDataPipeline::ForwardUpstream	(	int	i,
		int	j,
		vtkInformation *	request
	)		`[protected, virtual]`

Reimplemented in vtkThreadedStreamingPipeline.

virtual void vtkCompositeDataPipeline::CopyDefaultInformation	(	vtkInformation *	request,
		int	direction,
		vtkInformationVector **	inInfoVec,
		vtkInformationVector *	outInfoVec
	)		`[protected, virtual]`

Reimplemented from vtkStreamingDemandDrivenPipeline.

virtual void vtkCompositeDataPipeline::CopyFromDataToInformation	(	vtkDataObject *	dobj,
		vtkInformation *	inInfo
	)		`[protected, virtual]`

virtual void vtkCompositeDataPipeline::PushInformation ( vtkInformation * ) [protected, virtual]

virtual void vtkCompositeDataPipeline::PopInformation ( vtkInformation * ) [protected, virtual]

virtual int vtkCompositeDataPipeline::ExecuteDataObject	(	vtkInformation *	request,
		vtkInformationVector **	inInfo,
		vtkInformationVector *	outInfo
	)		`[protected, virtual]`

Reimplemented from vtkDemandDrivenPipeline.

virtual int vtkCompositeDataPipeline::ExecuteData	(	vtkInformation *	request,
		vtkInformationVector **	inInfoVec,
		vtkInformationVector *	outInfoVec
	)		`[protected, virtual]`

Reimplemented from vtkDemandDrivenPipeline.

virtual void vtkCompositeDataPipeline::ExecuteDataStart	(	vtkInformation *	request,
		vtkInformationVector **	inInfoVec,
		vtkInformationVector *	outInfoVec
	)		`[protected, virtual]`

Reimplemented from vtkStreamingDemandDrivenPipeline.

virtual int vtkCompositeDataPipeline::NeedToExecuteData	(	int	outputPort,
		vtkInformationVector **	inInfoVec,
		vtkInformationVector *	outInfoVec
	)		`[protected, virtual]`

Reimplemented from vtkStreamingDemandDrivenPipeline.

virtual int vtkCompositeDataPipeline::CheckCompositeData	(	vtkInformation *	request,
		int	port,
		vtkInformationVector **	inInfoVec,
		vtkInformationVector *	outInfoVec
	)		`[protected, virtual]`

virtual void vtkCompositeDataPipeline::ExecuteSimpleAlgorithm	(	vtkInformation *	request,
		vtkInformationVector **	inInfoVec,
		vtkInformationVector *	outInfoVec,
		int	compositePort
	)		`[protected, virtual]`

vtkDataObject* vtkCompositeDataPipeline::ExecuteSimpleAlgorithmForBlock	(	vtkInformationVector **	inInfoVec,
		vtkInformationVector *	outInfoVec,
		vtkInformation *	inInfo,
		vtkInformation *	outInfo,
		vtkInformation *	request,
		vtkDataObject *	dobj
	)		`[protected]`

bool vtkCompositeDataPipeline::ShouldIterateOverInput ( int & compositePort ) [protected]

virtual int vtkCompositeDataPipeline::InputTypeIsValid	(	int	port,
		int	index,
		vtkInformationVector **	inInfoVec
	)		`[protected, virtual]`

Reimplemented from vtkDemandDrivenPipeline.

virtual void vtkCompositeDataPipeline::ResetPipelineInformation	(	int	port,
		vtkInformation *
	)		`[protected, virtual]`

Reimplemented from vtkStreamingDemandDrivenPipeline.

vtkCompositeDataSet* vtkCompositeDataPipeline::CreateOutputCompositeDataSet	(	vtkCompositeDataSet *	input,
		int	compositePort
	)		`[protected]`

Tries to create the best possible composite data output for the given input and non-composite algorithm output. Returns a new instance on success. It's main purpose is to determine if vtkHierarchicalBoxDataSet can be propagated as vtkHierarchicalBoxDataSet in the output (if the algorithm can produce vtkUniformGrid given vtkUniformGrid inputs) or if it should be downgraded to a vtkMultiBlockDataSet.

virtual void vtkCompositeDataPipeline::MarkOutputsGenerated	(	vtkInformation *	request,
		vtkInformationVector **	inInfoVec,
		vtkInformationVector *	outInfoVec
	)		`[protected, virtual]`