VTK  9.1.0
vtkMapper.h
Go to the documentation of this file.
1/*=========================================================================
2
3 Program: Visualization Toolkit
4 Module: vtkMapper.h
5
6 Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
7 All rights reserved.
8 See Copyright.txt or http://www.kitware.com/Copyright.htm for details.
9
10 This software is distributed WITHOUT ANY WARRANTY; without even
11 the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
12 PURPOSE. See the above copyright notice for more information.
13
14=========================================================================*/
47#ifndef vtkMapper_h
48#define vtkMapper_h
49
50#include "vtkAbstractMapper3D.h"
51#include "vtkRenderingCoreModule.h" // For export macro
52#include "vtkSmartPointer.h" // needed for vtkSmartPointer.
53#include "vtkSystemIncludes.h" // For VTK_COLOR_MODE_DEFAULT and _MAP_SCALARS
54#include <vector> // for method args
55
56#define VTK_RESOLVE_OFF 0
57#define VTK_RESOLVE_POLYGON_OFFSET 1
58#define VTK_RESOLVE_SHIFT_ZBUFFER 2
59
60#define VTK_GET_ARRAY_BY_ID 0
61#define VTK_GET_ARRAY_BY_NAME 1
62
63#define VTK_MATERIALMODE_DEFAULT 0
64#define VTK_MATERIALMODE_AMBIENT 1
65#define VTK_MATERIALMODE_DIFFUSE 2
66#define VTK_MATERIALMODE_AMBIENT_AND_DIFFUSE 3
67
68class vtkActor;
69class vtkDataSet;
70class vtkDataObject;
71class vtkFloatArray;
73class vtkImageData;
74class vtkProp;
75class vtkRenderer;
77class vtkSelection;
79class vtkWindow;
80
81class VTKRENDERINGCORE_EXPORT vtkMapper : public vtkAbstractMapper3D
82{
83public:
85 void PrintSelf(ostream& os, vtkIndent indent) override;
86
90 void ShallowCopy(vtkAbstractMapper* m) override;
91
97
102 virtual void Render(vtkRenderer* ren, vtkActor* a) = 0;
103
110
112
118
124
126
129 vtkSetMacro(ScalarVisibility, vtkTypeBool);
130 vtkGetMacro(ScalarVisibility, vtkTypeBool);
131 vtkBooleanMacro(ScalarVisibility, vtkTypeBool);
133
135
141 vtkSetMacro(Static, vtkTypeBool);
142 vtkGetMacro(Static, vtkTypeBool);
143 vtkBooleanMacro(Static, vtkTypeBool);
145
147
159 vtkSetMacro(ColorMode, int);
160 vtkGetMacro(ColorMode, int);
161 void SetColorModeToDefault() { this->SetColorMode(VTK_COLOR_MODE_DEFAULT); }
165
169 const char* GetColorModeAsString();
170
172
178 vtkSetMacro(InterpolateScalarsBeforeMapping, vtkTypeBool);
179 vtkGetMacro(InterpolateScalarsBeforeMapping, vtkTypeBool);
180 vtkBooleanMacro(InterpolateScalarsBeforeMapping, vtkTypeBool);
182
184
192 vtkSetMacro(UseLookupTableScalarRange, vtkTypeBool);
193 vtkGetMacro(UseLookupTableScalarRange, vtkTypeBool);
194 vtkBooleanMacro(UseLookupTableScalarRange, vtkTypeBool);
196
198
203 vtkSetVector2Macro(ScalarRange, double);
204 vtkGetVectorMacro(ScalarRange, double, 2);
206
220 // When ScalarMode is set to use Field Data (ScalarModeToFieldData),
221 // you must call SelectColorArray to choose the field data array to
222 // be used to color cells. In this mode, the default behavior is to
223 // treat the field data tuples as being associated with cells. If
224 // the poly data contains triangle strips, the array is expected to
225 // contain the cell data for each mini-cell formed by any triangle
226 // strips in the poly data as opposed to treating them as a single
227 // tuple that applies to the entire strip. This mode can also be
228 // used to color the entire poly data by a single color obtained by
229 // mapping the tuple at a given index in the field data array
230 // through the color map. Use SetFieldDataTupleId() to specify
231 // the tuple index.
232 vtkSetMacro(ScalarMode, int);
233 vtkGetMacro(ScalarMode, int);
234 void SetScalarModeToDefault() { this->SetScalarMode(VTK_SCALAR_MODE_DEFAULT); }
238 {
239 this->SetScalarMode(VTK_SCALAR_MODE_USE_POINT_FIELD_DATA);
240 }
242 {
243 this->SetScalarMode(VTK_SCALAR_MODE_USE_CELL_FIELD_DATA);
244 }
246
248
253 void SelectColorArray(int arrayNum);
254 void SelectColorArray(const char* arrayName);
256
257 // When ScalarMode is set to UseFieldData, set the index of the
258 // tuple by which to color the entire data set. By default, the
259 // index is -1, which means to treat the field data array selected
260 // with SelectColorArray as having a scalar value for each cell.
261 // Indices of 0 or higher mean to use the tuple at the given index
262 // for coloring the entire data set.
263 vtkSetMacro(FieldDataTupleId, vtkIdType);
264 vtkGetMacro(FieldDataTupleId, vtkIdType);
265
267
272 void ColorByArrayComponent(int arrayNum, int component);
273 void ColorByArrayComponent(const char* arrayName, int component);
275
279 vtkGetStringMacro(ArrayName);
280 vtkSetStringMacro(ArrayName);
281 vtkGetMacro(ArrayId, int);
282 vtkSetMacro(ArrayId, int);
283 vtkGetMacro(ArrayAccessMode, int);
284 vtkSetMacro(ArrayAccessMode, int);
285 vtkGetMacro(ArrayComponent, int);
286 vtkSetMacro(ArrayComponent, int);
287
292
294
304 static void SetResolveCoincidentTopology(int val);
307 static void SetResolveCoincidentTopologyToOff() { SetResolveCoincidentTopology(VTK_RESOLVE_OFF); }
309 {
310 SetResolveCoincidentTopology(VTK_RESOLVE_POLYGON_OFFSET);
311 }
313 {
314 SetResolveCoincidentTopology(VTK_RESOLVE_SHIFT_ZBUFFER);
315 }
317
319
324 static void SetResolveCoincidentTopologyPolygonOffsetParameters(double factor, double units);
325 static void GetResolveCoincidentTopologyPolygonOffsetParameters(double& factor, double& units);
327
329
334 void GetRelativeCoincidentTopologyPolygonOffsetParameters(double& factor, double& units);
336
338
343 static void SetResolveCoincidentTopologyLineOffsetParameters(double factor, double units);
344 static void GetResolveCoincidentTopologyLineOffsetParameters(double& factor, double& units);
346
348
352 void SetRelativeCoincidentTopologyLineOffsetParameters(double factor, double units);
353 void GetRelativeCoincidentTopologyLineOffsetParameters(double& factor, double& units);
355
357
365
367
374
376
380 void GetCoincidentTopologyPolygonOffsetParameters(double& factor, double& units);
381 void GetCoincidentTopologyLineOffsetParameters(double& factor, double& units);
384
386
396
398
402 static void SetResolveCoincidentTopologyZShift(double val);
405
410 double* GetBounds() VTK_SIZEHINT(6) override;
411 void GetBounds(double bounds[6]) override { this->vtkAbstractMapper3D::GetBounds(bounds); }
412
418 void SetRenderTime(double time) { this->RenderTime = time; }
419 vtkGetMacro(RenderTime, double);
420
426
433 vtkDataSet* GetInputAsDataSet() { return this->GetInput(); }
434
436
444 virtual vtkUnsignedCharArray* MapScalars(double alpha, int& cellFlag);
446 virtual vtkUnsignedCharArray* MapScalars(vtkDataSet* input, double alpha, int& cellFlag);
448
450
455 virtual bool HasOpaqueGeometry();
458
465 virtual bool GetSupportsSelection() { return false; }
466
472 std::vector<unsigned int>& /* pixeloffsets */, vtkProp* /* prop */)
473 {
474 }
475
485
491
496
501
506
508
512 vtkGetObjectMacro(Selection, vtkSelection);
515
516protected:
518 ~vtkMapper() override;
519
520 // color mapped colors
522
523 // Use texture coordinates for coloring.
525 // Coordinate for each point.
527 // 1D ColorMap used for the texture image.
530
534 double ScalarRange[2];
536
539
541
542 // for coloring by a component of a field data array
547
548 // If coloring by field data, which tuple to use to color the entire
549 // data set. If -1, treat array values as cell data.
551
553
559
560 vtkSelection* Selection = nullptr;
561
562private:
563 vtkMapper(const vtkMapper&) = delete;
564 void operator=(const vtkMapper&) = delete;
565};
566
567#endif
Abstract superclass for all arrays.
abstract class specifies interface to map 3D data
virtual double * GetBounds()=0
Return bounding box (array of six doubles) of data expressed as (xmin,xmax, ymin,ymax,...
abstract class specifies interface to map data
represents an object (geometry & properties) in a rendered scene
Definition: vtkActor.h:46
general representation of visualization data
Definition: vtkDataObject.h:60
abstract class to specify dataset behavior
Definition: vtkDataSet.h:57
dynamic, self-adjusting array of float
Definition: vtkFloatArray.h:36
topologically and geometrically regular array of data
Definition: vtkImageData.h:48
a simple class to control print indentation
Definition: vtkIndent.h:34
abstract class specifies interface to map data to graphics primitives
Definition: vtkMapper.h:82
virtual bool HasOpaqueGeometry()
Some introspection on the type of data the mapper will render used by props to determine if they shou...
const char * GetScalarModeAsString()
Return the method for obtaining scalar data.
~vtkMapper() override
virtual int CanUseTextureMapForColoring(vtkDataObject *input)
Returns if we can use texture maps for scalar coloring.
void GetCoincidentTopologyLineOffsetParameters(double &factor, double &units)
Get the net parameters for handling coincident topology obtained by summing the global values with th...
static int GetResolveCoincidentTopology()
Set/Get a global flag that controls whether coincident topology (e.g., a line on top of a polygon) is...
void SelectColorArray(const char *arrayName)
When ScalarMode is set to UsePointFieldData or UseCellFieldData, you can specify which array to use f...
void SetScalarModeToUsePointFieldData()
Definition: vtkMapper.h:237
vtkScalarsToColors * LookupTable
Definition: vtkMapper.h:531
double CoincidentPolygonFactor
Definition: vtkMapper.h:554
void SetColorModeToMapScalars()
default (ColorModeToDefault), unsigned char scalars are treated as colors, and NOT mapped through the...
Definition: vtkMapper.h:162
int ColorMode
Definition: vtkMapper.h:537
void PrintSelf(ostream &os, vtkIndent indent) override
Methods invoked by print to print information about the object including superclasses.
void SetScalarModeToUseCellData()
Definition: vtkMapper.h:236
void SetLookupTable(vtkScalarsToColors *lut)
Specify a lookup table for the mapper to use.
virtual vtkUnsignedCharArray * MapScalars(double alpha)
Map the scalars (if there are any scalars and ScalarVisibility is on) through the lookup table,...
vtkTypeBool InterpolateScalarsBeforeMapping
Definition: vtkMapper.h:524
void SetColorModeToDefault()
default (ColorModeToDefault), unsigned char scalars are treated as colors, and NOT mapped through the...
Definition: vtkMapper.h:161
void SelectColorArray(int arrayNum)
When ScalarMode is set to UsePointFieldData or UseCellFieldData, you can specify which array to use f...
vtkTypeBool UseLookupTableScalarRange
Definition: vtkMapper.h:535
void SetScalarModeToDefault()
Definition: vtkMapper.h:234
int ScalarMode
Definition: vtkMapper.h:538
virtual bool GetSupportsSelection()
WARNING: INTERNAL METHOD - NOT INTENDED FOR GENERAL USE DO NOT USE THIS METHOD OUTSIDE OF THE RENDERI...
Definition: vtkMapper.h:465
static void GetResolveCoincidentTopologyLineOffsetParameters(double &factor, double &units)
Used to set the line offset scale factor and units.
void GetCoincidentTopologyPolygonOffsetParameters(double &factor, double &units)
Get the net parameters for handling coincident topology obtained by summing the global values with th...
virtual void CreateDefaultLookupTable()
Create default lookup table.
double RenderTime
Definition: vtkMapper.h:540
void SetScalarModeToUseCellFieldData()
Definition: vtkMapper.h:241
void MapScalarsToTexture(vtkAbstractArray *scalars, double alpha)
vtkImageData * GetColorTextureMap()
Provide read access to the color texture array.
static void GetResolveCoincidentTopologyPointOffsetParameter(double &units)
Used to set the point offset value Used when ResolveCoincidentTopology is set to PolygonOffset.
static void SetResolveCoincidentTopologyToDefault()
Set/Get a global flag that controls whether coincident topology (e.g., a line on top of a polygon) is...
virtual bool HasTranslucentPolygonalGeometry()
Some introspection on the type of data the mapper will render used by props to determine if they shou...
vtkImageData * ColorTextureMap
Definition: vtkMapper.h:528
vtkTimeStamp BuildTime
Definition: vtkMapper.h:533
void ColorByArrayComponent(int arrayNum, int component)
Legacy: These methods used to be used to specify the array component.
void GetRelativeCoincidentTopologyPointOffsetParameter(double &units)
Used to set the point offset value relative to the global Used when ResolveCoincidentTopology is set ...
void SetColorModeToDirectScalars()
default (ColorModeToDefault), unsigned char scalars are treated as colors, and NOT mapped through the...
Definition: vtkMapper.h:163
vtkTypeBool Static
Definition: vtkMapper.h:552
virtual vtkUnsignedCharArray * MapScalars(double alpha, int &cellFlag)
Map the scalars (if there are any scalars and ScalarVisibility is on) through the lookup table,...
void SetScalarModeToUseFieldData()
Definition: vtkMapper.h:245
static double GetResolveCoincidentTopologyZShift()
Used to set the z-shift if ResolveCoincidentTopology is set to ShiftZBuffer.
static void SetResolveCoincidentTopologyPolygonOffsetParameters(double factor, double units)
Used to set the polygon offset scale factor and units.
int ArrayAccessMode
Definition: vtkMapper.h:546
void SetRelativeCoincidentTopologyLineOffsetParameters(double factor, double units)
Used to set the line offset values relative to the global Used when ResolveCoincidentTopology is set ...
int ArrayId
Definition: vtkMapper.h:543
int ArrayComponent
Definition: vtkMapper.h:545
void SetRenderTime(double time)
This instance variable is used by vtkLODActor to determine which mapper to use.
Definition: vtkMapper.h:418
static void SetResolveCoincidentTopology(int val)
Set/Get a global flag that controls whether coincident topology (e.g., a line on top of a polygon) is...
void GetRelativeCoincidentTopologyLineOffsetParameters(double &factor, double &units)
Used to set the line offset values relative to the global Used when ResolveCoincidentTopology is set ...
vtkUnsignedCharArray * Colors
Definition: vtkMapper.h:521
static void SetResolveCoincidentTopologyToOff()
Set/Get a global flag that controls whether coincident topology (e.g., a line on top of a polygon) is...
Definition: vtkMapper.h:307
virtual void Render(vtkRenderer *ren, vtkActor *a)=0
Method initiates the mapping process.
vtkTypeBool ScalarVisibility
Definition: vtkMapper.h:532
vtkMTimeType GetMTime() override
Overload standard modified time function.
vtkDataSet * GetInputAsDataSet()
Get the input to this mapper as a vtkDataSet, instead of as a more specialized data type that the sub...
Definition: vtkMapper.h:433
vtkScalarsToColors * GetLookupTable()
Specify a lookup table for the mapper to use.
virtual vtkUnsignedCharArray * MapScalars(vtkDataSet *input, double alpha, int &cellFlag)
Map the scalars (if there are any scalars and ScalarVisibility is on) through the lookup table,...
vtkIdType FieldDataTupleId
Definition: vtkMapper.h:550
double CoincidentPointOffset
Definition: vtkMapper.h:558
static void SetResolveCoincidentTopologyToPolygonOffset()
Set/Get a global flag that controls whether coincident topology (e.g., a line on top of a polygon) is...
Definition: vtkMapper.h:308
static void SetResolveCoincidentTopologyToShiftZBuffer()
Set/Get a global flag that controls whether coincident topology (e.g., a line on top of a polygon) is...
Definition: vtkMapper.h:312
void ColorByArrayComponent(const char *arrayName, int component)
Legacy: These methods used to be used to specify the array component.
void GetRelativeCoincidentTopologyPolygonOffsetParameters(double &factor, double &units)
Used to set the polygon offset values relative to the global Used when ResolveCoincidentTopology is s...
static int GetResolveCoincidentTopologyPolygonOffsetFaces()
Used when ResolveCoincidentTopology is set to PolygonOffset.
vtkFloatArray * GetColorCoordinates()
Provide read access to the color texture coordinate array.
double * GetBounds() override
Return bounding box (array of six doubles) of data expressed as (xmin,xmax, ymin,ymax,...
virtual void ProcessSelectorPixelBuffers(vtkHardwareSelector *, std::vector< unsigned int > &, vtkProp *)
allows a mapper to update a selections color buffers Called from a prop which in turn is called from ...
Definition: vtkMapper.h:471
double CoincidentLineOffset
Definition: vtkMapper.h:557
void SetRelativeCoincidentTopologyPointOffsetParameter(double units)
Used to set the point offset value relative to the global Used when ResolveCoincidentTopology is set ...
static void SetResolveCoincidentTopologyPointOffsetParameter(double units)
Used to set the point offset value Used when ResolveCoincidentTopology is set to PolygonOffset.
vtkFloatArray * ColorCoordinates
Definition: vtkMapper.h:526
void SetRelativeCoincidentTopologyPolygonOffsetParameters(double factor, double units)
Used to set the polygon offset values relative to the global Used when ResolveCoincidentTopology is s...
void ShallowCopy(vtkAbstractMapper *m) override
Make a shallow copy of this mapper.
void SetScalarModeToUsePointData()
Definition: vtkMapper.h:235
vtkUnsignedCharArray * GetColorMapColors()
Provide read access to the color array.
static void SetResolveCoincidentTopologyLineOffsetParameters(double factor, double units)
Used to set the line offset scale factor and units.
vtkDataSet * GetInput()
Get the input as a vtkDataSet.
virtual void SetSelection(vtkSelection *)
Set/Get selection used to display particular points or cells in a second pass.
static void SetResolveCoincidentTopologyPolygonOffsetFaces(int faces)
Used when ResolveCoincidentTopology is set to PolygonOffset.
static void GetResolveCoincidentTopologyPolygonOffsetParameters(double &factor, double &units)
Used to set the polygon offset scale factor and units.
void GetCoincidentTopologyPointOffsetParameter(double &units)
Get the net parameters for handling coincident topology obtained by summing the global values with th...
double CoincidentLineFactor
Definition: vtkMapper.h:556
const char * GetColorModeAsString()
Return the method of coloring scalar data.
static void SetResolveCoincidentTopologyZShift(double val)
Used to set the z-shift if ResolveCoincidentTopology is set to ShiftZBuffer.
virtual vtkUnsignedCharArray * MapScalars(vtkDataSet *input, double alpha)
Map the scalars (if there are any scalars and ScalarVisibility is on) through the lookup table,...
double CoincidentPolygonOffset
Definition: vtkMapper.h:555
void ClearColorArrays()
Call to force a rebuild of color result arrays on next MapScalars.
char * ArrayName
Definition: vtkMapper.h:544
void ReleaseGraphicsResources(vtkWindow *) override
Release any graphics resources that are being consumed by this mapper.
Definition: vtkMapper.h:109
abstract superclass for all actors, volumes and annotations
Definition: vtkProp.h:57
abstract specification for renderers
Definition: vtkRenderer.h:73
Superclass for mapping scalar values to colors.
data object that represents a "selection" in VTK.
Definition: vtkSelection.h:54
record modification and/or execution time
Definition: vtkTimeStamp.h:33
dynamic, self-adjusting array of unsigned char
window superclass for vtkRenderWindow
Definition: vtkWindow.h:39
void GetBounds(T a, double bds[6])
@ component
Definition: vtkX3D.h:181
@ time
Definition: vtkX3D.h:503
@ alpha
Definition: vtkX3D.h:256
int vtkTypeBool
Definition: vtkABI.h:69
#define VTK_SCALAR_MODE_DEFAULT
#define VTK_SCALAR_MODE_USE_POINT_DATA
#define VTK_SCALAR_MODE_USE_FIELD_DATA
#define VTK_SCALAR_MODE_USE_CELL_DATA
#define VTK_SCALAR_MODE_USE_CELL_FIELD_DATA
#define VTK_SCALAR_MODE_USE_POINT_FIELD_DATA
#define VTK_RESOLVE_POLYGON_OFFSET
Definition: vtkMapper.h:57
#define VTK_RESOLVE_OFF
Definition: vtkMapper.h:56
#define VTK_RESOLVE_SHIFT_ZBUFFER
Definition: vtkMapper.h:58
#define VTK_COLOR_MODE_MAP_SCALARS
#define VTK_COLOR_MODE_DEFAULT
#define VTK_COLOR_MODE_DIRECT_SCALARS
int vtkIdType
Definition: vtkType.h:332
vtkTypeUInt32 vtkMTimeType
Definition: vtkType.h:287
#define VTK_SIZEHINT(...)