You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
260 lines
8.7 KiB
C++
260 lines
8.7 KiB
C++
/*=========================================================================
|
|
|
|
Program: Visualization Toolkit
|
|
Module: vtkAbstractPolygonalHandleRepresentation3D.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.
|
|
|
|
=========================================================================*/
|
|
/**
|
|
* @class vtkAbstractPolygonalHandleRepresentation3D
|
|
* @brief represent a user defined handle geometry in 3D while maintaining a fixed orientation w.r.t the camera.
|
|
*
|
|
* This class serves as the geometrical representation of a vtkHandleWidget.
|
|
* The handle can be represented by an arbitrary polygonal data (vtkPolyData),
|
|
* set via SetHandle(vtkPolyData *). The actual position of the handle
|
|
* will be initially assumed to be (0,0,0). You can specify an offset from
|
|
* this position if desired. This class differs from
|
|
* vtkPolygonalHandleRepresentation3D in that the handle will always remain
|
|
* front facing, ie it maintains a fixed orientation with respect to the
|
|
* camera. This is done by using vtkFollowers internally to render the actors.
|
|
* @sa
|
|
* vtkPolygonalHandleRepresentation3D vtkHandleRepresentation vtkHandleWidget
|
|
*/
|
|
|
|
#ifndef vtkAbstractPolygonalHandleRepresentation3D_h
|
|
#define vtkAbstractPolygonalHandleRepresentation3D_h
|
|
|
|
#include "vtkInteractionWidgetsModule.h" // For export macro
|
|
#include "vtkHandleRepresentation.h"
|
|
|
|
class vtkProperty;
|
|
class vtkPolyDataMapper;
|
|
class vtkCellPicker;
|
|
class vtkTransformPolyDataFilter;
|
|
class vtkMatrixToLinearTransform;
|
|
class vtkMatrix4x4;
|
|
class vtkPolyData;
|
|
class vtkAbstractTransform;
|
|
class vtkActor;
|
|
class vtkFollower;
|
|
class vtkVectorText;
|
|
|
|
class VTKINTERACTIONWIDGETS_EXPORT vtkAbstractPolygonalHandleRepresentation3D
|
|
: public vtkHandleRepresentation
|
|
{
|
|
public:
|
|
|
|
//@{
|
|
/**
|
|
* Standard methods for instances of this class.
|
|
*/
|
|
vtkTypeMacro(vtkAbstractPolygonalHandleRepresentation3D,vtkHandleRepresentation);
|
|
void PrintSelf(ostream& os, vtkIndent indent);
|
|
//@}
|
|
|
|
//@{
|
|
/**
|
|
* Set the position of the point in world and display coordinates.
|
|
*/
|
|
virtual void SetWorldPosition(double p[3]);
|
|
virtual void SetDisplayPosition(double p[3]);
|
|
//@}
|
|
|
|
//@{
|
|
/**
|
|
* Set/get the handle polydata.
|
|
*/
|
|
void SetHandle( vtkPolyData * );
|
|
vtkPolyData * GetHandle();
|
|
//@}
|
|
|
|
//@{
|
|
/**
|
|
* Set/Get the handle properties when unselected and selected.
|
|
*/
|
|
void SetProperty(vtkProperty*);
|
|
void SetSelectedProperty(vtkProperty*);
|
|
vtkGetObjectMacro(Property,vtkProperty);
|
|
vtkGetObjectMacro(SelectedProperty,vtkProperty);
|
|
//@}
|
|
|
|
/**
|
|
* Get the transform used to transform the generic handle polydata before
|
|
* placing it in the render window
|
|
*/
|
|
virtual vtkAbstractTransform * GetTransform();
|
|
|
|
//@{
|
|
/**
|
|
* Methods to make this class properly act like a vtkWidgetRepresentation.
|
|
*/
|
|
virtual void BuildRepresentation();
|
|
virtual void StartWidgetInteraction(double eventPos[2]);
|
|
virtual void WidgetInteraction(double eventPos[2]);
|
|
virtual int ComputeInteractionState(int X, int Y, int modify=0);
|
|
//@}
|
|
|
|
//@{
|
|
/**
|
|
* Methods to make this class behave as a vtkProp.
|
|
*/
|
|
virtual void ShallowCopy(vtkProp *prop);
|
|
virtual void DeepCopy(vtkProp *prop);
|
|
virtual void GetActors(vtkPropCollection *);
|
|
virtual void ReleaseGraphicsResources(vtkWindow *);
|
|
virtual int RenderOpaqueGeometry(vtkViewport *viewport);
|
|
virtual int RenderTranslucentPolygonalGeometry(vtkViewport *viewport);
|
|
virtual int HasTranslucentPolygonalGeometry();
|
|
virtual double *GetBounds();
|
|
//@}
|
|
|
|
//@{
|
|
/**
|
|
* A label may be associated with the seed. The string can be set via
|
|
* SetLabelText. The visibility of the label can be turned on / off.
|
|
*/
|
|
vtkSetMacro( LabelVisibility, int );
|
|
vtkGetMacro( LabelVisibility, int );
|
|
vtkBooleanMacro( LabelVisibility, int );
|
|
virtual void SetLabelText( const char * label );
|
|
virtual char * GetLabelText();
|
|
//@}
|
|
|
|
//@{
|
|
/**
|
|
* Scale text (font size along each dimension).
|
|
*/
|
|
virtual void SetLabelTextScale( double scale[3] );
|
|
void SetLabelTextScale(double x, double y, double z)
|
|
{
|
|
double scale[3] = {x, y, z};
|
|
this->SetLabelTextScale(scale);
|
|
}
|
|
virtual double * GetLabelTextScale();
|
|
//@}
|
|
|
|
//@{
|
|
/**
|
|
* Get the label text actor
|
|
*/
|
|
vtkGetObjectMacro( LabelTextActor, vtkFollower );
|
|
//@}
|
|
|
|
/**
|
|
* The handle may be scaled uniformly in all three dimensions using this
|
|
* API. The handle can also be scaled interactively using the right
|
|
* mouse button.
|
|
*/
|
|
virtual void SetUniformScale( double scale );
|
|
|
|
//@{
|
|
/**
|
|
* Toogle the visibility of the handle on and off
|
|
*/
|
|
vtkSetMacro( HandleVisibility, int );
|
|
vtkGetMacro( HandleVisibility, int );
|
|
vtkBooleanMacro( HandleVisibility, int );
|
|
//@}
|
|
|
|
void Highlight(int highlight);
|
|
|
|
//@{
|
|
/**
|
|
* Turn on/off smooth motion of the handle. See the documentation of
|
|
* MoveFocusRequest for details. By default, SmoothMotion is ON. However,
|
|
* in certain applications the user may want to turn it off. For instance
|
|
* when using certain specific PointPlacer's with the representation such
|
|
* as the vtkCellCentersPointPlacer, which causes the representation to
|
|
* snap to the center of cells, or using a vtkPolygonalSurfacePointPlacer
|
|
* which constrains the widget to the surface of a mesh. In such cases,
|
|
* inherent restrictions on handle placement might conflict with a request
|
|
* for smooth motion of the handles.
|
|
*/
|
|
vtkSetMacro( SmoothMotion, int );
|
|
vtkGetMacro( SmoothMotion, int );
|
|
vtkBooleanMacro( SmoothMotion, int );
|
|
//@}
|
|
|
|
protected:
|
|
vtkAbstractPolygonalHandleRepresentation3D();
|
|
~vtkAbstractPolygonalHandleRepresentation3D();
|
|
|
|
vtkActor * Actor;
|
|
vtkPolyDataMapper * Mapper;
|
|
vtkTransformPolyDataFilter * HandleTransformFilter;
|
|
vtkMatrixToLinearTransform * HandleTransform;
|
|
vtkMatrix4x4 * HandleTransformMatrix;
|
|
vtkCellPicker * HandlePicker;
|
|
double LastPickPosition[3];
|
|
double LastEventPosition[2];
|
|
int ConstraintAxis;
|
|
vtkProperty * Property;
|
|
vtkProperty * SelectedProperty;
|
|
int WaitingForMotion;
|
|
int WaitCount;
|
|
int HandleVisibility;
|
|
|
|
// Register internal Pickers within PickingManager
|
|
virtual void RegisterPickers();
|
|
|
|
// Methods to manipulate the cursor
|
|
virtual void Translate(double *p1, double *p2);
|
|
virtual void Scale(double *p1, double *p2, double eventPos[2]);
|
|
virtual void MoveFocus(double *p1, double *p2);
|
|
|
|
void CreateDefaultProperties();
|
|
|
|
// Given a motion vector defined by p1 --> p2 (p1 and p2 are in
|
|
// world coordinates), the new display position of the handle center is
|
|
// populated into requestedDisplayPos. This is again only a request for the
|
|
// new display position. It is up to the point placer to deduce the
|
|
// appropriate world co-ordinates that this display position will map into.
|
|
// The placer may even disallow such a movement.
|
|
// If "SmoothMotion" is OFF, the returned requestedDisplayPos is the same
|
|
// as the event position, ie the location of the mouse cursor. If its OFF,
|
|
// incremental offsets as described above are used to compute it.
|
|
void MoveFocusRequest( double *p1, double *p2,
|
|
double eventPos[2], double requestedDisplayPos[3] );
|
|
|
|
int DetermineConstraintAxis(int constraint, double *x, double *startPickPos);
|
|
|
|
/**
|
|
* Update the actor position. Different subclasses handle this differently.
|
|
* For instance vtkPolygonalHandleRepresentation3D updates the handle
|
|
* transformation and sets this on the handle.
|
|
* vtkOrientedPolygonalHandleRepresentation3D, which uses a vtkFollower to
|
|
* keep the handle geometry facinig the camera handles this differently. This
|
|
* is an opportunity for subclasses to update the actor's position etc each
|
|
* time the handle is rendered.
|
|
*/
|
|
virtual void UpdateHandle();
|
|
|
|
/**
|
|
* Opportunity to update the label position and text during each render.
|
|
*/
|
|
virtual void UpdateLabel();
|
|
|
|
// Handle the label.
|
|
int LabelVisibility;
|
|
vtkFollower *LabelTextActor;
|
|
vtkPolyDataMapper *LabelTextMapper;
|
|
vtkVectorText *LabelTextInput;
|
|
bool LabelAnnotationTextScaleInitialized;
|
|
int SmoothMotion;
|
|
|
|
private:
|
|
vtkAbstractPolygonalHandleRepresentation3D(const vtkAbstractPolygonalHandleRepresentation3D&) VTK_DELETE_FUNCTION;
|
|
void operator=(const vtkAbstractPolygonalHandleRepresentation3D&) VTK_DELETE_FUNCTION;
|
|
};
|
|
|
|
#endif
|
|
|
|
|