#include <CSOAbstractCreateAction.h>

Inheritance diagram for CSOAbstractCreateAction:

Public Member Functions
	CSOAbstractCreateAction (SoView2DCSOExtensibleEditor *editor, const std::string &id)

bool	isSensitiveAt (const SoPointerPosition &pos) override
	Returns `true` if the gesture is startable at the given device position. More...

void	startPressAt (const SoPointerPosition &pos) override
	Starts a drag at given device position. More...

void	dragMoveTo (const SoPointerPosition &pos) override
	Continues the drag to given device position. More...

SoPointingAction *	endPress (int clickCount) override
	Ends the drag at last device position. More...

int	getCurrentCursor (SoViewerProxy *) const override
	Returns the cursor ID to display for this action, as defined in SoViewerProxy.h - this gets (at least) called after setMode(), isSensitiveAt(), startPressAt(), dragMoveTo(), and endPress(). More...

void	setMode (int mode) override
	This gets called if the mode was changed and before startPressAt is called. More...

int	getNumModes () const override
	Returns the number of different modes of this action - modes can be changed during drag, and handle drag restrictions or drag result. More...

Public Member Functions inherited from CSOPointingAction
	CSOPointingAction (SoView2DCSOExtensibleEditor *editor, const std::string &id)

Public Member Functions inherited from SoPointingAction
	SoPointingAction (SoInteractionOwner *owner, std::string id, bool positionSensitive=true)
	Standard constructor. More...

virtual bool	isPositionSensitive () const
	Position sensitive actions can only start at positions where isSensitiveAt() return `true`. More...

void	clearTriggers ()
	Removes all triggers. More...

void	setTrigger (int triggerMask, int ignoreMask=0)
	Sets the (only) default modifier/button mask for triggering this action. More...

void	setTrigger (const Trigger &trigger)
	Same with Trigger object. More...

void	addTrigger (const Trigger &trigger)
	Adds another default modifier/button mask as trigger. More...

TriggerList	getTriggers () const
	Returns the list of default modifier/button mask combinations set for this action. More...

virtual bool	triggersAction (int mask)
	Returns whether the given modifier/button combination activates this action according to the default bindings. More...

virtual std::string	getCurrentStatusMessage () const
	Returns a status message for display in the status bar of MeVisLab (make it short!), this is called at same time as getCurrentCursor. More...

virtual void	setHighlightAt (const SoPointerPosition &)
	This method is called so that highlighting of objects under the mouse cursor can occur. More...

virtual void	unsetHighlight ()
	Removes any highlighting if this method is called. More...

virtual void	dragCancelled ()
	This is called if the current drag operation is canceled, e.g., through a key command like Escape. More...

virtual bool	wantsMouseOverUpdates ()
	Override this to return `true` if this action should get location updates directly before rendering, so it can update its status. More...

void	grabReleased ()
	Call this to release an interaction grab that has been established by the return value of endPress(), e.g., because it was aborted through a SoCommandAction. More...

virtual void	releaseGrab (StopMode)
	This will be called by the controller if you should release the grab established by endPress. More...

virtual bool	wantsImmediateDragUpdates ()
	Let this method return `false` if you do not want dragMoveTo to be called until it is clear that the interaction will not be handled as a click (endPress will be called with a clickCount greater zero). More...

Public Member Functions inherited from SoInteraction
	SoInteraction (InteractionType type, SoInteractionOwner *owner, const std::string &id, bool registerWithOwner=true)
	Standard constructor. More...

virtual	~SoInteraction ()
	Virtual destructor. More...

SoInteractionOwner *	getOwner () const
	Returns the interaction provider of this entry. More...

virtual bool	isEnabled () const
	Returns the enabled status of this interaction - if this returns `false`, the action is not selectable (but if a mouse action has already been started, it will not be aborted if this returns `false`). More...

virtual void	setEnabled (bool enabled)
	Sets the enabled status of this interaction. More...

std::string	getID () const
	Returns the ID of this interaction. More...

void	setID (const std::string &id)
	Sets the ID of this interaction. More...

std::string	getFullID () const
	Returns the ID string consisting of the ID of the provider and this action's ID, separated by '. More...

InteractionType	getInteractionType () const
	Returns type of interaction object. More...

template<class T >
bool	isOfType () const
	Convenience method for checking type. More...

int	getMenuPriority () const

void	setMenuPriority (int priority)
	Sets the priority value for ordered display in menus/tool boxes. More...

virtual std::string	getUserName () const
	Returns user-visible name of this item for direct display (e.g., in tool box or menu). More...

virtual void	setUserName (const std::string &name)
	Sets the user name of this interaction entry. More...

virtual std::string	getIconFile () const
	Returns the filename of an icon (e.g., for use in a tool box or in menu). More...

virtual void	setIconFile (const std::string &file)
	Sets the filename of an icon used for this interaction entry. More...

virtual std::string	getDescription () const
	Returns the description for user help. More...

virtual void	setDescription (const std::string &descr)
	Sets the description for user help. More...

virtual void	ref ()

virtual void	unref ()

int	getStateVersion () const

void	touch ()
	Increments the version number of attribute state to mark attribute changes. More...

Protected Member Functions
virtual void	callCreateStartPressAt (const SoPointerPosition &pos)=0

virtual void	callCreateDragMoveTo (const SoPointerPosition &pos)=0

virtual bool	callCreateEndPress (int clickCount)=0

SoCSOEditorExtension *	getActiveEditorChecked () const

Protected Member Functions inherited from CSOPointingAction
bool	isInsideImage (const SoPointerPosition &pos)
	Returns whether the position is inside the image if needsValidVoxel is set; Otherwise, it just returns true. More...

void	setView2DImage (const SoPointerPosition &pos)

void	updateImageStatistics (ml::CSO *cso)

void	setActionActive ()
	Set/unset the maskValid flag in the editor. More...

void	unsetActionActive ()

Protected Member Functions inherited from SoPointingAction
virtual SoOffsetAction *	proxiedOffsetAction () const

Protected Attributes
SoRef< SoCSOEditorExtension >	_activeEditor

SbVec3f	_initialPosition

SbVec3f	_sliceNormal

Protected Attributes inherited from CSOPointingAction
SoView2DCSOExtensibleEditor *	_editor

SoSFMLImage *	_image

Additional Inherited Members
Public Types inherited from SoPointingAction
enum	StopMode { AbortAction , FinishAction }
	Argument type for releaseGrab() More...

enum	{ Button1Mask = ManagedMouseButtonTrigger::Button1Mask , Button2Mask = ManagedMouseButtonTrigger::Button2Mask , Button3Mask = ManagedMouseButtonTrigger::Button3Mask , AllButtonsMask = ManagedMouseButtonTrigger::AllButtonsMask }
	Configuration values for the Trigger type. More...

enum	{ TypeId = TypePointingAction }

typedef ManagedMouseButtonTrigger	Trigger
	Class Trigger encapsulates the combination of required and ignored button, and modifier keys that activate a pointing action. More...

typedef std::list< Trigger >	TriggerList
	List of triggers. More...

Public Types inherited from SoInteraction
enum	{ NoModifier = ManagedActionTrigger::NoModifier , ShiftModifier = ManagedActionTrigger::ShiftModifier , ControlModifier = ManagedActionTrigger::ControlModifier , AltModifier = ManagedActionTrigger::AltModifier , AllModifiersMask = ManagedActionTrigger::AllModifiersMask , ShiftMask = ShiftModifier , CtrlMask = ControlModifier , AltMask = AltModifier }
	Constants to use where keyboard modifiers must be specified. More...

enum	InteractionType { TypePointingAction , TypeCommandAction , TypeOffsetAction }
	Enum identifying subtypes of this class. More...

Detailed Description

Definition at line 24 of file CSOAbstractCreateAction.h.

Constructor & Destructor Documentation

◆ CSOAbstractCreateAction()

CSOAbstractCreateAction::CSOAbstractCreateAction	(	SoView2DCSOExtensibleEditor *	editor,
		const std::string &	id
	)

Member Function Documentation

◆ callCreateDragMoveTo()

virtual void CSOAbstractCreateAction::callCreateDragMoveTo ( const SoPointerPosition & pos )

protectedpure virtual

Implemented in CSOCreateAction.

◆ callCreateEndPress()

virtual bool CSOAbstractCreateAction::callCreateEndPress ( int clickCount )

protectedpure virtual

Implemented in CSOCreateAction.

◆ callCreateStartPressAt()

virtual void CSOAbstractCreateAction::callCreateStartPressAt ( const SoPointerPosition & pos )

protectedpure virtual

Implemented in CSOCreateAction.

◆ dragMoveTo()

void CSOAbstractCreateAction::dragMoveTo ( const SoPointerPosition & pos )

overridevirtual

Continues the drag to given device position.

Implements SoPointingAction.

◆ endPress()

SoPointingAction* CSOAbstractCreateAction::endPress ( int clickCount )

overridevirtual

Ends the drag at last device position.

If this method returns a non-NULL SoPointingAction, the pointing device is restricted to this SoPointingAction until releaseGrab() is called or another call to endPress returns NULL. This is useful if the end user is required to click at at least one other position.

Note that locking of the returned action breaks down if the same node is used in several viewers, since each viewer usually has its own interaction controller that manages locked actions on its own.

Parameters

clickCount gives the number of clicks at the last start position. This is, for a normal drag it is 0, for a single click it is 1, for a double click it is 2, and for a triple click it is 3. Note that for a clickCount greater than zero, you will not have received any dragMoveTo calls if wantsImmediateDragUpdates returns false.

Implements SoPointingAction.

◆ getActiveEditorChecked()

SoCSOEditorExtension* CSOAbstractCreateAction::getActiveEditorChecked ( ) const

protected

◆ getCurrentCursor()

int CSOAbstractCreateAction::getCurrentCursor ( SoViewerProxy * ) const

overridevirtual

Returns the cursor ID to display for this action, as defined in SoViewerProxy.h - this gets (at least) called after setMode(), isSensitiveAt(), startPressAt(), dragMoveTo(), and endPress().

The SoViewerProxy pointer is provided so one can define custom cursors when this method is called (see header file SoViewerProxy.h for instructions).

Reimplemented from SoPointingAction.

◆ getNumModes()

int CSOAbstractCreateAction::getNumModes ( ) const

overridevirtual

Returns the number of different modes of this action - modes can be changed during drag, and handle drag restrictions or drag result.

Modes are normally controlled through the modifier keys.

Reimplemented from SoPointingAction.

◆ isSensitiveAt()

bool CSOAbstractCreateAction::isSensitiveAt ( const SoPointerPosition & pos )

overridevirtual

Returns true if the gesture is startable at the given device position.

Otherwise, a mouse click will be handed to another SoPointingAction and the cursor shape of this action is ignored!

Note: Only called if isPositionSensitive() returns true.

Implements SoPointingAction.

◆ setMode()

void CSOAbstractCreateAction::setMode ( int )

overridevirtual

This gets called if the mode was changed and before startPressAt is called.

Use this value to implement different dragging modes.

Note: You must override getNumModes() to return the number of required modes.

Reimplemented from SoPointingAction.

◆ startPressAt()

void CSOAbstractCreateAction::startPressAt ( const SoPointerPosition & pos )

overridevirtual

Starts a drag at given device position.

It is guaranteed that this will be followed by (possibly) dragMoveTo calls and either an endPress or dragCancelled call.

Implements SoPointingAction.

Member Data Documentation

◆ _activeEditor

SoRef<SoCSOEditorExtension> CSOAbstractCreateAction::_activeEditor

protected

Definition at line 47 of file CSOAbstractCreateAction.h.

◆ _initialPosition

SbVec3f CSOAbstractCreateAction::_initialPosition

protected

Definition at line 49 of file CSOAbstractCreateAction.h.

◆ _sliceNormal

SbVec3f CSOAbstractCreateAction::_sliceNormal

protected

Definition at line 50 of file CSOAbstractCreateAction.h.

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

MeVisLab/Standard/Sources/Inventor/SoCSO/SoView2DCSOEditor/SoView2DCSOExtensibleEditor/CSOActions/CSOAbstractCreateAction.h

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ CSOAbstractCreateAction()

Member Function Documentation

◆ callCreateDragMoveTo()

◆ callCreateEndPress()

◆ callCreateStartPressAt()

◆ dragMoveTo()

◆ endPress()

◆ getActiveEditorChecked()

◆ getCurrentCursor()

◆ getNumModes()

◆ isSensitiveAt()

◆ setMode()

◆ startPressAt()

Member Data Documentation

◆ _activeEditor

◆ _initialPosition

◆ _sliceNormal