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
|
/*=========================================================================
Program: Visualization Toolkit
Module: vtkImageTransform.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 vtkImageTransform
* @brief helper class to transform output of non-axis-aligned images
*
* vtkImageTransform is a helper class to transform the output of
* image filters (i.e., filter that input vtkImageData) by applying the
* Index to Physical transformation frmo the input image, which can
* include origin, spacing, direction. The transformation process is
* threaded with vtkSMPTools for performance.
*
* Typically in application the single method TransformPointSet() is
* invoked to transform the output of an image algorithm (assuming
* that the image's direction/orientation matrix is
* non-identity). Note that vtkPointSets encompass vtkPolyData as well
* as vtkUnstructuredGrids. In the future other output types may be
* added. Note that specific methods for transforming points, normals,
* and vectors is also provided by this class in case additional
* output data arrays need to be transformed (since
* TransformPointSet() only processes data arrays labeled as points,
* normals, and vectors).
*
* @warning
* This class has been threaded with vtkSMPTools. Using TBB or other
* non-sequential type (set in the CMake variable
* VTK_SMP_IMPLEMENTATION_TYPE) may improve performance significantly.
*
*/
#ifndef vtkImageTransform_h
#define vtkImageTransform_h
#include "vtkCommonDataModelModule.h" // For export macro
#include "vtkObject.h"
class vtkDataArray;
class vtkImageData;
class vtkMatrix3x3;
class vtkMatrix4x4;
class vtkPointSet;
class VTKCOMMONDATAMODEL_EXPORT vtkImageTransform : public vtkObject
{
public:
//@{
/**
* Standard methods for construction, type information, printing.
*/
static vtkImageTransform* New();
vtkTypeMacro(vtkImageTransform, vtkObject);
void PrintSelf(ostream& os, vtkIndent indent) override;
//@}
/**
* Given a vtkImageData (and hence its associated orientation
* matrix), and an instance of vtkPointSet, transform its points, as
* well as any normals and vectors, associated with the
* vtkPointSet. This is a convenience function, internally it calls
* TranslatePoints(), TransformPoints(), TransformNormals(), and/or
* TransformVectors() as appropriate. Note that both the normals and
* vectors associated with the point and cell data are transformed.
*/
static void TransformPointSet(vtkImageData* im, vtkPointSet* ps);
/**
* Given x-y-z points represented by a vtkDataArray,
* translate the points using the image origin. This
* method is useful if there is no orientation or
* spacing to apply.
*/
static void TranslatePoints(double* t, vtkDataArray* da);
/**
* Given x-y-z points represented by a vtkDataArray,
* transform the points using the matrix provided.
*/
static void TransformPoints(vtkMatrix4x4* m4, vtkDataArray* da);
/**
* Given three-component normals represented by a vtkDataArray,
* transform the normals using the matrix provided.
*/
static void TransformNormals(vtkMatrix3x3* m3, double spacing[3], vtkDataArray* da);
/**
* Given three-component vectors represented by a vtkDataArray,
* transform the vectors using the matrix provided.
*/
static void TransformVectors(vtkMatrix3x3* m3, double spacing[3], vtkDataArray* da);
protected:
vtkImageTransform() {}
~vtkImageTransform() override {}
private:
vtkImageTransform(const vtkImageTransform&) = delete;
void operator=(const vtkImageTransform&) = delete;
};
#endif
|
