apply colors to a data set. More...
#include <vtkApplyColors.h>
Detailed Description
apply colors to a data set.
vtkApplyColors performs a coloring of the dataset using default colors, lookup tables, annotations, and/or a selection. The output is a four-component vtkUnsignedCharArray containing RGBA tuples for each element in the dataset. The first input is the dataset to be colored, which may be a vtkTable, vtkGraph subclass, or vtkDataSet subclass. The API of this algorithm refers to "points" and "cells". For vtkGraph, the "points" refer to the graph vertices and "cells" refer to graph edges. For vtkTable, "points" refer to table rows. For vtkDataSet subclasses, the meaning is obvious.
The second (optional) input is a vtkAnnotationLayers object, which stores a list of annotation layers, with each layer holding a list of vtkAnnotation objects. The annotation specifies a subset of data along with other properties, including color. For annotations with color properties, this algorithm will use the color to color elements, using a "top one wins" strategy.
The third (optional) input is a vtkSelection object, meant for specifying the current selection. You can control the color of the selection.
The algorithm takes two input arrays, specified with SetInputArrayToProcess(0, 0, 0, vtkDataObject::FIELD_ASSOCIATION_POINTS, name) and SetInputArrayToProcess(1, 0, 0, vtkDataObject::FIELD_ASSOCIATION_CELLS, name). These set the point and cell data arrays to use to color the data with the associated lookup table. For vtkGraph, vtkTable inputs, you would use FIELD_ASSOCIATION_VERTICES, FIELD_ASSOCIATION_EDGES, or FIELD_ASSOCIATION_ROWS as appropriate.
To use the color array generated here, you should do the following:
mapper->SetScalarModeToUseCellFieldData(); mapper->SelectColorArray("vtkApplyColors color"); mapper->SetScalarVisibility(true);
Colors are assigned with the following priorities:
- If an item is part of the selection, it is colored with that color.
- Otherwise, if the item is part of an annotation, it is colored with the color of the final (top) annotation in the set of layers.
- Otherwise, if the lookup table is used, it is colored using the lookup table color for the data value of the element.
- Otherwise it will be colored with the default color.
Note: The opacity of an unselected item is defined by the multiplication of default opacity, lookup table opacity, and annotation opacity, where opacity is taken as a number from 0 to 1. So items will never be more opaque than any of these three opacities. Selected items are always given the selection opacity directly.
Definition at line 85 of file vtkApplyColors.h.
Member Typedef Documentation
Reimplemented from vtkPassInputTypeAlgorithm.
Definition at line 89 of file vtkApplyColors.h.
Constructor & Destructor Documentation
| vtkApplyColors::vtkApplyColors | ( | ) | [protected] |
| vtkApplyColors::~vtkApplyColors | ( | ) | [protected] |
Member Function Documentation
| static vtkApplyColors* vtkApplyColors::New | ( | ) | [static] |
Create an object with Debug turned off, modified time initialized to zero, and reference counting on.
Reimplemented from vtkPassInputTypeAlgorithm.
| static int vtkApplyColors::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 vtkPassInputTypeAlgorithm.
| virtual int vtkApplyColors::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 vtkPassInputTypeAlgorithm.
| static vtkApplyColors* vtkApplyColors::SafeDownCast | ( | vtkObjectBase * | o | ) | [static] |
Reimplemented from vtkPassInputTypeAlgorithm.
| virtual vtkObjectBase* vtkApplyColors::NewInstanceInternal | ( | ) | const [protected, virtual] |
Reimplemented from vtkPassInputTypeAlgorithm.
| vtkApplyColors* vtkApplyColors::NewInstance | ( | ) | const |
Reimplemented from vtkPassInputTypeAlgorithm.
| void vtkApplyColors::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 vtkPassInputTypeAlgorithm.
| virtual void vtkApplyColors::SetPointLookupTable | ( | vtkScalarsToColors * | lut | ) | [virtual] |
The lookup table to use for point colors. This is only used if input array 0 is set and UsePointLookupTable is on.
| virtual vtkScalarsToColors* vtkApplyColors::GetPointLookupTable | ( | ) | [virtual] |
The lookup table to use for point colors. This is only used if input array 0 is set and UsePointLookupTable is on.
| virtual void vtkApplyColors::SetUsePointLookupTable | ( | bool | ) | [virtual] |
If on, uses the point lookup table to set the colors of unannotated, unselected elements of the data.
| virtual bool vtkApplyColors::GetUsePointLookupTable | ( | ) | [virtual] |
If on, uses the point lookup table to set the colors of unannotated, unselected elements of the data.
| virtual void vtkApplyColors::UsePointLookupTableOn | ( | ) | [virtual] |
If on, uses the point lookup table to set the colors of unannotated, unselected elements of the data.
| virtual void vtkApplyColors::UsePointLookupTableOff | ( | ) | [virtual] |
If on, uses the point lookup table to set the colors of unannotated, unselected elements of the data.
| virtual void vtkApplyColors::SetScalePointLookupTable | ( | bool | ) | [virtual] |
If on, uses the range of the data to scale the lookup table range. Otherwise, uses the range defined in the lookup table.
| virtual bool vtkApplyColors::GetScalePointLookupTable | ( | ) | [virtual] |
If on, uses the range of the data to scale the lookup table range. Otherwise, uses the range defined in the lookup table.
| virtual void vtkApplyColors::ScalePointLookupTableOn | ( | ) | [virtual] |
If on, uses the range of the data to scale the lookup table range. Otherwise, uses the range defined in the lookup table.
| virtual void vtkApplyColors::ScalePointLookupTableOff | ( | ) | [virtual] |
If on, uses the range of the data to scale the lookup table range. Otherwise, uses the range defined in the lookup table.
| virtual void vtkApplyColors::SetDefaultPointColor | ( | double | , |
| double | , | ||
| double | |||
| ) | [virtual] |
The default point color for all unannotated, unselected elements of the data. This is used if UsePointLookupTable is off.
| virtual void vtkApplyColors::SetDefaultPointColor | ( | double | [3] | ) | [virtual] |
The default point color for all unannotated, unselected elements of the data. This is used if UsePointLookupTable is off.
| virtual double* vtkApplyColors::GetDefaultPointColor | ( | ) | [virtual] |
The default point color for all unannotated, unselected elements of the data. This is used if UsePointLookupTable is off.
| virtual void vtkApplyColors::GetDefaultPointColor | ( | double & | , |
| double & | , | ||
| double & | |||
| ) | [virtual] |
The default point color for all unannotated, unselected elements of the data. This is used if UsePointLookupTable is off.
| virtual void vtkApplyColors::GetDefaultPointColor | ( | double | [3] | ) | [virtual] |
The default point color for all unannotated, unselected elements of the data. This is used if UsePointLookupTable is off.
| virtual void vtkApplyColors::SetDefaultPointOpacity | ( | double | ) | [virtual] |
The default point opacity for all unannotated, unselected elements of the data. This is used if UsePointLookupTable is off.
| virtual double vtkApplyColors::GetDefaultPointOpacity | ( | ) | [virtual] |
The default point opacity for all unannotated, unselected elements of the data. This is used if UsePointLookupTable is off.
| virtual void vtkApplyColors::SetSelectedPointColor | ( | double | , |
| double | , | ||
| double | |||
| ) | [virtual] |
The point color for all selected elements of the data. This is used if the selection input is available.
| virtual void vtkApplyColors::SetSelectedPointColor | ( | double | [3] | ) | [virtual] |
The point color for all selected elements of the data. This is used if the selection input is available.
| virtual double* vtkApplyColors::GetSelectedPointColor | ( | ) | [virtual] |
The point color for all selected elements of the data. This is used if the selection input is available.
| virtual void vtkApplyColors::GetSelectedPointColor | ( | double & | , |
| double & | , | ||
| double & | |||
| ) | [virtual] |
The point color for all selected elements of the data. This is used if the selection input is available.
| virtual void vtkApplyColors::GetSelectedPointColor | ( | double | [3] | ) | [virtual] |
The point color for all selected elements of the data. This is used if the selection input is available.
| virtual void vtkApplyColors::SetSelectedPointOpacity | ( | double | ) | [virtual] |
The point opacity for all selected elements of the data. This is used if the selection input is available.
| virtual double vtkApplyColors::GetSelectedPointOpacity | ( | ) | [virtual] |
The point opacity for all selected elements of the data. This is used if the selection input is available.
| virtual void vtkApplyColors::SetPointColorOutputArrayName | ( | const char * | ) | [virtual] |
The output array name for the point color RGBA array. Default is "vtkApplyColors color".
| virtual char* vtkApplyColors::GetPointColorOutputArrayName | ( | ) | [virtual] |
The output array name for the point color RGBA array. Default is "vtkApplyColors color".
| virtual void vtkApplyColors::SetCellLookupTable | ( | vtkScalarsToColors * | lut | ) | [virtual] |
The lookup table to use for cell colors. This is only used if input array 1 is set and UseCellLookupTable is on.
| virtual vtkScalarsToColors* vtkApplyColors::GetCellLookupTable | ( | ) | [virtual] |
The lookup table to use for cell colors. This is only used if input array 1 is set and UseCellLookupTable is on.
| virtual void vtkApplyColors::SetUseCellLookupTable | ( | bool | ) | [virtual] |
If on, uses the cell lookup table to set the colors of unannotated, unselected elements of the data.
| virtual bool vtkApplyColors::GetUseCellLookupTable | ( | ) | [virtual] |
If on, uses the cell lookup table to set the colors of unannotated, unselected elements of the data.
| virtual void vtkApplyColors::UseCellLookupTableOn | ( | ) | [virtual] |
If on, uses the cell lookup table to set the colors of unannotated, unselected elements of the data.
| virtual void vtkApplyColors::UseCellLookupTableOff | ( | ) | [virtual] |
If on, uses the cell lookup table to set the colors of unannotated, unselected elements of the data.
| virtual void vtkApplyColors::SetScaleCellLookupTable | ( | bool | ) | [virtual] |
If on, uses the range of the data to scale the lookup table range. Otherwise, uses the range defined in the lookup table.
| virtual bool vtkApplyColors::GetScaleCellLookupTable | ( | ) | [virtual] |
If on, uses the range of the data to scale the lookup table range. Otherwise, uses the range defined in the lookup table.
| virtual void vtkApplyColors::ScaleCellLookupTableOn | ( | ) | [virtual] |
If on, uses the range of the data to scale the lookup table range. Otherwise, uses the range defined in the lookup table.
| virtual void vtkApplyColors::ScaleCellLookupTableOff | ( | ) | [virtual] |
If on, uses the range of the data to scale the lookup table range. Otherwise, uses the range defined in the lookup table.
| virtual void vtkApplyColors::SetDefaultCellColor | ( | double | , |
| double | , | ||
| double | |||
| ) | [virtual] |
The default cell color for all unannotated, unselected elements of the data. This is used if UseCellLookupTable is off.
| virtual void vtkApplyColors::SetDefaultCellColor | ( | double | [3] | ) | [virtual] |
The default cell color for all unannotated, unselected elements of the data. This is used if UseCellLookupTable is off.
| virtual double* vtkApplyColors::GetDefaultCellColor | ( | ) | [virtual] |
The default cell color for all unannotated, unselected elements of the data. This is used if UseCellLookupTable is off.
| virtual void vtkApplyColors::GetDefaultCellColor | ( | double & | , |
| double & | , | ||
| double & | |||
| ) | [virtual] |
The default cell color for all unannotated, unselected elements of the data. This is used if UseCellLookupTable is off.
| virtual void vtkApplyColors::GetDefaultCellColor | ( | double | [3] | ) | [virtual] |
The default cell color for all unannotated, unselected elements of the data. This is used if UseCellLookupTable is off.
| virtual void vtkApplyColors::SetDefaultCellOpacity | ( | double | ) | [virtual] |
The default cell opacity for all unannotated, unselected elements of the data. This is used if UseCellLookupTable is off.
| virtual double vtkApplyColors::GetDefaultCellOpacity | ( | ) | [virtual] |
The default cell opacity for all unannotated, unselected elements of the data. This is used if UseCellLookupTable is off.
| virtual void vtkApplyColors::SetSelectedCellColor | ( | double | , |
| double | , | ||
| double | |||
| ) | [virtual] |
The cell color for all selected elements of the data. This is used if the selection input is available.
| virtual void vtkApplyColors::SetSelectedCellColor | ( | double | [3] | ) | [virtual] |
The cell color for all selected elements of the data. This is used if the selection input is available.
| virtual double* vtkApplyColors::GetSelectedCellColor | ( | ) | [virtual] |
The cell color for all selected elements of the data. This is used if the selection input is available.
| virtual void vtkApplyColors::GetSelectedCellColor | ( | double & | , |
| double & | , | ||
| double & | |||
| ) | [virtual] |
The cell color for all selected elements of the data. This is used if the selection input is available.
| virtual void vtkApplyColors::GetSelectedCellColor | ( | double | [3] | ) | [virtual] |
The cell color for all selected elements of the data. This is used if the selection input is available.
| virtual void vtkApplyColors::SetSelectedCellOpacity | ( | double | ) | [virtual] |
The cell opacity for all selected elements of the data. This is used if the selection input is available.
| virtual double vtkApplyColors::GetSelectedCellOpacity | ( | ) | [virtual] |
The cell opacity for all selected elements of the data. This is used if the selection input is available.
| virtual void vtkApplyColors::SetCellColorOutputArrayName | ( | const char * | ) | [virtual] |
The output array name for the cell color RGBA array. Default is "vtkApplyColors color".
| virtual char* vtkApplyColors::GetCellColorOutputArrayName | ( | ) | [virtual] |
The output array name for the cell color RGBA array. Default is "vtkApplyColors color".
| virtual void vtkApplyColors::SetUseCurrentAnnotationColor | ( | bool | ) | [virtual] |
Use the annotation to color the current annotation (i.e. the current selection). Otherwise use the selection color attributes of this filter.
| virtual bool vtkApplyColors::GetUseCurrentAnnotationColor | ( | ) | [virtual] |
Use the annotation to color the current annotation (i.e. the current selection). Otherwise use the selection color attributes of this filter.
| virtual void vtkApplyColors::UseCurrentAnnotationColorOn | ( | ) | [virtual] |
Use the annotation to color the current annotation (i.e. the current selection). Otherwise use the selection color attributes of this filter.
| virtual void vtkApplyColors::UseCurrentAnnotationColorOff | ( | ) | [virtual] |
Use the annotation to color the current annotation (i.e. the current selection). Otherwise use the selection color attributes of this filter.
| virtual long unsigned int vtkApplyColors::GetMTime | ( | ) | [virtual] |
Retrieve the modified time for this filter.
Reimplemented from vtkObject.
| int vtkApplyColors::RequestData | ( | vtkInformation * | , |
| vtkInformationVector ** | , | ||
| vtkInformationVector * | |||
| ) | [protected, virtual] |
Convert the vtkGraph into vtkPolyData.
Reimplemented from vtkPassInputTypeAlgorithm.
| int vtkApplyColors::FillInputPortInformation | ( | int | port, |
| vtkInformation * | info | ||
| ) | [protected, virtual] |
Set the input type of the algorithm to vtkGraph.
Reimplemented from vtkPassInputTypeAlgorithm.
| void vtkApplyColors::ProcessColorArray | ( | vtkUnsignedCharArray * | colorArr, |
| vtkScalarsToColors * | lut, | ||
| vtkAbstractArray * | arr, | ||
| unsigned char | color[4], | ||
| bool | scale | ||
| ) | [protected] |
Member Data Documentation
vtkScalarsToColors* vtkApplyColors::PointLookupTable [protected] |
Definition at line 240 of file vtkApplyColors.h.
vtkScalarsToColors* vtkApplyColors::CellLookupTable [protected] |
Definition at line 241 of file vtkApplyColors.h.
double vtkApplyColors::DefaultPointColor[3] [protected] |
Definition at line 242 of file vtkApplyColors.h.
double vtkApplyColors::DefaultPointOpacity [protected] |
Definition at line 243 of file vtkApplyColors.h.
double vtkApplyColors::DefaultCellColor[3] [protected] |
Definition at line 244 of file vtkApplyColors.h.
double vtkApplyColors::DefaultCellOpacity [protected] |
Definition at line 245 of file vtkApplyColors.h.
double vtkApplyColors::SelectedPointColor[3] [protected] |
Definition at line 246 of file vtkApplyColors.h.
double vtkApplyColors::SelectedPointOpacity [protected] |
Definition at line 247 of file vtkApplyColors.h.
double vtkApplyColors::SelectedCellColor[3] [protected] |
Definition at line 248 of file vtkApplyColors.h.
double vtkApplyColors::SelectedCellOpacity [protected] |
Definition at line 249 of file vtkApplyColors.h.
bool vtkApplyColors::ScalePointLookupTable [protected] |
Definition at line 250 of file vtkApplyColors.h.
bool vtkApplyColors::ScaleCellLookupTable [protected] |
Definition at line 251 of file vtkApplyColors.h.
bool vtkApplyColors::UsePointLookupTable [protected] |
Definition at line 252 of file vtkApplyColors.h.
bool vtkApplyColors::UseCellLookupTable [protected] |
Definition at line 253 of file vtkApplyColors.h.
char* vtkApplyColors::PointColorOutputArrayName [protected] |
Definition at line 254 of file vtkApplyColors.h.
char* vtkApplyColors::CellColorOutputArrayName [protected] |
Definition at line 255 of file vtkApplyColors.h.
bool vtkApplyColors::UseCurrentAnnotationColor [protected] |
Definition at line 256 of file vtkApplyColors.h.
The documentation for this class was generated from the following file:
- dox/Views/Infovis/vtkApplyColors.h
