HOpMoveHandle

Functions

	HOpMoveHandle
	~HOpMoveHandle
char const *	GetName
int	OnLButtonDown
int	OnLButtonDownAndMove
int	OnNoButtonDownAndMove
int	OnLButtonUp
HC_KEY	FindHandle
HC_KEY	FindObject
void	SetupObject
void	Reset
HBaseOperator *	Clone

Detailed Description

class HOpMoveHandle : public HBaseOperator

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.

Public Functions

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()

virtual char const *GetName()

Returns

A pointer to a character string denoting the name of the operator which is ‘HOpMoveHandle’.

virtual int OnLButtonDown(HEventInfo &hevent)

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 OnLButtonDownAndMove(HEventInfo &hevent)

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 OnNoButtonDownAndMove(HEventInfo &hevent)

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 OnLButtonUp(HEventInfo &hevent)

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 FindHandle(HEventInfo &hevent)

This method finds a handle based on the mouse position.

HC_KEY 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 SetupObject(HC_KEY key)

Creates handles for the choosen geometry.

Parameters

key – The key of the geometry to attach handles to.

void Reset()

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

virtual HBaseOperator *Clone()

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.