MeVisLab Toolbox Reference
SoView2DCSOExtensibleEditor.h
Go to the documentation of this file.
1/*************************************************************************************
2**
3** Copyright 2012, MeVis Medical Solutions AG
4**
5** The user may use this file in accordance with the license agreement provided with
6** the Software or, alternatively, in accordance with the terms contained in a
7** written agreement between the user and MeVis Medical Solutions AG.
8**
9** For further information use the contact form at https://www.mevislab.de/contact
10**
11**************************************************************************************/
12
13
15
16#pragma once
17
18#include <SoView2DExtension.h>
21
22#include <Inventor/misc/SoRef.h>
23
24#include <mlMatrix4.h>
25#include <deque>
26
27typedef std::vector<SoRef<SoCSOEditorExtension> > ExtensionList;
28
30class CSO;
31class CSOList;
33
34class SoCSOTransform;
35
36
37class CSOCreateAction;
38class CSOBulgeAction;
44
48
51
54
56
58
60class CSOVisualizationSettings;
62
70
72
74{
75public:
76
80 static void initClass();
81
124
131 std::string getDefaultCreatorString() const { return std::string("__default"); }
132
134 void pointerLeftWindow() override;
136 void pointerPosition(const SoPointerPosition& pos) override;
137
140
152 void setInteractionModifier(int mode) { _interactionMode = mode; }
154 int getInteractionModifier() const { return _interactionMode; }
155
158
168 bool shouldShowCSOBeyondSlice(const CSODrawSliceInformation& sliceInfo, const CSODrawView2DInfos& view2DInfos, ml::CSO* cso);
174 ml::AbstractTransformationPtr getRegistrationInformation(const SoPointerPosition& pos, ml::CSO* cso);
177 ml::CoordinateSystemReference getCoordinateSystemReference(ml::CSO* cso);
178 ml::CoordinateSystemReference getCoordinateSystemReference(SoView2D* viewer);
179 ml::CoordinateSystemReference getCoordinateSystemReference(const CSODrawView2DInfos& view2DInfos);
180 ml::CoordinateSystemReference getCoordinateSystemReference(const SoPointerPosition& pos);
183 bool hasTransformationProvider() const { return _transformationProvider != nullptr; }
185 ml::AbstractTransformationPtr getTransformation(const ml::CoordinateSystemReference& from, const ml::CoordinateSystemReference& to);
187 bool isSameImage(const ml::CoordinateSystemReference& from, const ml::CoordinateSystemReference& to);
188
191 void transformCSO(ml::CSO* cso, const ml::AbstractTransformationPtr& transformation);
192
194 void fillCSOSliceInformation(const CSODrawCSOInfos& csoInfos, const CSODrawView2DInfos& view2DInfos, CSODrawSliceInformation& sliceInfo, const ml::Matrix4& worldToVoxelMatrix, const CSOVoxelSlab& csoSlab);
195
201
205 {
206 ON_ALL_IMAGES = 0,
207 ONLY_ON_IMAGES_THEY_WERE_CREATED_ON = 1,
208 ONLY_ON_IMAGES_THEY_WERE_NOT_CREATED_ON = 2,
209 ONLY_ON_IMAGES_THEY_CAN_BE_TRANSFORMED_TO = 3
210 };
211
215
217 bool isSelectionAllowedWithDefaultRenderer() const { return allowSelectionWithDefaultRenderer.getValue(); }
218
222
226
228 void cancel();
229
230protected:
231
234
236 void startDrawing(View2DSliceList* slicelist) override;
237
239 void draw(View2DSliceList* slicelist, View2DSlice* slice, int sliceZ) override;
240
241 bool evalEvent(SoView2D* view2d, View2DSliceList* slicelist, View2DEvent* ec, View2DEventPhase phase) override;
242
243 void notifyEditorsOfMouseWheelEvent(SoMouseWheelEvent::Orientation orientation, int turn, View2DEvent* ec);
244
246 static void csoListNotificationCB(void* userData, int notificationFlag);
247
249 void editingOnChanged(SoField*) override;
250 void buttonMaskChanged(SoField*) override;
251
258
260 void doAction(SoAction *action) override;
263
264private:
265
266 ml::CSOVisualizationSettings _dummyVisualizationSettings;
267 SoRef<SoCSODefaultRenderer> _defaultRenderer;
268
269 bool _activeCreatorEditorDirty;
270
271 void _inCSOListCB(SoField*);
272
273 SbVec3f _currentPointerWorldPosition;
274 SbVec3f _startPointerWorldPosition;
275 int _currentTimePointIndex;
276
277 void storeCopiedCSOGroupInformation();
278
279 void setActiveEditor(const ExtensionList& extensions);
280 void setActionsEnabled();
281 void setKeyboardActionsEnabled();
282 void setTriggerFieldsToActions();
283
284 void toggleCancelCommandIsActive();
285 void togglePasteCommandIsActive();
286 void toggleCutCopyCommandIsActive();
287 void toggleUndoCommandIsActive();
288 void toggleRedoCommandIsActive();
289 void toggleDeleteCSOCommandIsActive();
290 void toggleDeleteSeedPointCommandIsActive();
291 void toggleRemoveAllCommandIsActive();
292
293 bool areKeyboardCommandsActive() { return isEditingOn() && keyCommandsEnabled.getValue(); }
294
295 bool isInteracting();
296
297 void copySelectedCSOs();
298
299 void copySelectedCSOsToInternalList(ml::CSOList* csoList);
300 void cutSelectedCSOs();
301 void pasteCSOs();
302
303 void deleteSelectedCSOs();
304 void deleteSelectedSeedPoint();
305
306 void undo();
307 void redo();
308
309 void removeAllCSOsAndGroups();
310
311 SbVec3f getMidPointSelectedCSOs();
312
313 void getNonActiveEditorExtensionIds(std::vector <std::string>& nonActiveEditorExtensions);
314
315 // Returns whether the given CSO should be rendered.
316 bool shouldRenderCSO(ml::CSO* cso, const CSODrawView2DInfos& view2DInfos, const CSODrawSliceInformation& sliceInfo);
317
318 void resetCreatingAndEditingFields();
319 void resetAllExtensionCaches();
320 void resetAllEditorsAndCaches();
321
322 SoCSOEditorExtension* getExtensionForCSO(ml::CSO* cso);
323 bool doesCSOTimePointMatchCurrentTimePoint(const CSODrawView2DInfos& view2DInfos, ml::CSO* cso);
324
325 ml::TransformationProvider* _transformationProvider;
326
327 // this is the editor active for creating new CSOs
328 SoRef<SoCSOEditorExtension> _activeEditor;
329 SoRef<SoCSOEditorExtension> _lastActiveEditor;
330
331 CSOLabelResizeAction* _labelResizeAction;
332 CSOLabelMoveAction* _labelMoveAction;
333 CSOTransformAction* _transformAction;
334 CSOInsertSeedPointIntoPathPointListAction* _insertSeedPointAction;
335 CSOSelectAndMoveAction* _selectAndMoveAction;
336 CSOCreateAction* _createAction;
337 CSOBulgeAction* _bulgeAction;
338
339 int _interactionMode;
340
341 CSOCopyCommandAction* _copyCommandAction;
342 CSOCutCommandAction* _cutCommandAction;
343 CSOPasteCommandAction* _pasteCommandAction;
344
345 CSODeleteSeedPointCommandAction* _deleteSeedPointCommandAction;
346 CSODeleteCSOCommandAction* _deleteCSOCommandAction;
347
348 CSOUndoCommandAction* _undoCommandAction;
349 CSORedoCommandAction* _redoCommandAction;
350
351 CSOCancelCommandAction* _cancelCommandAction;
352
353 CSORemoveAllCommandAction* _removeAllCommandAction;
354
355 std::vector < ml::CSO* > _copiedCSOs;
356 std::map < int, std::vector< int > > _copiedCSOGroupIds;
357
358
359 unsigned int _prevWheelCode;
360 int _sumWheel;
361
362 friend bool SoCSOEditorTools::evaluateHitPoint(const ml::Vector3& worldPosition, View2DSliceList* slicelist, ml::CSOList* csoList,
363 const ml::CSOBoundingBox& slabBB, const std::string& subType, SoView2DCSOExtensibleEditor* editor,
364 bool testSeedPoints,
366 ml::CSOPathPoints*& localHitPathPoints, float& distance);
367
368 // Stores a list of voxel slabs for a given cso list
369 // for given world matrix and cso change id.
370 struct SlabCacheEntry
371 {
372 SlabCacheEntry()
373 {
374 csoList = nullptr;
375 csoListGeometryChangeId = 0;
376 }
377 void clear()
378 {
379 csoList = nullptr;
380 csoListGeometryChangeId = 0;
381 csoSlabs.clear();
382 }
383
384 void* csoList;
385 MLuint64 csoListGeometryChangeId;
386 ml::Matrix4 worldToVoxelMatrix;
387 std::vector<CSOVoxelSlab> csoSlabs;
388 };
389
390 // Stores N cache entries.
391 std::deque<SlabCacheEntry*> _csoSlabCache;
392
393 const SlabCacheEntry& findOrCreateSlabCache(const ml::Matrix4& worldToVoxelMatrix, size_t matrixHashKey, ml::CSOList* list);
394
395
396 void notifyCSOListObservers(ml::CSOList* csoList);
397
398 // make the keyboard commands friends so they
399 // can access private/protected methods.
403
406
409
411
412 SO_NODE_HEADER(SoView2DCSOExtensibleEditor);
413};
414
#define SOCSO_EXPORT
Header file for system independent resolution.
Definition SoCSOSystem.h:21
std::vector< SoRef< SoCSOEditorExtension > > ExtensionList
Extensible editor for CSOs.
View2DEventPhase
event phase for simple extensions that grab the focus, do something (motion) and are released afterwa...
Action for creating CSOs.
Class ManagedMouseButtonTrigger encapsulates the combination of required and ignored mouse buttons an...
Extension for rendering CSOs.
Base class for an editor extension for the SoView2DCSOExtensibleEditor.
Abstract Open Inventor base class for uniform shader parameter nodes.
SoPointerPosition manages the current position of the mouse cursor.
The SoSFMLBase field is the interface used by Inventor Nodes to output ML Base objects to the outside...
Definition SoSFMLBase.h:45
void inTransformationProviderChanged(SoField *)
ml::CSOVisualizationSettings * getVisualizationSettings()
Returns the pointer to a optionally attached CSOVisualizationSettings object.
void transformCSO(ml::CSO *cso, const ml::AbstractTransformationPtr &transformation)
Transforms the given CSO on base of registration information.
void draw(View2DSliceList *slicelist, View2DSlice *slice, int sliceZ) override
Renders by calling the draw-method of all attached extensions.
ml::CoordinateSystemReference getCoordinateSystemReference(const CSODrawView2DInfos &view2DInfos)
bool shouldShowCSOForCurrentTimePoint(const CSODrawView2DInfos &view2DInfos, ml::CSO *cso)
Returns whether the given CSO should be rendered for the current time point.
ml::AbstractTransformationPtr getRegistrationInformation(const SoPointerPosition &pos, ml::CSO *cso)
Returns a registration if it exists for the given CSO on the given image (as a SoPointerPosition),...
bool hasRegistrationInformation(const SoPointerPosition &pos, ml::CSO *cso)
Returns whether a registration exists.
SoSFBool isCreatingNewCSO
Flag shows whether any editor is currently creating a new CSO.
ml::CSOList * getInputCSOList()
Returns a pointer to the input CSOList or NULL if nothing valid is attached.
SoSFBool renderLeftOverCSOsWithDefaultRenderer
Shall the CSOs that were not rendered by an attached editor be rendered by a default renderer?
SoSFString creatorExtensionId
The unique id of an editor extension that receives the create events.
SoSFBool alwaysModifyExistingCSOs
Shall always be selected and modified and never created?
SoCSODefaultRenderer * getDefaultRenderer()
Returns the default renderer.
int getInteractionModifier() const
Returns the interaction mode as determined by a pointing action.
void toggleCancelCommandIsActiveForModifications(bool isActive)
Toggles the activation of the cancel command without any additional checks; to be used with care and ...
void isCreatingOrEditingChanged(SoField *)
bool shouldShowCSORegardingParallelState(const CSODrawSliceInformation &sliceInfo, const CSODrawView2DInfos &view2DInfos, ml::CSO *cso)
Returns whether the given CSO should be rendered regarding its parallel state.
SoCSOEditorExtension * getActiveEditor() const
Returns the attached editor that is active for creating new CSOs (or NULL if there is not any).
bool shouldShowCSOBeyondSlice(const CSODrawSliceInformation &sliceInfo, const CSODrawView2DInfos &view2DInfos, ml::CSO *cso)
Returns whether the given CSO should be rendered beyond the current slice.
SoSFBool keyCommandsEnabled
Shall the key commands be enabled?
void resetLastActiveEditor()
Resets the active editor to the last active editor if it was set.
void startDrawing(View2DSliceList *slicelist) override
Is called before drawing to initialize editors.
SoSFBool enableRemoveAll
Shall the removeAll-key command be available?
SoCSOTransform * _csoTransform
Global transformation for visualization.
void setInteractionModifier(int mode)
Sets the interaction mode as determined by a pointing action.
void pointerPosition(const SoPointerPosition &pos) override
Is called on moving the mouse, sets the CSO id under the cursor.
SoSFBool interactOnlyWithSelectedCSO
Shall only a selected CSO be allow to be interacted with?
void notifyEditorsOfMouseWheelEvent(SoMouseWheelEvent::Orientation orientation, int turn, View2DEvent *ec)
bool isSelectionAllowedWithDefaultRenderer() const
Returns whether a CSO can be selected by the internal default renderer.
static void csoListNotificationCB(void *userData, int notificationFlag)
Is called by CSOList notifications.
SoSFNode inExtensions
Input field for extensions.
void setActiveEditor(SoCSOEditorExtension *editor, bool storeLastEditor=true)
Sets the active editor, use this only to temporarily set a modification editor.
SoSFBool isEditingExistingCSO
Flag shows whether any editor is currently editing/modifying an existing CSO.
SoSFMLBase inCSOList
Input field for CSOList.
SoSFEnum renderCSOsOnImagesDependingOnCreationMode
Defines on which images the CSOs should be rendered on, depending on where they have been created.
ml::CoordinateSystemReference getCoordinateSystemReference(ml::CSO *cso)
bool shouldShowCSOOnImageWithId(const CSODrawView2DInfos &view2DInfos, ml::CSO *cso)
Returns whether the given CSO should be rendered on a particular image, identified by its DICOM Serie...
void cancel()
Cancels the current interaction.
bool hasTransformationProvider() const
Returns if the editor has a transformation provider.
SoSFBool updateImageStatisticsOnFinishInteraction
Should the image statistics be updated for the currently active CSO on finishing an interaction (mous...
SoSFInt32 csoIdUnderMouseCursor
The id of the CSO currently under the mouse (or -1 if no CSO is under the mouse).
void buttonMaskChanged(SoField *) override
called when one of the button/modifier fields is touched:
void setCSOUnderTheMouseId(int id)
Sets the csoUnderTheMouseId field, only if the id changes.
void fillCSOSliceInformation(const CSODrawCSOInfos &csoInfos, const CSODrawView2DInfos &view2DInfos, CSODrawSliceInformation &sliceInfo, const ml::Matrix4 &worldToVoxelMatrix, const CSOVoxelSlab &csoSlab)
Fills the relation of the given CSO to the current slice.
SoView2DCSOExtensibleEditor()
Constructor.
ml::CoordinateSystemReference getCoordinateSystemReference(SoView2D *viewer)
bool isSameImage(const ml::CoordinateSystemReference &from, const ml::CoordinateSystemReference &to)
Returns whether the given coordinate references reference the same image.
void interactOnlyWithSelectedCSOChanged(SoField *)
SoSFBool allowSelectionWithDefaultRenderer
Shall the CSOs be selectable by the internal default renderer?
SoSFBool updateCSOIdUnderMouseCursor
Shall the cso id under the mouse cursor be updated?
void doAction(SoAction *action) override
Overloading to obtain and set the SoCSOTransform.
bool evalEvent(SoView2D *view2d, View2DSliceList *slicelist, View2DEvent *ec, View2DEventPhase phase) override
Called by the SoView2D for each event that happens on the viewer.
bool shouldShowCSOAtAll(ml::CSO *cso)
Returns whether the given CSO should be rendered at all, that is whether its shows state is true and ...
ml::CoordinateSystemReference getCoordinateSystemReference(const SoPointerPosition &pos)
void stopEditingCSO()
Sets the isEditingExistingCSO field to FALSE.
void cancelGenerationChanged(SoField *)
void setCreateActionTrigger(const SoPointingAction::Trigger &trigger)
Sets the CSOCreateAction trigger.
SoSFBool alwaysCreateNewCSOs
Shall always be created and never selected and modified?
void getExtensions(ExtensionList &extensions)
Collects attached extensions to the given list.
void extensionChanged(SoField *)
New field change callbacks:
CSORenderOnImagesDependingOnCreationModes
Modes to control the rendering of CSOs depending on the images they were created on.
std::string getDefaultCreatorString() const
Returns a default creator id string that indicates that the first found editor should create CSOs.
void setCreateActionTriggerToDefault()
Sets the CSOCreateAction trigger to its default, according to the trigger fields.
SoSFMLBase inVisualizationSettings
Input of visualization settings.
void startEditingCSO(const SoPointerPosition &pos, ml::CSO *cso)
Sets the isEditingExistingCSO field to TRUE and stores the current viewer's name in the CSO's userDat...
void pointerLeftWindow() override
Is called when mouse pointer leaves the window.
void editingOnChanged(SoField *) override
Inherited from SoView2DExtension:
SoSFMLBase inTransformationProvider
Input of provided transformations.
static void initClass()
Initialization of inventor stuff.
SoSFTrigger cancelGeneration
Triggers the cancellation of the current generation.
ml::AbstractTransformationPtr getTransformation(const ml::CoordinateSystemReference &from, const ml::CoordinateSystemReference &to)
Returns a transformation if existing, NULL otherwise.
~SoView2DCSOExtensibleEditor() override
Destructor.
SoView2DExtension Base class for all View2DExtensions used for drawing and event handling on the View...
virtual bool isEditingOn()
check if editing is on
SoView2D is a 2D viewer for image data.
Definition SoView2D.h:62
View2DEvent stores all information on an event on a SoView2D.
a list that holds all View2DSlice objects (lazily created) of a SoView2D
a single slice that is stored in a View2DSliceList, typically created by a View2DSliceList
Definition View2DSlice.h:48
The CSOBoundingBox defines an axis parallel bounding box with double precision.
A CSOList comprises a number of CSOs and CSOGroups and is the central object for contour segmentation...
Definition CSOList.h:61
The CSOPathPoints is a list of world coordinates which are interpolated by a certain interpolation sc...
The CSOSeedPoint can be interactively set and modified and is the framework for contours.
The CSO represents a contour segmentation object.
Definition CSO.h:44
Target mlrange_cast(Source arg)
Generic version of checked ML casts.
UINT64 MLuint64
Introduce platform independent 64 bit unsigned integer type.
Definition mlTypeDefs.h:425
SOCSO_EXPORT bool evaluateHitPoint(const ml::Vector3 &worldPosition, View2DSliceList *slicelist, ml::CSOList *csoList, const ml::CSOBoundingBox &slabBB, const std::string &subType, SoView2DCSOExtensibleEditor *editor, bool testSeedPoints, ml::CSO *&localHitCSO, ml::CSOSeedPoint *&localHitSeedPoint, ml::CSOPathPoints *&localHitPathPoints, float &distanceToCSO)
Returns whether a CSO was hit and fills the according structures. If subType is an empty string,...
Defines the z slab of a CSO bounding box in voxel coordinates.