MeVisLab Toolbox Reference
SoView2DPosition Class Reference

draw and edit a position on the SoView2D More...

#include <SoView2DPosition.h>

Inheritance diagram for SoView2DPosition:
SoView2DInteractionExtension SoView2DExtension SoInteractionProviderNode SoInteractionOwner SoInteractionProvider

Public Member Functions

 SoView2DPosition ()
 Constructor.
 
void draw (View2DSliceList *dsl, View2DSlice *dslice, int slice) override
 reimplemented from SoView2DExtension
 
bool evalEvent (SoView2D *view2d, View2DSliceList *slicelist, View2DEvent *ec, View2DEventPhase phase) override
 reimplemented from SoView2DExtension
 
bool ignoreEvent (View2DEvent *ec) override
 Overwrite ignoreEvent -> ignore the "ignoreHandledEvents"-Field.
 
- Public Member Functions inherited from SoView2DInteractionExtension
 SoView2DInteractionExtension (const std::string &actionID, bool positionSensitive=true)
 
 SoView2DInteractionExtension ()
 Constructor.
 
bool implementsManagedInteractionAndClassicEventHandling () const override
 this node is a hybrid module providing managed interaction and classic event handling
 
- Public Member Functions inherited from SoView2DExtension
 SoView2DExtension ()
 Constructor.
 
void init ()
 setup internal state
 
virtual void updateValues ()
 Update fields to local variables, may be reimplemented if you want to update additional local vars.
 
virtual void startDrawing (View2DSliceList *)
 
virtual void endDrawing (View2DSliceList *)
 
virtual void overwriteDrawingSettings (SoView2DDrawingSettings &)
 
View2DEventgetEvent ()
 get the current event (when inside of evalEvent)
 
float getSelectDist ()
 Set the distance tolerance on hit checking in pixels.
 
bool isPointInsideDeviceRect (float pointX, float pointY, float centerX, float centerY, float hitRectangleSize=0.0)
 returns whether the given point is inside a rectangle around the given center.
 
void drawMiniRect (float xp, float yp, float ext, float lineWidth=1.f)
 Draws a small rectangle with given half side length and a line width.
 
void drawDashedMiniRect (float xp, float yp, float ext, float lineWidth)
 
void drawFilledMiniRect (float xp, float yp, float ext, float lineWidth=1.f)
 Draws a small filled rectangle with given half side length.
 
void drawMiniTriangle (float xp, float yp, float ext, float lineWidth=1.f)
 Draws a small triangle with given center point, half height and line width.
 
void drawFilledMiniTriangle (float xp, float yp, float ext, float lineWidth=1.f)
 Draws a small filled triangle with given center point and half height.
 
void drawMiniCircle (float xp, float yp, float ext, float lineWidth=1.f)
 Draws a small circle with given center point and radius.
 
void drawFilledMiniCircle (float xp, float yp, float ext, float lineWidth=1.f)
 Draws a small filled circle with given center point and radius.
 
void drawFixedSizeMiniCircleAt (float xp, float yp)
 Draws a fixed size small circle at the given position.
 
void drawVoxelBorder (View2DSlice *slice, float vx, float vy, float vz)
 surround the given voxel with a border
 
int getX ()
 get the x device position of current event, only returns valid result when called inside of evalEvent()
 
int getY ()
 get the y device position of current event, only returns valid result when called inside of evalEvent()
 
virtual bool isDrawingOn ()
 check if drawing is on
 
virtual bool isEditingOn ()
 check if editing is on
 
virtual bool isFixZOn ()
 check if z should stay fixed
 
virtual bool isClipToSlice ()
 check if the image is clipped to slice
 
virtual void fieldChanged (SoSensor *sensor)
 handle if any field has changed
 
bool isCreateNewMode ()
 check if extension is in createNewMode
 
void setCreateNewMode (bool flag)
 set this extension to create new objects
 
bool isCreateNewModeRequest ()
 check if extension has a request for createNewMode
 
void setCreateNewModeRequest (bool flag)
 set that extension want to become createNewMode
 
virtual bool isActive ()
 returns if the extension is active (derive this method in child) (in createNewMode or with a selected object)(called by SoView2D)
 
virtual void deleteSelectedObject ()
 deletes the currently active object (derive this method in child) (called by SoView2D)
 
virtual void getStatusString (SbString &status)
 get the current status of this extension
 
virtual bool evaluateEvent (SoView2D *view2d, View2DEvent *ec)
 
bool wantsMouseOverUpdates () const
 public access to _wantsMouseOverUpdateEvents
 
virtual void consumeEvent (View2DEvent *ec, bool handled=TRUE)
 Set handled-flag of ec to true (= consumed) if handled is True and setEventHandled is True.
 
int getSelectedModifierMask ()
 Get compare and ignore mask for the currently selected button/modifier combination, usable with SoPointingAction.
 
int getSelectedIgnoreMask ()
 
SoPointingAction::Trigger getPointingActionTriggerFromFields ()
 Get the trigger that matches the button/modifier field state.
 
- Public Member Functions inherited from SoInteractionProviderNode
 SoInteractionProviderNode ()
 Default constructor.
 
 ~SoInteractionProviderNode () override
 Destructor.
 
std::string getID () const override
 Returns the id string for identifying the provider (and its actions) - this is usually the name of the scene node.
 
void objRef () override
 Memory management by reference counting; must be implemented in derived classes.
 
void objUnref () override
 
- Public Member Functions inherited from SoInteractionOwner
 SoInteractionOwner ()
 Default constructor.
 
 ~SoInteractionOwner () override
 The destructor will destroy all interactions created with this object as owner.
 
std::list< SoInteraction * > getInteractions (SoState *state) override
 Returns the list of all interactions of this provider.
 
void pointerPosition (SoState *state, const SoPointerPosition &pos) override
 Same as below, with additional SoState argument. Be defaults simply calls the below version.
 
void pointerLeftWindow (SoState *state) override
 Same as below, with additional SoState argument. Be defaults simply calls the below version.
 
void addListener (SoInteractionOwnerListenerInterface *listener)
 Add a listener object that is notified of changes in the interaction list.
 
void removeListener (SoInteractionOwnerListenerInterface *listener)
 Remove a listener object that was notified of changes in the interaction list.
 
- Public Member Functions inherited from SoInteractionProvider
 SoInteractionProvider ()
 Default constructor.
 
virtual ~SoInteractionProvider ()
 
template<class T >
std::list< T * > getInteractionsOfType (SoState *state)
 Returns list of interactions of a specific type:
 
virtual std::list< SoCommandAction * > getCommandActions (SoState *state)
 
virtual std::list< SoPointingAction * > getPointingActions (SoState *state)
 
virtual std::list< SoOffsetAction * > getOffsetActions (SoState *state)
 

Static Public Member Functions

static void initClass ()
 inventor runtime type system
 
- Static Public Member Functions inherited from SoView2DInteractionExtension
static void initClass ()
 Initializes this class.
 
- Static Public Member Functions inherited from SoView2DExtension
static void initClass ()
 Initializes this class.
 
static float snapToPixelCenter (float coordinateComponent)
 Snaps the coordinate component to the pixel center.
 
static void fieldChangedCB (void *data, SoSensor *sensor)
 inventor callbacks if any field has changed, calls fieldChanged
 
static bool isImageParallel (SoSFMLImage *image, View2DSliceList *dsl)
 Return true if image is parallel to the image of the slice list up to slice thickness.
 
static void enableLineStippling (const SoSFEnum &lineStyleField)
 Set/reset stippling pattern.
 
static void disableLineStippling (const SoSFEnum &lineStyleField)
 
static void getAxisOrientation (int axis, SbMatrix &matrix, char &negativeResult, char &positiveResult)
 Geometry helpers.
 
static float pointToLineDistance (SbVec3f point, SbVec3f line1, SbVec3f line2)
 calculate 3D point to line distance
 
static float pointToLineDistance (SbVec2f point, SbVec2f line1, SbVec2f line2)
 calculate 2D point to line distance
 
static Sign edgeIntersectWithPlane (const SbVec3f &v1, const SbVec3f &v2, const SbPlane &plane, SbVec3f &intersect)
 intersect given edge from v1 to v2 with given plane, returns sign and intersect point
 
- Static Public Member Functions inherited from SoInteractionProviderNode
static void initClass ()
 Initializes this class.
 
- Static Public Member Functions inherited from SoInteractionProvider
static void registerInteractionProviderNode (SoType type, GetProviderFunc func)
 Register a function to obtain a SoInteractionProvider from a SoNode.
 
static SoInteractionProvidergetInteractionProvider (SoNode *node)
 Get a SoInteractionProvider from a SoNode if registered, else NULL.
 

Public Attributes

SoSFVec3f worldPosition
 selected world position
 
SoSFEnum drawingModel
 model that shall be used for the position indicator (crosshairs, circle...)
 
SoSFEnum drawingModelSizeUnit
 unit in which cross-hair dimensions are expressed (voxel, world or screen units)
 
SoSFFloat drawingModelSize
 size of the position indicator model
 
SoSFFloat crossHairSpacing
 spacing in center of the crosshair position indicator
 
SoSFBool drawEditingRect
 flag to draw mini rect in cursor center
 
SoSFBool colorAxes
 flag to draw axes in color
 
SoSFColor coronalColor
 color for coronal view
 
SoSFColor axialColor
 color for axial view
 
SoSFColor sagittalColor
 color for sagittal view
 
SoSFBool colorBorder
 flag to draw colored borders
 
SoSFFloat colorBorderWidth
 width of the color border
 
SoSFFloat lineWidth
 line width of the rendered position indicators
 
SoSFUShort linePattern
 line stipple pattern
 
SoSFFloat blendOnto
 blend factor for the slice the position is located on
 
SoSFFloat blendOutside
 blend factor for the slice the position is not located on
 
SoSFBool updateOnPress
 update worldPosition on press event
 
SoSFBool updateOnMotion
 update worldPosition on motion event
 
SoSFBool updateOnRelease
 update worldPosition on release event
 
SoSFBool cooperative
 enable cooperative editing
 
SoSFVec3f firstSliceWorldPosition
 world position on first slice (useful, if numOfSlices in the corresponding viewer is > 1)
 
- Public Attributes inherited from SoView2DInteractionExtension
SoSFTrigger singleClicked
 this is triggered when the user clicks without moving the mouse (this only is supported when using Managed Interaction)
 
SoSFTrigger doubleClicked
 the same for the second click in a row
 
- Public Attributes inherited from SoView2DExtension
SoSFColor color
 color that should be used for drawing
 
SoSFBool drawingOn
 flag if the extension should draw, needs to be checked inside of the draw() method
 
SoSFBool editingOn
 flag if the extension should edit objects on mouse events, needs to be checked inside of the evalEvent() method
 
SoSFBool maskValid
 flag if the event mask is valid.
 
SoSFFloat selectionTolerance
 the selection tolerance in pixels
 
SoSFBool wantsAllEvents
 flag if ALL events should be passed to evalEvent(), if disabled, events are only passed to evalEvent when the mouse mask gets valid
 
SoSFBool wantsKeyEvents
 flag if keyboard events should be passed to evalEvent()
 
SoSFBool wantsMouseWheelEvents
 flag if MouseWheel events should be passed to evalEvent()
 
SoSFBool setEventHandled
 Set event handled if it is indeed handled by this extension.
 
SoSFBool ignoreHandledEvents
 Ignore events, that have been handled by previous extensions.
 
SoSFEnum button1
 mouse mask for button1
 
SoSFEnum button2
 mouse mask for button2
 
SoSFEnum button3
 mouse mask for button3
 
SoSFEnum shift
 shift modifier for mouse mask
 
SoSFEnum control
 shift control for mouse mask
 
SoSFEnum alt
 shift alt for mouse mask
 
SoSFBool needsValidVoxel
 sets if a valid voxel must be hit to get evalEvent() calls
 
SoSFBool renderOnSlab
 defines if the extension should be rendered on all slab slices
 
SoSFBool createNewMode
 flag if extension is in createNewMode
 
SoSFTrigger createNewModeRequest
 
SoSFBool clipToSlice
 Flag to clip drawing to slice.
 
SoSFEnum cursorShape
 Set cursor shape if the mouse mask fits and mouseEvents are effectively sent to evalEvent for editing.
 
SoSFBool fixZOn
 DEPRECATED flag that indicates that the extension should fix the z value, only used in SoView2DRectangle.
 
- Public Attributes inherited from SoInteractionProviderNode
SoSFString instanceName
 Defines interface field to store the instance name.
 
SoSFString interactionProviderID
 This field overrides the instanceName as providerID if specified.
 

Protected Member Functions

void setPosition (const SbVec3f &pos, SoView2D *view2d, View2DSliceList *slicelist)
 
void getAxisColor (char orientation, float *color)
 get color of orientation
 
void pointerPosition (const SoPointerPosition &pos) override
 interface inherited from SoInteractionProvider
 
bool isSensitiveAt (const SoPointerPosition &pos) override
 interface forwarded from SoPointingAction:
 
void startPressAt (const SoPointerPosition &pos) override
 
void dragMoveTo (const SoPointerPosition &pos) override
 
- Protected Member Functions inherited from SoView2DInteractionExtension
 ~SoView2DInteractionExtension () override
 destructor
 
bool isValidLocation (const SoPointerPosition &pos)
 return true if the position is inside the image or needsValidVoxel is not set
 
virtual bool shouldPointingActionBeEnabled ()
 
void editingOnChanged (SoField *field) override
 called when editingOn field is touched:
 
void buttonMaskChanged (SoField *field) override
 called when one of the button/modifier fields is touched:
 
virtual int getCurrentCursor (SoViewerProxy *viewerProxy)
 interface forwarded from SoPointingAction:
 
virtual void setHighlightAt (const SoPointerPosition &)
 
virtual void unsetHighlight ()
 
virtual SoPointingActionendPress (int)
 
virtual int getNumInteractionModes () const
 
virtual void setInteractionMode (int)
 
- Protected Member Functions inherited from SoView2DExtension
virtual void createNewModeRequestTriggered (SoField *)
 called when createNewModeRequest field ist touched:
 
 ~SoView2DExtension () override
 destructor
 
void GLRender (SoGLRenderAction *action) override
 Inventor actions.
 
void callback (SoCallbackAction *action) override
 
void handleEvent (SoHandleEventAction *action) override
 
void getMatrix (SoGetMatrixAction *action) override
 
void getBoundingBox (SoGetBoundingBoxAction *action) override
 
void pick (SoPickAction *action) override
 
void doAction (SoAction *action) override
 
- Protected Member Functions inherited from SoInteractionOwner
virtual void pointerLeftWindow ()
 This is called when the mouse cursor leaves the window.
 
bool hasInteractions () const
 Returns whether there are any actions defined by this owner.
 
template<class T >
bool hasInteractionsOfType () const
 Same as above, but asking for a specific type of interaction.
 
void addPointingAction (SoPointingAction *)
 
void addCommandAction (SoCommandAction *)
 
void addOffsetAction (SoOffsetAction *)
 

Protected Attributes

SbVec3f _oldWorldPos
 previous world position
 
bool _isDragging
 flag if position is being dragged
 
- Protected Attributes inherited from SoView2DInteractionExtension
SoPointingAction_pointingAction
 
- Protected Attributes inherited from SoView2DExtension
SoNodeSensor_nodeSensor
 node sensor that is used to notice field changes
 
float _rgbColor [4]
 Color of the object, update on each field change by _nodeSensor.
 
bool _wantsMouseOverUpdateEvents
 set this flag to receive mouse over events while the extension is active
 

Additional Inherited Members

- Public Types inherited from SoView2DExtension
enum  Sign { ZERO , NEGATIVE , POSITIVE }
 defines the sign of a number, with zero as an extra value More...
 
- Public Types inherited from SoInteractionProvider
typedef SoInteractionProvider *(* GetProviderFunc) (SoNode *)
 

Detailed Description

draw and edit a position on the SoView2D

Definition at line 45 of file SoView2DPosition.h.

Constructor & Destructor Documentation

◆ SoView2DPosition()

SoView2DPosition::SoView2DPosition ( )

Constructor.

Member Function Documentation

◆ dragMoveTo()

void SoView2DPosition::dragMoveTo ( const SoPointerPosition & pos)
overrideprotectedvirtual

Reimplemented from SoView2DInteractionExtension.

◆ draw()

void SoView2DPosition::draw ( View2DSliceList * dsl,
View2DSlice * dslice,
int slice )
overridevirtual

reimplemented from SoView2DExtension

Reimplemented from SoView2DExtension.

◆ evalEvent()

bool SoView2DPosition::evalEvent ( SoView2D * view2d,
View2DSliceList * slicelist,
View2DEvent * ec,
View2DEventPhase phase )
overridevirtual

reimplemented from SoView2DExtension

Reimplemented from SoView2DExtension.

◆ getAxisColor()

void SoView2DPosition::getAxisColor ( char orientation,
float * color )
protected

get color of orientation

◆ ignoreEvent()

bool SoView2DPosition::ignoreEvent ( View2DEvent * ec)
overridevirtual

Overwrite ignoreEvent -> ignore the "ignoreHandledEvents"-Field.

Reimplemented from SoView2DExtension.

◆ initClass()

static void SoView2DPosition::initClass ( )
static

inventor runtime type system

◆ isSensitiveAt()

bool SoView2DPosition::isSensitiveAt ( const SoPointerPosition & pos)
overrideprotectedvirtual

interface forwarded from SoPointingAction:

Reimplemented from SoView2DInteractionExtension.

◆ pointerPosition()

void SoView2DPosition::pointerPosition ( const SoPointerPosition & pos)
overrideprotectedvirtual

interface inherited from SoInteractionProvider

Reimplemented from SoInteractionOwner.

◆ setPosition()

void SoView2DPosition::setPosition ( const SbVec3f & pos,
SoView2D * view2d,
View2DSliceList * slicelist )
protected

◆ startPressAt()

void SoView2DPosition::startPressAt ( const SoPointerPosition & pos)
overrideprotectedvirtual

Reimplemented from SoView2DInteractionExtension.

Member Data Documentation

◆ _isDragging

bool SoView2DPosition::_isDragging
protected

flag if position is being dragged

Definition at line 136 of file SoView2DPosition.h.

◆ _oldWorldPos

SbVec3f SoView2DPosition::_oldWorldPos
protected

previous world position

Definition at line 134 of file SoView2DPosition.h.

◆ axialColor

SoSFColor SoView2DPosition::axialColor

color for axial view

Definition at line 68 of file SoView2DPosition.h.

◆ blendOnto

SoSFFloat SoView2DPosition::blendOnto

blend factor for the slice the position is located on

Definition at line 83 of file SoView2DPosition.h.

◆ blendOutside

SoSFFloat SoView2DPosition::blendOutside

blend factor for the slice the position is not located on

Definition at line 85 of file SoView2DPosition.h.

◆ colorAxes

SoSFBool SoView2DPosition::colorAxes

flag to draw axes in color

Definition at line 64 of file SoView2DPosition.h.

◆ colorBorder

SoSFBool SoView2DPosition::colorBorder

flag to draw colored borders

Definition at line 73 of file SoView2DPosition.h.

◆ colorBorderWidth

SoSFFloat SoView2DPosition::colorBorderWidth

width of the color border

Definition at line 75 of file SoView2DPosition.h.

◆ cooperative

SoSFBool SoView2DPosition::cooperative

enable cooperative editing

Definition at line 94 of file SoView2DPosition.h.

◆ coronalColor

SoSFColor SoView2DPosition::coronalColor

color for coronal view

Definition at line 66 of file SoView2DPosition.h.

◆ crossHairSpacing

SoSFFloat SoView2DPosition::crossHairSpacing

spacing in center of the crosshair position indicator

Definition at line 60 of file SoView2DPosition.h.

◆ drawEditingRect

SoSFBool SoView2DPosition::drawEditingRect

flag to draw mini rect in cursor center

Definition at line 62 of file SoView2DPosition.h.

◆ drawingModel

SoSFEnum SoView2DPosition::drawingModel

model that shall be used for the position indicator (crosshairs, circle...)

Definition at line 54 of file SoView2DPosition.h.

◆ drawingModelSize

SoSFFloat SoView2DPosition::drawingModelSize

size of the position indicator model

Definition at line 58 of file SoView2DPosition.h.

◆ drawingModelSizeUnit

SoSFEnum SoView2DPosition::drawingModelSizeUnit

unit in which cross-hair dimensions are expressed (voxel, world or screen units)

Definition at line 56 of file SoView2DPosition.h.

◆ firstSliceWorldPosition

SoSFVec3f SoView2DPosition::firstSliceWorldPosition

world position on first slice (useful, if numOfSlices in the corresponding viewer is > 1)

Definition at line 96 of file SoView2DPosition.h.

◆ linePattern

SoSFUShort SoView2DPosition::linePattern

line stipple pattern

Definition at line 80 of file SoView2DPosition.h.

◆ lineWidth

SoSFFloat SoView2DPosition::lineWidth

line width of the rendered position indicators

Definition at line 78 of file SoView2DPosition.h.

◆ sagittalColor

SoSFColor SoView2DPosition::sagittalColor

color for sagittal view

Definition at line 70 of file SoView2DPosition.h.

◆ updateOnMotion

SoSFBool SoView2DPosition::updateOnMotion

update worldPosition on motion event

Definition at line 90 of file SoView2DPosition.h.

◆ updateOnPress

SoSFBool SoView2DPosition::updateOnPress

update worldPosition on press event

Definition at line 88 of file SoView2DPosition.h.

◆ updateOnRelease

SoSFBool SoView2DPosition::updateOnRelease

update worldPosition on release event

Definition at line 92 of file SoView2DPosition.h.

◆ worldPosition

SoSFVec3f SoView2DPosition::worldPosition

selected world position

Fields

Definition at line 52 of file SoView2DPosition.h.


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