Medical Imaging Interaction Toolkit  2024.06.00
Medical Imaging Interaction Toolkit

Paintbrush tool for InteractiveSegmentation. More...

#include <mitkPaintbrushTool.h>

Inheritance diagram for mitk::PaintbrushTool:
Collaboration diagram for mitk::PaintbrushTool:

Public Member Functions

 mitkClassMacro (PaintbrushTool, FeedbackContourTool)
 
void SetSize (int value)
 
- Public Member Functions inherited from mitk::FeedbackContourTool
 mitkClassMacro (FeedbackContourTool, SegTool2D)
 
- Public Member Functions inherited from mitk::SegTool2D
 mitkClassMacro (SegTool2D, Tool)
 
void SetShowMarkerNodes (bool)
 
void SetEnable3DInterpolation (bool)
 Enables or disables the 3D interpolation after writing back the 2D segmentation result, and defaults to true. More...
 
void Activated () override
 Called when the tool gets activated. More...
 
void Deactivated () override
 Called when the tool gets deactivated. More...
 
virtual void SetIsTimePointChangeAware (bool _arg)
 
virtual bool GetIsTimePointChangeAware ()
 
virtual void IsTimePointChangeAwareOn ()
 
virtual void IsTimePointChangeAwareOff ()
 
- Public Member Functions inherited from mitk::Tool
 mitkClassMacro (Tool, EventStateMachine)
 
virtual const char ** GetXPM () const =0
 Returns an icon in the XPM format. More...
 
virtual std::string GetIconPath () const
 Returns the path of an icon. More...
 
virtual us::ModuleResource GetCursorIconResource () const
 Returns the path of a cursor icon. More...
 
virtual us::ModuleResource GetIconResource () const
 Returns the tool button icon of the tool wrapped by a usModuleResource. More...
 
virtual const char * GetName () const =0
 Returns the name of this tool. Make it short! More...
 
virtual const char * GetGroup () const
 Name of a group. More...
 
virtual void InitializeStateMachine ()
 
virtual itk::Object::Pointer GetGUI (const std::string &toolkitPrefix, const std::string &toolkitPostfix)
 Interface for GUI creation. More...
 
virtual NodePredicateBase::ConstPointer GetReferenceDataPreference () const
 
virtual NodePredicateBase::ConstPointer GetWorkingDataPreference () const
 
DataNode::Pointer CreateEmptySegmentationNode (const Image *original, const std::string &organName, const mitk::Color &color) const
 
DataNode::Pointer CreateSegmentationNode (Image *image, const std::string &organName, const mitk::Color &color) const
 
virtual bool CanHandle (const BaseData *referenceData, const BaseData *workingData) const
 
virtual bool ConfirmBeforeDeactivation ()
 Method call to invoke a dialog box just before exiting. The method can be reimplemented in the respective tool class with business logic on when there should be a confirmation dialog from the user before the tool exits. More...
 
- Public Member Functions inherited from mitk::EventStateMachine
virtual std::vector< std::string > GetClassHierarchy () const override
 
virtual const char * GetClassName () const
 
bool LoadStateMachine (const std::string &filename, const us::Module *module=nullptr)
 Loads XML resource. More...
 
bool HandleEvent (InteractionEvent *event, DataNode *dataNode)
 
void EnableUndo (bool enable)
 Enables or disabled Undo. More...
 
void EnableInteraction (bool enable)
 Enables/disables the state machine. In un-enabled state it won't react to any events. More...
 
- Public Member Functions inherited from mitk::InteractionEventHandler
bool SetEventConfig (const std::string &filename, const us::Module *module=nullptr)
 Loads a configuration from an XML resource. More...
 
bool SetEventConfig (const EventConfig &config)
 Loads a configuration from an EventConfig object. More...
 
EventConfig GetEventConfig () const
 Returns the current configuration. More...
 
bool AddEventConfig (const std::string &filename, const us::Module *module=nullptr)
 This method extends the configuration. More...
 
bool AddEventConfig (const EventConfig &config)
 This method extends the configuration. The configuration from the EventConfig object is loaded and only the ones conflicting are replaced by the new one. This way several configurations can be combined. More...
 
- Public Member Functions inherited from mitk::InteractionEventObserver
 InteractionEventObserver ()
 
virtual ~InteractionEventObserver ()
 
void Disable ()
 
void Enable ()
 
bool IsEnabled () const
 

Public Attributes

Message1< int > SizeChanged
 
- Public Attributes inherited from mitk::Tool
Message GUIProcessEventsMessage
 To let GUI process new events (e.g. qApp->processEvents() ) More...
 
Message1< std::string > ErrorMessage
 To send error messages (to be shown by some GUI) More...
 
Message1< bool > CurrentlyBusy
 To send whether the tool is busy (to be shown by some GUI) More...
 
Message1< std::string > GeneralMessage
 To send general messages (to be shown by some GUI) More...
 

Protected Member Functions

 PaintbrushTool (bool startWithFillMode=true)
 
 ~PaintbrushTool () override
 
void ConnectActionsAndFunctions () override
 
void Activated () override
 Called when the tool gets activated. More...
 
void Deactivated () override
 Called when the tool gets deactivated. More...
 
virtual void OnMousePressed (StateMachineAction *, InteractionEvent *)
 
virtual void OnMouseMoved (StateMachineAction *, InteractionEvent *)
 
virtual void OnPrimaryButtonPressedMoved (StateMachineAction *, InteractionEvent *)
 
virtual void MouseMoved (mitk::InteractionEvent *interactionEvent, bool leftMouseButtonPressed)
 
virtual void OnMouseReleased (StateMachineAction *, InteractionEvent *)
 
void UpdateFeedbackColor ()
 
virtual void OnInvertLogic (StateMachineAction *, InteractionEvent *)
 
void UpdateContour (const InteractionPositionEvent *)
 
mitk::Point2D upperLeft (mitk::Point2D p)
 
bool CheckIfCurrentSliceHasChanged (const InteractionPositionEvent *event)
 
void ResetWorkingSlice (const InteractionPositionEvent *event)
 
void OnToolManagerWorkingDataModified ()
 
- Protected Member Functions inherited from mitk::FeedbackContourTool
 FeedbackContourTool ()
 
 FeedbackContourTool (const char *)
 
 ~FeedbackContourTool () override
 
const ContourModelGetFeedbackContour () const
 
void InitializeFeedbackContour (bool isClosed)
 
void ClearsCurrentFeedbackContour (bool isClosed)
 
void UpdateCurrentFeedbackContour (const ContourModel *sourceModel, TimeStepType sourceTimeStep=0)
 
void UpdateFeedbackContour (const ContourModel *sourceModel, TimeStepType feedbackTimeStep, TimeStepType sourceTimeStep=0)
 
void AddVertexToCurrentFeedbackContour (const Point3D &point)
 
void AddVertexToFeedbackContour (const Point3D &point, TimeStepType feedbackTimeStep)
 
void SetFeedbackContourVisible (bool)
 
void SetFeedbackContourColor (float r, float g, float b)
 Provide values from 0.0 (black) to 1.0 (full color) More...
 
void SetFeedbackContourColorDefault ()
 
ContourModel::Pointer ProjectContourTo2DSlice (const Image *slice, const ContourModel *contourIn3D)
 Projects a contour onto an image point by point. Converts from world to index coordinates. More...
 
ContourModel::Pointer BackProjectContourFrom2DSlice (const BaseGeometry *sliceGeometry, const ContourModel *contourIn2D)
 Projects a slice index coordinates of a contour back into world coordinates. More...
 
void WriteBackFeedbackContourAsSegmentationResult (const InteractionPositionEvent *positionEvent, int paintingPixelValue, bool setInvisibleAfterSuccess=true)
 
void FillContourInSlice (ContourModel *projectedContour, Image *sliceImage, int paintingPixelValue=1)
 Fill a contour in a 2D slice with a specified pixel value. More...
 
void FillContourInSlice (ContourModel *projectedContour, unsigned int timeStep, Image *sliceImage, int paintingPixelValue=1)
 Fill a contour in a 2D slice with a specified pixel value at a given time step. More...
 
- Protected Member Functions inherited from mitk::SegTool2D
 SegTool2D ()
 
 SegTool2D (const char *, const us::Module *interactorModule=nullptr)
 
 ~SegTool2D () override
 
DataNodeGetWorkingDataNode () const
 returns the segmentation node that should be modified by the tool. More...
 
ImageGetWorkingData () const
 
DataNodeGetReferenceDataNode () const
 
ImageGetReferenceData () const
 
virtual void OnTimePointChanged ()
 
bool FilterEvents (InteractionEvent *interactionEvent, DataNode *dataNode) override
 Filters events that cannot be handled by 2D segmentation tools. More...
 
Image::Pointer GetAffectedWorkingSlice (const InteractionPositionEvent *) const
 Extract the slice of the currently selected working image that the user just scribbles on. More...
 
Image::Pointer GetAffectedReferenceSlice (const InteractionPositionEvent *) const
 Extract the slice of the currently selected reference image that the user just scribbles on. More...
 
Image::Pointer GetAffectedReferenceSlice (const PlaneGeometry *planeGeometry, TimeStepType timeStep) const
 
void WriteBackSegmentationResult (const InteractionPositionEvent *, const Image *segmentationResult)
 
void WriteBackSegmentationResult (const PlaneGeometry *planeGeometry, const Image *segmentationResult, TimeStepType timeStep)
 
void WriteBackSegmentationResults (const std::vector< SliceInformation > &sliceList, bool writeSliceToVolume=true)
 
int AddContourmarker (const PlaneGeometry *planeGeometry, unsigned int sliceIndex)
 Adds a new node called Contourmarker to the datastorage which holds a mitk::PlanarFigure. By selecting this node the slicestack will be reoriented according to the passed PlanarFigure's Geometry. More...
 
void InteractiveSegmentationBugMessage (const std::string &message) const
 
virtual TimePointType GetLastTimePointTriggered ()
 
- Protected Member Functions inherited from mitk::Tool
virtual void SetToolManager (ToolManager *)
 
ToolManagerGetToolManager () const
 
mitk::DataStorageGetDataStorage () const
 
void ConnectActionsAndFunctions () override
 
 Tool (const char *, const us::Module *interactorModule=nullptr)
 
 ~Tool () override
 
void Notify (InteractionEvent *interactionEvent, bool isHandled) override
 
bool FilterEvents (InteractionEvent *, DataNode *) override
 
- Protected Member Functions inherited from mitk::EventStateMachine
 EventStateMachine ()
 
 ~EventStateMachine () override
 
void AddActionFunction (const std::string &action, TActionFunctor *functor)
 
void AddActionFunction (const std::string &action, const ActionFunctionDelegate &delegate)
 
void AddConditionFunction (const std::string &condition, const ConditionFunctionDelegate &delegate)
 
StateMachineStateGetCurrentState () const
 
void ResetToStartState ()
 ResetToStartState Reset state machine to it initial starting state. More...
 
virtual bool CheckCondition (const StateMachineCondition &condition, const InteractionEvent *interactionEvent)
 
virtual void ExecuteAction (StateMachineAction *action, InteractionEvent *interactionEvent)
 
void SetMouseCursor (const char *xpm[], int hotspotX, int hotspotY)
 Sets the specified mouse cursor. More...
 
void ResetMouseCursor ()
 Resets the mouse cursor to its original state. More...
 
StateMachineTransitionGetExecutableTransition (InteractionEvent *event)
 Returns the executable transition for the given event. More...
 
- Protected Member Functions inherited from mitk::InteractionEventHandler
 InteractionEventHandler ()
 
 ~InteractionEventHandler () override
 
PropertyList::Pointer GetAttributes () const
 
std::string MapToEventVariant (InteractionEvent *interactionEvent)
 
virtual void ConfigurationChanged ()
 

Protected Attributes

bool m_FillMode
 
ContourModel::Pointer m_MasterContour
 
int m_LastContourSize
 
const int m_InternalFillValue
 
Image::Pointer m_WorkingSlice
 
Image::Pointer m_PaintingSlice
 
PlaneGeometry::ConstPointer m_CurrentPlane
 
DataNode::Pointer m_PaintingNode
 
mitk::Point3D m_LastPosition
 
- Protected Attributes inherited from mitk::SegTool2D
BaseRendererm_LastEventSender
 
unsigned int m_LastEventSlice
 
- Protected Attributes inherited from mitk::Tool
std::string m_EventConfig
 Let subclasses change their event configuration. More...
 
- Protected Attributes inherited from mitk::EventStateMachine
bool m_IsActive
 
UndoControllerm_UndoController
 
bool m_UndoEnabled
 

Static Protected Attributes

static int m_Size
 

Additional Inherited Members

- Public Types inherited from mitk::Tool
typedef mitk::Label::PixelType DefaultSegmentationDataType
 
- Public Types inherited from mitk::EventStateMachine
typedef EventStateMachine Self
 
typedef InteractionEventHandler Superclass
 
typedef itk::SmartPointer< SelfPointer
 
typedef itk::SmartPointer< const SelfConstPointer
 
typedef std::map< std::string, TActionFunctor * > ActionFunctionsMapType
 
typedef itk::SmartPointer< StateMachineStateStateMachineStateType
 
- Public Types inherited from mitk::InteractionEventHandler
typedef InteractionEventHandler Self
 
typedef itk::Object Superclass
 
typedef itk::SmartPointer< SelfPointer
 
typedef itk::SmartPointer< const SelfConstPointer
 
- Static Public Member Functions inherited from mitk::SegTool2D
static bool DetermineAffectedImageSlice (const Image *image, const PlaneGeometry *plane, int &affectedDimension, int &affectedSlice)
 Calculates for a given Image and PlaneGeometry, which slice of the image (in index coordinates) is meant by the plane. More...
 
static void UpdateAllSurfaceInterpolations (const LabelSetImage *workingImage, TimeStepType timeStep, const PlaneGeometry *plane, bool detectIntersection)
 Updates the surface interpolations by extracting the contour form the given slice for all labels that have a surface contour information stored for the given plane at the given timestep. More...
 
static Image::Pointer GetAffectedImageSliceAs2DImage (const InteractionPositionEvent *positionEvent, const Image *image, unsigned int component=0)
 Extract the slice of an image that the user just scribbles on. The given component denotes the vector component of an vector image. More...
 
static Image::Pointer GetAffectedImageSliceAs2DImage (const PlaneGeometry *planeGeometry, const Image *image, TimeStepType timeStep, unsigned int component=0)
 Extract the slice of an image cut by given plane. The given component denotes the vector component of a vector image. More...
 
static Image::Pointer GetAffectedImageSliceAs2DImageByTimePoint (const PlaneGeometry *planeGeometry, const Image *image, TimePointType timePoint, unsigned int component=0)
 
static void WriteBackSegmentationResult (const DataNode *workingNode, const PlaneGeometry *planeGeometry, const Image *segmentationResult, TimeStepType timeStep)
 
static void WriteSliceToVolume (Image *workingImage, const PlaneGeometry *planeGeometry, const Image *slice, TimeStepType timeStep, bool allowUndo)
 
- Static Public Member Functions inherited from mitk::EventStateMachine
static const char * GetStaticNameOfClass ()
 
- Static Public Member Functions inherited from mitk::InteractionEventHandler
static const char * GetStaticNameOfClass ()
 
- Protected Types inherited from mitk::EventStateMachine
typedef MessageAbstractDelegate2< StateMachineAction *, InteractionEvent *, void > ActionFunctionDelegate
 
typedef MessageAbstractDelegate1< const InteractionEvent *, bool > ConditionFunctionDelegate
 
- Static Protected Member Functions inherited from mitk::SegTool2D
static void UpdateSurfaceInterpolation (const std::vector< SliceInformation > &sliceInfos, const Image *workingImage, bool detectIntersection, mitk::Label::PixelType activeLabelValue, bool silent=false)
 Updates the surface interpolation by extracting the contour form the given slice. More...
 
static void WriteBackSegmentationResults (const DataNode *workingNode, const std::vector< SliceInformation > &sliceList, bool writeSliceToVolume=true)
 Writes all provided source slices into the data of the passed workingNode. The function does the following: 1) for every passed slice write it to workingNode (and generate and undo/redo step); 2) update the surface interpolation and 3) mark the node as modified. More...
 
static void WriteSliceToVolume (Image *workingImage, const SliceInformation &sliceInfo, bool allowUndo)
 
static bool IsPositionEventInsideImageRegion (InteractionPositionEvent *positionEvent, const BaseData *data)
 

Detailed Description

Paintbrush tool for InteractiveSegmentation.

See also
FeedbackContourTool
ExtractImageFilter

Simple paintbrush drawing tool. Right now there are only circular pens of varying size.

Warning
Only to be instantiated by mitk::ToolManager.
Author
maleike

Definition at line 41 of file mitkPaintbrushTool.h.

Constructor & Destructor Documentation

◆ PaintbrushTool()

mitk::PaintbrushTool::PaintbrushTool ( bool  startWithFillMode = true)
protected

◆ ~PaintbrushTool()

mitk::PaintbrushTool::~PaintbrushTool ( )
overrideprotected

Member Function Documentation

◆ Activated()

void mitk::PaintbrushTool::Activated ( )
overrideprotectedvirtual

Called when the tool gets activated.

Derived tools should call their parents implementation at the beginning of the overriding function.

Reimplemented from mitk::FeedbackContourTool.

◆ CheckIfCurrentSliceHasChanged()

bool mitk::PaintbrushTool::CheckIfCurrentSliceHasChanged ( const InteractionPositionEvent event)
protected

Checks if the current slice has changed and updates (if needed m_CurrentPlane).

◆ ConnectActionsAndFunctions()

void mitk::PaintbrushTool::ConnectActionsAndFunctions ( )
overrideprotectedvirtual

Is called after loading a statemachine. Overwrite this function in specific interactor implementations. Connect actions and functions using the CONNECT_FUNCTION macro within this function.

Reimplemented from mitk::EventStateMachine.

◆ Deactivated()

void mitk::PaintbrushTool::Deactivated ( )
overrideprotectedvirtual

Called when the tool gets deactivated.

Derived tools should call their parents implementation at the end of the overriding function.

Reimplemented from mitk::FeedbackContourTool.

◆ mitkClassMacro()

mitk::PaintbrushTool::mitkClassMacro ( PaintbrushTool  ,
FeedbackContourTool   
)

◆ MouseMoved()

virtual void mitk::PaintbrushTool::MouseMoved ( mitk::InteractionEvent interactionEvent,
bool  leftMouseButtonPressed 
)
protectedvirtual

◆ OnInvertLogic()

virtual void mitk::PaintbrushTool::OnInvertLogic ( StateMachineAction ,
InteractionEvent  
)
protectedvirtual

◆ OnMouseMoved()

virtual void mitk::PaintbrushTool::OnMouseMoved ( StateMachineAction ,
InteractionEvent  
)
protectedvirtual

◆ OnMousePressed()

virtual void mitk::PaintbrushTool::OnMousePressed ( StateMachineAction ,
InteractionEvent  
)
protectedvirtual

◆ OnMouseReleased()

virtual void mitk::PaintbrushTool::OnMouseReleased ( StateMachineAction ,
InteractionEvent  
)
protectedvirtual

◆ OnPrimaryButtonPressedMoved()

virtual void mitk::PaintbrushTool::OnPrimaryButtonPressedMoved ( StateMachineAction ,
InteractionEvent  
)
protectedvirtual

◆ OnToolManagerWorkingDataModified()

void mitk::PaintbrushTool::OnToolManagerWorkingDataModified ( )
protected

◆ ResetWorkingSlice()

void mitk::PaintbrushTool::ResetWorkingSlice ( const InteractionPositionEvent event)
protected

◆ SetSize()

void mitk::PaintbrushTool::SetSize ( int  value)

◆ UpdateContour()

void mitk::PaintbrushTool::UpdateContour ( const InteractionPositionEvent )
protected

◆ UpdateFeedbackColor()

void mitk::PaintbrushTool::UpdateFeedbackColor ( )
protected

◆ upperLeft()

mitk::Point2D mitk::PaintbrushTool::upperLeft ( mitk::Point2D  p)
protected

Little helper function. Returns the upper left corner of the given pixel.

Member Data Documentation

◆ m_CurrentPlane

PlaneGeometry::ConstPointer mitk::PaintbrushTool::m_CurrentPlane
protected

Definition at line 99 of file mitkPaintbrushTool.h.

◆ m_FillMode

bool mitk::PaintbrushTool::m_FillMode
protected

Definition at line 88 of file mitkPaintbrushTool.h.

◆ m_InternalFillValue

const int mitk::PaintbrushTool::m_InternalFillValue
protected

Definition at line 95 of file mitkPaintbrushTool.h.

◆ m_LastContourSize

int mitk::PaintbrushTool::m_LastContourSize
protected

Definition at line 93 of file mitkPaintbrushTool.h.

◆ m_LastPosition

mitk::Point3D mitk::PaintbrushTool::m_LastPosition
protected

Definition at line 101 of file mitkPaintbrushTool.h.

◆ m_MasterContour

ContourModel::Pointer mitk::PaintbrushTool::m_MasterContour
protected

Definition at line 91 of file mitkPaintbrushTool.h.

◆ m_PaintingNode

DataNode::Pointer mitk::PaintbrushTool::m_PaintingNode
protected

Definition at line 100 of file mitkPaintbrushTool.h.

◆ m_PaintingSlice

Image::Pointer mitk::PaintbrushTool::m_PaintingSlice
protected

Definition at line 98 of file mitkPaintbrushTool.h.

◆ m_Size

int mitk::PaintbrushTool::m_Size
staticprotected

Definition at line 89 of file mitkPaintbrushTool.h.

◆ m_WorkingSlice

Image::Pointer mitk::PaintbrushTool::m_WorkingSlice
protected

Definition at line 97 of file mitkPaintbrushTool.h.

◆ SizeChanged

Message1<int> mitk::PaintbrushTool::SizeChanged

Definition at line 45 of file mitkPaintbrushTool.h.


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