HOpCameraManipulate

class HOpCameraManipulate

The HOpCameraManipulate class combines the Orbit, Pan and Zoom Operators.

HOpCameraManipulate implements three mouse event methods defined on the base class and maps the event information to orbit, pan or zoom the camera. This operator has three modes of operation.

  1. With no key press, the camera orbits.
  2. With the Shift key down, the camera pans.
  3. With the Ctrl key down, the camer zooms.

More Detailed Description: see event methods.

Inherits from: HBaseOperator

Methods

HOpCameraManipulate::HOpCameraManipulate(HBaseView *view, int DoRepeat = 0, int DoCapture = 1, HBaseOperator *orbit = 0, HBaseOperator *pan = 0, HBaseOperator *zoom = 0, HBaseOperator *relative = 0, bool AllowHandleActivation = false)

Constructs an HOpCameraManipulate 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.

orbit: A pointer to an HOpCameraOrbit object. If you pass null, HOpCameraManipulate will make construct a new one.

pan: A pointer to an HOpCameraPan object. If you pass null, HOpCameraManipulate will make construct a new one.

zoom: A pointer to an HOpCameraZoom object. If you pass null, HOpCameraManipulate will make construct a new one.

relative: A pointer to an HOpCameraRelativeOrbit object. If you pass null, HOpCameraManipulate will make construct a new one.

AllowHandleActivation: Pass true to allow manipulation using handles.

virtual HOpCameraManipulate::~HOpCameraManipulate()

virtual

virtual char const *HOpCameraManipulate::GetName()

virtual

Returns

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

virtual

This method handles the left mouse button down event.

Parameters

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

Returns

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

virtual

This method handles the left mouse button down and move event. It determines if the shift or control key is down and then passes control over to the correct camera operator which can be pan, orbit or zoom.

Parameters

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

Returns

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

virtual

This method handles the left mouse button up event.

Parameters

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

Returns

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

virtual

This methods passes the event to the relative orbit camera operator’s left button mouse down event handler.

Parameters

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

Returns

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

virtual

This methods passes the event to the relative orbit camera operator’s left button mouse down and move event handler.

Parameters

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

Returns

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

virtual

This methods passes the event to the relative orbit camera operator’s left button mouse up event handler.

Parameters

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

Returns

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

virtual

This methods passes the event to the pan camera operator’s left button mouse down event handler.

Parameters

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

Returns

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

virtual

This methods passes the event to the pan camera operator’s left button mouse down and move event handler.

Parameters

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

Returns

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

virtual

This event handler passes the event to the pan camera operator’s OnLButtonUp handler.

Parameters

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

Returns

An HOperatorReturn indicating the status of the event.
virtual HBaseOperator *HOpCameraManipulate::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 HOpCameraManipulate object.
virtual bool HOpCameraManipulate::OperatorStarted()

virtual

Operator has been started if true, and has not been started if false.

HOpCameraOrbit *HOpCameraManipulate::GetOrbitOperator()

Returns

A pointer to the orbit operator.
void HOpCameraManipulate::HandleDblClk(float requested_time, float actual_time)

This method is the double click function called from timer callback.

Parameters

requested_time: The time that the event had requested.

actual_time: The actual time the event callback happened.

bool HOpCameraManipulate::GetLButtonDown()

Returns

The state of the left button down flag.

Variables

HTClient *HOpCameraManipulate::m_pDblClkTimer

protected

A pointer to the timer client for detection of double click events.

HBaseOperator *HOpCameraManipulate::m_pOrbitOperator

protected

A pointer to the orbit operator.

HBaseOperator *HOpCameraManipulate::m_pRelativeOrbitOperator

protected

A pointer to the relative orbit operator.

HBaseOperator *HOpCameraManipulate::m_pPanOperator

protected

A pointer to the pan operator.

HBaseOperator *HOpCameraManipulate::m_pZoomOperator

protected

A pointer to the zoom operator.

HPoint HOpCameraManipulate::m_ptRealOld

protected

For internal use only.

bool HOpCameraManipulate::m_bAllowHandleActivation

private

bool
bool HOpCameraManipulate::m_bLButtonDown

private

bool
bool HOpCameraManipulate::m_bLButtonUp

private

bool
bool HOpCameraManipulate::m_bForceDown

private

bool
HPoint HOpCameraManipulate::m_ptRealFirst

private

HEventInfo *HOpCameraManipulate::m_LastEvent

private

float HOpCameraManipulate::m_time

private

float