VTK
9.4.20241221
|
stores a list of colors. More...
#include <vtkColorSeries.h>
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. | |
vtkColorSeries * | NewInstance () const |
void | PrintSelf (ostream &os, vtkIndent indent) override |
Methods invoked by print to print information about the object including superclasses. | |
int | GetNumberOfColorSchemes () const |
Return the number of schemes currently defined. | |
virtual vtkStdString | GetColorSchemeName () const |
Get the color scheme that is currently being used. | |
virtual void | SetColorSchemeName (const vtkStdString &name) |
Set the name of the current color scheme. | |
virtual int | GetColorScheme () const |
Return the ID of the color scheme currently in use. | |
virtual int | GetNumberOfColors () const |
Get the number of colors available in the current color scheme. | |
virtual void | SetNumberOfColors (int numColors) |
Set the number of colors to be stored in a non-default color scheme. | |
vtkColor3ub | GetColor (int index) const |
Get the color at the specified index. | |
vtkColor3ub | GetColorRepeating (int index) const |
Get the color at the specified index. | |
virtual void | SetColor (int index, const vtkColor3ub &color) |
Set the color at the specified index. | |
virtual void | AddColor (const vtkColor3ub &color) |
Adds the color to the end of the list. | |
virtual void | InsertColor (int index, const vtkColor3ub &color) |
Inserts the color at the specified index in the list. | |
virtual void | RemoveColor (int index) |
Removes the color at the specified index in the list. | |
virtual void | ClearColors () |
Clears the list of colors. | |
virtual void | DeepCopy (vtkColorSeries *chartColors) |
Make a deep copy of the supplied object. | |
void | BuildLookupTable (vtkLookupTable *lkup, int lutIndexing=CATEGORICAL) |
Populate a lookup table with all the colors in the current scheme. | |
vtkLookupTable * | CreateLookupTable (int lutIndexing=CATEGORICAL) |
Create a new lookup table with all the colors in the current scheme. | |
virtual void | SetColorScheme (int scheme) |
Set the color scheme that should be used. | |
virtual int | SetColorSchemeByName (const vtkStdString &schemeName) |
Set the color scheme that should be used. | |
Public Member Functions inherited from vtkObject | |
vtkBaseTypeMacro (vtkObject, vtkObjectBase) | |
virtual void | DebugOn () |
Turn debugging output on. | |
virtual void | DebugOff () |
Turn debugging output off. | |
bool | GetDebug () |
Get the value of the debug flag. | |
void | SetDebug (bool debugFlag) |
Set the value of the debug flag. | |
virtual void | Modified () |
Update the modification time for this object. | |
virtual vtkMTimeType | GetMTime () |
Return this object's modified time. | |
void | PrintSelf (ostream &os, vtkIndent indent) override |
Methods invoked by print to print information about the object including superclasses. | |
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. | |
unsigned long | AddObserver (unsigned long event, vtkCommand *, float priority=0.0f) |
Allow people to add/remove/invoke observers (callbacks) to any VTK object. | |
unsigned long | AddObserver (const char *event, vtkCommand *, float priority=0.0f) |
Allow people to add/remove/invoke observers (callbacks) to any VTK object. | |
vtkCommand * | GetCommand (unsigned long tag) |
Allow people to add/remove/invoke observers (callbacks) to any VTK object. | |
void | RemoveObserver (vtkCommand *) |
Allow people to add/remove/invoke observers (callbacks) to any VTK object. | |
void | RemoveObservers (unsigned long event, vtkCommand *) |
Allow people to add/remove/invoke observers (callbacks) to any VTK object. | |
void | RemoveObservers (const char *event, vtkCommand *) |
Allow people to add/remove/invoke observers (callbacks) to any VTK object. | |
vtkTypeBool | HasObserver (unsigned long event, vtkCommand *) |
Allow people to add/remove/invoke observers (callbacks) to any VTK object. | |
vtkTypeBool | HasObserver (const char *event, vtkCommand *) |
Allow people to add/remove/invoke observers (callbacks) to any VTK object. | |
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. | |
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. | |
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. | |
vtkTypeBool | InvokeEvent (unsigned long event, void *callData) |
This method invokes an event and return whether the event was aborted or not. | |
vtkTypeBool | InvokeEvent (const char *event, void *callData) |
This method invokes an event and return whether the event was aborted or not. | |
virtual void | SetObjectName (const std::string &objectName) |
Set/get the name of this object for reporting purposes. | |
virtual std::string | GetObjectName () const |
Set/get the name of this object for reporting purposes. | |
Public Member Functions inherited from vtkObjectBase | |
const char * | GetClassName () const |
Return the class name as a string. | |
virtual std::string | GetObjectDescription () const |
The object description printed in messages and PrintSelf output. | |
virtual vtkTypeBool | IsA (const char *name) |
Return 1 if this class is the same type of (or a subclass of) the named class. | |
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). | |
virtual void | Delete () |
Delete a VTK object. | |
virtual void | FastDelete () |
Delete a reference to this object. | |
void | InitializeObjectBase () |
void | Print (ostream &os) |
Print an object to an ostream. | |
void | Register (vtkObjectBase *o) |
Increase the reference count (mark as used by another object). | |
virtual void | UnRegister (vtkObjectBase *o) |
Decrease the reference count (release by another object). | |
int | GetReferenceCount () |
Return the current reference count of this object. | |
void | SetReferenceCount (int) |
Sets the reference count. | |
bool | GetIsInMemkind () const |
A local state flag that remembers whether this object lives in the normal or extended memory space. | |
virtual void | PrintHeader (ostream &os, vtkIndent indent) |
Methods invoked by print to print information about the object including superclasses. | |
virtual void | PrintTrailer (ostream &os, vtkIndent indent) |
Methods invoked by print to print information about the object including superclasses. | |
virtual bool | UsesGarbageCollector () const |
Indicate whether the class uses vtkGarbageCollector or not. | |
Static Public Member Functions | |
static vtkTypeBool | IsTypeOf (const char *type) |
static vtkColorSeries * | SafeDownCast (vtkObjectBase *o) |
static vtkColorSeries * | New () |
Create a new vtkColorSeries with the SPECTRUM color scheme. | |
Static Public Member Functions inherited from vtkObject | |
static vtkObject * | New () |
Create an object with Debug turned off, modified time initialized to zero, and reference counting on. | |
static void | BreakOnError () |
This method is called when vtkErrorMacro executes. | |
static void | SetGlobalWarningDisplay (vtkTypeBool val) |
This is a global flag that controls whether any debug, warning or error messages are displayed. | |
static void | GlobalWarningDisplayOn () |
This is a global flag that controls whether any debug, warning or error messages are displayed. | |
static void | GlobalWarningDisplayOff () |
This is a global flag that controls whether any debug, warning or error messages are displayed. | |
static vtkTypeBool | GetGlobalWarningDisplay () |
This is a global flag that controls whether any debug, warning or error messages are displayed. | |
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. | |
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). | |
static vtkObjectBase * | New () |
Create an object with Debug turned off, modified time initialized to zero, and reference counting on. | |
static void | SetMemkindDirectory (const char *directoryname) |
The name of a directory, ideally mounted -o dax, to memory map an extended memory space within. | |
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. | |
Protected Member Functions | |
virtual vtkObjectBase * | NewInstanceInternal () const |
vtkColorSeries () | |
~vtkColorSeries () override | |
virtual void | CopyOnWrite () |
If the current scheme is a predefined (read-only) scheme, copy the current colors to a new scheme and modify the new scheme instead. | |
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. | |
void | InternalReleaseFocus () |
These methods allow a command to exclusively grab all events. | |
Protected Member Functions inherited from vtkObjectBase | |
vtkObjectBase () | |
virtual | ~vtkObjectBase () |
virtual void | RegisterInternal (vtkObjectBase *, vtkTypeBool check) |
virtual void | UnRegisterInternal (vtkObjectBase *, vtkTypeBool check) |
virtual void | ReportReferences (vtkGarbageCollector *) |
virtual void | ObjectFinalize () |
vtkObjectBase (const vtkObjectBase &) | |
void | operator= (const vtkObjectBase &) |
Protected Attributes | |
int | ColorScheme |
The color scheme being used. | |
vtkStdString | ColorSchemeName |
The color scheme being used. | |
Private * | Storage |
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 () |
stores a list of colors.
The vtkColorSeries stores palettes of colors. There are several default palettes (or schemes) available and functions to control several aspects of what colors are returned. In essence a color scheme is set and then the number of colors and individual color values may be requested.
For a web page showcasing the default palettes, see: VTKColorSeriesPatches; ColorSeriesPatches was used to generate this table.
It is also possible to add schemes beyond the default palettes. Whenever SetColorScheme is called with a string for which no palette already exists, a new, empty palette is created. You may then use SetNumberOfColors and SetColor to populate the palette. You may not extend default palettes by calling functions that alter a scheme; if called while a predefined palette is in use, they will create a new non-default scheme and populate it with the current palette before continuing.
The "Brewer" palettes are courtesy of Cynthia A. Brewer (Dept. of Geography, Pennsylvania State University) and under the Apache License. See the source code for details.
Definition at line 160 of file vtkColorSeries.h.
typedef vtkObject vtkColorSeries::Superclass |
Definition at line 163 of file vtkColorSeries.h.
Enum of the available color schemes.
Definition at line 174 of file vtkColorSeries.h.
An enum defining how lookup tables should be used: either as a list of discrete colors to choose from (categorical), or as an ordered list of color set - points to interpolate among (ordinal).
Enumerator | |
---|---|
ORDINAL | indexed lookup is off |
CATEGORICAL | indexed lookup is on |
Definition at line 309 of file vtkColorSeries.h.
|
protected |
|
overrideprotected |
|
static |
|
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 vtkObjectBase.
|
static |
|
protectedvirtual |
vtkColorSeries * vtkColorSeries::NewInstance | ( | ) | const |
|
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 vtkObjectBase.
|
static |
Create a new vtkColorSeries with the SPECTRUM color scheme.
|
virtual |
Set the color scheme that should be used.
The variant of this function that takes an integer should pass a number from those in the enum, or a value returned by the string variant. The variant that accepts a string returns the integer index of the resulting palette (whether it already existed or is newly-created).
|
virtual |
Set the color scheme that should be used.
The variant of this function that takes an integer should pass a number from those in the enum, or a value returned by the string variant. The variant that accepts a string returns the integer index of the resulting palette (whether it already existed or is newly-created).
int vtkColorSeries::GetNumberOfColorSchemes | ( | ) | const |
Return the number of schemes currently defined.
|
virtual |
Get the color scheme that is currently being used.
|
virtual |
Set the name of the current color scheme.
|
virtual |
Return the ID of the color scheme currently in use.
|
virtual |
Get the number of colors available in the current color scheme.
|
virtual |
Set the number of colors to be stored in a non-default color scheme.
Calling this function on a predefined color scheme will cause the scheme to be duplicated to a new custom scheme.
vtkColor3ub vtkColorSeries::GetColor | ( | int | index | ) | const |
Get the color at the specified index.
If the index is out of range then black will be returned.
vtkColor3ub vtkColorSeries::GetColorRepeating | ( | int | index | ) | const |
Get the color at the specified index.
If the index is out of range then the call wraps around, i.e. uses the mod operator.
|
virtual |
Set the color at the specified index.
Does nothing if the index is out of range.
|
virtual |
Adds the color to the end of the list.
|
virtual |
Inserts the color at the specified index in the list.
|
virtual |
Removes the color at the specified index in the list.
|
virtual |
Clears the list of colors.
|
virtual |
Make a deep copy of the supplied object.
void vtkColorSeries::BuildLookupTable | ( | vtkLookupTable * | lkup, |
int | lutIndexing = CATEGORICAL |
||
) |
Populate a lookup table with all the colors in the current scheme.
The default behavior is to return categorical data. Set lutIndexing to ORDINAL to return ordinal data. Any other value for lutIndexing is treated as CATEGORICAL.
vtkLookupTable * vtkColorSeries::CreateLookupTable | ( | int | lutIndexing = CATEGORICAL | ) |
Create a new lookup table with all the colors in the current scheme.
The caller is responsible for deleting the table after use.
The default behavior is to return categorical data. Set lutIndexing to ORDINAL to return ordinal data. Any other value for lutIndexing is treated as CATEGORICAL.
|
protectedvirtual |
If the current scheme is a predefined (read-only) scheme, copy the current colors to a new scheme and modify the new scheme instead.
|
protected |
Definition at line 440 of file vtkColorSeries.h.
|
protected |
The color scheme being used.
Definition at line 446 of file vtkColorSeries.h.
|
protected |
The color scheme being used.
Definition at line 449 of file vtkColorSeries.h.