Provides coordinating interface to the SoInteractionHandlers in the scene. More...

#include <SoInteractionCoordinator.h>

Inheritance diagram for SoInteractionCoordinator:

Public Member Functions
	SoInteractionCoordinator ()

virtual	~SoInteractionCoordinator ()

size_t	getNumMappers ()
	Return number of added mappers, to be used with truncateMappers.

void	addMapper (SoInteractionMapper *mapper)
	Add an instance to override pointing and command action mappings.

void	clearMappers ()
	Clear list of mappers.

void	truncateMappers (size_t n=0)
	Truncate list of mappers to the given number, used for push/pop semantics.

virtual void	setSelectedPointingAction (SoPointingAction action, SoInteractionHandler handler, const SoPointerPosition &location, bool allowed=true)
	This method sets the new selected pointing action.

SoPointingAction *	getCurrentPointingAction () const
	Get currently selected pointing action.

SoInteractionHandler *	getCurrentPointingActionHandler () const
	Get handler for currently selected pointing action.

bool	getCurrentPointingActionAllowed () const
	Get if the current pointing action may be applied at the current location.

void	affirmSelectedPointingAction ()
	Affirm currently selected pointing action (this prevents other nodes from changing the action without doing anything else)

bool	isPointingActionSelected () const
	Find out whether the pointing action has been set during the current scene graph traversal.

bool	maySelectPointingAction () const
	Return whether one is even allowed to select a (new) pointing action.

virtual void	setLockedPointingAction (SoPointingAction action, SoInteractionHandler handler)
	Setting the locked pointing action with this method ensures that a callback is set to be informed of an external grab release.

SoPointingAction *	getLockedPointingAction ()
	Get locked pointing action.

SoInteractionHandler *	getLockedPointingActionHandler ()
	Get handler for locked pointing action.

void	grabReleasedByAction (SoPointingAction *action)
	This method is called from a PointingAction if a grab should be released.

virtual bool	isPointingActionActive (SoPointingAction *action, int currentMask)
	This method will be used to override the default action selection mechanism.

virtual int	getModeModifierMask (int numModes)
	Return a mask that covers all modifier flags that are needed for the given number of drag modes.

virtual int	getModeFromModifiers (int numModes, int modifierMask)
	Get mode number to set for a total number of modes and the current modifier mask.

virtual bool	startPress (const SoPointerPosition &position, int modifierMask)
	Start mouse button press for current action.

virtual void	endPress (int clickCount)
	Stop mouse button press for current action.

virtual bool	isDragging ()
	Query flag indicating drag action.

bool	isCancelled () const
	This returns true if the current drag action has been cancelled.

void	cancelDrag ()
	Cancel the current drag action (if this wasn't done already).

bool	wheelModifiersFitOffsetAction (SoOffsetAction *action, int modifiers, double &sensitivityX, double &sensitivityY, bool &swapAxes)
	Check if the current modifiers allow to execute a wheel action; also returns the sensitivity settings associated with the matching trigger.

void	setWheelActionExecuted ()
	Prevent further wheel actions from being executed.

bool	mayExecuteWheelAction () const
	Check if it is allowed to execute wheel actions.

bool	keyFitsCommandAction (SoCommandAction *action, int modifiers, SoKeyboardEvent::Key nKey)
	Check if a keyboard event fits a certain command action.

bool	keyFitsOffsetAction (SoOffsetAction *action, int modifiers, SoKeyboardEvent::Key nKey, double &sensitivityX, double &sensitivityY, bool &swapAxes)
	Check if a keyboard event fits a certain offset action.

void	setKeyboardActionExecuted ()
	Prevent further keyboard actions from being executed.

bool	mayExecuteKeyboardAction () const
	Check if it is allowed to execute keyboard actions.

virtual bool	isDragThresholdExceeded () const
	Must be overridden to implement click detection.

SoPointingAction::TriggerList	getTriggers (SoPointingAction *action)
	get current triggers for a pointing action

SoCommandAction::ShortcutList	getShortcuts (SoCommandAction *action)
	get current shortcuts for a command action

SoOffsetAction::TriggerList	getTriggers (SoOffsetAction *action)
	get current triggers for an offset action

Protected Member Functions
virtual void	setDragging (bool dragging)
	Set flag indicating drag action.

void	unsetPointingActionSelected ()
	reset _pointingActionSelected flag (before traversing the scene)

Protected Attributes
bool	_maySelectPointingAction

bool	_mayExecuteKeyboardAction

bool	_mayExecuteWheelAction

Detailed Description

Provides coordinating interface to the SoInteractionHandlers in the scene.

Definition at line 34 of file SoInteractionCoordinator.h.

Constructor & Destructor Documentation

◆ SoInteractionCoordinator()

SoInteractionCoordinator::SoInteractionCoordinator ( )

◆ ~SoInteractionCoordinator()

virtual SoInteractionCoordinator::~SoInteractionCoordinator ( )

virtual

Member Function Documentation

◆ addMapper()

void SoInteractionCoordinator::addMapper ( SoInteractionMapper * mapper )

Add an instance to override pointing and command action mappings.

Earlier mappings will override later mappings. The mappers will still be owned by the caller.

◆ affirmSelectedPointingAction()

void SoInteractionCoordinator::affirmSelectedPointingAction ( )

inline

Affirm currently selected pointing action (this prevents other nodes from changing the action without doing anything else)

Definition at line 74 of file SoInteractionCoordinator.h.

◆ cancelDrag()

void SoInteractionCoordinator::cancelDrag ( )

Cancel the current drag action (if this wasn't done already).

This will be reset when all mouse buttons are relased.

◆ clearMappers()

void SoInteractionCoordinator::clearMappers ( )

Clear list of mappers.

◆ endPress()

virtual void SoInteractionCoordinator::endPress ( int clickCount )

virtual

Stop mouse button press for current action.

◆ getCurrentPointingAction()

SoPointingAction * SoInteractionCoordinator::getCurrentPointingAction ( ) const

inline

Get currently selected pointing action.

Definition at line 64 of file SoInteractionCoordinator.h.

◆ getCurrentPointingActionAllowed()

bool SoInteractionCoordinator::getCurrentPointingActionAllowed ( ) const

inline

Get if the current pointing action may be applied at the current location.

Definition at line 70 of file SoInteractionCoordinator.h.

◆ getCurrentPointingActionHandler()

SoInteractionHandler * SoInteractionCoordinator::getCurrentPointingActionHandler ( ) const

inline

Get handler for currently selected pointing action.

Definition at line 67 of file SoInteractionCoordinator.h.

◆ getLockedPointingAction()

SoPointingAction * SoInteractionCoordinator::getLockedPointingAction ( )

inline

Get locked pointing action.

Definition at line 88 of file SoInteractionCoordinator.h.

◆ getLockedPointingActionHandler()

SoInteractionHandler * SoInteractionCoordinator::getLockedPointingActionHandler ( )

inline

Get handler for locked pointing action.

Definition at line 91 of file SoInteractionCoordinator.h.

◆ getModeFromModifiers()

virtual int SoInteractionCoordinator::getModeFromModifiers	(	int	numModes,
		int	modifierMask )

virtual

Get mode number to set for a total number of modes and the current modifier mask.

Can be overridden to change the modifier handling.

◆ getModeModifierMask()

virtual int SoInteractionCoordinator::getModeModifierMask ( int numModes )

virtual

Return a mask that covers all modifier flags that are needed for the given number of drag modes.

Can be overridden to change the modifier handling.

◆ getNumMappers()

size_t SoInteractionCoordinator::getNumMappers ( )

Return number of added mappers, to be used with truncateMappers.

◆ getShortcuts()

SoCommandAction::ShortcutList SoInteractionCoordinator::getShortcuts ( SoCommandAction * action )

get current shortcuts for a command action

◆ getTriggers() [1/2]

SoOffsetAction::TriggerList SoInteractionCoordinator::getTriggers ( SoOffsetAction * action )

get current triggers for an offset action

◆ getTriggers() [2/2]

SoPointingAction::TriggerList SoInteractionCoordinator::getTriggers ( SoPointingAction * action )

get current triggers for a pointing action

◆ grabReleasedByAction()

void SoInteractionCoordinator::grabReleasedByAction ( SoPointingAction * action )

This method is called from a PointingAction if a grab should be released.

◆ isCancelled()

bool SoInteractionCoordinator::isCancelled ( ) const

inline

This returns true if the current drag action has been cancelled.

Definition at line 118 of file SoInteractionCoordinator.h.

◆ isDragging()

virtual bool SoInteractionCoordinator::isDragging ( )

inlinevirtual

Query flag indicating drag action.

Definition at line 115 of file SoInteractionCoordinator.h.

◆ isDragThresholdExceeded()

virtual bool SoInteractionCoordinator::isDragThresholdExceeded ( ) const

inlinevirtual

Must be overridden to implement click detection.

Reimplemented in SoInteractionController.

Definition at line 150 of file SoInteractionCoordinator.h.

◆ isPointingActionActive()

virtual bool SoInteractionCoordinator::isPointingActionActive	(	SoPointingAction *	action,
		int	currentMask )

virtual

This method will be used to override the default action selection mechanism.

◆ isPointingActionSelected()

bool SoInteractionCoordinator::isPointingActionSelected ( ) const

inline

Find out whether the pointing action has been set during the current scene graph traversal.

Definition at line 78 of file SoInteractionCoordinator.h.

◆ keyFitsCommandAction()

bool SoInteractionCoordinator::keyFitsCommandAction	(	SoCommandAction *	action,
		int	modifiers,
		SoKeyboardEvent::Key	nKey )

Check if a keyboard event fits a certain command action.

◆ keyFitsOffsetAction()

bool SoInteractionCoordinator::keyFitsOffsetAction	(	SoOffsetAction *	action,
		int	modifiers,
		SoKeyboardEvent::Key	nKey,
		double &	sensitivityX,
		double &	sensitivityY,
		bool &	swapAxes )

Check if a keyboard event fits a certain offset action.

◆ mayExecuteKeyboardAction()

bool SoInteractionCoordinator::mayExecuteKeyboardAction ( ) const

inline

Check if it is allowed to execute keyboard actions.

Definition at line 147 of file SoInteractionCoordinator.h.

◆ mayExecuteWheelAction()

bool SoInteractionCoordinator::mayExecuteWheelAction ( ) const

inline

Check if it is allowed to execute wheel actions.

Definition at line 133 of file SoInteractionCoordinator.h.

◆ maySelectPointingAction()

bool SoInteractionCoordinator::maySelectPointingAction ( ) const

inline

Return whether one is even allowed to select a (new) pointing action.

Definition at line 81 of file SoInteractionCoordinator.h.

◆ setDragging()

virtual void SoInteractionCoordinator::setDragging ( bool dragging )

protectedvirtual

Set flag indicating drag action.

Reimplemented in SoInteractionController.

◆ setKeyboardActionExecuted()

void SoInteractionCoordinator::setKeyboardActionExecuted ( )

inline

Prevent further keyboard actions from being executed.

Definition at line 144 of file SoInteractionCoordinator.h.

◆ setLockedPointingAction()

virtual void SoInteractionCoordinator::setLockedPointingAction	(	SoPointingAction *	action,
		SoInteractionHandler *	handler )

virtual

Setting the locked pointing action with this method ensures that a callback is set to be informed of an external grab release.

◆ setSelectedPointingAction()

virtual void SoInteractionCoordinator::setSelectedPointingAction	(	SoPointingAction *	action,
		SoInteractionHandler *	handler,
		const SoPointerPosition &	location,
		bool	allowed = true )

virtual

This method sets the new selected pointing action.

The location is given so that the action can update its highlighting.

◆ setWheelActionExecuted()

void SoInteractionCoordinator::setWheelActionExecuted ( )

inline

Prevent further wheel actions from being executed.

Definition at line 130 of file SoInteractionCoordinator.h.

◆ startPress()

virtual bool SoInteractionCoordinator::startPress	(	const SoPointerPosition &	position,
		int	modifierMask )

virtual

Start mouse button press for current action.

◆ truncateMappers()

void SoInteractionCoordinator::truncateMappers ( size_t n = 0 )

Truncate list of mappers to the given number, used for push/pop semantics.

The mappers are not freed!

◆ unsetPointingActionSelected()

void SoInteractionCoordinator::unsetPointingActionSelected ( )

inlineprotected

reset _pointingActionSelected flag (before traversing the scene)

Definition at line 167 of file SoInteractionCoordinator.h.

◆ wheelModifiersFitOffsetAction()

bool SoInteractionCoordinator::wheelModifiersFitOffsetAction	(	SoOffsetAction *	action,
		int	modifiers,
		double &	sensitivityX,
		double &	sensitivityY,
		bool &	swapAxes )

Check if the current modifiers allow to execute a wheel action; also returns the sensitivity settings associated with the matching trigger.

Member Data Documentation

◆ _mayExecuteKeyboardAction

bool SoInteractionCoordinator::_mayExecuteKeyboardAction

protected

Definition at line 173 of file SoInteractionCoordinator.h.

◆ _mayExecuteWheelAction

bool SoInteractionCoordinator::_mayExecuteWheelAction

protected

Definition at line 176 of file SoInteractionCoordinator.h.

◆ _maySelectPointingAction

bool SoInteractionCoordinator::_maySelectPointingAction

protected

Definition at line 170 of file SoInteractionCoordinator.h.

The documentation for this class was generated from the following file:

MeVis/Foundation/Sources/SoManagedInteraction/SoInteractionCoordinator.h

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ SoInteractionCoordinator()

◆ ~SoInteractionCoordinator()

Member Function Documentation

◆ addMapper()

◆ affirmSelectedPointingAction()

◆ cancelDrag()

◆ clearMappers()

◆ endPress()

◆ getCurrentPointingAction()

◆ getCurrentPointingActionAllowed()

◆ getCurrentPointingActionHandler()

◆ getLockedPointingAction()

◆ getLockedPointingActionHandler()

◆ getModeFromModifiers()

◆ getModeModifierMask()

◆ getNumMappers()

◆ getShortcuts()

◆ getTriggers() [1/2]

◆ getTriggers() [2/2]

◆ grabReleasedByAction()

◆ isCancelled()

◆ isDragging()

◆ isDragThresholdExceeded()

◆ isPointingActionActive()

◆ isPointingActionSelected()

◆ keyFitsCommandAction()

◆ keyFitsOffsetAction()

◆ mayExecuteKeyboardAction()

◆ mayExecuteWheelAction()

◆ maySelectPointingAction()

◆ setDragging()

◆ setKeyboardActionExecuted()

◆ setLockedPointingAction()

◆ setSelectedPointingAction()

◆ setWheelActionExecuted()

◆ startPress()

◆ truncateMappers()

◆ unsetPointingActionSelected()

◆ wheelModifiersFitOffsetAction()

Member Data Documentation

◆ _mayExecuteKeyboardAction

◆ _mayExecuteWheelAction

◆ _maySelectPointingAction