HOpObjectTranslate

class HOpObjectTranslate

The HOpObjectTranslate class 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:

  1. Left Button Down: The operation is initiated and an object is selected.
  2. Left Button Down and Drag: The object is translated using spriting.
  3. 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 HOpObjectTranslate object.

Parameters

view: A pointer to an HBaseView object,

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: An HEventInfo object containing information about the current event.

Returns

An HOperatorReturn indicating 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: An HEventInfo object containing information about the current event.

Returns

An HOperatorReturn indicating 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: An HEventInfo object containing information about the current event.

Returns

An HOperatorReturn indicating the status of the event.
virtual int HOpObjectTranslate::OnLButtonDblClk(HEventInfo &hevent)

virtual

OnLButtonDblClk translates the object back to its original location.

Parameters

hevent: An HEventInfo object containing information about the current event.

Returns

An HOperatorReturn indicating 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 created HOpObjectTranslate object.
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 HEventInfo object 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: An HEventInfo object 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

bool

This boolean indicates whether object was temporarily selected.

bool HOpObjectTranslate::m_bInitialMatrix

protected

bool

The initial modelling matrix.

HKeyList *HOpObjectTranslate::m_KeyList

protected

HKeyList

A List of keys to translate (copied from selection set).

HPoint HOpObjectTranslate::m_ptLast

protected

unsigned long HOpObjectTranslate::m_cookie[2]

private

unsigned long

Cookies from notification subscription in HBaseView.