This file is indexed.

/usr/include/gofigure2/vtkViewImage2D.h is in libgofigure-dev 0.9.0-3+b1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  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
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
/*========================================================================
 Copyright (c) INRIA - ASCLEPIOS Project (http://www-sop.inria.fr/asclepios).
 All rights reserved.

 Redistribution and use in source and binary forms, with or without
 modification, are permitted provided that the following conditions are met:

 * Redistributions of source code must retain the above copyright notice,
 this list of conditions and the following disclaimer.

 * Redistributions in binary form must reproduce the above copyright notice,
 this list of conditions and the following disclaimer in the documentation
 and/or other materials provided with the distribution.

 * Neither the name of INRIA or ASCLEPIOS, nor the names of any contributors
 may be used to endorse or promote products derived from this software
 without specific prior written permission.

 * Modified source versions must be plainly marked as such, and must not be
 misrepresented as being the original software.

 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER AND CONTRIBUTORS ``AS IS''
 AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE FOR
 ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
 SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
 CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
 OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 =========================================================================*/

/*=========================================================================
 Modifications were made by the GoFigure Dev. Team.
 while at Megason Lab, Systems biology, Harvard Medical school, 2009-11

 Copyright (c) 2009-11, President and Fellows of Harvard College.
 All rights reserved.

 Redistribution and use in source and binary forms, with or without
 modification, are permitted provided that the following conditions are met:

 Redistributions of source code must retain the above copyright notice,
 this list of conditions and the following disclaimer.
 Redistributions in binary form must reproduce the above copyright notice,
 this list of conditions and the following disclaimer in the documentation
//  and/or other materials provided with the distribution.
 Neither the name of the  President and Fellows of Harvard College
 nor the names of its contributors may be used to endorse or promote
 products derived from this software without specific prior written
 permission.

 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
 THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS
 BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
 OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
 OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
 OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
 WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
 OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
 ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

 =========================================================================*/

#ifndef _vtkViewImage2D_h_
#define _vtkViewImage2D_h_

#include "vtkViewImage.h"
#include "MegaVTK2Configure.h"

#include <map>
#include <list>

#include "vtkTransform.h"
#include "vtkImageActor.h"
#include "vtkInteractorStyleImage2D.h"
#include "vtkSmartPointer.h"

class vtkPlane;
class vtkViewImage2DCommand;
class vtkTransform;
class vtkInteractorStyle;
class vtkInteractorStyleRubberBandZoom;
class vtkOrientationAnnotation;
class vtkPointHandleRepresentation2D;
class vtkCursor2D;
class vtkCellPicker;
class vtkActor;
// class vtkQuadricLODActor;

/**
 * \class vtkViewImage2D
 * \ingroup MegaVTK
 * \brief Basic class to handle 2D/3D items such as images and polydatas
 * visualization in 2D
 */
class VTK_RENDERINGADDON2_EXPORT vtkViewImage2D:public vtkViewImage
{
public:

  /**
   * \brief Convenient method to access the constructor.
   */
  static vtkViewImage2D * New();

  vtkTypeRevisionMacro(vtkViewImage2D, vtkViewImage);
  /**
     \brief The orientation of the view is a abstract representation of the object
     we are looking at. It results from the acquisition plane. Setting the View
     Orientation by calling SetViewOrientation() will imply the view to set its
     inner "slice" orientation. (slice orientation == 2 means plane of
     acquisition.)

     \note The view orientations defined here are orthogonal to the normal basis
     in the scanner. A very interesting improvement would be to define "oblique"
     view orientations for cardiac imaging, something like:

     VIEW_ORIENTATION_SHORT_AXIS, VIEW_ORIENTATION_LONG_AXIS, and
     VIEW_ORIENTATION_FOUR_CHAMBER could define the different views that are
     usually used in cardiac imaging.

     From this user-input information, the idea would be to evaluate which slice
     orientation does correspond to the requested view. This can be done by
     evaluating the dot product between the axis of acquisition and a
     pre-defined oblique axis that "should" correspond to the requested
     orientation...
  **/
  //BTX
  enum {
    VIEW_ORIENTATION_SAGITTAL = 0,
    VIEW_ORIENTATION_CORONAL = 1,
    VIEW_ORIENTATION_AXIAL = 2
    };
  //ETX
  /**
     Description:
  **/
  //BTX
  enum {
    VIEW_CONVENTION_RADIOLOGICAL = 0,
    VIEW_CONVENTION_NEUROLOGICAL = 1
    };
  //ETX
  /**
     Description:
     These types describe the behaviour
     of the interactor style.
  */
  //BTX
  enum {
    INTERACTOR_STYLE_NAVIGATION = 0,
    INTERACTOR_STYLE_RUBBER_ZOOM
    };
  //ETX

  enum ORIENTATION {
    XY = 0,
    XZ = 1,
    YZ = 2
    };

  /**
   * \brief Get the polydata representing the Slice Plane
   *
   * The SlicePlane instance (GetSlicePlane()) is the polygonal
   * square corresponding to the slice plane,
   * it is updated each time the slice changes,
   * and is color-coded according to conventions
  */
  vtkGetObjectMacro(SlicePlane, vtkPolyData);

  /**
   * \brief Get the orientation annotation.
   * This annotation describes the orientation of the slice plane,
   * according to the rule
   * Right(R)-Left(L) Anterior(A)-Posterior(P) Inferior(I)-Superior(S)
 */
  vtkGetObjectMacro(OrientationAnnotation, vtkOrientationAnnotation);

  /**
   * \brief The world is not always what we think it is ...
   * Use this method to move the viewer slice such that the position
   * (in world coordinates) given by the arguments is contained by
   * the slice plane. If the given position is outside the bounds
   * of the image, then the slice will be as close as possible.
   */
  virtual void SetWorldCoordinates(double pos[3]);

  /**
   * \brief Set/Get the current slice to display (depending on the orientation
   * this can be in X, Y or Z).
   */
  virtual void SetSlice(int s);

  /**
   * \brief Get the view orientation
   * \return 0: radiological, 1: anatomic
   *
   * Instead of setting the slice orientation to an axis (YZ - XZ - XY),
   * you can force the view to be axial (foot-head), coronal (front-back),
   * or sagittal (left-right). It will just use the OrientationMatrix
   * (GetOrientationMatrix()) to check which slice orientation to pick.
  */
  vtkGetMacro(ViewOrientation, int);

  virtual void SetViewOrientation(int orientation);

  virtual void SetOrientationMatrix(vtkMatrix4x4 *matrix);

  /**
   * \brief Get the view orientation
   * \return 0: sagittal, 1: coronal, 2: axial
   *
   * The ViewConvention instance explains where to place the camera around
   * the patient. Default behaviour is Radiological convention, meaning
   * we respectively look at the patient from his feet, his face and his left
   * ear.
   * For Neurological convention, we respectively look from the top of his head,
   * the the back of his head, and his left ear.
   */
  vtkGetMacro(ViewConvention, int);
  virtual void SetViewConvention(int convention);

  /**
   * \brief Convert an indices coordinate point (image coordinates) into a world
   * coordinate point
  */
  virtual double * GetWorldCoordinatesForSlice(int slice);

  /**
   * \brief Convert a world coordinate point into an image indices coordinate point
  */
  virtual int GetSliceForWorldCoordinates(double pos[3]);
  /**
   * \brief Reset the 3D position to center
  */
  virtual void ResetPosition(void);

  /**
   * \brief Reset position - zoom - window/level to default
  */
  virtual void Reset(void);

  /**
   * \brief Reset the camera in a nice way for the 2D view
   */
  virtual void ResetCamera(void);

  /**
   * \brief Set the zoom factor in the views
   */
  vtkSetMacro(Zoom, double);

  /**
   * \brief Get the zoom factor in the views
   * \return double representing the zoom factor
   */
  vtkGetMacro(Zoom, double);

  /**
   * \brief Useful method that transform a display position into a world corrdinate point
  */
  virtual double *GetWorldCoordinatesFromDisplayPosition(int xy[2]);
  virtual double * GetWorldCoordinatesFromDisplayPosition(const int & x,
                                                          const int & y);

  //BTX
  /**
     Access to the command of the viewer.
     This instance is in charge of observing the interactorstyle (GetInteractorStyle())
     and update things accordingly in the view (i.e. the slice number when moving slice).
  */
  vtkGetObjectMacro (Command, vtkViewImage2DCommand);
  //ETX

  /**
   * \brief Set whether or not the interpolation between pixels should be activated.
   * It is Off by default
   * \param[in] val 0: interpolation off, 1: interpolation on
  */
  virtual void SetInterpolate(const int & val);

  /**
   * \brief Get whether or not the interpolation between pixels should be activated.
   * It is Off by default
   * \return val 0: interpolation off, 1: interpolation on
  */
  virtual int GetInterpolate();

  vtkBooleanMacro (Interpolate, int);

  /**
   * \brief Add a dataset to the view (has to be subclass of vtkPointSet).
   * The dataset will be cut through the implicit slice plane
   * (GetImplicitSlicePlane()).
   * This results in a loss of dimensionality, i.e. tetrahedron will be displayed
   * as triangles, triangles as lines, lines as points.
   * A vtkProperty of the dataset can be specified.
   *
   * \param[in] dataset Data to be displayed (shape, position, etc.)
   * \param[in] property Property of the data to be displayed (color, opacity, etc.)
   * \param[in] intersection Display projection or intersection of the dataset with the current slice
   * \param[in] iDataVisibility Visibility of the current actor
  */
  virtual vtkActor * AddDataSet(vtkPolyData *polydata,
                                vtkProperty *property = NULL,
                                const bool & intersection = true,
                                const bool & iDataVisibility = false);

  /**
   * \brief Set the camera motion vector
  */
  vtkSetVector3Macro(CameraMotionVector, double);

  /**
   * \brief Get the camera motion vector
   * \return double[3] containing the motion vector
  */
  vtkGetVector3Macro(CameraMotionVector, double);

  /**
   * \brief Set the annotation visibility
  */
  virtual void SetShowAnnotations(const int & iShowAnnotations);
  /**
   * \brief Get the annotation visibility
   * \return 0: not visible, 1:visible
  */
  vtkGetMacro(ShowAnnotations, int);
  /**
   * \brief Show/Hide the annotations.
  */
  vtkBooleanMacro(ShowAnnotations, int);

  /**
   * \brief Set camera focal point and position
   * \param[in] focal double[3] containing the focal point of the camera
   * \param[in] pos double[3] containing the position of the camera
  */
  void SetCameraFocalAndPosition(double focal[3], double pos[3]);

  /**
   * \brief Set camera focal point and position
   * \param[out] focal double[3] containing the focal point of the camera
   * \param[out] pos double[3] containing the position of the camera
  */
  void GetCameraFocalAndPosition(double focal[3], double pos[3]);

  /**
     Access to the position of the center of the view.
     CAUTION: for the moment this feature is de-activated because updating it
     slows down the visualization process.
  */
  /**
   * \brief Get the view center
   * \return double[3] containing the center of the view
  */
  vtkGetVector3Macro (ViewCenter, double);

  /**
   * \brief Update the orientation
  */
  virtual void Update(void)
  { this->UpdateOrientation(); }

  /**
   * \brief Set interaction style to Default mode:
   * Left button: Window level
   * Right button: Zoom
   * Middle button: Pan
   * Wheel: Throught volume
  */
  void SetDefaultInteractionStyle(void)
  {
    vtkInteractorStyleImage2D *t = vtkInteractorStyleImage2D::SafeDownCast (this->InteractorStyle);

    if ( t )
      {
      t->SetDefaultMode();
      }
  }

  /**
   * \brief Set interaction style to Zoom mode:
   * All buttons: Zoom
  */
  void SetZoomInteractionStyle(void)
  {
    vtkInteractorStyleImage2D *t = vtkInteractorStyleImage2D::SafeDownCast (this->InteractorStyle);

    if ( t )
      {
      t->SetZoomMode();
      }
  }

  /**
   * \brief Set interaction style to Pan mode:
   * All buttons: Pan
  */
  void SetPanInteractionStyle(void)
  {
    vtkInteractorStyleImage2D *t = vtkInteractorStyleImage2D::SafeDownCast (this->InteractorStyle);

    if ( t )
      {
      t->SetPanMode();
      }
  }

  /**
   * \brief Set interaction style to Zoom mode:
   * The actor the mouse is highlighted in addition to the Default Mode.
  */
  void SetPickInteractionStyle(void)
  {
    vtkInteractorStyleImage2D *t = vtkInteractorStyleImage2D::SafeDownCast (this->InteractorStyle);

    if ( t )
      {
      t->SetPickMode();
      }
  }


  /*
   * \brief Synchronize the views
   * \param[in] iSynchronize Enable/disable synchronization
   */
  void SynchronizeViews( bool iSynchronize)
  {
    vtkInteractorStyleImage2D *t = vtkInteractorStyleImage2D::SafeDownCast (this->InteractorStyle);
    if ( t )
      {
      t->SynchronizeViews(iSynchronize);
      }
  }

  /**
     Access to the actor corresponding to the cursor. It follows the mouse cursor
     everywhere it goes, and can be activated by pressing 'c'
  */
  vtkGetObjectMacro (Cursor, vtkPointHandleRepresentation2D);
  vtkGetObjectMacro (CursorGenerator, vtkCursor2D);

  /**
   * \brief Add contours with specific properties to the view
   */
  template< class TContourContainer,
            class TPropertyContainer >
  void AddContours(TContourContainer & iContours,
                   TPropertyContainer & iProperty,
                   const bool & iIntersection = true)
  {
    if ( iContours.size() != iProperty.size() )
      {
      vtkWarningMacro(<< "iContours.size() != iProperty.size()");
      return;
      }

    typedef typename TContourContainer::iterator  ContourContainerIterator;
    typedef typename TPropertyContainer::iterator PropertyContainerIterator;

    ContourContainerIterator contour_it = iContours.begin();
    ContourContainerIterator contour_end = iContours.end();

    PropertyContainerIterator prop_it = iProperty.begin();
    PropertyContainerIterator prop_end = iProperty.end();

    while ( contour_it != contour_end )
      {
      this->AddDataSet(*contour_it, *prop_it, iIntersection);
      ++contour_it;
      ++prop_it;
      }
  }

  /**
   *
   */
/*
  template<class TContourContainer>
  void RemoveContours(TContourContainer& iContours)
  {
    typedef typename TContourContainer::iterator ContourContainerIterator;
    ContourContainerIterator contour_it = iContours.begin();
    ContourContainerIterator contour_end = iContours.end();

    while (contour_it != contour_end)
      {
      this->RemoveDataSet(*contour_it);
      ++contour_it;
      }
  }
*/
  std::map<double, vtkActor *> ExtractActors(
    vtkPolyData *iDataSet, ORIENTATION iOrientation);

protected:

  vtkViewImage2D();
  ~vtkViewImage2D();

  virtual void UpdateSlicePlane(void);

  virtual void UpdateCenter(void);

  virtual void UpdateOrientation();

  virtual void PostUpdateOrientation(void);

  virtual void SetSlicePlaneFromOrientation(void);

  virtual int  SetCameraFromOrientation(void);

  virtual void SetAnnotationsFromOrientation(void);

  /**
   * \brief After the orientation has changed, it is crucial to adapt
   * a couple of things according to new orientation.
   * Thus UpdateOrientation() is here overwritten and calls
   * PostUpdateOrientation(), where the SlicePlane, the Camera settings,
   * the CornerAnnotation, and the SliceImplicitPlane are modified.
  */
  virtual void SetImplicitPlaneFromOrientation(void);

  /**
   * \brief Update the cursor position and the CornerAnnotation (top-left) according
   * to current mouse position.
  */
  ///\todo This may has to be modified as with this configuration, the user has
  // no possibility of changing the upper-left corner annotation because it is
  // bypassed by this method at each mouse movement.
  virtual void UpdateCursor(void);

  /**
   * \brief This method is called each time the orientation changes (SetViewOrientation())
   * and sets the appropriate color to the slice plane.
   * Red: R-L direction --> sagittal orientation
   * Green: A-P direction --> coronal orientation
   * Blue: I-S direction --> axial orientation
  */
  virtual void InitializeSlicePlane(void);

  /**
   * \brief Overwrite of the Superclass InstallPipeline() method in order to set up the
   * home made InteractorStyle, and make it observe all events we need
  */
  virtual void InstallPipeline(void);

  virtual int SetCameraToConvention(void);

  virtual void SetAnnotationToConvention(void);

  virtual void SetSlicePlaneToConvention(unsigned int axis);

  vtkMatrix4x4 *ConventionMatrix;

  vtkSmartPointer< vtkPlane > SliceImplicitPlane;

  /**
   * \brief This polydata instance is a square colored (see InitializeSlicePlane()) according to the
   * orientation of the view. It follows the image actor and is used by other view to display
   * intersections between views.
  */
  vtkPolyData *SlicePlane;
  /**
   * \brief Get the orientation annotation. This annotation describes the orientation
   * of the slice plane, according to the rule
   * Right(R)-Left(L) Anterior(A)-Posterior(P) Inferior(I)-Superior(S)
  */
  vtkOrientationAnnotation *OrientationAnnotation;

  vtkInteractorStyle *InteractorStyleSwitcher;
  /**
   * \brief InteractorStyle used in this view. It is a vtkInteractorStyleImage2D by default
   * but can be set to vtkInteractorStyleRubberBandZoom with SetInteractorStyleType().
   * Rubber band zoom is in beta. Prefer using default behaviour.
  */
  vtkInteractorStyleRubberBandZoom *InteractorStyleRubberZoom;
  /**
   * \brief Access to the command of the viewer.
   * This instance is in charge of observing the interactorstyle (GetInteractorStyle())
   * and update things accordingly in the view (i.e. the slice number when moving slice).
  */
  vtkViewImage2DCommand *Command;
  /**
   * \brief Access to the actor corresponding to the cursor. It follows the mouse cursor
   * everywhere it goes, and can be activated by pressing 'c'
  */
  vtkPointHandleRepresentation2D *Cursor;
  /**
   * \brief Access to the actor corresponding to the cursor. It follows the mouse cursor
   * everywhere it goes, and can be activated by pressing 'c'
  */
  vtkCursor2D *CursorGenerator;

  int ViewOrientation;
  int ViewConvention;
  int InteractorStyleType;

  double ViewCenter[3];

  char SliceAndWindowInformation[64];
  char ImageInformation[64];

  double Zoom;
  double CameraMotionVector[3];
};

#endif /* _vtkViewImage2D_h_ */