MeVisLab Toolbox Reference
|
SoView2DExtension Base class for all View2DExtensions used for drawing and event handling on the View2D. More...
#include <SoView2DExtension.h>
Public Member Functions | |
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 | draw (View2DSliceList *slicelist, View2DSlice *slice, int sliceZ) |
Called by the SoView2D for each slice that is rendered. | |
virtual bool | evalEvent (SoView2D *view2d, View2DSliceList *slicelist, View2DEvent *ec, View2DEventPhase phase) |
Called by the SoView2D for each event that happens on the viewer. | |
virtual void | startDrawing (View2DSliceList *) |
virtual void | endDrawing (View2DSliceList *) |
virtual void | overwriteDrawingSettings (SoView2DDrawingSettings &) |
View2DEvent * | getEvent () |
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) |
virtual bool | ignoreEvent (View2DEvent *ec) |
Return true if ec has been handled before and if ignoreHandledEvents is True. | |
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. | |
virtual bool | implementsManagedInteractionAndClassicEventHandling () const |
return true if this node is a hybrid module providing managed interaction and classic event handling - in this case SoView2D::useManagedInteraction decides which one to use | |
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 () |
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 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 SoInteractionProvider * | getInteractionProvider (SoNode *node) |
Get a SoInteractionProvider from a SoNode if registered, else NULL. | |
Public Attributes | |
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 Attributes | |
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 | |
enum | Sign { ZERO , NEGATIVE , POSITIVE } |
defines the sign of a number, with zero as an extra value More... | |
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 | |
Additional Inherited Members | |
Public Types inherited from SoInteractionProvider | |
typedef SoInteractionProvider *(* | GetProviderFunc) (SoNode *) |
SoView2DExtension Base class for all View2DExtensions used for drawing and event handling on the View2D.
Definition at line 227 of file SoView2DExtension.h.
defines the sign of a number, with zero as an extra value
Enumerator | |
---|---|
ZERO | |
NEGATIVE | |
POSITIVE |
Definition at line 427 of file SoView2DExtension.h.
SoView2DExtension::SoView2DExtension | ( | ) |
Constructor.
|
overrideprotected |
destructor
called when one of the button/modifier fields is touched:
Reimplemented in SoView2DCSOExtensibleEditor, and SoView2DInteractionExtension.
Definition at line 483 of file SoView2DExtension.h.
|
overrideprotected |
|
virtual |
Set handled-flag of ec to true (= consumed) if handled is True and setEventHandled is True.
called when createNewModeRequest field ist touched:
Definition at line 486 of file SoView2DExtension.h.
References mlrange_cast().
deletes the currently active object (derive this method in child) (called by SoView2D)
|
virtual |
Called by the SoView2D for each slice that is rendered.
Implement this method if you want your SoView2DExtension to point on the slices. The sliceZ is the slice that is rendered onto, the slicelist and slice object are passed to access image geometry and render state
Reimplemented in SoView2DAnnotation, SoView2DBorder, SoView2DBorderHighlight, SoView2DButton, SoView2DDeformationGridView, SoView2DExtensionSeparator, SoView2DLabel, SoView2DLegend, SoView2DOverlay, SoView2DOverlayDecoration, SoView2DPlane, SoView2DPosition, SoView2DRectangle, SoView2DRuler, SoView2DSlider, SoView2DVectorFieldView, SoView2DVoxelView, SoView2DExtensionSampler, SoView2DShaderDevicePosition, SoView2DShaderOverlay, SoView2DCallback, SoView2DMagnifyController, SoView2DRigidRegistrationEditorBase, SoView2DCSOExtensibleEditor, SoView2DAutoCenter, SoView2DCurrentState, and SoView2DGrid.
Draws a small rectangle with given half side length and a line width. The outline is drawn dashed if the size and line width allow that.
void SoView2DExtension::drawFilledMiniCircle | ( | float | xp, |
float | yp, | ||
float | ext, | ||
float | lineWidth = 1.f ) |
Draws a small filled circle with given center point and radius.
Draws a small filled rectangle with given half side length.
void SoView2DExtension::drawFilledMiniTriangle | ( | float | xp, |
float | yp, | ||
float | ext, | ||
float | lineWidth = 1.f ) |
Draws a small filled triangle with given center point and half height.
Draws a fixed size small circle at the given position.
Draws a small circle with given center point and radius.
Draws a small rectangle with given half side length and a line width.
Draws a small triangle with given center point, half height and line width.
void SoView2DExtension::drawVoxelBorder | ( | View2DSlice * | slice, |
float | vx, | ||
float | vy, | ||
float | vz ) |
surround the given voxel with a border
|
static |
intersect given edge from v1
to v2
with given plane, returns sign and intersect
point
called when editingOn field is touched:
Reimplemented in SoView2DCSOExtensibleEditor, SoView2DAnnotation, SoView2DLegend, SoView2DSlicer, SoView2DSliceZoom, SoView2DVoxelValue, and SoView2DInteractionExtension.
Definition at line 480 of file SoView2DExtension.h.
Set/reset stippling pattern.
|
inlinevirtual |
this method is called after the slicelist is called and allows some cleanup of precalculated data
Reimplemented in SoView2DExtensionSeparator, SoView2DOverlay, and SoView2DExtensionSampler.
Definition at line 328 of file SoView2DExtension.h.
|
virtual |
Called by the SoView2D for each event that happens on the viewer.
Implement this method if you want to handle events. If this method is called depends on the fields wantsAllEvents
, wantsKeyEvents
, wantsMouseWheelEvents
and the mouse mask given by button1
, button2
, button3
, shift
, control
, alt
. When using the mouse mask (when wantsAllEvents is set to false), the View2DEventPhase
indicates in which phase of the mouse mask you are in.
Reimplemented in SoView2DButton, SoView2DMagnifyController, SoView2DTouchControl, SoView2DCSOExtensibleEditor, SoView2DAnnotation, SoView2DAutoCenter, SoView2DEnlargeOnClick, SoView2DLegend, SoView2DOverlay, SoView2DPlane, SoView2DPosition, SoView2DRectangle, SoView2DSlicePan, SoView2DSlicer, SoView2DSliceZoom, SoView2DSlider, SoView2DTransRot, SoView2DVoxelValue, SoView2DCallback, and SoView2DGrid.
|
virtual |
To be called by the application which creates events and which wants to apply them to the extension
Reimplemented in SoView2DExtensionSeparator, and SoView2DExtensionSampler.
handle if any field has changed
inventor callbacks if any field has changed, calls fieldChanged
|
static |
Geometry helpers.
returns the orientation letter for the negative and positive direction of the given axis axis = 0 - X axis = 1 - Y axis = 2 - Z
|
overrideprotected |
View2DEvent * SoView2DExtension::getEvent | ( | ) |
get the current event (when inside of evalEvent)
|
overrideprotected |
SoPointingAction::Trigger SoView2DExtension::getPointingActionTriggerFromFields | ( | ) |
Get the trigger that matches the button/modifier field state.
float SoView2DExtension::getSelectDist | ( | ) |
Set the distance tolerance on hit checking in pixels.
int SoView2DExtension::getSelectedIgnoreMask | ( | ) |
int SoView2DExtension::getSelectedModifierMask | ( | ) |
Get compare and ignore mask for the currently selected button/modifier combination, usable with SoPointingAction.
get the current status of this extension
int SoView2DExtension::getX | ( | ) |
get the x device position of current event, only returns valid result when called inside of evalEvent()
int SoView2DExtension::getY | ( | ) |
get the y device position of current event, only returns valid result when called inside of evalEvent()
|
overrideprotected |
Inventor actions.
|
overrideprotected |
|
virtual |
Return true if ec has been handled before and if ignoreHandledEvents is True.
Reimplemented in SoView2DButton, SoView2DPosition, SoView2DRectangle, and SoView2DSlider.
|
inlinevirtual |
return true if this node is a hybrid module providing managed interaction and classic event handling - in this case SoView2D::useManagedInteraction decides which one to use
Reimplemented in SoView2DAnnotation, SoView2DButton, SoView2DLabel, SoView2DLegend, SoView2DRigidRegistrationEditorBase, SoView2DSlider, and SoView2DInteractionExtension.
Definition at line 466 of file SoView2DExtension.h.
void SoView2DExtension::init | ( | ) |
setup internal state
returns if the extension is active (derive this method in child) (in createNewMode or with a selected object)(called by SoView2D)
check if the image is clipped to slice
Definition at line 382 of file SoView2DExtension.h.
bool SoView2DExtension::isCreateNewMode | ( | ) |
check if extension is in createNewMode
bool SoView2DExtension::isCreateNewModeRequest | ( | ) |
check if extension has a request for createNewMode
check if drawing is on
Definition at line 376 of file SoView2DExtension.h.
check if editing is on
Definition at line 378 of file SoView2DExtension.h.
Referenced by SoView2DInteractionExtension::shouldPointingActionBeEnabled().
check if z should stay fixed
Definition at line 380 of file SoView2DExtension.h.
|
static |
Return true if image
is parallel to the image of the slice list up to slice thickness.
bool SoView2DExtension::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.
the rectangle's size is defined by getSelectDist if not overwritten by a non-zero hitRectangleSize.
|
inlinevirtual |
this method is called before any drawing and allows overwriting drawing settings
Reimplemented in SoView2DShaderOverlay.
Definition at line 331 of file SoView2DExtension.h.
|
overrideprotected |
|
static |
calculate 2D point to line distance
|
static |
calculate 3D point to line distance
set that extension want to become createNewMode
Snaps the coordinate component to the pixel center.
Definition at line 340 of file SoView2DExtension.h.
References mlrange_cast().
|
inlinevirtual |
this method is called before the slicelist is called and allows some precalculation needed for all drawn slices
Reimplemented in SoView2DExtensionSeparator, SoView2DCSOExtensibleEditor, SoView2DAutoCenter, SoView2DOverlay, SoView2DSliceZoom, and SoView2DExtensionSampler.
Definition at line 325 of file SoView2DExtension.h.
Update fields to local variables, may be reimplemented if you want to update additional local vars.
Reimplemented in SoView2DBorder, SoView2DBorderHighlight, and SoView2DSlicer.
|
inline |
public access to _wantsMouseOverUpdateEvents
Definition at line 450 of file SoView2DExtension.h.
|
protected |
node sensor that is used to notice field changes
Definition at line 489 of file SoView2DExtension.h.
|
protected |
Color of the object, update on each field change by _nodeSensor.
Definition at line 492 of file SoView2DExtension.h.
|
protected |
set this flag to receive mouse over events while the extension is active
Definition at line 495 of file SoView2DExtension.h.
SoSFEnum SoView2DExtension::alt |
shift alt for mouse mask
Definition at line 270 of file SoView2DExtension.h.
SoSFEnum SoView2DExtension::button1 |
mouse mask for button1
Definition at line 260 of file SoView2DExtension.h.
SoSFEnum SoView2DExtension::button2 |
mouse mask for button2
Definition at line 262 of file SoView2DExtension.h.
SoSFEnum SoView2DExtension::button3 |
mouse mask for button3
Definition at line 264 of file SoView2DExtension.h.
SoSFBool SoView2DExtension::clipToSlice |
Flag to clip drawing to slice.
Definition at line 283 of file SoView2DExtension.h.
SoSFColor SoView2DExtension::color |
color that should be used for drawing
Definition at line 233 of file SoView2DExtension.h.
SoSFEnum SoView2DExtension::control |
shift control for mouse mask
Definition at line 268 of file SoView2DExtension.h.
SoSFBool SoView2DExtension::createNewMode |
flag if extension is in createNewMode
Definition at line 279 of file SoView2DExtension.h.
SoSFTrigger SoView2DExtension::createNewModeRequest |
Definition at line 280 of file SoView2DExtension.h.
SoSFEnum SoView2DExtension::cursorShape |
Set cursor shape if the mouse mask fits and mouseEvents are effectively sent to evalEvent for editing.
Definition at line 287 of file SoView2DExtension.h.
SoSFBool SoView2DExtension::drawingOn |
flag if the extension should draw, needs to be checked inside of the draw() method
Definition at line 235 of file SoView2DExtension.h.
SoSFBool SoView2DExtension::editingOn |
flag if the extension should edit objects on mouse events, needs to be checked inside of the evalEvent() method
Definition at line 237 of file SoView2DExtension.h.
SoSFBool SoView2DExtension::fixZOn |
DEPRECATED flag that indicates that the extension should fix the z value, only used in SoView2DRectangle.
Definition at line 292 of file SoView2DExtension.h.
SoSFBool SoView2DExtension::ignoreHandledEvents |
Ignore events, that have been handled by previous extensions.
Definition at line 256 of file SoView2DExtension.h.
SoSFBool SoView2DExtension::maskValid |
flag if the event mask is valid.
Definition at line 240 of file SoView2DExtension.h.
SoSFBool SoView2DExtension::needsValidVoxel |
sets if a valid voxel must be hit to get evalEvent() calls
Definition at line 273 of file SoView2DExtension.h.
SoSFBool SoView2DExtension::renderOnSlab |
defines if the extension should be rendered on all slab slices
Definition at line 276 of file SoView2DExtension.h.
SoSFFloat SoView2DExtension::selectionTolerance |
the selection tolerance in pixels
Definition at line 243 of file SoView2DExtension.h.
SoSFBool SoView2DExtension::setEventHandled |
Set event handled if it is indeed handled by this extension.
Definition at line 254 of file SoView2DExtension.h.
SoSFEnum SoView2DExtension::shift |
shift modifier for mouse mask
Definition at line 266 of file SoView2DExtension.h.
SoSFBool SoView2DExtension::wantsAllEvents |
flag if ALL events should be passed to evalEvent(), if disabled, events are only passed to evalEvent when the mouse mask gets valid
Definition at line 247 of file SoView2DExtension.h.
SoSFBool SoView2DExtension::wantsKeyEvents |
flag if keyboard events should be passed to evalEvent()
Definition at line 249 of file SoView2DExtension.h.
SoSFBool SoView2DExtension::wantsMouseWheelEvents |
flag if MouseWheel events should be passed to evalEvent()
Definition at line 251 of file SoView2DExtension.h.