VTK
Public Types | Public Member Functions | Static Public Member Functions | Protected Member Functions | Protected Attributes
vtkDataObject Class Reference

general representation of visualization data More...

#include <vtkDataObject.h>

Inheritance diagram for vtkDataObject:
Inheritance graph
[legend]
Collaboration diagram for vtkDataObject:
Collaboration graph
[legend]

List of all members.

Public Types

typedef vtkObject Superclass
enum  FieldAssociations {
  FIELD_ASSOCIATION_POINTS, FIELD_ASSOCIATION_CELLS, FIELD_ASSOCIATION_NONE, FIELD_ASSOCIATION_POINTS_THEN_CELLS,
  FIELD_ASSOCIATION_VERTICES, FIELD_ASSOCIATION_EDGES, FIELD_ASSOCIATION_ROWS, NUMBER_OF_ASSOCIATIONS
}
enum  AttributeTypes {
  POINT, CELL, FIELD, POINT_THEN_CELL,
  VERTEX, EDGE, ROW, NUMBER_OF_ATTRIBUTE_TYPES
}
enum  FieldOperations { FIELD_OPERATION_PRESERVED, FIELD_OPERATION_REINTERPOLATED, FIELD_OPERATION_MODIFIED, FIELD_OPERATION_REMOVED }

Public Member Functions

virtual int IsA (const char *type)
vtkDataObjectNewInstance () const
void PrintSelf (ostream &os, vtkIndent indent)
unsigned long int GetMTime ()
virtual void Initialize ()
void ReleaseData ()
virtual int GetDataObjectType ()
unsigned long GetUpdateTime ()
virtual unsigned long GetActualMemorySize ()
void DataHasBeenGenerated ()
virtual void PrepareForNewData ()
virtual int GetExtentType ()
virtual void Crop (const int *updateExtent)
virtual vtkDataSetAttributesGetAttributes (int type)
virtual vtkFieldDataGetAttributesAsFieldData (int type)
virtual int GetAttributeTypeForArray (vtkAbstractArray *arr)
virtual vtkIdType GetNumberOfElements (int type)
virtual vtkInformationGetInformation ()
virtual void SetInformation (vtkInformation *)
virtual int GetDataReleased ()
virtual void SetFieldData (vtkFieldData *)
virtual vtkFieldDataGetFieldData ()
virtual void CopyInformationFromPipeline (vtkInformation *vtkNotUsed(info))
virtual void ShallowCopy (vtkDataObject *src)
virtual void DeepCopy (vtkDataObject *src)

Static Public Member Functions

static vtkDataObjectNew ()
static int IsTypeOf (const char *type)
static vtkDataObjectSafeDownCast (vtkObjectBase *o)
static const char * GetAssociationTypeAsString (int associationType)
static int GetAssociationTypeFromString (const char *associationType)
static vtkInformationStringKeyDATA_TYPE_NAME ()
static
vtkInformationDataObjectKey
DATA_OBJECT ()
static vtkInformationIntegerKeyDATA_EXTENT_TYPE ()
static
vtkInformationIntegerPointerKey
DATA_EXTENT ()
static vtkInformationIntegerKeyDATA_PIECE_NUMBER ()
static vtkInformationIntegerKeyDATA_NUMBER_OF_PIECES ()
static vtkInformationIntegerKeyDATA_NUMBER_OF_GHOST_LEVELS ()
static vtkInformationDoubleKeyDATA_RESOLUTION ()
static vtkInformationDoubleKeyDATA_TIME_STEP ()
static
vtkInformationInformationVectorKey
POINT_DATA_VECTOR ()
static
vtkInformationInformationVectorKey
CELL_DATA_VECTOR ()
static
vtkInformationInformationVectorKey
VERTEX_DATA_VECTOR ()
static
vtkInformationInformationVectorKey
EDGE_DATA_VECTOR ()
static vtkInformationIntegerKeyFIELD_ARRAY_TYPE ()
static vtkInformationIntegerKeyFIELD_ASSOCIATION ()
static vtkInformationIntegerKeyFIELD_ATTRIBUTE_TYPE ()
static vtkInformationIntegerKeyFIELD_ACTIVE_ATTRIBUTE ()
static vtkInformationIntegerKeyFIELD_NUMBER_OF_COMPONENTS ()
static vtkInformationIntegerKeyFIELD_NUMBER_OF_TUPLES ()
static vtkInformationIntegerKeyFIELD_OPERATION ()
static
vtkInformationDoubleVectorKey
FIELD_RANGE ()
static
vtkInformationDoubleVectorKey
PIECE_FIELD_RANGE ()
static vtkInformationStringKeyFIELD_ARRAY_NAME ()
static
vtkInformationIntegerVectorKey
PIECE_EXTENT ()
static vtkInformationStringKeyFIELD_NAME ()
static
vtkInformationDoubleVectorKey
ORIGIN ()
static
vtkInformationDoubleVectorKey
SPACING ()
static vtkInformationIntegerKeyDATA_GEOMETRY_UNMODIFIED ()
static
vtkInformationDoubleVectorKey
BOUNDING_BOX ()
static
vtkInformationDataObjectKey
SIL ()
static vtkInformationGetActiveFieldInformation (vtkInformation *info, int fieldAssociation, int attributeType)
static vtkInformationGetNamedFieldInformation (vtkInformation *info, int fieldAssociation, const char *name)
static void RemoveNamedFieldInformation (vtkInformation *info, int fieldAssociation, const char *name)
static vtkInformationSetActiveAttribute (vtkInformation *info, int fieldAssociation, const char *attributeName, int attributeType)
static void SetActiveAttributeInfo (vtkInformation *info, int fieldAssociation, int attributeType, const char *name, int arrayType, int numComponents, int numTuples)
static void SetPointDataActiveScalarInfo (vtkInformation *info, int arrayType, int numComponents)
static vtkDataObjectGetData (vtkInformation *info)
static vtkDataObjectGetData (vtkInformationVector *v, int i=0)

Protected Member Functions

virtual vtkObjectBaseNewInstanceInternal () const
 vtkDataObject ()
 ~vtkDataObject ()

Protected Attributes

vtkFieldDataFieldData
int DataReleased
vtkTimeStamp UpdateTime
vtkInformationInformation
static void SetGlobalReleaseDataFlag (int val)
static int GetGlobalReleaseDataFlag ()
void GlobalReleaseDataFlagOn ()
void GlobalReleaseDataFlagOff ()

Detailed Description

general representation of visualization data

helper class to get VTK data object types as string and instantiate them

vtkDataObject is an general representation of visualization data. It serves to encapsulate instance variables and methods for visualization network execution, as well as representing data consisting of a field (i.e., just an unstructured pile of data). This is to be compared with a vtkDataSet, which is data with geometric and/or topological structure.

vtkDataObjects are used to represent arbitrary repositories of data via the vtkFieldData instance variable. These data must be eventually mapped into a concrete subclass of vtkDataSet before they can actually be displayed.

See also:
vtkDataSet vtkFieldData vtkDataObjectSource vtkDataObjectFilter vtkDataObjectMapper vtkDataObjectToDataSet vtkFieldDataToAttributeDataFilter
Examples:
vtkDataObject (Examples)
Tests:
vtkDataObject (Tests)

vtkDataObjectTypes is a helper class that supports conversion between integer types defined in vtkType.h and string names as well as creation of data objects from either integer or string types. This class has to be updated every time a new data type is added to VTK.

See also:
vtkDataObject

Definition at line 64 of file vtkDataObject.h.


Member Typedef Documentation


Member Enumeration Documentation

Possible values for the FIELD_ASSOCIATION information entry.

Enumerator:
FIELD_ASSOCIATION_POINTS 
FIELD_ASSOCIATION_CELLS 
FIELD_ASSOCIATION_NONE 
FIELD_ASSOCIATION_POINTS_THEN_CELLS 
FIELD_ASSOCIATION_VERTICES 
FIELD_ASSOCIATION_EDGES 
FIELD_ASSOCIATION_ROWS 
NUMBER_OF_ASSOCIATIONS 

Definition at line 224 of file vtkDataObject.h.

Possible attribute types. POINT_THEN_CELL is provided for consistency with FieldAssociations.

Enumerator:
POINT 
CELL 
FIELD 
POINT_THEN_CELL 
VERTEX 
EDGE 
ROW 
NUMBER_OF_ATTRIBUTE_TYPES 

Definition at line 242 of file vtkDataObject.h.

Possible values for the FIELD_OPERATION information entry.

Enumerator:
FIELD_OPERATION_PRESERVED 
FIELD_OPERATION_REINTERPOLATED 
FIELD_OPERATION_MODIFIED 
FIELD_OPERATION_REMOVED 

Definition at line 284 of file vtkDataObject.h.


Constructor & Destructor Documentation


Member Function Documentation

static vtkDataObject* vtkDataObject::New ( ) [static]
static int vtkDataObject::IsTypeOf ( const char *  name) [static]
virtual int vtkDataObject::IsA ( const char *  name) [virtual]
virtual vtkObjectBase* vtkDataObject::NewInstanceInternal ( ) const [protected, virtual]
void vtkDataObject::PrintSelf ( ostream &  os,
vtkIndent  indent 
) [virtual]

Set/Get the information object associated with this data object.

virtual void vtkDataObject::SetInformation ( vtkInformation ) [virtual]

Set/Get the information object associated with this data object.

unsigned long int vtkDataObject::GetMTime ( ) [virtual]

Data objects are composite objects and need to check each part for MTime. The information object also needs to be considered.

Reimplemented from vtkObject.

Reimplemented in vtkGraph, vtkDataSet, vtkGenericDataSet, vtkBridgeDataSet, vtkAnnotation, vtkSelection, vtkAnnotationLayers, and vtkPointSet.

virtual void vtkDataObject::Initialize ( ) [virtual]

Release data back to system to conserve memory resource. Used during visualization network execution. Releasing this data does not make down-stream data invalid, so it does not modify the MTime of this data object.

virtual int vtkDataObject::GetDataReleased ( ) [virtual]

Get the flag indicating the data has been released.

static void vtkDataObject::SetGlobalReleaseDataFlag ( int  val) [static]

Turn on/off flag to control whether every object releases its data after being used by a filter.

Turn on/off flag to control whether every object releases its data after being used by a filter.

Definition at line 101 of file vtkDataObject.h.

Turn on/off flag to control whether every object releases its data after being used by a filter.

Definition at line 102 of file vtkDataObject.h.

Turn on/off flag to control whether every object releases its data after being used by a filter.

virtual void vtkDataObject::SetFieldData ( vtkFieldData ) [virtual]

Assign or retrieve a general field data to this data object.

virtual vtkFieldData* vtkDataObject::GetFieldData ( ) [virtual]

Assign or retrieve a general field data to this data object.

virtual int vtkDataObject::GetDataObjectType ( ) [inline, virtual]
unsigned long vtkDataObject::GetUpdateTime ( )

Used by Threaded ports to determine if they should initiate an asynchronous update (still in development).

virtual unsigned long vtkDataObject::GetActualMemorySize ( ) [virtual]

Return the actual size of the data in kilobytes. This number is valid only after the pipeline has updated. The memory size returned is guaranteed to be greater than or equal to the memory required to represent the data (e.g., extra space in arrays, etc. are not included in the return value).

Reimplemented in vtkHyperOctree, vtkPolyData, vtkHyperTreeGrid, vtkImageData, vtkDataSet, vtkUnstructuredGrid, vtkGenericDataSet, vtkRectilinearGrid, vtkStructuredGrid, vtkDataObjectTree, vtkPointSet, vtkTable, and vtkCompositeDataSet.

virtual void vtkDataObject::CopyInformationFromPipeline ( vtkInformation vtkNotUsedinfo) [inline, virtual]

Copy information about this data object from the pipeline information to its own Information. Called right before the main execution pass..

Definition at line 133 of file vtkDataObject.h.

static vtkInformation* vtkDataObject::GetActiveFieldInformation ( vtkInformation info,
int  fieldAssociation,
int  attributeType 
) [static]

Return the information object within the input information object's field data corresponding to the specified association (FIELD_ASSOCIATION_POINTS or FIELD_ASSOCIATION_CELLS) and attribute (SCALARS, VECTORS, NORMALS, TCOORDS, or TENSORS)

static vtkInformation* vtkDataObject::GetNamedFieldInformation ( vtkInformation info,
int  fieldAssociation,
const char *  name 
) [static]

Return the information object within the input information object's field data corresponding to the specified association (FIELD_ASSOCIATION_POINTS or FIELD_ASSOCIATION_CELLS) and name.

static void vtkDataObject::RemoveNamedFieldInformation ( vtkInformation info,
int  fieldAssociation,
const char *  name 
) [static]

Remove the info associated with an array

static vtkInformation* vtkDataObject::SetActiveAttribute ( vtkInformation info,
int  fieldAssociation,
const char *  attributeName,
int  attributeType 
) [static]

Set the named array to be the active field for the specified type (SCALARS, VECTORS, NORMALS, TCOORDS, or TENSORS) and association (FIELD_ASSOCIATION_POINTS or FIELD_ASSOCIATION_CELLS). Returns the active field information object and creates on entry if one not found.

static void vtkDataObject::SetActiveAttributeInfo ( vtkInformation info,
int  fieldAssociation,
int  attributeType,
const char *  name,
int  arrayType,
int  numComponents,
int  numTuples 
) [static]

Set the name, array type, number of components, and number of tuples within the passed information object for the active attribute of type attributeType (in specified association, FIELD_ASSOCIATION_POINTS or FIELD_ASSOCIATION_CELLS). If there is not an active attribute of the specified type, an entry in the information object is created. If arrayType, numComponents, or numTuples equal to -1, or name=NULL the value is not changed.

static void vtkDataObject::SetPointDataActiveScalarInfo ( vtkInformation info,
int  arrayType,
int  numComponents 
) [static]

Convenience version of previous method for use (primarily) by the Imaging filters. If arrayType or numComponents == -1, the value is not changed.

This method is called by the source when it executes to generate data. It is sort of the opposite of ReleaseData. It sets the DataReleased flag to 0, and sets a new UpdateTime.

virtual void vtkDataObject::PrepareForNewData ( ) [inline, virtual]

make the output data ready for new data to be inserted. For most objects we just call Initialize. But for vtkImageData we leave the old data in case the memory can be reused.

Reimplemented in vtkImageData.

Definition at line 200 of file vtkDataObject.h.

virtual void vtkDataObject::ShallowCopy ( vtkDataObject src) [virtual]
virtual void vtkDataObject::DeepCopy ( vtkDataObject src) [virtual]
virtual int vtkDataObject::GetExtentType ( ) [inline, virtual]

The ExtentType will be left as VTK_PIECES_EXTENT for data objects such as vtkPolyData and vtkUnstructuredGrid. The ExtentType will be changed to VTK_3D_EXTENT for data objects with 3D structure such as vtkImageData (and its subclass vtkStructuredPoints), vtkRectilinearGrid, and vtkStructuredGrid. The default is the have an extent in pieces, with only one piece (no streaming possible).

Reimplemented in vtkImageData, vtkRectilinearGrid, vtkStructuredGrid, and vtkImageStencilData.

Definition at line 215 of file vtkDataObject.h.

virtual void vtkDataObject::Crop ( const int updateExtent) [virtual]

This method crops the data object (if necessary) so that the extent matches the update extent.

Reimplemented in vtkImageData, vtkStructuredGrid, and vtkRectilinearGrid.

Returns the attributes of the data object of the specified attribute type. The type may be:

The other attribute type, FIELD, will return NULL since field data is stored as a vtkFieldData instance, not a vtkDataSetAttributes instance. To retrieve field data, use GetAttributesAsFieldData.

Reimplemented in vtkGenericDataSet.

Returns the attributes of the data object as a vtkFieldData. This returns non-null values in all the same cases as GetAttributes, in addition to the case of FIELD, which will return the field data for any vtkDataObject subclass.

Reimplemented in vtkGraph, vtkDataSet, and vtkTable.

Retrieves the attribute type that an array came from. This is useful for obtaining which attribute type a input array to an algorithm came from (retrieved from GetInputAbstractArrayToProcesss).

virtual vtkIdType vtkDataObject::GetNumberOfElements ( int  type) [virtual]

Get the number of elements for a specific attribute type (POINT, CELL, etc.).

Reimplemented in vtkGraph, vtkDataSet, and vtkTable.

static const char* vtkDataObject::GetAssociationTypeAsString ( int  associationType) [static]

Given an integer association type, this static method returns a string type for the attribute (i.e. type = 0: returns "Points").

static int vtkDataObject::GetAssociationTypeFromString ( const char *  associationType) [static]

Given an integer association type, this static method returns a string type for the attribute (i.e. type = 0: returns "Points").

static vtkDataObject* vtkDataObject::GetData ( vtkInformation info) [static]
static vtkDataObject* vtkDataObject::GetData ( vtkInformationVector v,
int  i = 0 
) [static]

Member Data Documentation

Definition at line 349 of file vtkDataObject.h.

Definition at line 352 of file vtkDataObject.h.

Definition at line 355 of file vtkDataObject.h.

Definition at line 358 of file vtkDataObject.h.


The documentation for this class was generated from the following file: