/usr/include/vtk-5.8/vtkPicker.h is in libvtk5-dev 5.8.0-5.
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 | /*=========================================================================
Program: Visualization Toolkit
Module: vtkPicker.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.
=========================================================================*/
// .NAME vtkPicker - superclass for 3D geometric pickers (uses ray cast)
// .SECTION Description
// vtkPicker is used to select instances of vtkProp3D by shooting a ray
// into a graphics window and intersecting with the actor's bounding box.
// The ray is defined from a point defined in window (or pixel) coordinates,
// and a point located from the camera's position.
//
// vtkPicker may return more than one vtkProp3D, since more than one bounding
// box may be intersected. vtkPicker returns an unsorted list of props that
// were hit, and a list of the corresponding world points of the hits.
// For the vtkProp3D that is closest to the camera, vtkPicker returns the
// pick coordinates in world and untransformed mapper space, the prop itself,
// the data set, and the mapper. For vtkPicker the closest prop is the one
// whose center point (i.e., center of bounding box) projected on the view
// ray is closest to the camera. Subclasses of vtkPicker use other methods
// for computing the pick point.
// .SECTION See Also
// vtkPicker is used for quick geometric picking. If you desire more precise
// picking of points or cells based on the geometry of any vtkProp3D, use the
// subclasses vtkPointPicker or vtkCellPicker. For hardware-accelerated
// picking of any type of vtkProp, use vtkPropPicker or vtkWorldPointPicker.
#ifndef __vtkPicker_h
#define __vtkPicker_h
#include "vtkAbstractPropPicker.h"
class vtkAbstractMapper3D;
class vtkDataSet;
class vtkTransform;
class vtkActorCollection;
class vtkProp3DCollection;
class vtkPoints;
class VTK_RENDERING_EXPORT vtkPicker : public vtkAbstractPropPicker
{
public:
static vtkPicker *New();
vtkTypeMacro(vtkPicker,vtkAbstractPropPicker);
void PrintSelf(ostream& os, vtkIndent indent);
// Description:
// Specify tolerance for performing pick operation. Tolerance is specified
// as fraction of rendering window size. (Rendering window size is measured
// across diagonal.)
vtkSetMacro(Tolerance,double);
vtkGetMacro(Tolerance,double);
// Description:
// Return position in mapper (i.e., non-transformed) coordinates of
// pick point.
vtkGetVectorMacro(MapperPosition,double,3);
// Description:
// Return mapper that was picked (if any).
vtkGetObjectMacro(Mapper,vtkAbstractMapper3D);
// Description:
// Get a pointer to the dataset that was picked (if any). If nothing
// was picked then NULL is returned.
vtkGetObjectMacro(DataSet,vtkDataSet);
// Description:
// Return a collection of all the prop 3D's that were intersected
// by the pick ray. This collection is not sorted.
vtkProp3DCollection *GetProp3Ds() {return this->Prop3Ds;};
// Description:
// Return a collection of all the actors that were intersected.
// This collection is not sorted. (This is a convenience method
// to maintain backward compatibility.)
vtkActorCollection *GetActors();
// Description:
// Return a list of the points the the actors returned by GetProp3Ds
// were intersected at. The order of this list will match the order of
// GetProp3Ds.
vtkPoints *GetPickedPositions() {return this->PickedPositions;};
// Description:
// Perform pick operation with selection point provided. Normally the
// first two values for the selection point are x-y pixel coordinate, and
// the third value is =0. Return non-zero if something was successfully
// picked.
virtual int Pick(double selectionX, double selectionY, double selectionZ,
vtkRenderer *renderer);
// Description:
// Perform pick operation with selection point provided. Normally the first
// two values for the selection point are x-y pixel coordinate, and the
// third value is =0. Return non-zero if something was successfully picked.
int Pick(double selectionPt[3], vtkRenderer *ren)
{return this->Pick(selectionPt[0], selectionPt[1], selectionPt[2], ren);};
protected:
vtkPicker();
~vtkPicker();
void MarkPicked(vtkAssemblyPath *path, vtkProp3D *p, vtkAbstractMapper3D *m,
double tMin, double mapperPos[3]);
virtual double IntersectWithLine(double p1[3], double p2[3], double tol,
vtkAssemblyPath *path, vtkProp3D *p,
vtkAbstractMapper3D *m);
virtual void Initialize();
double Tolerance; //tolerance for computation (% of window)
double MapperPosition[3]; //selection point in untransformed coordinates
vtkAbstractMapper3D *Mapper; //selected mapper (if the prop has a mapper)
vtkDataSet *DataSet; //selected dataset (if there is one)
double GlobalTMin; //parametric coordinate along pick ray where hit occured
vtkTransform *Transform; //use to perform ray transformation
vtkActorCollection *Actors; //candidate actors (based on bounding box)
vtkProp3DCollection *Prop3Ds; //candidate actors (based on bounding box)
vtkPoints *PickedPositions; // candidate positions
private:
vtkPicker(const vtkPicker&); // Not implemented.
void operator=(const vtkPicker&); // Not implemented.
};
#endif
|