1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
|
// SPDX-FileCopyrightText: Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
// SPDX-License-Identifier: BSD-3-Clause
/**
* @class vtkTextureMapToPlane
* @brief generate texture coordinates by mapping points to plane
*
* vtkTextureMapToPlane is a filter that generates 2D texture coordinates
* by mapping input dataset points onto a plane. The plane can either be
* user specified or generated automatically. (A least squares method is
* used to generate the plane automatically.)
*
* There are two ways you can specify the plane. The first is to provide a
* plane normal. In this case the points are projected to a plane, and the
* points are then mapped into the user specified s-t coordinate range. For
* more control, you can specify a plane with three points: an origin and two
* points defining the two axes of the plane. (This is compatible with the
* vtkPlaneSource.) Using the second method, the SRange and TRange vectors
* are ignored, since the presumption is that the user does not want to scale
* the texture coordinates; and you can adjust the origin and axes points to
* achieve the texture coordinate scaling you need. Note also that using the
* three point method the axes do not have to be orthogonal.
*
* @sa
* vtkPlaneSource vtkTextureMapToCylinder
* vtkTextureMapToSphere vtkThresholdTextureCoords
*/
#ifndef vtkTextureMapToPlane_h
#define vtkTextureMapToPlane_h
#include "vtkDataSetAlgorithm.h"
#include "vtkFiltersTextureModule.h" // For export macro
VTK_ABI_NAMESPACE_BEGIN
class VTKFILTERSTEXTURE_EXPORT vtkTextureMapToPlane : public vtkDataSetAlgorithm
{
public:
vtkTypeMacro(vtkTextureMapToPlane, vtkDataSetAlgorithm);
void PrintSelf(ostream& os, vtkIndent indent) override;
/**
* Construct with s,t range=(0,1) and automatic plane generation turned on.
*/
static vtkTextureMapToPlane* New();
///@{
/**
* Specify a point defining the origin of the plane. Used in conjunction with
* the Point1 and Point2 ivars to specify a map plane.
*/
vtkSetVector3Macro(Origin, double);
vtkGetVectorMacro(Origin, double, 3);
///@}
///@{
/**
* Specify a point defining the first axis of the plane.
*/
vtkSetVector3Macro(Point1, double);
vtkGetVectorMacro(Point1, double, 3);
///@}
///@{
/**
* Specify a point defining the second axis of the plane.
*/
vtkSetVector3Macro(Point2, double);
vtkGetVectorMacro(Point2, double, 3);
///@}
///@{
/**
* Specify plane normal. An alternative way to specify a map plane. Using
* this method, the object will scale the resulting texture coordinate
* between the SRange and TRange specified.
*/
vtkSetVector3Macro(Normal, double);
vtkGetVectorMacro(Normal, double, 3);
///@}
///@{
/**
* Specify s-coordinate range for texture s-t coordinate pair.
*/
vtkSetVector2Macro(SRange, double);
vtkGetVectorMacro(SRange, double, 2);
///@}
///@{
/**
* Specify t-coordinate range for texture s-t coordinate pair.
*/
vtkSetVector2Macro(TRange, double);
vtkGetVectorMacro(TRange, double, 2);
///@}
///@{
/**
* Turn on/off automatic plane generation.
*/
vtkSetMacro(AutomaticPlaneGeneration, vtkTypeBool);
vtkGetMacro(AutomaticPlaneGeneration, vtkTypeBool);
vtkBooleanMacro(AutomaticPlaneGeneration, vtkTypeBool);
///@}
protected:
vtkTextureMapToPlane();
~vtkTextureMapToPlane() override = default;
int RequestData(vtkInformation*, vtkInformationVector**, vtkInformationVector*) override;
void ComputeNormal(vtkDataSet* output);
double Origin[3];
double Point1[3];
double Point2[3];
double Normal[3];
double SRange[2];
double TRange[2];
vtkTypeBool AutomaticPlaneGeneration;
private:
vtkTextureMapToPlane(const vtkTextureMapToPlane&) = delete;
void operator=(const vtkTextureMapToPlane&) = delete;
};
VTK_ABI_NAMESPACE_END
#endif
|
