Main Page   Class Hierarchy   Alphabetical List   Compound List   File List   Compound Members   File Members   Related Pages  

graphics/vtkPicker.h

Go to the documentation of this file.
00001 /*=========================================================================
00002 
00003   Program:   Visualization Toolkit
00004   Module:    $RCSfile: vtkPicker.h,v $
00005   Language:  C++
00006 
00007 
00008 Copyright (c) 1993-2001 Ken Martin, Will Schroeder, Bill Lorensen 
00009 All rights reserved.
00010 
00011 Redistribution and use in source and binary forms, with or without
00012 modification, are permitted provided that the following conditions are met:
00013 
00014  * Redistributions of source code must retain the above copyright notice,
00015    this list of conditions and the following disclaimer.
00016 
00017  * Redistributions in binary form must reproduce the above copyright notice,
00018    this list of conditions and the following disclaimer in the documentation
00019    and/or other materials provided with the distribution.
00020 
00021  * Neither name of Ken Martin, Will Schroeder, or Bill Lorensen nor the names
00022    of any contributors may be used to endorse or promote products derived
00023    from this software without specific prior written permission.
00024 
00025  * Modified source versions must be plainly marked as such, and must not be
00026    misrepresented as being the original software.
00027 
00028 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS''
00029 AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
00030 IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
00031 ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE FOR
00032 ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
00033 DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
00034 SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
00035 CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
00036 OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
00037 OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
00038 
00039 =========================================================================*/
00064 #ifndef __vtkPicker_h
00065 #define __vtkPicker_h
00066 
00067 #include "vtkObject.h"
00068 #include "vtkAbstractPropPicker.h"
00069 #include "vtkRenderer.h"
00070 #include "vtkActor.h"
00071 #include "vtkActorCollection.h"
00072 #include "vtkProp3DCollection.h"
00073 #include "vtkMapper.h"
00074 #include "vtkTransform.h"
00075 
00076 class VTK_EXPORT vtkPicker : public vtkAbstractPropPicker
00077 {
00078 public:
00079   static vtkPicker *New();
00080   vtkTypeMacro(vtkPicker,vtkAbstractPropPicker);
00081   void PrintSelf(ostream& os, vtkIndent indent);
00082 
00086   vtkSetMacro(Tolerance,float);
00087   vtkGetMacro(Tolerance,float);
00088 
00091   vtkGetVectorMacro(MapperPosition,float,3);
00092 
00094   vtkGetObjectMacro(Mapper,vtkAbstractMapper3D);
00095 
00098   vtkGetObjectMacro(DataSet,vtkDataSet);
00099 
00102   vtkProp3DCollection *GetProp3Ds() {return this->Prop3Ds;};
00103 
00107   vtkActorCollection *GetActors() {
00108     if (this->Actors->GetNumberOfItems() != 
00109    this->PickedPositions->GetNumberOfPoints()) {
00110       vtkWarningMacro(<<"Not all Prop3Ds are actors, use GetProp3Ds instead");}
00111     return this->Actors; };
00112 
00116   vtkPoints *GetPickedPositions() {return this->PickedPositions;};
00117   
00122   virtual int Pick(float selectionX, float selectionY, float selectionZ, 
00123                    vtkRenderer *renderer);  
00124 
00129   int Pick(float selectionPt[3], vtkRenderer *ren)
00130     {return this->Pick(selectionPt[0], selectionPt[1], selectionPt[2], ren);};
00131       
00132 protected:
00133   vtkPicker();
00134   ~vtkPicker();
00135   vtkPicker(const vtkPicker&) {};
00136   void operator=(const vtkPicker&) {};
00137 
00138   void MarkPicked(vtkAssemblyPath *path, vtkProp3D *p, vtkAbstractMapper3D *m, 
00139                   float tMin, float mapperPos[3]);
00140   virtual float IntersectWithLine(float p1[3], float p2[3], float tol, 
00141                                   vtkAssemblyPath *path, vtkProp3D *p, 
00142                                   vtkAbstractMapper3D *m);
00143   virtual void Initialize();
00144 
00145   float Tolerance; //tolerance for computation (% of window)
00146   float MapperPosition[3]; //selection point in untransformed coordinates
00147 
00148   vtkAbstractMapper3D *Mapper; //selected mapper (if the prop has a mapper)
00149   vtkDataSet *DataSet; //selected dataset (if there is one)
00150 
00151   float GlobalTMin; //parametric coordinate along pick ray where hit occured
00152   vtkTransform *Transform; //use to perform ray transformation
00153   vtkActorCollection *Actors; //candidate actors (based on bounding box)
00154   vtkProp3DCollection *Prop3Ds; //candidate actors (based on bounding box)
00155   vtkPoints *PickedPositions; // candidate positions
00156   
00157 };
00158 
00159 
00160 #endif
00161 
00162 

Generated on Wed Nov 21 12:27:01 2001 for VTK by doxygen1.2.11.1 written by Dimitri van Heesch, © 1997-2001