genre | Interaction |
author | Florian Link |
package | MeVisLab/Standard |
dll | SoView2D |
definition | view2d.def |
see also | SoView2D, StylePalette |
inherits from | SoView2DExtension |
keywords | draw, markerlist, vector, seed, point, pixel, extension, xmarker, sphere, box |
The module SoView2DMarkerEditor allows for an interactive placement, editing and showing of markers on a 2D viewer.
If the module is used alone, it also contains the marker list; otherwise, if there are more marker editors or marker list container modules present, and they are connected, they all share one marker list.
If a StylePalette is attached to set the marker type with it, make sure to check the field Use icon file.
A standard icon file comes with the SoView2DMarkerEditor, but if custom markers should be used, an own icon file can be provided via Icon File. The icon file needs to be in TIF format and contain all the icons in 32x32 pixel format. Multiple icons needs to be arranged horizontally; so an icon file containing 10 markers has the size 320x32.
If checked, markers are rendered onto a viewer.
see also drawingOn
If checked, markers can be interactively edited.
see also editingOn
Sets a general marker color if not overwritten by an attached StylePalette.
see also color
Sets a general marker size if not overwritten by an attached StylePalette.
Sets the depth visibility (in slices or in mm).
Markers (and vectors) not on the currently visible slice are drawn with some alpha attenuation. The depth visibility also controls in which depth the user can still interact with markers: if a marker is visible, one can interact with it. A value of 0.0 means that the marker is only visible on the slice it has been drawn on.
If checked, all created or moved markers are placed into the middle of the next fitting voxel.
If checked, this is the same as Snap to voxel, only that is works for the z-dimension and not only for the x- and y-dimensions.
If turned of, it is possible to edit a marker in the depth without altering its z-coordinate.
Sets the current marker type.
This information is stored in each created marker and can be used in conjunction with the StylePalette.
If checked, a click on an existing marker deletes it.
If checked, the module adds a new marker if clicked somewhere outside existing markers.
Otherwise and if Delete on click is not checked, the existing marker is being selected.
Sets a global alpha factor.
This value is used as minimum alpha value for markers.
Sets a path to an icon file.
If checked, the icons specified in Icon File are used to render the markers.
The icons are chosen on base of the marker's type.
Note that you have to use a StylePalette in order to make use of the icon files.
Sets an offset value for using the icons read from a file.
Default is 0, meaning that all markers from index 0 on are visualized with the loaded icons.
If checked, the marker shapes defined in an attached style palette are rendered with OpenGL lines. If not checked, the textures of the loaded icon file are used.
If checked, existing markers can be selected.
If checked, the module only reacts on button releases and not on button presses.
This can be used to reduce the number of notifications in a network or to let other modules only compute anew if the interaction with a marker is finished.
Defines the editor mode.
Values:
Title | Name |
---|---|
Marker | EDIT_MARKER |
Vector | EDIT_VECTOR |
Object | EDIT_OBJECT |
Defines the color mode.
Values:
Title | Name |
---|---|
Index | COLOR_BY_INDEX |
Type | COLOR_BY_TYPE |
Id | COLOR_BY_ID |
Defines the text color mode.
Values:
Title | Name |
---|---|
Like Marker | COLOR_LIKE_MARKER |
Text | COLOR_TEXT |
Defines the text mode.
Values:
Title | Name |
---|---|
Off | TEXT_OFF |
Styleindex | TEXT_STYLEINDEX |
Stylename | TEXT_STYLENAME |
Itemname | TEXT_ITEMNAME |
Itemid | TEXT_ITEMID |
Voxelpos | TEXT_VOXELPOS |
Worldpos | TEXT_WORLDPOS |
Length | TEXT_LENGTH |
Markertype | TEXT_MARKERTYPE |
Markerlistindex | TEXT_MARKERLISTINDEX |
Defines the text position if text is displayed.
Values:
Title | Name |
---|---|
Center | TEXT_POSITION_CENTER |
Above | TEXT_POSITION_ABOVE |
Right Above | TEXT_POSITION_RIGHT_ABOVE |
Right | TEXT_POSITION_RIGHT |
Right Below | TEXT_POSITION_RIGHT_BELOW |
Below | TEXT_POSITION_BELOW |
Left Below | TEXT_POSITION_LEFT_BELOW |
Left | TEXT_POSITION_LEFT |
Left Above | TEXT_POSITION_LEFT_ABOVE |
Sets a color for text, depending on Text Color Mode.
If checked, a shadow is rendered behind the text.
If checked, a text is only displayed for the selected marker.
If checked, the text may have only that many lines before being cut as the field Max. Num. of Lines allows.
Sets the maximum number of lines for the text.
Defines the vector draw mode.
Only affects vector markers.
Values:
Title | Name |
---|---|
Vector No Arrows | VECTOR_NO_ARROWS |
Vector End Arrow | VECTOR_END_ARROW |
Vector Start Arrow | VECTOR_START_ARROW |
Vector Both Arrows | VECTOR_BOTH_ARROWS |
Vector Plus Minus | VECTOR_PLUS_MINUS |
Vector Pm With Arr | VECTOR_PM_WITH_ARR |
Box Start To End | BOX_START_TO_END |
Box Plus Minus | BOX_PLUS_MINUS |
Sets the line width for vectors in range [1..8].
If checked, all markers and vectors are rendered using anti-aliasing.
If checked, and markers with vectors are rendered as markers, the size of the markers will be half the length of the vector.
Otherwise, the marker will just have the set marker's size.
Shows the style index of the currently selected marker or a -1 if no marker is selected.
The index of the marker under the mouse cursor (or -1 if no marker is under the mouse cursor). This is updated on mouse click, and also on mouse move if the SoView2D is in Managed Interaction mode (Use Managed Interaction is true).
If checked, the mouse is currently over a marker.
Defines how vectors are rendered if crossed by the current slice.
Values:
Title | Name | Deprecated Name | Description |
---|---|---|---|
None | DRAW_NONE | Vectors not lying in the current slice (crossing the current slice) are not rendered at all. | |
Highlight Slice Segment | DRAW_HIGHLIGHT_SLICE_SEGMENT | DRAW_BOLD,DRAW_DEPTH_INDICATOR | Vectors crossed by the current slice are rendered as:
|
Defines the draw mode for markers and vectors.
Values:
Title | Name |
---|---|
Vector | DRAW_VECTOR |
Marker | DRAW_MARKER |
Disc | DRAW_DISC |
Sphere | DRAW_SPHERE |
Vector And Disc | DRAW_VECTOR_AND_DISC |
If checked, the selected marker will be rendered highlighted.
If checked, only the selected marker is rendered as a vector.
All other markers, even if they are vectors are rendered as just markers.
If checked, only the selected marker vector is rendered with selection boxes at the start and the end.
All other vectors are rendered just as vectors.
If checked, the module does not evaluate events marked by other modules as being handled.
Sets the new current time for the viewer.
Defines the unit used in depth visibility of markers and vectors.
Values:
Title | Name |
---|---|
Slices | DEPTH_IN_SLICES |
Mm | DEPTH_IN_MM |
Shows the number of markers in the marker list.
If checked, the internal marker list is saved with saving the network where the SoView2DMarkerEditor is in.
Shows the index of the currently selected marker or -1 if no marker is selected.
Defines the overflow mode that handles how an additional marker is treated if the maximum size of the marker list is reached.
Values:
Title | Name |
---|---|
None | None |
Remove First | RemoveFirst |
Remove Last | RemoveLast |
Remove All | RemoveAll |
Remove New | RemoveNew |
Sets the maximum size of the marker list. Size 0 means unlimited markers.
See also Overflow Mode.