VTK  9.0.1
vtkAbstractImageInterpolator.h
Go to the documentation of this file.
1 /*=========================================================================
2 
3  Program: Visualization Toolkit
4  Module: vtkAbstractImageInterpolator.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 =========================================================================*/
30 #ifndef vtkAbstractImageInterpolator_h
31 #define vtkAbstractImageInterpolator_h
32 
33 #include "vtkImagingCoreModule.h" // For export macro
34 #include "vtkObject.h"
35 
36 #define VTK_IMAGE_BORDER_CLAMP 0
37 #define VTK_IMAGE_BORDER_REPEAT 1
38 #define VTK_IMAGE_BORDER_MIRROR 2
39 
40 class vtkDataObject;
41 class vtkImageData;
42 class vtkDataArray;
45 
46 class VTKIMAGINGCORE_EXPORT vtkAbstractImageInterpolator : public vtkObject
47 {
48 public:
50  void PrintSelf(ostream& os, vtkIndent indent) override;
51 
55  virtual void Initialize(vtkDataObject* data);
56 
60  virtual void ReleaseData();
61 
66  void DeepCopy(vtkAbstractImageInterpolator* obj);
67 
73  void Update();
74 
82  double Interpolate(double x, double y, double z, int component);
83 
91  bool Interpolate(const double point[3], double* value);
92 
96  void SetOutValue(double outValue);
97  double GetOutValue() { return this->OutValue; }
98 
104  void SetTolerance(double tol);
105  double GetTolerance() { return this->Tolerance; }
106 
113  void SetComponentOffset(int offset);
114  int GetComponentOffset() { return this->ComponentOffset; }
115 
122  void SetComponentCount(int count);
123  int GetComponentCount() { return this->ComponentCount; }
124 
129  int ComputeNumberOfComponents(int inputComponents);
130 
136  int GetNumberOfComponents();
137 
139 
144  void InterpolateIJK(const double point[3], double* value);
145  void InterpolateIJK(const float point[3], float* value);
147 
149 
155  bool CheckBoundsIJK(const double x[3]);
156  bool CheckBoundsIJK(const float x[3]);
158 
160 
167  void SetBorderMode(int mode);
168  void SetBorderModeToClamp() { this->SetBorderMode(VTK_IMAGE_BORDER_CLAMP); }
169  void SetBorderModeToRepeat() { this->SetBorderMode(VTK_IMAGE_BORDER_REPEAT); }
170  void SetBorderModeToMirror() { this->SetBorderMode(VTK_IMAGE_BORDER_MIRROR); }
171  int GetBorderMode() { return this->BorderMode; }
172  const char* GetBorderModeAsString();
174 
182  void SetSlidingWindow(bool x);
183  void SlidingWindowOn() { this->SetSlidingWindow(true); }
184  void SlidingWindowOff() { this->SetSlidingWindow(false); }
185  bool GetSlidingWindow() { return this->SlidingWindow; }
186 
193  virtual void ComputeSupportSize(const double matrix[16], int support[3]) = 0;
194 
201  virtual bool IsSeparable() = 0;
202 
204 
214  virtual void PrecomputeWeightsForExtent(const double matrix[16], const int extent[6],
215  int checkExtent[6], vtkInterpolationWeights*& weights);
216  virtual void PrecomputeWeightsForExtent(const float matrix[16], const int extent[6],
217  int checkExtent[6], vtkInterpolationWeights*& weights);
219 
223  virtual void FreePrecomputedWeights(vtkInterpolationWeights*& weights);
224 
226 
232  void InterpolateRow(
233  vtkInterpolationWeights*& weights, int xIdx, int yIdx, int zIdx, double* value, int n);
234  void InterpolateRow(
235  vtkInterpolationWeights*& weights, int xIdx, int yIdx, int zIdx, float* value, int n);
237 
239 
242  vtkGetVector3Macro(Spacing, double);
244 
246 
249  vtkGetVector3Macro(Origin, double);
251 
253 
256  vtkGetVector6Macro(Extent, int);
258 
260 
264  VTK_LEGACY(int* GetWholeExtent());
265  VTK_LEGACY(void GetWholeExtent(int extent[6]));
267 
268 protected:
270  ~vtkAbstractImageInterpolator() override;
271 
275  virtual void InternalUpdate() = 0;
276 
280  virtual void InternalDeepCopy(vtkAbstractImageInterpolator* obj) = 0;
281 
283 
286  virtual void GetInterpolationFunc(
287  void (**doublefunc)(vtkInterpolationInfo*, const double[3], double*));
288  virtual void GetInterpolationFunc(
289  void (**floatfunc)(vtkInterpolationInfo*, const float[3], float*));
291 
293 
296  virtual void GetRowInterpolationFunc(
297  void (**doublefunc)(vtkInterpolationWeights*, int, int, int, double*, int));
298  virtual void GetRowInterpolationFunc(
299  void (**floatfunc)(vtkInterpolationWeights*, int, int, int, float*, int));
301 
303 
306  virtual void GetSlidingWindowFunc(
307  void (**doublefunc)(vtkInterpolationWeights*, int, int, int, double*, int));
308  virtual void GetSlidingWindowFunc(
309  void (**floatfunc)(vtkInterpolationWeights*, int, int, int, float*, int));
311 
313  double StructuredBoundsDouble[6];
314  float StructuredBoundsFloat[6];
315  int Extent[6];
316  double Spacing[3];
317  double Origin[3];
318  double OutValue;
319  double Tolerance;
324 
325  // information needed by the interpolator funcs
327 
328  void (*InterpolationFuncDouble)(
329  vtkInterpolationInfo* info, const double point[3], double* outPtr);
330  void (*InterpolationFuncFloat)(vtkInterpolationInfo* info, const float point[3], float* outPtr);
331 
332  void (*RowInterpolationFuncDouble)(
333  vtkInterpolationWeights* weights, int idX, int idY, int idZ, double* outPtr, int n);
334  void (*RowInterpolationFuncFloat)(
335  vtkInterpolationWeights* weights, int idX, int idY, int idZ, float* outPtr, int n);
336 
337 private:
339  void operator=(const vtkAbstractImageInterpolator&) = delete;
340 };
341 
342 inline void vtkAbstractImageInterpolator::InterpolateIJK(const double point[3], double* value)
343 {
344  this->InterpolationFuncDouble(this->InterpolationInfo, point, value);
345 }
346 
347 inline void vtkAbstractImageInterpolator::InterpolateIJK(const float point[3], float* value)
348 {
349  this->InterpolationFuncFloat(this->InterpolationInfo, point, value);
350 }
351 
352 inline bool vtkAbstractImageInterpolator::CheckBoundsIJK(const double x[3])
353 {
354  const double* bounds = this->StructuredBoundsDouble;
355  return !((x[0] < bounds[0]) || (x[0] > bounds[1]) || (x[1] < bounds[2]) || (x[1] > bounds[3]) ||
356  (x[2] < bounds[4]) || (x[2] > bounds[5]));
357 }
358 
359 inline bool vtkAbstractImageInterpolator::CheckBoundsIJK(const float x[3])
360 {
361  const float* bounds = this->StructuredBoundsFloat;
362  return !((x[0] < bounds[0]) || (x[0] > bounds[1]) || (x[1] < bounds[2]) || (x[1] > bounds[3]) ||
363  (x[2] < bounds[4]) || (x[2] > bounds[5]));
364 }
365 
367  vtkInterpolationWeights*& weights, int xIdx, int yIdx, int zIdx, double* value, int n)
368 {
369  this->RowInterpolationFuncDouble(weights, xIdx, yIdx, zIdx, value, n);
370 }
371 
373  vtkInterpolationWeights*& weights, int xIdx, int yIdx, int zIdx, float* value, int n)
374 {
375  this->RowInterpolationFuncFloat(weights, xIdx, yIdx, zIdx, value, n);
376 }
377 
378 #endif
interpolate data values from images
abstract base class for most VTK objects
Definition: vtkObject.h:62
void PrintSelf(ostream &os, vtkIndent indent) override
Methods invoked by print to print information about the object including superclasses.
void SetBorderModeToRepeat()
The border mode (default: clamp).
#define VTK_IMAGE_BORDER_REPEAT
#define VTK_IMAGE_BORDER_CLAMP
void InterpolateIJK(const double point[3], double *value)
A version of Interpolate that takes structured coords instead of data coords.
a simple class to control print indentation
Definition: vtkIndent.h:33
topologically and geometrically regular array of data
Definition: vtkImageData.h:41
abstract superclass for arrays of numeric data
Definition: vtkDataArray.h:49
int GetBorderMode()
The border mode (default: clamp).
void(* InterpolationFuncFloat)(vtkInterpolationInfo *info, const float point[3], float *outPtr)
#define VTK_IMAGE_BORDER_MIRROR
void(* RowInterpolationFuncDouble)(vtkInterpolationWeights *weights, int idX, int idY, int idZ, double *outPtr, int n)
bool CheckBoundsIJK(const double x[3])
Check an x,y,z point to see if it is within the bounds for the structured coords of the image...
void(* RowInterpolationFuncFloat)(vtkInterpolationWeights *weights, int idX, int idY, int idZ, float *outPtr, int n)
general representation of visualization data
Definition: vtkDataObject.h:59
void SetBorderModeToClamp()
The border mode (default: clamp).
void InterpolateRow(vtkInterpolationWeights *&weights, int xIdx, int yIdx, int zIdx, double *value, int n)
Get a row of samples, using the weights that were precomputed by PrecomputeWeightsForExtent.
void(* InterpolationFuncDouble)(vtkInterpolationInfo *info, const double point[3], double *outPtr)
void SetBorderModeToMirror()
The border mode (default: clamp).