mitk::EraseRegionTool Class Reference

Erase a connected region by filling it with the background (unlabeled) pixel value. More...

#include <mitkEraseRegionTool.h>

Inheritance diagram for mitk::EraseRegionTool:

Collaboration diagram for mitk::EraseRegionTool:

Public Member Functions
	mitkClassMacro (EraseRegionTool, FillRegionBaseTool)
Pointer	Clone () const
us::ModuleResource	GetCursorIconResource () const override
	Return the cursor icon resource for this tool. More...
us::ModuleResource	GetIconResource () const override
	Return the toolbar icon resource for this tool. More...
const char *	GetName () const override
	Return the human-readable name of this tool ("Erase"). More...
Public Member Functions inherited from mitk::FillRegionBaseTool
	mitkClassMacro (FillRegionBaseTool, SegTool2D)
mitk::Label::AlgorithmType	GetAlgorithmType () const override
	A single click triggers a connected-component flood/morphology that decides the affected region, so Fill/Erase/Close are SEMIAUTOMATIC (covers all derived tools). More...
Public Member Functions inherited from mitk::SegTool2D
	mitkClassMacro (SegTool2D, Tool)
void	SetShowMarkerNodes (bool show)
	Sets whether contour marker nodes should be visible in the DataStorage. More...
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 ()
DataNode *	GetWorkingDataNode () const
	Returns the segmentation node that should be modified by the tool. More...
MultiLabelSegmentation *	GetWorkingData () const
	Returns the working data (multi-label segmentation image). More...
DataNode *	GetReferenceDataNode () const
	Returns the reference data node. More...
Image *	GetReferenceData () const
	Returns the reference image data. More...
Public Member Functions inherited from mitk::Tool
	mitkClassMacro (Tool, EventStateMachine)
virtual const char *	GetGroup () const
	Name of a group. More...
virtual bool	IsEligibleForAutoInit () const
	Returns whether this tool is eligible for auto-initialization by ToolManager. More...
virtual void	InitializeStateMachine ()
	Initializes the state machine for this tool based on the interaction type. More...
virtual itk::Object::Pointer	GetGUI (const std::string &toolkitPrefix, const std::string &toolkitPostfix)
	Interface for GUI creation. More...
virtual NodePredicateBase::ConstPointer	GetReferenceDataPreference () const
	Returns a predicate describing valid reference data for this tool. More...
virtual NodePredicateBase::ConstPointer	GetWorkingDataPreference () const
	Returns a predicate describing valid working data for this tool. More...
virtual bool	CanHandle (const BaseData *referenceData, const BaseData *workingData) const
	Checks if a tool can handle the given reference data and optional working data. More...
virtual bool	ConfirmBeforeDeactivation ()
	Method call to invoke a dialog box just before exiting. More...
Public Member Functions inherited from mitk::EventStateMachine
	mitkClassMacro (EventStateMachine, InteractionEventHandler)
bool	LoadStateMachine (const std::string &filename, const us::Module *module=nullptr)
	Load a state machine pattern from an XML resource file. More...
bool	HandleEvent (InteractionEvent *event, DataNode *dataNode)
	Process an incoming interaction event. More...
void	EnableUndo (bool enable)
	Enable or disable the undo mechanism for this state machine. More...
void	EnableInteraction (bool enable)
	Enable or disable the state machine. More...
Public Member Functions inherited from mitk::InteractionEventHandler
	mitkClassMacroItkParent (InteractionEventHandler, itk::Object)
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 ()
	Disable this observer so it no longer receives notifications. More...
void	Enable ()
	Enable this observer so it receives notifications. More...
bool	IsEnabled () const
	Check whether this observer is currently enabled. More...

Static Public Member Functions
static Pointer	New ()
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 MultiLabelSegmentation *workingImage, TimeStepType timeStep, const PlaneGeometry *plane, bool detectIntersection)
	Updates the surface interpolations by extracting contours from the given slice. 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)
	Extract the slice of an image cut by the given plane at a specified time point. More...
static void	WriteBackSegmentationResult (const DataNode *workingNode, const PlaneGeometry *planeGeometry, const Image *segmentationResult, TimeStepType timeStep, const std::string &toolName)
	Writes the provided segmentation result slice into the data of the passed workingNode. More...
static void	WriteSliceToVolume (Image *workingImage, const PlaneGeometry *planeGeometry, const Image *slice, TimeStepType timeStep)
	Writes a provided slice into the passed working image. More...

Protected Member Functions
	EraseRegionTool ()=default
	~EraseRegionTool ()=default
Image::Pointer	GenerateFillImage (const Image *workingSlice, Point3D seedPoint, mitk::Label::PixelType &seedLabelValue) const override
	Generate a fill image by region-growing from the seed point. More...
void	PrepareFilling (const Image *workingSlice, Point3D seedPoint) override
	Configure fill parameters to erase (set fill label to UNLABELED_VALUE). More...
Protected Member Functions inherited from mitk::FillRegionBaseTool
	FillRegionBaseTool ()
	~FillRegionBaseTool () override
void	ConnectActionsAndFunctions () override
virtual void	OnClick (StateMachineAction *, InteractionEvent *interactionEvent)
	Add a control point and finish current segment. More...
MultiLabelSegmentation::LabelValueVectorType	GetAffectedLabelValues () const override
	The modified label is the one written by the fill (e.g. the active label for Fill, the seed label for Close); when filling with UNLABELED (Erase) the modified label is the clicked seed label. This deviates from the active label, so the base default is overridden here. More...
Protected Member Functions inherited from mitk::SegTool2D
	SegTool2D ()
	SegTool2D (const char *, const us::Module *interactorModule=nullptr)
	~SegTool2D () override
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	DisableContourMarkers ()
void	InteractiveSegmentationBugMessage (const std::string &message) const
virtual TimePointType	GetLastTimePointTriggered ()
void	PushCursor ()
	Pushes the current tool cursor onto the cursor stack. More...
void	PushCursor (us::ModuleResource cursorResource)
	Pushes a custom cursor onto the cursor stack. More...
void	PopCursor (bool popFirstCursor=false)
	Pops the most recently pushed cursor from the stack. More...
void	PopAllCursors ()
	Pops all cursors from the stack, restoring the default cursor. More...
Protected Member Functions inherited from mitk::Tool
virtual void	SetToolManager (ToolManager *)
ToolManager *	GetToolManager () const
mitk::DataStorage *	GetDataStorage () const
void	ConnectActionsAndFunctions () override
	Tool (const char *, const us::Module *interactorModule=nullptr)
	~Tool () override
void	Notify (InteractionEvent *interactionEvent, bool isHandled) override
	Called by the Dispatcher to notify this observer about an InteractionEvent. More...
bool	FilterEvents (InteractionEvent *, DataNode *) override
Protected Member Functions inherited from mitk::EventStateMachine
	EventStateMachine ()
	~EventStateMachine () override
void	AddActionFunction (const std::string &action, const ActionFunctionDelegate &delegate)
void	AddConditionFunction (const std::string &condition, const ConditionFunctionDelegate &delegate)
StateMachineState *	GetCurrentState () 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...
StateMachineTransition *	GetExecutableTransition (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 ()

Additional Inherited Members
Public Types inherited from mitk::Tool
typedef mitk::Label::PixelType	DefaultSegmentationDataType
Public Types inherited from mitk::EventStateMachine
typedef itk::SmartPointer< StateMachineState >	StateMachineStateType
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 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 contours from given slices. More...
static void	WriteBackSegmentationResults (const DataNode *workingNode, const std::vector< SliceInformation > &sliceList, bool writeSliceToVolume=true, bool allowUndo=true, const std::string &toolName="")
	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)
static bool	IsPositionEventInsideImageRegion (InteractionPositionEvent *positionEvent, const BaseData *data)
Protected Attributes inherited from mitk::FillRegionBaseTool
Label::PixelType	m_FillLabelValue
Label::PixelType	m_SeedLabelValue
MultiLabelSegmentation::MergeStyle	m_MergeStyle
Protected Attributes inherited from mitk::SegTool2D
BaseRenderer *	m_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
UndoController *	m_UndoController
bool	m_UndoEnabled

Detailed Description

Erase a connected region by filling it with the background (unlabeled) pixel value.

See also

FillRegionBaseTool

Finds the outer contour of a shape in 2D (possibly including single patches) and sets all the pixels inside to the background pixel value (erasing a segmentation). Clicking on an unlabeled (background) pixel has no effect.

Warning

Only to be instantiated by mitk::ToolManager.

Definition at line 37 of file mitkEraseRegionTool.h.

Constructor & Destructor Documentation

EraseRegionTool()

mitk::EraseRegionTool::EraseRegionTool ( )

protecteddefault

~EraseRegionTool()

mitk::EraseRegionTool::~EraseRegionTool ( )

protecteddefault

Member Function Documentation

Clone()

Pointer mitk::EraseRegionTool::Clone

(

)

const

GenerateFillImage()

Image::Pointer mitk::EraseRegionTool::GenerateFillImage ( const Image *  workingSlice, Point3D  seedPoint, mitk::Label::PixelType &  seedLabelValue  ) const

overrideprotectedvirtual

Generate a fill image by region-growing from the seed point.

Parameters

workingSlice	The current 2D working slice.
seedPoint	The seed position in world coordinates.
seedLabelValue	Output parameter receiving the label value at the seed point.

Returns

A binary fill image, or nullptr if the seed is on unlabeled background.

Reimplemented from mitk::FillRegionBaseTool.

GetCursorIconResource()

us::ModuleResource mitk::EraseRegionTool::GetCursorIconResource ( ) const

overridevirtual

Return the cursor icon resource for this tool.

Reimplemented from mitk::Tool.

GetIconResource()

us::ModuleResource mitk::EraseRegionTool::GetIconResource ( ) const

overridevirtual

Return the toolbar icon resource for this tool.

Reimplemented from mitk::Tool.

GetName()

const char* mitk::EraseRegionTool::GetName ( ) const

overridevirtual

Return the human-readable name of this tool ("Erase").

Implements mitk::Tool.

mitkClassMacro()

mitk::EraseRegionTool::mitkClassMacro	(	EraseRegionTool	,
		FillRegionBaseTool
	)

New()

static Pointer mitk::EraseRegionTool::New ( )

static

PrepareFilling()

void mitk::EraseRegionTool::PrepareFilling ( const Image *  workingSlice, Point3D  seedPoint  )

overrideprotectedvirtual

Configure fill parameters to erase (set fill label to UNLABELED_VALUE).

Implements mitk::FillRegionBaseTool.

---

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

• mitkEraseRegionTool.h