VTK  9.3.20240418
Public Types | Public Member Functions | Static Public Member Functions | Protected Member Functions | Protected Attributes | List of all members
vtkSelection Class Reference

data object that represents a "selection" in VTK. More...

#include <vtkSelection.h>

Inheritance diagram for vtkSelection:
[legend]
Collaboration diagram for vtkSelection:
[legend]

Public Types

typedef vtkDataObject Superclass
 
- Public Types inherited from vtkDataObject
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
}
 Possible values for the FIELD_ASSOCIATION information entry. More...
 
enum  AttributeTypes {
  POINT , CELL , FIELD , POINT_THEN_CELL ,
  VERTEX , EDGE , ROW , NUMBER_OF_ATTRIBUTE_TYPES
}
 Possible attribute types. More...
 
enum  FieldOperations { FIELD_OPERATION_PRESERVED , FIELD_OPERATION_REINTERPOLATED , FIELD_OPERATION_MODIFIED , FIELD_OPERATION_REMOVED }
 Possible values for the FIELD_OPERATION information entry. More...
 
typedef vtkObject Superclass
 

Public Member Functions

virtual vtkTypeBool IsA (const char *type)
 Return 1 if this class is the same type of (or a subclass of) the named class. More...
 
vtkSelectionNewInstance () const
 
void PrintSelf (ostream &os, vtkIndent indent) override
 Methods invoked by print to print information about the object including superclasses. More...
 
void Initialize () override
 Restore data object to initial state,. More...
 
int GetDataObjectType () override
 Returns VTK_SELECTION enumeration value. More...
 
unsigned int GetNumberOfNodes () const
 Returns the number of nodes in this selection. More...
 
virtual vtkSelectionNodeGetNode (unsigned int idx) const
 Returns a node given it's index. More...
 
virtual vtkSelectionNodeGetNode (const std::string &name) const
 Returns a node with the given name, if present, else nullptr is returned. More...
 
virtual std::string AddNode (vtkSelectionNode *)
 Adds a selection node. More...
 
virtual void SetNode (const std::string &name, vtkSelectionNode *)
 Adds a vtkSelectionNode and assigns it the specified name. More...
 
virtual std::string GetNodeNameAtIndex (unsigned int idx) const
 Returns the name for a node at the given index. More...
 
virtual void RemoveAllNodes ()
 Removes all selection nodes. More...
 
void DeepCopy (vtkDataObject *src) override
 Copy selection nodes of the input. More...
 
void ShallowCopy (vtkDataObject *src) override
 Copy selection nodes of the input. More...
 
virtual void Union (vtkSelection *selection)
 Union this selection with the specified selection. More...
 
virtual void Union (vtkSelectionNode *node)
 Union this selection with the specified selection node. More...
 
virtual void Subtract (vtkSelection *selection)
 Remove the nodes from the specified selection from this selection. More...
 
virtual void Subtract (vtkSelectionNode *node)
 Remove the nodes from the specified selection from this selection. More...
 
vtkMTimeType GetMTime () override
 Return the MTime taking into account changes to the properties. More...
 
virtual void RemoveNode (unsigned int idx)
 Removes a selection node. More...
 
virtual void RemoveNode (const std::string &name)
 Removes a selection node. More...
 
virtual void RemoveNode (vtkSelectionNode *)
 Removes a selection node. More...
 
virtual void SetExpression (std::string)
 Get/Set the expression that defines the boolean expression to combine the selection nodes. More...
 
virtual std::string GetExpression ()
 Get/Set the expression that defines the boolean expression to combine the selection nodes. More...
 
virtual void Dump ()
 Dumps the contents of the selection, giving basic information only. More...
 
virtual void Dump (ostream &os)
 Dumps the contents of the selection, giving basic information only. More...
 
vtkSmartPointer< vtkSignedCharArrayEvaluate (vtkSignedCharArray *const *values, unsigned int num_values) const
 Evaluates the expression for each element in the values and extracts the range. More...
 
vtkSmartPointer< vtkSignedCharArrayEvaluate (vtkSignedCharArray *const *values, unsigned int num_values, std::array< signed char, 2 > &range) const
 Evaluates the expression for each element in the values and extracts the range. More...
 
template<typename MapType >
vtkSmartPointer< vtkSignedCharArrayEvaluate (const MapType &values_map) const
 Convenience method to pass a map of vtkSignedCharArray ptrs (or vtkSmartPointers) and range. More...
 
template<typename MapType >
vtkSmartPointer< vtkSignedCharArrayEvaluate (const MapType &values_map, std::array< signed char, 2 > &range) const
 Convenience method to pass a map of vtkSignedCharArray ptrs (or vtkSmartPointers) and range. More...
 
- Public Member Functions inherited from vtkDataObject
vtkDataObjectNewInstance () const
 
void ReleaseData ()
 Release data back to system to conserve memory resource. More...
 
vtkMTimeType GetUpdateTime ()
 Used by Threaded ports to determine if they should initiate an asynchronous update (still in development). More...
 
virtual unsigned long GetActualMemorySize ()
 Return the actual size of the data in kibibytes (1024 bytes). More...
 
virtual void CopyInformationFromPipeline (vtkInformation *vtkNotUsed(info))
 Copy from the pipeline information to the data object's own information. More...
 
virtual void CopyInformationToPipeline (vtkInformation *vtkNotUsed(info))
 Copy information from this data object to the pipeline information. More...
 
void DataHasBeenGenerated ()
 This method is called by the source when it executes to generate data. More...
 
virtual void PrepareForNewData ()
 make the output data ready for new data to be inserted. More...
 
virtual int GetExtentType ()
 The ExtentType will be left as VTK_PIECES_EXTENT for data objects such as vtkPolyData and vtkUnstructuredGrid. More...
 
virtual void Crop (const int *updateExtent)
 This method crops the data object (if necessary) so that the extent matches the update extent. More...
 
virtual vtkDataSetAttributesGetAttributes (int type)
 Returns the attributes of the data object of the specified attribute type. More...
 
virtual vtkUnsignedCharArrayGetGhostArray (int type)
 Returns the ghost arrays of the data object of the specified attribute type. More...
 
virtual bool SupportsGhostArray (int type)
 Returns if this type of data object support ghost array for specified type. More...
 
virtual vtkFieldDataGetAttributesAsFieldData (int type)
 Returns the attributes of the data object as a vtkFieldData. More...
 
virtual int GetAttributeTypeForArray (vtkAbstractArray *arr)
 Retrieves the attribute type that an array came from. More...
 
virtual vtkIdType GetNumberOfElements (int type)
 Get the number of elements for a specific attribute type (POINT, CELL, etc.). More...
 
virtual vtkInformationGetInformation ()
 Set/Get the information object associated with this data object. More...
 
virtual void SetInformation (vtkInformation *)
 Set/Get the information object associated with this data object. More...
 
virtual vtkTypeBool GetDataReleased ()
 Get the flag indicating the data has been released. More...
 
virtual void SetFieldData (vtkFieldData *)
 Assign or retrieve a general field data to this data object. More...
 
virtual vtkFieldDataGetFieldData ()
 Assign or retrieve a general field data to this data object. More...
 
void GlobalReleaseDataFlagOn ()
 Turn on/off flag to control whether every object releases its data after being used by a filter. More...
 
void GlobalReleaseDataFlagOff ()
 Turn on/off flag to control whether every object releases its data after being used by a filter. More...
 
- Public Member Functions inherited from vtkObject
 vtkBaseTypeMacro (vtkObject, vtkObjectBase)
 
virtual void DebugOn ()
 Turn debugging output on. More...
 
virtual void DebugOff ()
 Turn debugging output off. More...
 
bool GetDebug ()
 Get the value of the debug flag. More...
 
void SetDebug (bool debugFlag)
 Set the value of the debug flag. More...
 
virtual void Modified ()
 Update the modification time for this object. More...
 
void RemoveObserver (unsigned long tag)
 
void RemoveObservers (unsigned long event)
 
void RemoveObservers (const char *event)
 
void RemoveAllObservers ()
 
vtkTypeBool HasObserver (unsigned long event)
 
vtkTypeBool HasObserver (const char *event)
 
vtkTypeBool InvokeEvent (unsigned long event)
 
vtkTypeBool InvokeEvent (const char *event)
 
std::string GetObjectDescription () const override
 The object description printed in messages and PrintSelf output. More...
 
unsigned long AddObserver (unsigned long event, vtkCommand *, float priority=0.0f)
 Allow people to add/remove/invoke observers (callbacks) to any VTK object. More...
 
unsigned long AddObserver (const char *event, vtkCommand *, float priority=0.0f)
 Allow people to add/remove/invoke observers (callbacks) to any VTK object. More...
 
vtkCommandGetCommand (unsigned long tag)
 Allow people to add/remove/invoke observers (callbacks) to any VTK object. More...
 
void RemoveObserver (vtkCommand *)
 Allow people to add/remove/invoke observers (callbacks) to any VTK object. More...
 
void RemoveObservers (unsigned long event, vtkCommand *)
 Allow people to add/remove/invoke observers (callbacks) to any VTK object. More...
 
void RemoveObservers (const char *event, vtkCommand *)
 Allow people to add/remove/invoke observers (callbacks) to any VTK object. More...
 
vtkTypeBool HasObserver (unsigned long event, vtkCommand *)
 Allow people to add/remove/invoke observers (callbacks) to any VTK object. More...
 
vtkTypeBool HasObserver (const char *event, vtkCommand *)
 Allow people to add/remove/invoke observers (callbacks) to any VTK object. More...
 
template<class U , class T >
unsigned long AddObserver (unsigned long event, U observer, void(T::*callback)(), float priority=0.0f)
 Overloads to AddObserver that allow developers to add class member functions as callbacks for events. More...
 
template<class U , class T >
unsigned long AddObserver (unsigned long event, U observer, void(T::*callback)(vtkObject *, unsigned long, void *), float priority=0.0f)
 Overloads to AddObserver that allow developers to add class member functions as callbacks for events. More...
 
template<class U , class T >
unsigned long AddObserver (unsigned long event, U observer, bool(T::*callback)(vtkObject *, unsigned long, void *), float priority=0.0f)
 Allow user to set the AbortFlagOn() with the return value of the callback method. More...
 
vtkTypeBool InvokeEvent (unsigned long event, void *callData)
 This method invokes an event and return whether the event was aborted or not. More...
 
vtkTypeBool InvokeEvent (const char *event, void *callData)
 This method invokes an event and return whether the event was aborted or not. More...
 
virtual void SetObjectName (const std::string &objectName)
 Set/get the name of this object for reporting purposes. More...
 
virtual std::string GetObjectName () const
 Set/get the name of this object for reporting purposes. More...
 
- Public Member Functions inherited from vtkObjectBase
const char * GetClassName () const
 Return the class name as a string. More...
 
virtual vtkIdType GetNumberOfGenerationsFromBase (const char *name)
 Given the name of a base class of this class type, return the distance of inheritance between this class type and the named class (how many generations of inheritance are there between this class and the named class). More...
 
virtual void Delete ()
 Delete a VTK object. More...
 
virtual void FastDelete ()
 Delete a reference to this object. More...
 
void InitializeObjectBase ()
 
void Print (ostream &os)
 Print an object to an ostream. More...
 
void Register (vtkObjectBase *o)
 Increase the reference count (mark as used by another object). More...
 
virtual void UnRegister (vtkObjectBase *o)
 Decrease the reference count (release by another object). More...
 
int GetReferenceCount ()
 Return the current reference count of this object. More...
 
void SetReferenceCount (int)
 Sets the reference count. More...
 
bool GetIsInMemkind () const
 A local state flag that remembers whether this object lives in the normal or extended memory space. More...
 
virtual void PrintHeader (ostream &os, vtkIndent indent)
 Methods invoked by print to print information about the object including superclasses. More...
 
virtual void PrintTrailer (ostream &os, vtkIndent indent)
 Methods invoked by print to print information about the object including superclasses. More...
 
virtual bool UsesGarbageCollector () const
 Indicate whether the class uses vtkGarbageCollector or not. More...
 

Static Public Member Functions

static vtkTypeBool IsTypeOf (const char *type)
 
static vtkSelectionSafeDownCast (vtkObjectBase *o)
 
static vtkSelectionNew ()
 
static vtkSelectionGetData (vtkInformation *info)
 Retrieve a vtkSelection stored inside an invormation object. More...
 
static vtkSelectionGetData (vtkInformationVector *v, int i=0)
 Retrieve a vtkSelection stored inside an invormation object. More...
 
- Static Public Member Functions inherited from vtkDataObject
static vtkDataObjectNew ()
 
static vtkTypeBool IsTypeOf (const char *type)
 
static vtkDataObjectSafeDownCast (vtkObjectBase *o)
 
static vtkInformationGetActiveFieldInformation (vtkInformation *info, int fieldAssociation, int attributeType)
 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) More...
 
static vtkInformationGetNamedFieldInformation (vtkInformation *info, int fieldAssociation, const char *name)
 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. More...
 
static void RemoveNamedFieldInformation (vtkInformation *info, int fieldAssociation, const char *name)
 Remove the info associated with an array. More...
 
static vtkInformationSetActiveAttribute (vtkInformation *info, int fieldAssociation, const char *attributeName, int attributeType)
 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). More...
 
static void SetActiveAttributeInfo (vtkInformation *info, int fieldAssociation, int attributeType, const char *name, int arrayType, int numComponents, int numTuples)
 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). More...
 
static void SetPointDataActiveScalarInfo (vtkInformation *info, int arrayType, int numComponents)
 Convenience version of previous method for use (primarily) by the Imaging filters. More...
 
static const char * GetAssociationTypeAsString (int associationType)
 Given an integer association type, this static method returns a string type for the attribute (i.e. More...
 
static int GetAssociationTypeFromString (const char *associationName)
 Given a string association name, this static method returns an integer association type for the attribute (i.e. More...
 
static vtkInformationStringKeyDATA_TYPE_NAME ()
 
static vtkInformationDataObjectKeyDATA_OBJECT ()
 
static vtkInformationIntegerKeyDATA_EXTENT_TYPE ()
 
static vtkInformationIntegerPointerKeyDATA_EXTENT ()
 
static vtkInformationIntegerVectorKeyALL_PIECES_EXTENT ()
 
static vtkInformationIntegerKeyDATA_PIECE_NUMBER ()
 
static vtkInformationIntegerKeyDATA_NUMBER_OF_PIECES ()
 
static vtkInformationIntegerKeyDATA_NUMBER_OF_GHOST_LEVELS ()
 
static vtkInformationDoubleKeyDATA_TIME_STEP ()
 
static vtkInformationInformationVectorKeyPOINT_DATA_VECTOR ()
 
static vtkInformationInformationVectorKeyCELL_DATA_VECTOR ()
 
static vtkInformationInformationVectorKeyVERTEX_DATA_VECTOR ()
 
static vtkInformationInformationVectorKeyEDGE_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 vtkInformationDoubleVectorKeyFIELD_RANGE ()
 
static vtkInformationIntegerVectorKeyPIECE_EXTENT ()
 
static vtkInformationStringKeyFIELD_NAME ()
 
static vtkInformationDoubleVectorKeyORIGIN ()
 
static vtkInformationDoubleVectorKeySPACING ()
 
static vtkInformationDoubleVectorKeyDIRECTION ()
 
static vtkInformationDoubleVectorKeyBOUNDING_BOX ()
 
static vtkInformationDataObjectKeySIL ()
 
static vtkDataObjectGetData (vtkInformation *info)
 Retrieve an instance of this class from an information object. More...
 
static vtkDataObjectGetData (vtkInformationVector *v, int i=0)
 Retrieve an instance of this class from an information object. More...
 
static void SetGlobalReleaseDataFlag (vtkTypeBool val)
 Turn on/off flag to control whether every object releases its data after being used by a filter. More...
 
static vtkTypeBool GetGlobalReleaseDataFlag ()
 Turn on/off flag to control whether every object releases its data after being used by a filter. More...
 
- Static Public Member Functions inherited from vtkObject
static vtkObjectNew ()
 Create an object with Debug turned off, modified time initialized to zero, and reference counting on. More...
 
static void BreakOnError ()
 This method is called when vtkErrorMacro executes. More...
 
static void SetGlobalWarningDisplay (vtkTypeBool val)
 This is a global flag that controls whether any debug, warning or error messages are displayed. More...
 
static void GlobalWarningDisplayOn ()
 This is a global flag that controls whether any debug, warning or error messages are displayed. More...
 
static void GlobalWarningDisplayOff ()
 This is a global flag that controls whether any debug, warning or error messages are displayed. More...
 
static vtkTypeBool GetGlobalWarningDisplay ()
 This is a global flag that controls whether any debug, warning or error messages are displayed. More...
 
- Static Public Member Functions inherited from vtkObjectBase
static vtkTypeBool IsTypeOf (const char *name)
 Return 1 if this class type is the same type of (or a subclass of) the named class. More...
 
static vtkIdType GetNumberOfGenerationsFromBaseType (const char *name)
 Given a the name of a base class of this class type, return the distance of inheritance between this class type and the named class (how many generations of inheritance are there between this class and the named class). More...
 
static vtkObjectBaseNew ()
 Create an object with Debug turned off, modified time initialized to zero, and reference counting on. More...
 
static void SetMemkindDirectory (const char *directoryname)
 The name of a directory, ideally mounted -o dax, to memory map an extended memory space within. More...
 
static bool GetUsingMemkind ()
 A global state flag that controls whether vtkObjects are constructed in the usual way (the default) or within the extended memory space. More...
 

Protected Member Functions

virtual vtkObjectBaseNewInstanceInternal () const
 
 vtkSelection ()
 
 ~vtkSelection () override
 
- Protected Member Functions inherited from vtkDataObject
 vtkDataObject ()
 
 ~vtkDataObject () override
 
- Protected Member Functions inherited from vtkObject
 vtkObject ()
 
 ~vtkObject () override
 
void RegisterInternal (vtkObjectBase *, vtkTypeBool check) override
 
void UnRegisterInternal (vtkObjectBase *, vtkTypeBool check) override
 
void InternalGrabFocus (vtkCommand *mouseEvents, vtkCommand *keypressEvents=nullptr)
 These methods allow a command to exclusively grab all events. More...
 
void InternalReleaseFocus ()
 These methods allow a command to exclusively grab all events. More...
 
- Protected Member Functions inherited from vtkObjectBase
 vtkObjectBase ()
 
virtual ~vtkObjectBase ()
 
virtual void ReportReferences (vtkGarbageCollector *)
 
 vtkObjectBase (const vtkObjectBase &)
 
void operator= (const vtkObjectBase &)
 

Protected Attributes

std::string Expression
 
- Protected Attributes inherited from vtkDataObject
vtkFieldDataFieldData
 
vtkTypeBool DataReleased
 
vtkTimeStamp UpdateTime
 
vtkInformationInformation
 
- Protected Attributes inherited from vtkObject
bool Debug
 
vtkTimeStamp MTime
 
vtkSubjectHelper * SubjectHelper
 
std::string ObjectName
 
- Protected Attributes inherited from vtkObjectBase
std::atomic< int32_t > ReferenceCount
 
vtkWeakPointerBase ** WeakPointers
 

Additional Inherited Members

- Static Protected Member Functions inherited from vtkObjectBase
static vtkMallocingFunction GetCurrentMallocFunction ()
 
static vtkReallocingFunction GetCurrentReallocFunction ()
 
static vtkFreeingFunction GetCurrentFreeFunction ()
 
static vtkFreeingFunction GetAlternateFreeFunction ()
 

Detailed Description

data object that represents a "selection" in VTK.

vtkSelection defines a selection. A selection is a data-object that defines which entities from another data-object are to treated as "selected". Filters like vtkExtractSelection or vtkExtractDataArraysOverTime can then be used to extract these selected entities from the other data-object.

vtkSelection comprises of vtkSelectionNodes and optionally, an expression specified using vtkSelection::SetExpression. If non-empty, the expression is a boolean expression that defines now the selection nodes present in the selection are to be combined together to form the selection. If no expression is specified and there are multiple selection nodes, then the default expression simply combines all the selection nodes using an or operator.

Each vtkSelectionNode is used to define the selection criteria. vtkSelectionNode API lets one select what kind of entities are being selected (vtkSelectionNode::FieldType) and how they are being selected (vtkSelectionNode::ContentType).

See also
vtkSelectionNode
Examples:
vtkSelection (Examples)
Online Examples:

Tests:
vtkSelection (Tests)

Definition at line 158 of file vtkSelection.h.

Member Typedef Documentation

◆ Superclass

Definition at line 161 of file vtkSelection.h.

Constructor & Destructor Documentation

◆ vtkSelection()

vtkSelection::vtkSelection ( )
protected

◆ ~vtkSelection()

vtkSelection::~vtkSelection ( )
overrideprotected

Member Function Documentation

◆ IsTypeOf()

static vtkTypeBool vtkSelection::IsTypeOf ( const char *  type)
static

◆ IsA()

virtual vtkTypeBool vtkSelection::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 vtkDataObject.

◆ SafeDownCast()

static vtkSelection* vtkSelection::SafeDownCast ( vtkObjectBase o)
static

◆ NewInstanceInternal()

virtual vtkObjectBase* vtkSelection::NewInstanceInternal ( ) const
protectedvirtual

Reimplemented from vtkDataObject.

◆ NewInstance()

vtkSelection* vtkSelection::NewInstance ( ) const

◆ PrintSelf()

void vtkSelection::PrintSelf ( ostream &  os,
vtkIndent  indent 
)
overridevirtual

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 vtkDataObject.

◆ New()

static vtkSelection* vtkSelection::New ( )
static

◆ Initialize()

void vtkSelection::Initialize ( )
overridevirtual

Restore data object to initial state,.

Reimplemented from vtkDataObject.

◆ GetDataObjectType()

int vtkSelection::GetDataObjectType ( )
inlineoverridevirtual

Returns VTK_SELECTION enumeration value.

Reimplemented from vtkDataObject.

Definition at line 173 of file vtkSelection.h.

◆ GetNumberOfNodes()

unsigned int vtkSelection::GetNumberOfNodes ( ) const

Returns the number of nodes in this selection.

Each node contains information about part of the selection.

◆ GetNode() [1/2]

virtual vtkSelectionNode* vtkSelection::GetNode ( unsigned int  idx) const
virtual

Returns a node given it's index.

Performs bound checking and will return nullptr if out-of-bounds.

◆ GetNode() [2/2]

virtual vtkSelectionNode* vtkSelection::GetNode ( const std::string &  name) const
virtual

Returns a node with the given name, if present, else nullptr is returned.

◆ AddNode()

virtual std::string vtkSelection::AddNode ( vtkSelectionNode )
virtual

Adds a selection node.

Assigns the node a unique name and returns that name. This API is primarily provided for backwards compatibility and SetNode is the preferred method.

◆ SetNode()

virtual void vtkSelection::SetNode ( const std::string &  name,
vtkSelectionNode  
)
virtual

Adds a vtkSelectionNode and assigns it the specified name.

The name must be a non-empty string. If an item with the same name has already been added, it will be removed.

◆ GetNodeNameAtIndex()

virtual std::string vtkSelection::GetNodeNameAtIndex ( unsigned int  idx) const
virtual

Returns the name for a node at the given index.

◆ RemoveNode() [1/3]

virtual void vtkSelection::RemoveNode ( unsigned int  idx)
virtual

Removes a selection node.

◆ RemoveNode() [2/3]

virtual void vtkSelection::RemoveNode ( const std::string &  name)
virtual

Removes a selection node.

◆ RemoveNode() [3/3]

virtual void vtkSelection::RemoveNode ( vtkSelectionNode )
virtual

Removes a selection node.

◆ RemoveAllNodes()

virtual void vtkSelection::RemoveAllNodes ( )
virtual

Removes all selection nodes.

◆ SetExpression()

virtual void vtkSelection::SetExpression ( std::string  )
virtual

Get/Set the expression that defines the boolean expression to combine the selection nodes.

Expression consists of node name identifiers, | for boolean-or, '^' for boolean-xor, '&' for boolean and, '!' for boolean not, and parenthesis ( and ). If the expression consists of a node name identifier that is not assigned any vtkSelectionNode (using SetNode) then it is evaluates to false.

SetExpression does not validate the expression. It will be validated in Evaluate call.

◆ GetExpression()

virtual std::string vtkSelection::GetExpression ( )
virtual

Get/Set the expression that defines the boolean expression to combine the selection nodes.

Expression consists of node name identifiers, | for boolean-or, '^' for boolean-xor, '&' for boolean and, '!' for boolean not, and parenthesis ( and ). If the expression consists of a node name identifier that is not assigned any vtkSelectionNode (using SetNode) then it is evaluates to false.

SetExpression does not validate the expression. It will be validated in Evaluate call.

◆ DeepCopy()

void vtkSelection::DeepCopy ( vtkDataObject src)
overridevirtual

Copy selection nodes of the input.

Reimplemented from vtkDataObject.

◆ ShallowCopy()

void vtkSelection::ShallowCopy ( vtkDataObject src)
overridevirtual

Copy selection nodes of the input.

This is a shallow copy: selection lists and pointers in the properties are passed by reference.

Reimplemented from vtkDataObject.

◆ Union() [1/2]

virtual void vtkSelection::Union ( vtkSelection selection)
virtual

Union this selection with the specified selection.

Attempts to reuse selection nodes in this selection if properties match exactly. Otherwise, creates new selection nodes.

◆ Union() [2/2]

virtual void vtkSelection::Union ( vtkSelectionNode node)
virtual

Union this selection with the specified selection node.

Attempts to reuse a selection node in this selection if properties match exactly. Otherwise, creates a new selection node.

◆ Subtract() [1/2]

virtual void vtkSelection::Subtract ( vtkSelection selection)
virtual

Remove the nodes from the specified selection from this selection.

Assumes that selection node internal arrays are vtkIdTypeArrays.

◆ Subtract() [2/2]

virtual void vtkSelection::Subtract ( vtkSelectionNode node)
virtual

Remove the nodes from the specified selection from this selection.

Assumes that selection node internal arrays are vtkIdTypeArrays.

◆ GetMTime()

vtkMTimeType vtkSelection::GetMTime ( )
overridevirtual

Return the MTime taking into account changes to the properties.

Reimplemented from vtkDataObject.

◆ Dump() [1/2]

virtual void vtkSelection::Dump ( )
virtual

Dumps the contents of the selection, giving basic information only.

◆ Dump() [2/2]

virtual void vtkSelection::Dump ( ostream &  os)
virtual

Dumps the contents of the selection, giving basic information only.

◆ GetData() [1/2]

static vtkSelection* vtkSelection::GetData ( vtkInformation info)
static

Retrieve a vtkSelection stored inside an invormation object.

◆ GetData() [2/2]

static vtkSelection* vtkSelection::GetData ( vtkInformationVector v,
int  i = 0 
)
static

Retrieve a vtkSelection stored inside an invormation object.

◆ Evaluate() [1/4]

vtkSmartPointer<vtkSignedCharArray> vtkSelection::Evaluate ( vtkSignedCharArray *const *  values,
unsigned int  num_values 
) const
inline

Evaluates the expression for each element in the values and extracts the range.

The order matches the order of the selection nodes. If not expression is set or if it's an empty string, then an expression that simply combines all selection nodes in an binary-or is assumed.

Definition at line 307 of file vtkSelection.h.

◆ Evaluate() [2/4]

vtkSmartPointer<vtkSignedCharArray> vtkSelection::Evaluate ( vtkSignedCharArray *const *  values,
unsigned int  num_values,
std::array< signed char, 2 > &  range 
) const

Evaluates the expression for each element in the values and extracts the range.

The order matches the order of the selection nodes. If not expression is set or if it's an empty string, then an expression that simply combines all selection nodes in an binary-or is assumed.

◆ Evaluate() [3/4]

template<typename MapType >
vtkSmartPointer<vtkSignedCharArray> vtkSelection::Evaluate ( const MapType &  values_map) const
inline

Convenience method to pass a map of vtkSignedCharArray ptrs (or vtkSmartPointers) and range.

Definition at line 323 of file vtkSelection.h.

◆ Evaluate() [4/4]

template<typename MapType >
vtkSmartPointer< vtkSignedCharArray > vtkSelection::Evaluate ( const MapType &  values_map,
std::array< signed char, 2 > &  range 
) const
inline

Convenience method to pass a map of vtkSignedCharArray ptrs (or vtkSmartPointers) and range.

Definition at line 350 of file vtkSelection.h.

Member Data Documentation

◆ Expression

std::string vtkSelection::Expression
protected

Definition at line 337 of file vtkSelection.h.


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