packages/wxvtk/src/wxvtkImageViewer2.h

   1 /*
   2  # ---------------------------------------------------------------------
   3  #
   4  # Copyright (c) CREATIS (Centre de Recherche en Acquisition et Traitement de l'Image
   5  #                        pour la SantÈ)
   6  # Authors : Eduardo Davila, Frederic Cervenansky, Claire Mouton
   7  # Previous Authors : Laurent Guigues, Jean-Pierre Roux
   8  # CreaTools website : www.creatis.insa-lyon.fr/site/fr/creatools_accueil
   9  #
  10  #  This software is governed by the CeCILL-B license under French law and
  11  #  abiding by the rules of distribution of free software. You can  use,
  12  #  modify and/ or redistribute the software under the terms of the CeCILL-B
  13  #  license as circulated by CEA, CNRS and INRIA at the following URL
  14  #  http://www.cecill.info/licences/Licence_CeCILL-B_V1-en.html
  15  #  or in the file LICENSE.txt.
  16  #
  17  #  As a counterpart to the access to the source code and  rights to copy,
  18  #  modify and redistribute granted by the license, users are provided only
  19  #  with a limited warranty  and the software's author,  the holder of the
  20  #  economic rights,  and the successive licensors  have only  limited
  21  #  liability.
  22  #
  23  #  The fact that you are presently reading this means that you have had
  24  #  knowledge of the CeCILL-B license and that you accept its terms.
  25  # ------------------------------------------------------------------------ */
  26
  27
  28 /*=========================================================================
  29
  30   Program:   Visualization Toolkit
  31   Module:    $RCSfile: wxvtkImageViewer2.h,v $
  32
  33   Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
  34   All rights reserved.
  35   See Copyright.txt or http://www.kitware.com/Copyright.htm for details.
  36
  37      This software is distributed WITHOUT ANY WARRANTY; without even
  38      the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
  39      PURPOSE.  See the above copyright notice for more information.
  40
  41 =========================================================================*/
  42 // .NAME wxvtkImageViewer2 - Display a 2D image.
  43 // .SECTION Description
  44 // wxvtkImageViewer2 is a convenience class for displaying a 2D image.  It
  45 // packages up the functionality found in vtkRenderWindow, vtkRenderer,
  46 // vtkImageActor and vtkImageMapToWindowLevelColors into a single easy to use
  47 // class.  This class also creates an image interactor style
  48 // (vtkInteractorStyleImage) that allows zooming and panning of images, and
  49 // supports interactive window/level operations on the image. Note that
  50 // wxvtkImageViewer2 is simply a wrapper around these classes.
  51 //
  52 // wxvtkImageViewer2 uses the 3D rendering and texture mapping engine
  53 // to draw an image on a plane.  This allows for rapid rendering,
  54 // zooming, and panning. The image is placed in the 3D scene at a
  55 // depth based on the z-coordinate of the particular image slice. Each
  56 // call to SetSlice() changes the image data (slice) displayed AND
  57 // changes the depth of the displayed slice in the 3D scene. This can
  58 // be controlled by the AutoAdjustCameraClippingRange ivar of the
  59 // InteractorStyle member.
  60 //
  61 // It is possible to mix images and geometry, using the methods:
  62 //
  63 // viewer->SetInput( myImage );
  64 // viewer->GetRenderer()->AddActor( myActor );
  65 //
  66 // This can be used to annotate an image with a PolyData of "edges" or
  67 // or highlight sections of an image or display a 3D isosurface
  68 // with a slice from the volume, etc. Any portions of your geometry
  69 // that are in front of the displayed slice will be visible; any
  70 // portions of your geometry that are behind the displayed slice will
  71 // be obscured. A more general framework (with respect to viewing
  72 // direction) for achieving this effect is provided by the
  73 // vtkImagePlaneWidget .
  74 //
  75 // Note that pressing 'r' will reset the window/level and pressing
  76 // shift+'r' or control+'r' will reset the camera.
  77 //
  78 // .SECTION See Also
  79 // vtkRenderWindow vtkRenderer vtkImageActor vtkImageMapToWindowLevelColors
  80
  81 #ifndef __wxvtkImageViewer2_h
  82 #define __wxvtkImageViewer2_h
  83
  84 #include "vtkObject.h"
  85
  86 class vtkAlgorithmOutput;
  87 class vtkImageActor;
  88 class vtkImageData;
  89 class vtkImageMapToWindowLevelColors;
  90 class vtkInteractorStyleImage;
  91 class vtkRenderWindow;
  92 class vtkRenderer;
  93 class vtkRenderWindowInteractor;
  94
  95 class /*VTK_RENDERING_EXPORT*/ wxvtkImageViewer2 : public vtkObject
  96 {
  97 public:
  98   static wxvtkImageViewer2 *New();
  99
 100 //EED 2017-01-01 Migration VTK7
 101 #if VTK_MAJOR_VERSION <= 5
 102   vtkTypeRevisionMacro(wxvtkImageViewer2,vtkObject);
 103 #else
 104   vtkTypeMacro(wxvtkImageViewer2,vtkObject);
 105 #endif
 106
 107   void PrintSelf(ostream& os, vtkIndent indent);
 108
 109   // Description:
 110   // Get the name of rendering window.
 111   virtual const char *GetWindowName();
 112
 113   // Description:
 114   // Render the resulting image.
 115   virtual void Render(void);
 116
 117   // Description:
 118   // Set/Get the input image to the viewer.
 119   virtual void SetInput(vtkImageData *in);
 120   virtual vtkImageData *GetInput();
 121   virtual void SetInputConnection(vtkAlgorithmOutput* input);
 122
 123   // Description:
 124   // Set/get the slice orientation
 125   //BTX
 126   enum
 127   {
 128     SLICE_ORIENTATION_YZ = 0,
 129     SLICE_ORIENTATION_XZ = 1,
 130     SLICE_ORIENTATION_XY = 2
 131   };
 132   //ETX
 133   vtkGetMacro(SliceOrientation, int);
 134   virtual void SetSliceOrientation(int orientation);
 135   virtual void SetSliceOrientationToXY()
 136     { this->SetSliceOrientation(wxvtkImageViewer2::SLICE_ORIENTATION_XY); };
 137   virtual void SetSliceOrientationToYZ()
 138     { this->SetSliceOrientation(wxvtkImageViewer2::SLICE_ORIENTATION_YZ); };
 139   virtual void SetSliceOrientationToXZ()
 140     { this->SetSliceOrientation(wxvtkImageViewer2::SLICE_ORIENTATION_XZ); };
 141
 142   // Description:
 143   // Set/Get the current slice to display (depending on the orientation
 144   // this can be in X, Y or Z).
 145   vtkGetMacro(Slice, int);
 146   virtual void SetSlice(int s);
 147
 148   // Description:
 149   // Update the display extent manually so that the proper slice for the
 150   // given orientation is displayed. It will also try to set a
 151   // reasonable camera clipping range.
 152   // This method is called automatically when the Input is changed, but
 153   // most of the time the input of this class is likely to remain the same,
 154   // i.e. connected to the output of a filter, or an image reader. When the
 155   // input of this filter or reader itself is changed, an error message might
 156   // be displayed since the current display extent is probably outside
 157   // the new whole extent. Calling this method will ensure that the display
 158   // extent is reset properly.
 159   virtual void UpdateDisplayExtent();
 160
 161   // Description:
 162   // Return the minimum and maximum slice values (depending on the orientation
 163   // this can be in X, Y or Z).
 164   virtual int GetSliceMin();
 165   virtual int GetSliceMax();
 166   virtual void GetSliceRange(int range[2])
 167     { this->GetSliceRange(range[0], range[1]); }
 168   virtual void GetSliceRange(int &min, int &max);
 169   virtual int* GetSliceRange();
 170
 171   // Description:
 172   // Set window and level for mapping pixels to colors.
 173   virtual double GetColorWindow();
 174   virtual double GetColorLevel();
 175   virtual void SetColorWindow(double s);
 176   virtual void SetColorLevel(double s);
 177
 178   // Description:
 179   // These are here when using a Tk window.
 180   virtual void SetDisplayId(void *a);
 181   virtual void SetWindowId(void *a);
 182   virtual void SetParentId(void *a);
 183
 184   // Description:
 185   // Set/Get the position in screen coordinates of the rendering window.
 186   virtual int* GetPosition();
 187   virtual void SetPosition(int a,int b);
 188   virtual void SetPosition(int a[2]) { this->SetPosition(a[0],a[1]); }
 189
 190   // Description:
 191   // Set/Get the size of the window in screen coordinates in pixels.
 192   virtual int* GetSize();
 193   virtual void SetSize(int a, int b);
 194   virtual void SetSize(int a[2]) { this->SetSize(a[0],a[1]); }
 195
 196   // Description:
 197   // Get the internal render window, renderer, image actor, and
 198   // image map instances.
 199   vtkGetObjectMacro(RenderWindow,vtkRenderWindow);
 200   vtkGetObjectMacro(Renderer, vtkRenderer);
 201   vtkGetObjectMacro(ImageActor,vtkImageActor);
 202   vtkGetObjectMacro(WindowLevel,vtkImageMapToWindowLevelColors);
 203   vtkGetObjectMacro(InteractorStyle,vtkInteractorStyleImage);
 204
 205   // Description:
 206   // Set your own renderwindow and renderer
 207   virtual void SetRenderWindow(vtkRenderWindow *arg);
 208   virtual void SetRenderer(vtkRenderer *arg);
 209
 210   // Description:
 211   // Attach an interactor for the internal render window.
 212   virtual void SetupInteractor(vtkRenderWindowInteractor*);
 213
 214   // Description:
 215   // Create a window in memory instead of on the screen. This may not
 216   // be supported for every type of window and on some windows you may
 217   // need to invoke this prior to the first render.
 218   virtual void SetOffScreenRendering(int);
 219   virtual int GetOffScreenRendering();
 220   vtkBooleanMacro(OffScreenRendering,int);
 221
 222   // Description:
 223   // @deprecated Replaced by wxvtkImageViewer2::GetSliceMin() as of VTK 5.0.
 224   VTK_LEGACY(int GetWholeZMin());
 225
 226   // Description:
 227   // @deprecated Replaced by wxvtkImageViewer2::GetSliceMax() as of VTK 5.0.
 228   VTK_LEGACY(int GetWholeZMax());
 229
 230   // Description:
 231   // @deprecated Replaced by wxvtkImageViewer2::GetSlice() as of VTK 5.0.
 232   VTK_LEGACY(int GetZSlice());
 233
 234   // Description:
 235   // @deprecated Replaced by wxvtkImageViewer2::SetSlice() as of VTK 5.0.
 236   VTK_LEGACY(void SetZSlice(int));
 237
 238 protected:
 239   wxvtkImageViewer2();
 240   ~wxvtkImageViewer2();
 241
 242   virtual void InstallPipeline();
 243   virtual void UnInstallPipeline();
 244
 245   vtkImageMapToWindowLevelColors  *WindowLevel;
 246   vtkRenderWindow                 *RenderWindow;
 247   vtkRenderer                     *Renderer;
 248   vtkImageActor                   *ImageActor;
 249   vtkRenderWindowInteractor       *Interactor;
 250   vtkInteractorStyleImage         *InteractorStyle;
 251
 252   int SliceOrientation;
 253   int FirstRender;
 254   int Slice;
 255
 256   virtual void UpdateOrientation();
 257
 258 private:
 259   wxvtkImageViewer2(const wxvtkImageViewer2&);  // Not implemented.
 260   void operator=(const wxvtkImageViewer2&);  // Not implemented.
 261 };
 262
 263 #endif
 264
 265