VTK  9.6.20260411
vtkDiscretizableColorTransferFunction.h
Go to the documentation of this file.
1// SPDX-FileCopyrightText: Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
2// SPDX-License-Identifier: BSD-3-Clause
95
96#ifndef vtkDiscretizableColorTransferFunction_h
97#define vtkDiscretizableColorTransferFunction_h
98
100#include "vtkRenderingCoreModule.h" // For export macro
101#include "vtkSmartPointer.h" // for vtkSmartPointer
102#include "vtkWrappingHints.h" // For VTK_MARSHALMANUAL
103
104VTK_ABI_NAMESPACE_BEGIN
106class vtkLookupTable;
109
112{
113public:
116 void PrintSelf(ostream& os, vtkIndent indent) override;
117
119
123 vtkTypeBool IsOpaque(vtkAbstractArray* scalars, int colorMode, int component) override;
124 vtkTypeBool IsOpaque(vtkAbstractArray* scalars, int colorMode, int component,
125 vtkUnsignedCharArray* ghosts, unsigned char ghostsToSkip = 0xff) override;
127
135 void SetIndexedColorRGB(unsigned int index, const double rgb[3])
136 {
137 this->SetIndexedColor(index, rgb[0], rgb[1], rgb[2]);
138 }
139 void SetIndexedColorRGBA(unsigned int index, const double rgba[4])
140 {
141 this->SetIndexedColor(index, rgba[0], rgba[1], rgba[2], rgba[3]);
142 }
143 void SetIndexedColor(unsigned int index, double r, double g, double b, double a = 1.0);
144
157 void GetIndexedColor(vtkIdType i, double rgba[4]) override;
158
160
165 void SetNumberOfIndexedColors(unsigned int count);
168
175 void Build() override;
176
178
184 vtkSetMacro(Discretize, vtkTypeBool);
185 vtkGetMacro(Discretize, vtkTypeBool);
186 vtkBooleanMacro(Discretize, vtkTypeBool);
188
190
194 virtual void SetUseLogScale(vtkTypeBool useLogScale);
197
199
207
212 const unsigned char* MapValue(double v) override;
213
218 void GetColor(double v, double rgb[3]) override;
219
223 double GetOpacity(double v) override;
224
226
231 void MapScalarsThroughTable(vtkAbstractArray* input, unsigned char* output, int numberOfTuples,
232 int numberOfComponents, int vectorComponent, int outputFormat) override;
235
243 void SetAlpha(double alpha) override;
244
246
251 void SetNanColor(double r, double g, double b) override;
252 void SetNanColor(const double rgb[3]) override { this->SetNanColor(rgb[0], rgb[1], rgb[2]); }
254
260 void SetNanOpacity(double a) override;
261
266 vtkTypeBool UsingLogScale() override { return this->UseLogScale; }
267
272
274
280
282
285 vtkSetMacro(EnableOpacityMapping, bool);
286 vtkGetMacro(EnableOpacityMapping, bool);
287 vtkBooleanMacro(EnableOpacityMapping, bool);
289
294
295protected:
298
303
308
313
318
320
323
324 void MapDataArrayToOpacity(vtkDataArray* scalars, int component, vtkUnsignedCharArray* colors);
325
326private:
328 void operator=(const vtkDiscretizableColorTransferFunction&) = delete;
329
330 template <typename T, typename VectorGetter>
331 void MapVectorToOpacity(VectorGetter getter, T* scalars, int component, int numberOfComponents,
332 vtkIdType numberOfTuples, unsigned char* colors);
333
334 template <template <class> class VectorGetter>
335 void AllTypesMapVectorToOpacity(int scalarType, void* scalarsPtr, int component,
336 int numberOfComponents, vtkIdType numberOfTuples, unsigned char* colors);
337
338 class vtkInternals;
339 vtkInternals* Internals;
340};
341
342VTK_ABI_NAMESPACE_END
343#endif
Abstract superclass for all arrays.
Defines a transfer function for mapping a property to an RGB color value.
void SetNanColor(const double rgb[3]) override
Set the color to use when a NaN (not a number) is encountered.
unsigned int GetNumberOfIndexedColors()
Set the number of indexed colors.
vtkMTimeType GetMTime() override
Overridden to include the ScalarOpacityFunction's MTime.
vtkIdType NumberOfValues
Number of values to use in discretized color map.
vtkTypeBool IsOpaque(vtkAbstractArray *scalars, int colorMode, int component) override
Returns the negation of EnableOpacityMapping.
void MapDataArrayToOpacity(vtkDataArray *scalars, int component, vtkUnsignedCharArray *colors)
vtkTypeBool UseLogScale
Flag indicating whether log scaling is to be used.
void SetIndexedColorRGBA(unsigned int index, const double rgba[4])
void GetColor(double v, double rgb[3]) override
Map one value through the lookup table and return the color as an RGB array of doubles between 0 and ...
void SetNumberOfIndexedColors(unsigned int count)
Set the number of indexed colors.
void GetIndexedColor(vtkIdType i, double rgba[4]) override
Get the "indexed color" assigned to an index.
const unsigned char * MapValue(double v) override
Map one value through the lookup table and return a color defined as a RGBA unsigned char tuple (4 by...
virtual void SetUseLogScale(vtkTypeBool useLogScale)
Get/Set if log scale must be used while mapping scalars to colors.
vtkTypeBool Discretize
Flag indicating whether transfer function is discretized.
void SetAlpha(double alpha) override
Specify an additional opacity (alpha) value to blend with.
virtual vtkPiecewiseFunction * GetScalarOpacityFunction() const
Set/get the opacity function to use.
vtkTypeBool IsOpaque() override
Returns the negation of EnableOpacityMapping.
vtkIdType GetNumberOfAvailableColors() override
Get the number of available colors for mapping to.
vtkSmartPointer< vtkPiecewiseFunction > ScalarOpacityFunction
vtkLookupTable * LookupTable
Internal lookup table used for some aspects of the color mapping.
void MapScalarsThroughTable(vtkAbstractArray *input, unsigned char *output, int numberOfTuples, int numberOfComponents, int vectorComponent, int outputFormat) override
Map a set of scalars through the lookup table.
virtual void SetScalarOpacityFunction(vtkPiecewiseFunction *function)
Set/get the opacity function to use.
void SetIndexedColorRGB(unsigned int index, const double rgb[3])
Add colors to use when IndexedLookup is true.
vtkTypeBool IsOpaque(vtkAbstractArray *scalars, int colorMode, int component, vtkUnsignedCharArray *ghosts, unsigned char ghostsToSkip=0xff) override
Returns the negation of EnableOpacityMapping.
double GetOpacity(double v) override
Return the opacity of a given scalar.
void SetIndexedColor(unsigned int index, double r, double g, double b, double a=1.0)
void SetNanColor(double r, double g, double b) override
Set the color to use when a NaN (not a number) is encountered.
static vtkDiscretizableColorTransferFunction * New()
void SetNanOpacity(double a) override
Set the opacity to use when a NaN (not a number) is encountered.
vtkTypeBool UsingLogScale() override
This should return 1 if the subclass is using log scale for mapping scalars to colors.
void PrintSelf(ostream &os, vtkIndent indent) override
Print method for vtkColorTransferFunction.
void Build() override
Generate discretized lookup table, if applicable.
a simple class to control print indentation
Definition vtkIndent.h:108
map scalar values into colors via a lookup table
Defines a 1D piecewise function.
void MapScalarsThroughTable(vtkDataArray *scalars, unsigned char *output, int outputFormat)
Map a set of scalars through the lookup table in a single operation.
Hold a reference to a vtkObjectBase instance.
record modification and/or execution time
dynamic, self-adjusting array of unsigned char
int vtkTypeBool
Definition vtkABI.h:64
#define vtkDataArray
int vtkIdType
Definition vtkType.h:363
vtkTypeUInt32 vtkMTimeType
Definition vtkType.h:318
#define VTK_MARSHALMANUAL