HOpMoveHandle

class HOpMoveHandle

The HOpMoveHandle class selects/moves “handles” and their associated geometry.

HOpMoveHandle implements three mouse event methods defined on the base class and maps the event information to operator routines. This operation consists of the following steps:

  1. Left Button Down: The new handle object is selected.
  2. Left Button Down and Drag: Dragging the handle and associated geometry.
  3. Left Button Up: The operation ends.

More Detailed Description: see event methods.

Inherits from: HBaseOperator

Methods

HOpMoveHandle::HOpMoveHandle(HBaseView *view, bool allowSelect = true, int DoRepeat = 0, int DoCapture = 1)

Constructs an HOpMoveHandle object.

Parameters

view: A pointer to an HBaseView object.

allowSelect: Pass true to allow selection of different handle objects.

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 HOpMoveHandle::~HOpMoveHandle()

virtual

virtual char const *HOpMoveHandle::GetName()

virtual

Returns

A pointer to a character string denoting the name of the operator which is ‘HOpMoveHandle‘.
virtual int HOpMoveHandle::OnLButtonDown(HEventInfo &hevent)

virtual

OnLButtonDown selects an existing handle if the mouse is over a handle or designates a new object for handle based movement.

Parameters

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

Returns

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

virtual

OnLButtonDownAndMove moves/rotates/scales the handle and it’s associated geometry based on various constraints (ray, plane, etc).

Parameters

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

Returns

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

virtual

OnNoButtonDownAndMove activates handle in mouse cursor range.

Parameters

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

Returns

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

virtual

OnLButtonUp finalizes mouse movement and deselectes the active handle.

Parameters

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

Returns

An HOperatorReturn indicating the status of the event.
HC_KEY HOpMoveHandle::FindHandle(HEventInfo &hevent)

This method finds a handle based on the mouse position.

HC_KEY HOpMoveHandle::FindObject(HEventInfo &hevent, HC_KEY key, bool exclude = false)

This method finds geometry based on mouse position.

Parameters

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

key: Key of currently selected object.

exclude: Pass true to exclude currently selected object from search.

Returns

The key of the geometry at mouse position that serves as new handle target.
void HOpMoveHandle::SetupObject(HC_KEY key)

Creates handles for the choosen geometry.

Parameters

key: The key of the geometry to attach handles to.
void HOpMoveHandle::Reset()

Reset the operator so that no object or handle is currently selected for manipulation.

virtual HBaseOperator *HOpMoveHandle::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 HOpMoveHandle object.

Variables

HC_KEY HOpMoveHandle::m_pHandleKey

protected

HC_KEY

The key of the active handle.

HC_KEY HOpMoveHandle::m_pObjectKey

protected

HC_KEY

The key of the handle object.

bool HOpMoveHandle::m_bAllowSelect

protected

bool

If the value is true, this class allows selection of different handle objects. This is disabled for cutting planes.

HPoint HOpMoveHandle::m_windowspaceDelta

private