forked from Kitware/VTK
-
Notifications
You must be signed in to change notification settings - Fork 0
/
vtkTextureMapToPlane.h
137 lines (117 loc) · 4.2 KB
/
vtkTextureMapToPlane.h
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
128
129
130
131
132
133
134
135
136
137
/*=========================================================================
Program: Visualization Toolkit
Module: vtkTextureMapToPlane.h
Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
All rights reserved.
See Copyright.txt or http://www.kitware.com/Copyright.htm for details.
This software is distributed WITHOUT ANY WARRANTY; without even
the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the above copyright notice for more information.
=========================================================================*/
/**
* @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
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;
};
#endif