TSL3DInteractionModeTrackballEyepoint Class Reference

Inheritance diagram for TSL3DInteractionModeTrackballEyepoint:

Detailed Description

This is a simple interaction mode for handling pan to point.

The user's application creates an instance of one these classes and adds it to a TSLInteractionModeManager.

When the LButtonUp event occurs, the mode causes the current view of the TSL3DDrawingSurface to pan to the specified point.

When an RButtonUp event occurs, the mode resets to the default mode.

This is a simple interaction mode with similar behaviour to the NASA World Wind application in the default mode. In this mode, the tilt/rotate functionality rotates the eyepoint in the direction moved.

Thus:

LMB drag grabs and moves the current view. RMB up/down controls the tilt of the current view. RMB left/right rotates the current view. Wheel forward/back zooms in/out by the percentage specified in the constructor.

The user's application creates an instance of one these classes and adds it to a TSL3DInteractionModeManager.

Deprecated

Deprecated as of MapLink 11.1. Advised to use MapLink Earth SDK instead.

Public Member Functions
	TSL3DInteractionModeTrackballEyepoint (int modeID, int zoomPercentage=30, const char *prompt="Left button grab pan, Right button tilt/rotate, Wheel zoom")
virtual	~TSL3DInteractionModeTrackballEyepoint ()
void	activate ()
void	deactivate ()
virtual bool	onLButtonDown (TSLDeviceUnits x, TSLDeviceUnits y, bool shift, bool control)
virtual bool	onLButtonUp (TSLDeviceUnits x, TSLDeviceUnits y, bool shift, bool control)
virtual bool	onMouseMove (TSLButtonType button, TSLDeviceUnits x, TSLDeviceUnits y, bool shift, bool control)
virtual bool	onMouseWheel (short delta, TSLDeviceUnits x, TSLDeviceUnits y)
virtual bool	onRButtonDown (TSLDeviceUnits x, TSLDeviceUnits y, bool shift, bool control)
virtual bool	onRButtonUp (TSLDeviceUnits x, TSLDeviceUnits y, bool shift, bool control)
TSLCursorStyle	queryCursor ()
virtual const char *	queryPrompt ()
void *	operator new (size_t size) TSL_NO_THROW
void	operator delete (void *self)
void *	operator new (size_t size, char *filename, int line)
Public Member Functions inherited from TSL3DInteractionMode
virtual	~TSL3DInteractionMode ()
virtual void	onDraw (TSLDeviceUnits x1, TSLDeviceUnits y1, TSLDeviceUnits x2, TSLDeviceUnits y2)
virtual bool	onMButtonDown (TSLDeviceUnits x, TSLDeviceUnits y, bool shift, bool control)
virtual bool	onMButtonUp (TSLDeviceUnits x, TSLDeviceUnits y, bool shift, bool control)
virtual void	onSize (TSLDeviceUnits cx, TSLDeviceUnits cy)
virtual void	setDisplay (TSL3DInteractionModeDisplay *display)
int	id () const

Additional Inherited Members
Protected Member Functions inherited from TSL3DInteractionMode
	TSL3DInteractionMode (int modeID)
Protected Attributes inherited from TSL3DInteractionMode
int	m_id
TSL3DInteractionModeDisplay *	m_display
TSL3DInteractionCameraManager *	m_cameraManager
TSL3DDrawingSurface *	m_drawingSurface
bool	m_pressed

Constructor & Destructor Documentation

TSL3DInteractionModeTrackballEyepoint()

TSL3DInteractionModeTrackballEyepoint::TSL3DInteractionModeTrackballEyepoint	(	int	modeID,
		int	zoomPercentage = 30,
		const char *	prompt = "Left button grab pan, Right button tilt/rotate, Wheel zoom" )

See this class description and base class method description for further details

~TSL3DInteractionModeTrackballEyepoint()

virtual TSL3DInteractionModeTrackballEyepoint::~TSL3DInteractionModeTrackballEyepoint ( )

virtual

See this class description and base class method description for further details

Member Function Documentation

activate()

void TSL3DInteractionModeTrackballEyepoint::activate ( )

virtual

See this class description and base class method description for further details

Reimplemented from TSL3DInteractionMode.

deactivate()

void TSL3DInteractionModeTrackballEyepoint::deactivate ( )

virtual

See this class description and base class method description for further details

Reimplemented from TSL3DInteractionMode.

onLButtonDown()

virtual bool TSL3DInteractionModeTrackballEyepoint::onLButtonDown ( TSLDeviceUnits x, TSLDeviceUnits y, bool shift, bool control )

virtual

See this class description and base class method description for further details

Reimplemented from TSL3DInteractionMode.

onLButtonUp()

virtual bool TSL3DInteractionModeTrackballEyepoint::onLButtonUp ( TSLDeviceUnits x, TSLDeviceUnits y, bool shift, bool control )

virtual

See this class description and base class method description for further details

Reimplemented from TSL3DInteractionMode.

onMouseMove()

virtual bool TSL3DInteractionModeTrackballEyepoint::onMouseMove ( TSLButtonType button, TSLDeviceUnits x, TSLDeviceUnits y, bool shift, bool control )

virtual

See this class description and base class method description for further details

Reimplemented from TSL3DInteractionMode.

onMouseWheel()

virtual bool TSL3DInteractionModeTrackballEyepoint::onMouseWheel ( short delta, TSLDeviceUnits x, TSLDeviceUnits y )

virtual

Mouse wheel hander for interaction modes. This event will be passed on to the currently active mode.

Parameters

delta	Delta value of mouse wheel movement. See Windows help for further information.
(x,y)	Position of locator event, in device unit coordinates.

Returns

true if the view needs to be redrawn, false otherwise.

Reimplemented from TSL3DInteractionMode.

onRButtonDown()

virtual bool TSL3DInteractionModeTrackballEyepoint::onRButtonDown ( TSLDeviceUnits x, TSLDeviceUnits y, bool shift, bool control )

virtual

See this class description and base class method description for further details

Reimplemented from TSL3DInteractionMode.

onRButtonUp()

virtual bool TSL3DInteractionModeTrackballEyepoint::onRButtonUp ( TSLDeviceUnits x, TSLDeviceUnits y, bool shift, bool control )

virtual

See this class description and base class method description for further details

Reimplemented from TSL3DInteractionMode.

operator delete()

void TSL3DInteractionModeTrackballEyepoint::operator delete

(

void *

self

)

operator new() [1/2]

void * TSL3DInteractionModeTrackballEyepoint::operator new

(

size_t

size

)

operator new() [2/2]

void * TSL3DInteractionModeTrackballEyepoint::operator new	(	size_t	size,
		char *	filename,
		int	line )

When included in an MFC application in debug mode, the debug new expects this to be here. Override it and return the same as the normal one. The library must include it when compiled in release mode, since the user's application may be in debug mode.

queryCursor()

TSLCursorStyle TSL3DInteractionModeTrackballEyepoint::queryCursor ( )

virtual

See this class description and base class method description for further details

Reimplemented from TSL3DInteractionMode.

queryPrompt()

virtual const char * TSL3DInteractionModeTrackballEyepoint::queryPrompt ( )

virtual

See this class description and base class method description for further details

Reimplemented from TSL3DInteractionMode.