TSL3DInteractionModeTrackballWorld Class Reference

Inheritance diagram for TSL3DInteractionModeTrackballWorld:

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 Google Earth application in the default TrackBall mode. In this mode, the tilt/rotate functionality rotates the world in the direction moved. Google Earth is a trademark of Google Inc.

Thus:

LMB drag grabs and moves the current view. MMB up/down controls the tilt of the current view. MMB left/right rotates the current view. RMB drag up/down zooms the current view out/in by percentage specified in the constructor. Wheel forward/back zooms out/in by 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
	TSL3DInteractionModeTrackballWorld (int modeID, int zoomPercentage=30, const char *prompt="Left button grab pan, Middle button tilt/rotate, Right button/Wheel zoom")
virtual	~TSL3DInteractionModeTrackballWorld ()
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	onMButtonDown (TSLDeviceUnits x, TSLDeviceUnits y, bool shift, bool control)
virtual bool	onMButtonUp (TSLDeviceUnits x, TSLDeviceUnits y, bool shift, bool control)
virtual bool	onRButtonDown (TSLDeviceUnits x, TSLDeviceUnits y, bool shift, bool control)
virtual bool	onRButtonUp (TSLDeviceUnits x, TSLDeviceUnits y, bool shift, bool control)
virtual bool	onMouseWheel (short delta, TSLDeviceUnits x, TSLDeviceUnits y)
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 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

TSL3DInteractionModeTrackballWorld()

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

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

~TSL3DInteractionModeTrackballWorld()

virtual TSL3DInteractionModeTrackballWorld::~TSL3DInteractionModeTrackballWorld ( )

virtual

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

Member Function Documentation

activate()

void TSL3DInteractionModeTrackballWorld::activate ( )

virtual

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

Reimplemented from TSL3DInteractionMode.

deactivate()

void TSL3DInteractionModeTrackballWorld::deactivate ( )

virtual

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

Reimplemented from TSL3DInteractionMode.

onLButtonDown()

virtual bool TSL3DInteractionModeTrackballWorld::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 TSL3DInteractionModeTrackballWorld::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.

onMButtonDown()

virtual bool TSL3DInteractionModeTrackballWorld::onMButtonDown ( TSLDeviceUnits x, TSLDeviceUnits y, bool shift, bool control )

virtual

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

Reimplemented from TSL3DInteractionMode.

onMButtonUp()

virtual bool TSL3DInteractionModeTrackballWorld::onMButtonUp ( 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 TSL3DInteractionModeTrackballWorld::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 TSL3DInteractionModeTrackballWorld::onMouseWheel ( short delta, TSLDeviceUnits x, TSLDeviceUnits y )

virtual

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

Reimplemented from TSL3DInteractionMode.

onRButtonDown()

virtual bool TSL3DInteractionModeTrackballWorld::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 TSL3DInteractionModeTrackballWorld::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 TSL3DInteractionModeTrackballWorld::operator delete

(

void *

self

)

operator new() [1/2]

void * TSL3DInteractionModeTrackballWorld::operator new

(

size_t

size

)

operator new() [2/2]

void * TSL3DInteractionModeTrackballWorld::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 TSL3DInteractionModeTrackballWorld::queryCursor ( )

virtual

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

Reimplemented from TSL3DInteractionMode.

queryPrompt()

virtual const char * TSL3DInteractionModeTrackballWorld::queryPrompt ( )

virtual

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

Reimplemented from TSL3DInteractionMode.