VTK  9.1.0
vtkImageSincInterpolator.h
Go to the documentation of this file.
1/*=========================================================================
2
3 Program: Visualization Toolkit
4 Module: vtkImageSincInterpolator.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=========================================================================*/
40#ifndef vtkImageSincInterpolator_h
41#define vtkImageSincInterpolator_h
42
44#include "vtkImagingCoreModule.h" // For export macro
45
46#define VTK_LANCZOS_WINDOW 0
47#define VTK_KAISER_WINDOW 1
48#define VTK_COSINE_WINDOW 2
49#define VTK_HANN_WINDOW 3
50#define VTK_HAMMING_WINDOW 4
51#define VTK_BLACKMAN_WINDOW 5
52#define VTK_BLACKMAN_HARRIS3 6
53#define VTK_BLACKMAN_HARRIS4 7
54#define VTK_NUTTALL_WINDOW 8
55#define VTK_BLACKMAN_NUTTALL3 9
56#define VTK_BLACKMAN_NUTTALL4 10
57#define VTK_SINC_KERNEL_SIZE_MAX 32
58
59class vtkImageData;
61
62class VTKIMAGINGCORE_EXPORT vtkImageSincInterpolator : public vtkAbstractImageInterpolator
63{
64public:
67 void PrintSelf(ostream& os, vtkIndent indent) override;
68
70
78 virtual void SetWindowFunction(int mode);
79 void SetWindowFunctionToLanczos() { this->SetWindowFunction(VTK_LANCZOS_WINDOW); }
80 void SetWindowFunctionToKaiser() { this->SetWindowFunction(VTK_KAISER_WINDOW); }
81 void SetWindowFunctionToCosine() { this->SetWindowFunction(VTK_COSINE_WINDOW); }
82 void SetWindowFunctionToHann() { this->SetWindowFunction(VTK_HANN_WINDOW); }
83 void SetWindowFunctionToHamming() { this->SetWindowFunction(VTK_HAMMING_WINDOW); }
84 void SetWindowFunctionToBlackman() { this->SetWindowFunction(VTK_BLACKMAN_WINDOW); }
85 void SetWindowFunctionToBlackmanHarris3() { this->SetWindowFunction(VTK_BLACKMAN_HARRIS3); }
86 void SetWindowFunctionToBlackmanHarris4() { this->SetWindowFunction(VTK_BLACKMAN_HARRIS4); }
87 void SetWindowFunctionToNuttall() { this->SetWindowFunction(VTK_NUTTALL_WINDOW); }
90 int GetWindowFunction() { return this->WindowFunction; }
91 virtual const char* GetWindowFunctionAsString();
93
102 int GetWindowHalfWidth() { return this->WindowHalfWidth; }
103
109 void UseWindowParameterOn() { this->SetUseWindowParameter(1); }
110 void UseWindowParameterOff() { this->SetUseWindowParameter(0); }
111 int GetUseWindowParameter() { return this->UseWindowParameter; }
112
121 void SetWindowParameter(double parm);
122 double GetWindowParameter() { return this->WindowParameter; }
123
130 void ComputeSupportSize(const double matrix[16], int support[3]) override;
131
133
141 void SetBlurFactors(double x, double y, double z);
142 void SetBlurFactors(const double f[3]) { this->SetBlurFactors(f[0], f[1], f[2]); }
143 void GetBlurFactors(double f[3])
144 {
145 f[0] = this->BlurFactors[0];
146 f[1] = this->BlurFactors[1];
147 f[2] = this->BlurFactors[2];
148 }
149 double* GetBlurFactors() VTK_SIZEHINT(3) { return this->BlurFactors; }
151
162 void SetAntialiasing(int antialiasing);
163 void AntialiasingOn() { this->SetAntialiasing(1); }
164 void AntialiasingOff() { this->SetAntialiasing(0); }
165 int GetAntialiasing() { return this->Antialiasing; }
166
174 void SetRenormalization(int renormalization);
175 void RenormalizationOn() { this->SetRenormalization(1); }
176 void RenormalizationOff() { this->SetRenormalization(0); }
177 int GetRenormalization() { return this->Renormalization; }
178
183 bool IsSeparable() override;
184
186
196 void PrecomputeWeightsForExtent(const double matrix[16], const int extent[6], int newExtent[6],
197 vtkInterpolationWeights*& weights) override;
198 void PrecomputeWeightsForExtent(const float matrix[16], const int extent[6], int newExtent[6],
199 vtkInterpolationWeights*& weights) override;
201
206
207protected:
210
214 void InternalUpdate() override;
215
220
222
226 void (**doublefunc)(vtkInterpolationInfo*, const double[3], double*)) override;
228 void (**floatfunc)(vtkInterpolationInfo*, const float[3], float*)) override;
230
232
236 void (**doublefunc)(vtkInterpolationWeights*, int, int, int, double*, int)) override;
238 void (**floatfunc)(vtkInterpolationWeights*, int, int, int, float*, int)) override;
240
245
249 virtual void FreeKernelLookupTable();
250
253 float* KernelLookupTable[3];
254 int KernelSize[3];
257 double BlurFactors[3];
258 double LastBlurFactors[3];
261
262private:
264 void operator=(const vtkImageSincInterpolator&) = delete;
265};
266
267#endif
interpolate data values from images
topologically and geometrically regular array of data
Definition: vtkImageData.h:57
perform sinc interpolation on images
void SetWindowFunctionToKaiser()
The window function to use.
virtual void SetWindowFunction(int mode)
The window function to use.
void InternalDeepCopy(vtkAbstractImageInterpolator *obj) override
Copy the interpolator.
void SetWindowFunctionToCosine()
The window function to use.
virtual const char * GetWindowFunctionAsString()
The window function to use.
double * GetBlurFactors()
Blur the image by widening the windowed sinc kernel by the specified factors for the x,...
virtual void BuildKernelLookupTable()
Build the lookup tables used for the interpolation.
void SetWindowFunctionToLanczos()
The window function to use.
void GetBlurFactors(double f[3])
Blur the image by widening the windowed sinc kernel by the specified factors for the x,...
void SetWindowFunctionToBlackmanNuttall3()
The window function to use.
void GetInterpolationFunc(void(**doublefunc)(vtkInterpolationInfo *, const double[3], double *)) override
Get the interpolation functions.
void SetRenormalization(int renormalization)
Turn off renormalization.
void SetWindowFunctionToBlackmanHarris3()
The window function to use.
void SetUseWindowParameter(int val)
Turn this on in order to use SetWindowParameter.
void SetWindowFunctionToBlackmanNuttall4()
The window function to use.
void SetWindowFunctionToNuttall()
The window function to use.
void InternalUpdate() override
Update the interpolator.
void SetAntialiasing(int antialiasing)
Turn on antialiasing.
void FreePrecomputedWeights(vtkInterpolationWeights *&weights) override
Free the precomputed weights.
~vtkImageSincInterpolator() override
void GetInterpolationFunc(void(**floatfunc)(vtkInterpolationInfo *, const float[3], float *)) override
Get the interpolation functions.
void SetWindowHalfWidth(int n)
Set the window half-width, this must be an integer between 1 and 16, with a default value of 3.
void GetRowInterpolationFunc(void(**doublefunc)(vtkInterpolationWeights *, int, int, int, double *, int)) override
Get the row interpolation functions.
void SetBlurFactors(const double f[3])
Blur the image by widening the windowed sinc kernel by the specified factors for the x,...
void PrecomputeWeightsForExtent(const float matrix[16], const int extent[6], int newExtent[6], vtkInterpolationWeights *&weights) override
If the data is going to be sampled on a regular grid, then the interpolation weights can be precomput...
static vtkImageSincInterpolator * New()
void SetWindowFunctionToHann()
The window function to use.
int GetWindowFunction()
The window function to use.
virtual void FreeKernelLookupTable()
Free the kernel lookup tables.
void ComputeSupportSize(const double matrix[16], int support[3]) override
Get the support size for use in computing update extents.
void SetWindowFunctionToBlackman()
The window function to use.
bool IsSeparable() override
Returns true if the interpolator supports weight precomputation.
void SetWindowParameter(double parm)
Set the alpha parameter for the Kaiser window function.
void SetWindowFunctionToBlackmanHarris4()
The window function to use.
void SetWindowFunctionToHamming()
The window function to use.
void PrecomputeWeightsForExtent(const double matrix[16], const int extent[6], int newExtent[6], vtkInterpolationWeights *&weights) override
If the data is going to be sampled on a regular grid, then the interpolation weights can be precomput...
void PrintSelf(ostream &os, vtkIndent indent) override
Methods invoked by print to print information about the object including superclasses.
void GetRowInterpolationFunc(void(**floatfunc)(vtkInterpolationWeights *, int, int, int, float *, int)) override
Get the row interpolation functions.
void SetBlurFactors(double x, double y, double z)
Blur the image by widening the windowed sinc kernel by the specified factors for the x,...
a simple class to control print indentation
Definition: vtkIndent.h:43
@ mode
Definition: vtkX3D.h:253
@ extent
Definition: vtkX3D.h:351
#define VTK_HAMMING_WINDOW
#define VTK_KAISER_WINDOW
#define VTK_BLACKMAN_HARRIS4
#define VTK_HANN_WINDOW
#define VTK_NUTTALL_WINDOW
#define VTK_BLACKMAN_WINDOW
#define VTK_BLACKMAN_NUTTALL4
#define VTK_LANCZOS_WINDOW
#define VTK_COSINE_WINDOW
#define VTK_BLACKMAN_HARRIS3
#define VTK_BLACKMAN_NUTTALL3
#define VTK_SIZEHINT(...)