HOpObjectTranslate
-
class
HOpObjectTranslate The
HOpObjectTranslateclass translates a selected object.HOpObjectTranslates implements three of the mouse event handlers defined on the base class and maps the event information to HOOPS routines which translates the currently selected objects. This provides the basic functionality for applying a translation transform to an object (as opposed to a global panning of the camera which affects the entire scene). The operation consists of the following steps:
- Left Button Down: The operation is initiated and an object is selected.
- Left Button Down and Drag: The object is translated using spriting.
- Left Button Up: The translation is finalized and the operation ends.
More Detailed Description: see event methods.
Inherits from:
HBaseOperator
Methods
-
HOpObjectTranslate::HOpObjectTranslate(HBaseView *view, int DoRepeat = 0, int DoCapture = 1) Constructs an
HOpObjectTranslateobject.Parameters
view: A pointer to an
HBaseViewobject,DoRepeat: An integer denoting whether this is a repeatable operator. This parameter has been deprecated.
DoCapture: An integer denoting whether the mouse state should be captured, which means that all mouse events should be received after a mousedown, even if it leaves the window. This parameter has been deprecated.
-
virtual
HOpObjectTranslate::~HOpObjectTranslate() virtual
-
virtual char const *
HOpObjectTranslate::GetName() virtual
Returns
A pointer to a character string denoting the name of the operator which is ‘HOpObjectTranslate‘.
-
virtual int
HOpObjectTranslate::OnLButtonDown(HEventInfo &hevent) virtual
OnLButtonDown records the first pointer position and initializes the translation mechanism.
Parameters
hevent: AnHEventInfoobject containing information about the current event.Returns
AnHOperatorReturnindicating the status of the event.
-
virtual int
HOpObjectTranslate::OnLButtonDownAndMove(HEventInfo &hevent) virtual
OnLButtonDownAndMove computes the translation transform based on the distance between the first and current pointer positions, and translates the object accordingly.
Parameters
hevent: AnHEventInfoobject containing information about the current event.Returns
AnHOperatorReturnindicating the status of the event.
-
virtual int
HOpObjectTranslate::OnLButtonUp(HEventInfo &hevent) virtual
OnLButtonUp cleans up the construction segments used during the transformation and ends the operation.
Parameters
hevent: AnHEventInfoobject containing information about the current event.Returns
AnHOperatorReturnindicating the status of the event.
-
virtual int
HOpObjectTranslate::OnLButtonDblClk(HEventInfo &hevent) virtual
OnLButtonDblClk translates the object back to its original location.
Parameters
hevent: AnHEventInfoobject containing information about the current event.Returns
AnHOperatorReturnindicating the status of the event.
-
virtual HBaseOperator *
HOpObjectTranslate::Clone() virtual
Creates a new operator which is a copy of the current operator. The user is responsible for deleting the newly created operator.
Returns
A pointer to the newly createdHOpObjectTranslateobject.
-
virtual void
HOpObjectTranslate::UpdateKeyList(void *data) virtual
This method is used to update the list of keys to translate when the selection list changes.
-
void
HOpObjectTranslate::Init() protected
This method initializes the selected entities and turns on spriting.
-
void
HOpObjectTranslate::Cleanup() protected
This method cleans up the selected entities and turns off spriting if appropriate.
-
int
HOpObjectTranslate::GetMatrix(HEventInfo &hevent, int key_count, HC_KEY const *full_path_keys, float matrix_out[]) protected
For internal use only. This method does the computation work to compose a translation matrix that makes objects follow the mouse pointer. It copies the matrix contents into matrix_out so that they may be applied to arbitrary targets. It takes key as an argument because the required transformation can depend on segments’ pre-existing modelling matrices. Currently, it assumes that the input key is a segment.
Parameters
hevent: An
HEventInfoobject containing information about the current event.key_count: The number of keys in the full segment path.
full_path_keys: The keys of each segment in the full segment path.
matrix_out: A pointer to an array of 16 floats. Called by reference, returned to user.
Returns
An integer value indicating success or failure.
-
int
HOpObjectTranslate::UpdateMousePos(HEventInfo &hevent) protected
For internal use only. This method updates the internal state needed for matrix calculations.
Parameters
hevent: AnHEventInfoobject containing information about the current event.Returns
An integer value indicating success or failure.
Variables
-
HPoint
HOpObjectTranslate::m_ptRecent -
A pointer to the current position in world coordinates.
-
HPoint
HOpObjectTranslate::m_ptRecentVP -
A pointer to the current position in viewpoint (screen) coordinates.
-
bool
HOpObjectTranslate::m_bTemporarySelection protected
boolThis boolean indicates whether object was temporarily selected.
-
bool
HOpObjectTranslate::m_bInitialMatrix protected
boolThe initial modelling matrix.
-
HKeyList *
HOpObjectTranslate::m_KeyList protected
HKeyListA List of keys to translate (copied from selection set).
-
HPoint
HOpObjectTranslate::m_ptLast protected
-
unsigned long
HOpObjectTranslate::m_cookie[2] private
unsigned longCookies from notification subscription in
HBaseView.