You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
nmWTAI-Platform/3rd/VTK7.1/include/vtkDataSetAttributes.h

694 lines
25 KiB
C++

/*=========================================================================
Program: Visualization Toolkit
Module: vtkDataSetAttributes.h
Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
All rights reserved.
See Copyright.txt or http://www.kitware.com/Copyright.htm for details.
This software is distributed WITHOUT ANY WARRANTY; without even
the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the above copyright notice for more information.
=========================================================================*/
/**
* @class vtkDataSetAttributes
* @brief represent and manipulate attribute data in a dataset
*
* vtkDataSetAttributes is a class that is used to represent and manipulate
* attribute data (e.g., scalars, vectors, normals, texture coordinates,
* tensors, global ids, pedigree ids, and field data).
*
* This adds to vtkFieldData the ability to pick one of the arrays from the
* field as the currently active array for each attribute type. In other
* words, you pick one array to be called "THE" Scalars, and then filters down
* the pipeline will treat that array specially. For example vtkContourFilter
* will contour "THE" Scalar array unless a different array is asked for.
*
* Additionally vtkDataSetAttributes provides methods that filters call to
* pass data through, copy data into, and interpolate from Fields. PassData
* passes entire arrays from the source to the destination. Copy passes
* through some subset of the tuples from the source to the destination.
* Interpolate interpolates from the chosen tuple(s) in the source data, using
* the provided weights, to produce new tuples in the destination.
* Each attribute type has pass, copy and interpolate "copy" flags that
* can be set in the destination to choose which attribute arrays will be
* transferred from the source to the destination.
*
* Finally this class provides a mechanism to determine which attributes a
* group of sources have in common, and to copy tuples from a source into
* the destination, for only those attributes that are held by all.
*/
#ifndef vtkDataSetAttributes_h
#define vtkDataSetAttributes_h
#include "vtkCommonDataModelModule.h" // For export macro
#include "vtkFieldData.h"
class vtkLookupTable;
class VTKCOMMONDATAMODEL_EXPORT vtkDataSetAttributes : public vtkFieldData
{
public:
/**
* Construct object with copying turned on for all data.
*/
static vtkDataSetAttributes *New();
vtkTypeMacro(vtkDataSetAttributes,vtkFieldData);
void PrintSelf(ostream& os, vtkIndent indent) VTK_OVERRIDE;
/**
* Initialize all of the object's data to NULL
* Also, clear the copy flags.
*/
void Initialize() VTK_OVERRIDE;
/**
* Attributes have a chance to bring themselves up to date; right
* now this is ignored.
*/
virtual void Update() {}
// -- shallow and deep copy -----------------------------------------------
/**
* Deep copy of data (i.e., create new data arrays and
* copy from input data).
* Ignores the copy flags but preserves them in the output.
*/
void DeepCopy(vtkFieldData *pd) VTK_OVERRIDE;
/**
* Shallow copy of data (i.e., use reference counting).
* Ignores the copy flags but preserves them in the output.
*/
void ShallowCopy(vtkFieldData *pd) VTK_OVERRIDE;
// -- attribute types -----------------------------------------------------
// Always keep NUM_ATTRIBUTES as the last entry
enum AttributeTypes
{
SCALARS=0,
VECTORS=1,
NORMALS=2,
TCOORDS=3,
TENSORS=4,
GLOBALIDS=5,
PEDIGREEIDS=6,
EDGEFLAG=7,
NUM_ATTRIBUTES
};
enum AttributeLimitTypes
{
MAX,
EXACT,
NOLIMIT
};
// ----------- ghost points and ghost cells -------------------------------------------
//The following bit fields are consistent with VisIt ghost zones specification
//For details, see http://www.visitusers.org/index.php?title=Representing_ghost_data
enum CellGhostTypes
{
DUPLICATECELL = 1, //the cell is present on multiple processors
HIGHCONNECTIVITYCELL = 2, //the cell has more neighbors than in a regular mesh
LOWCONNECTIVITYCELL = 4, //the cell has less neighbors than in a regular mesh
REFINEDCELL = 8, //other cells are present that refines it.
EXTERIORCELL = 16, //the cell is on the exterior of the data set
HIDDENCELL = 32 //the cell is needed to maintain connectivity, but the data values should be ignored.
};
enum PointGhostTypes
{
DUPLICATEPOINT =1, //the cell is present on multiple processors
HIDDENPOINT =2 //the point is needed to maintain connectivity, but the data values should be ignored.
};
//A vtkDataArray with this name must be of type vtkUnsignedCharArray.
//Each value must be assigned according to the bit fields described in
//PointGhostTypes or CellGhostType
static const char* GhostArrayName() { return "vtkGhostType";}
//-----------------------------------------------------------------------------------
//@{
/**
* Set/Get the scalar data.
*/
int SetScalars(vtkDataArray* da);
int SetActiveScalars(const char* name);
vtkDataArray* GetScalars();
//@}
//@{
/**
* Set/Get the vector data.
*/
int SetVectors(vtkDataArray* da);
int SetActiveVectors(const char* name);
vtkDataArray* GetVectors();
//@}
//@{
/**
* Set/get the normal data.
*/
int SetNormals(vtkDataArray* da);
int SetActiveNormals(const char* name);
vtkDataArray* GetNormals();
//@}
//@{
/**
* Set/Get the texture coordinate data.
*/
int SetTCoords(vtkDataArray* da);
int SetActiveTCoords(const char* name);
vtkDataArray* GetTCoords();
//@}
//@{
/**
* Set/Get the tensor data.
*/
int SetTensors(vtkDataArray* da);
int SetActiveTensors(const char* name);
vtkDataArray* GetTensors();
//@}
//@{
/**
* Set/Get the global id data.
*/
int SetGlobalIds(vtkDataArray* da);
int SetActiveGlobalIds(const char* name);
vtkDataArray* GetGlobalIds();
//@}
//@{
/**
* Set/Get the pedigree id data.
*/
int SetPedigreeIds(vtkAbstractArray* da);
int SetActivePedigreeIds(const char* name);
vtkAbstractArray* GetPedigreeIds();
//@}
//@{
/**
* This will first look for an array with the correct name.
* If one exists, it is returned. Otherwise, the name argument
* is ignored, and the active attribute is returned.
*/
vtkDataArray* GetScalars(const char* name);
vtkDataArray* GetVectors(const char* name);
vtkDataArray* GetNormals(const char* name);
vtkDataArray* GetTCoords(const char* name);
vtkDataArray* GetTensors(const char* name);
vtkDataArray* GetGlobalIds(const char* name);
vtkAbstractArray* GetPedigreeIds(const char* name);
//@}
/**
* Make the array with the given name the active attribute.
* Attribute types are:
* vtkDataSetAttributes::SCALARS = 0
* vtkDataSetAttributes::VECTORS = 1
* vtkDataSetAttributes::NORMALS = 2
* vtkDataSetAttributes::TCOORDS = 3
* vtkDataSetAttributes::TENSORS = 4
* vtkDataSetAttributes::GLOBALIDS = 5
* vtkDataSetAttributes::PEDIGREEIDS = 6
* vtkDataSetAttributes::EDGEFLAG = 7
* Returns the index of the array if successful, -1 if the array
* is not in the list of arrays.
*/
int SetActiveAttribute(const char* name, int attributeType);
/**
* Make the array with the given index the active attribute.
*/
int SetActiveAttribute(int index, int attributeType);
/**
* Get the field data array indices corresponding to scalars,
* vectors, tensors, etc.
*/
void GetAttributeIndices(int* indexArray);
/**
* Determine whether a data array of index idx is considered a data set
* attribute (i.e., scalar, vector, tensor, etc). Return less-than zero
* if it is, otherwise an index 0<=idx<NUM_ATTRIBUTES to indicate
* which attribute.
*/
int IsArrayAnAttribute(int idx);
/**
* Set an array to use as the given attribute type (i.e.,
* vtkDataSetAttributes::SCALAR, vtkDataSetAttributes::VECTOR,
* vtkDataSetAttributes::TENSOR, etc.). If this attribute was
* previously set to another array, that array is removed from the
* vtkDataSetAttributes object and the array aa is used as the
* attribute.
* Returns the index of aa within the vtkDataSetAttributes object
* (i.e., the index to pass to the method GetArray(int) to obtain
* aa) if the attribute was set to aa successfully. If aa was
* already set as the given attributeType, returns the index of
* aa.
* Returns -1 in the following cases:
* - aa is NULL (used to unset an attribute; not an error indicator)
* - aa is not a subclass of vtkDataArray, unless the attributeType
* is vtkDataSetAttributes::PEDIGREEIDS (error indicator)
* - aa has a number of components incompatible with the attribute type
* (error indicator)
*/
int SetAttribute(vtkAbstractArray* aa, int attributeType);
/**
* Return an attribute given the attribute type
* (see vtkDataSetAttributes::AttributeTypes).
* Some attributes (such as PEDIGREEIDS) may not be vtkDataArray subclass,
* so in that case use GetAbstractAttribute().
*/
vtkDataArray* GetAttribute(int attributeType);
/**
* Return an attribute given the attribute type
* (see vtkDataSetAttributes::AttributeTypes).
* This is the same as GetAttribute(), except that the returned array
* is a vtkAbstractArray instead of vtkDataArray.
* Some attributes (such as PEDIGREEIDS) may not be vtkDataArray subclass.
*/
vtkAbstractArray* GetAbstractAttribute(int attributeType);
//@{
/**
* Remove an array (with the given name) from the list of arrays.
*/
using vtkFieldData::RemoveArray;
void RemoveArray(int index) VTK_OVERRIDE;
//@}
//@{
/**
* Given an integer attribute type, this static method returns a string type
* for the attribute (i.e. type = 0: returns "Scalars").
*/
static const char* GetAttributeTypeAsString(int attributeType);
static const char* GetLongAttributeTypeAsString(int attributeType);
//@}
// -- attribute copy properties ------------------------------------------
enum AttributeCopyOperations
{
COPYTUPLE=0,
INTERPOLATE=1,
PASSDATA=2,
ALLCOPY //all of the above
};
/**
* Turn on/off the copying of attribute data.
* ctype is one of the AttributeCopyOperations, and controls copy,
* interpolate and passdata behavior.
* For set, ctype=ALLCOPY means set all three flags to the same value.
* For get, ctype=ALLCOPY returns true only if all three flags are true.
* During copying, interpolation and passdata, the following rules are
* followed for each array:
* 1. If the copy/interpolate/pass flag for an attribute is set (on or off),
* it is applied. This overrides rules 2 and 3.
* 2. If the copy flag for an array is set (on or off), it is applied
* This overrides rule 3.
* 3. If CopyAllOn is set, copy the array.
* If CopyAllOff is set, do not copy the array
* For interpolation, the flag values can be as follows:
* 0: Do not interpolate.
* 1: Weighted interpolation.
* 2. Nearest neighbor interpolation.
*/
void SetCopyAttribute (int index, int value, int ctype=ALLCOPY);
/**
* Get the attribute copy flag for copy operation <ctype> of attribute
* <index>.
*/
int GetCopyAttribute (int index, int ctype);
/// @copydoc vtkDataSetAttributes::SetCopyAttribute()
void SetCopyScalars(int i, int ctype=ALLCOPY);
int GetCopyScalars(int ctype=ALLCOPY);
vtkBooleanMacro(CopyScalars, int);
/// @copydoc vtkDataSetAttributes::SetCopyAttribute()
void SetCopyVectors(int i, int ctype=ALLCOPY);
int GetCopyVectors(int ctype=ALLCOPY);
vtkBooleanMacro(CopyVectors, int);
/// @copydoc vtkDataSetAttributes::SetCopyAttribute()
void SetCopyNormals(int i, int ctype=ALLCOPY);
int GetCopyNormals(int ctype=ALLCOPY);
vtkBooleanMacro(CopyNormals, int);
/// @copydoc vtkDataSetAttributes::SetCopyAttribute()
void SetCopyTCoords(int i, int ctype=ALLCOPY);
int GetCopyTCoords(int ctype=ALLCOPY);
vtkBooleanMacro(CopyTCoords, int);
/// @copydoc vtkDataSetAttributes::SetCopyAttribute()
void SetCopyTensors(int i, int ctype=ALLCOPY);
int GetCopyTensors(int ctype=ALLCOPY);
vtkBooleanMacro(CopyTensors, int);
/// @copydoc vtkDataSetAttributes::SetCopyAttribute()
void SetCopyGlobalIds(int i, int ctype=ALLCOPY);
int GetCopyGlobalIds(int ctype=ALLCOPY);
vtkBooleanMacro(CopyGlobalIds, int);
/// @copydoc vtkDataSetAttributes::SetCopyAttribute()
void SetCopyPedigreeIds(int i, int ctype=ALLCOPY);
int GetCopyPedigreeIds(int ctype=ALLCOPY);
vtkBooleanMacro(CopyPedigreeIds, int);
/// @copydoc vtkDataSetAttributes::SetCopyAttribute()
void CopyAllOn(int ctype=ALLCOPY) VTK_OVERRIDE;
/// @copydoc vtkDataSetAttributes::SetCopyAttribute()
void CopyAllOff(int ctype=ALLCOPY) VTK_OVERRIDE;
// -- passthrough operations ----------------------------------------------
/**
* Pass entire arrays of input data through to output. Obey the "copy"
* flags. When passing a field, the following copying rules are
* followed: 1) Check if a field is an attribute, if yes and if there
* is a PASSDATA copy flag for that attribute (on or off), obey the flag
* for that attribute, ignore (2) and (3), 2) if there is a copy field for
* that field (on or off), obey the flag, ignore (3) 3) obey
* CopyAllOn/Off
*/
void PassData(vtkFieldData* fd) VTK_OVERRIDE;
// -- copytuple operations ------------------------------------------------
//@{
/**
* Allocates point data for point-by-point (or cell-by-cell) copy operation.
* If sze=0, then use the input DataSetAttributes to create (i.e., find
* initial size of) new objects; otherwise use the sze variable.
* Note that pd HAS to be the vtkDataSetAttributes object which
* will later be used with CopyData. If this is not the case,
* consider using the alternative forms of CopyAllocate and CopyData.
* ext is no longer used.
* If shallowCopyArrays is true, input arrays are copied to the output
* instead of new ones being allocated.
*/
void CopyAllocate(vtkDataSetAttributes* pd, vtkIdType sze=0,
vtkIdType ext=1000)
{
this->CopyAllocate(pd, sze, ext, 0);
}
void CopyAllocate(vtkDataSetAttributes* pd, vtkIdType sze,
vtkIdType ext, int shallowCopyArrays);
//@}
/**
* This method is used to copy data arrays in images.
* You should call "CopyAllocate" before calling this method.
*/
void CopyStructuredData(vtkDataSetAttributes *inDsa,
const int *inExt, const int *outExt);
//@{
/**
* Copy the attribute data from one id to another. Make sure CopyAllocate()
* has been invoked before using this method. When copying a field,
* the following copying rules are
* followed: 1) Check if a field is an attribute, if yes and if there
* is a COPYTUPLE copy flag for that attribute (on or off), obey the flag
* for that attribute, ignore (2) and (3), 2) if there is a copy field for
* that field (on or off), obey the flag, ignore (3) 3) obey
* CopyAllOn/Off
*/
void CopyData(vtkDataSetAttributes *fromPd, vtkIdType fromId, vtkIdType toId);
void CopyData(vtkDataSetAttributes *fromPd,
vtkIdList *fromIds, vtkIdList *toIds);
//@}
/**
* Copy n consecutive attributes starting at srcStart from fromPd to this
* container, starting at the dstStart location.
* Note that memory allocation is performed as necessary to hold the data.
*/
void CopyData(vtkDataSetAttributes *fromPd, vtkIdType dstStart, vtkIdType n,
vtkIdType srcStart);
//@{
/**
* Copy a tuple (or set of tuples) of data from one data array to another.
* This method assumes that the fromData and toData objects are of the
* same type, and have the same number of components. This is true if you
* invoke CopyAllocate() or InterpolateAllocate().
*/
void CopyTuple(vtkAbstractArray *fromData, vtkAbstractArray *toData,
vtkIdType fromId, vtkIdType toId);
void CopyTuples(vtkAbstractArray *fromData, vtkAbstractArray *toData,
vtkIdList *fromIds, vtkIdList *toIds);
void CopyTuples(vtkAbstractArray *fromData, vtkAbstractArray *toData,
vtkIdType dstStart, vtkIdType n, vtkIdType srcStart);
//@}
// -- interpolate operations ----------------------------------------------
//@{
/**
* Initialize point interpolation method.
* Note that pd HAS to be the vtkDataSetAttributes object which
* will later be used with InterpolatePoint or InterpolateEdge.
* ext is no longer used.
* If shallowCopyArrays is true, input arrays are copied to the output
* instead of new ones being allocated.
*/
void InterpolateAllocate(vtkDataSetAttributes* pd, vtkIdType sze=0,
vtkIdType ext=1000)
{
this->InterpolateAllocate(pd, sze, ext, 0);
}
void InterpolateAllocate(vtkDataSetAttributes* pd, vtkIdType sze,
vtkIdType ext, int shallowCopyArrays);
//@}
/**
* Interpolate data set attributes from other data set attributes
* given cell or point ids and associated interpolation weights.
* If the INTERPOLATION copy flag is set to 0 for an array, interpolation
* is prevented. If the flag is set to 1, weighted interpolation occurs.
* If the flag is set to 2, nearest neighbor interpolation is used.
*/
void InterpolatePoint(vtkDataSetAttributes *fromPd, vtkIdType toId,
vtkIdList *ids, double *weights);
/**
* Interpolate data from the two points p1,p2 (forming an edge) and an
* interpolation factor, t, along the edge. The weight ranges from (0,1),
* with t=0 located at p1. Make sure that the method InterpolateAllocate()
* has been invoked before using this method.
* If the INTERPOLATION copy flag is set to 0 for an array, interpolation
* is prevented. If the flag is set to 1, weighted interpolation occurs.
* If the flag is set to 2, nearest neighbor interpolation is used.
*/
void InterpolateEdge(vtkDataSetAttributes *fromPd, vtkIdType toId,
vtkIdType p1, vtkIdType p2, double t);
/**
* Interpolate data from the same id (point or cell) at different points
* in time (parameter t). Two input data set attributes objects are input.
* The parameter t lies between (0<=t<=1). IMPORTANT: it is assumed that
* the number of attributes and number of components is the same for both
* from1 and from2, and the type of data for from1 and from2 are the same.
* Make sure that the method InterpolateAllocate() has been invoked before
* using this method.
* If the INTERPOLATION copy flag is set to 0 for an array, interpolation
* is prevented. If the flag is set to 1, weighted interpolation occurs.
* If the flag is set to 2, nearest neighbor interpolation is used.
*/
void InterpolateTime(vtkDataSetAttributes *from1,
vtkDataSetAttributes *from2,
vtkIdType id, double t);
class FieldList;
// field list copy operations ------------------------------------------
/**
* A special form of CopyAllocate() to be used with FieldLists. Use it
* when you are copying data from a set of vtkDataSetAttributes.
*/
void CopyAllocate(vtkDataSetAttributes::FieldList& list, vtkIdType sze=0,
vtkIdType ext=1000);
/**
* A special form of CopyData() to be used with FieldLists. Use it when
* you are copying data from a set of vtkDataSetAttributes. Make sure
* that you have called the special form of CopyAllocate that accepts
* FieldLists.
*/
void CopyData(vtkDataSetAttributes::FieldList& list,
vtkDataSetAttributes* dsa, int idx, vtkIdType fromId,
vtkIdType toId);
/**
* A special form of InterpolateAllocate() to be used with FieldLists. Use it
* when you are interpolating data from a set of vtkDataSetAttributes.
* \c Warning: This does not copy the Information object associated with
* each data array. This behavior may change in the future.
*/
void InterpolateAllocate(vtkDataSetAttributes::FieldList& list, vtkIdType sze=0,
vtkIdType ext=1000);
/**
* Interpolate data set attributes from other data set attributes
* given cell or point ids and associated interpolation weights.
* Make sure that special form of InterpolateAllocate() that accepts
* FieldList has been used.
*/
void InterpolatePoint(
vtkDataSetAttributes::FieldList& list,
vtkDataSetAttributes *fromPd,
int idx, vtkIdType toId,
vtkIdList *ids, double *weights);
friend class vtkDataSetAttributes::FieldList;
protected:
vtkDataSetAttributes();
~vtkDataSetAttributes() VTK_OVERRIDE;
void InternalCopyAllocate(vtkDataSetAttributes* pd,
int ctype,
vtkIdType sze=0,
vtkIdType ext=1000,
int shallowCopyArrays=0);
void InternalCopyAllocate(
vtkDataSetAttributes::FieldList& list,
int ctype,
vtkIdType sze, vtkIdType ext);
/**
* Initialize all of the object's data to NULL
*/
void InitializeFields() VTK_OVERRIDE;
int AttributeIndices[NUM_ATTRIBUTES]; //index to attribute array in field data
int CopyAttributeFlags[ALLCOPY][NUM_ATTRIBUTES]; //copy flag for attribute data
vtkFieldData::BasicIterator RequiredArrays;
int* TargetIndices;
static const int NumberOfAttributeComponents[NUM_ATTRIBUTES];
static const int AttributeLimits[NUM_ATTRIBUTES];
static const char AttributeNames[NUM_ATTRIBUTES][12];
static const char LongAttributeNames[NUM_ATTRIBUTES][35];
private:
static int CheckNumberOfComponents(vtkAbstractArray* da, int attributeType);
vtkFieldData::BasicIterator ComputeRequiredArrays(vtkDataSetAttributes* pd, int ctype);
private:
vtkDataSetAttributes(const vtkDataSetAttributes&) VTK_DELETE_FUNCTION;
void operator=(const vtkDataSetAttributes&) VTK_DELETE_FUNCTION;
public:
// This public class is used to perform set operations, other misc.
// operations on fields. For example, vtkAppendFilter uses it to
// determine which attributes the input datasets share in common.
class vtkInternalComponentNames;
class VTKCOMMONDATAMODEL_EXPORT FieldList
{
public:
FieldList(int numInputs);
~FieldList();
void PrintSelf(ostream &os, vtkIndent indent);
void InitializeFieldList(vtkDataSetAttributes* dsa);
void IntersectFieldList(vtkDataSetAttributes* dsa);
/**
* Similar to IntersectFieldList() except that it builds a union of the
* array list. To determine the active attributes, it still, however, takes
* an intersection.
* WARNING!!!-IntersectFieldList() and UnionFieldList() should not be
* intermixed.
*/
void UnionFieldList(vtkDataSetAttributes* dsa);
//Determine whether data is available
int IsAttributePresent(int attrType); //true/false attributes specified
// Accessor methods.
int GetNumberOfFields() { return this->NumberOfFields; }
int GetFieldIndex(int i) { return this->FieldIndices[i]; }
const char* GetFieldName(int i) { return this->Fields[i]; }
int GetFieldComponents(int i) { return this->FieldComponents[i]; }
int GetDSAIndex(int index, int i) { return this->DSAIndices[index][i]; }
friend class vtkDataSetAttributes;
protected:
void SetFieldIndex(int i, int index)
{ this->FieldIndices[i] = index; }
private:
FieldList(const FieldList&) VTK_DELETE_FUNCTION;
void operator=(const FieldList&) VTK_DELETE_FUNCTION;
void SetField(int index, vtkAbstractArray *da);
void RemoveField(const char *name);
void ClearFields();
void GrowBy(unsigned int delta);
int NumberOfFields; //the number of fields (including five named attributes)
// These keep track of what is common across datasets. The first
// six items are always named attributes.
char** Fields; // the names of the fields
int *FieldTypes; // the types of the fields
int *FieldComponents; // the number of components in field
int *FieldIndices; // output data array index
vtkLookupTable **LUT; // luts associated with each array
vtkInformation **FieldInformation; // Information map associated with each array
vtkInternalComponentNames **FieldComponentsNames; // the name for each component in the field
vtkIdType NumberOfTuples; // a running total of values
//For every vtkDataSetAttributes that are processed, keep track of the
//indices into various things. The indices are organized so that the
//first NUM_ATTRIBUTES refer to attributes, the next refer to the
//non-attribute fields, for a total of NUM_ATTRIBUTES + NumberOfFields.
//CurrentInput is the current input being processed.
int **DSAIndices;
int NumberOfDSAIndices;
int CurrentInput;
};
};
#endif