Extracts a single region from a segmentation image and creates a new image with same geometry of the input image. More...

#include <mitkPickingTool.h>

Inheritance diagram for mitk::PickingTool:

[legend]

Collaboration diagram for mitk::PickingTool:

[legend]

Public Member Functions
	mitkClassMacro (PickingTool, SegWithPreviewTool)

Pointer	Clone () const

const char *	GetName () const override
	Returns the name of this tool. Make it short! More...

us::ModuleResource	GetIconResource () const override
	Returns the tool button icon of the tool wrapped by a usModuleResource. More...

void	Activated () override
	Called when the tool gets activated. More...

void	Deactivated () override
	Called when the tool gets deactivated. More...

void	ClearPicks ()
	Clears all seed picks and updates the preview. More...

bool	HasPicks () const
	Returns whether any seed points have been placed. More...

Public Member Functions inherited from mitk::SegWithPreviewTool
	mitkClassMacro (SegWithPreviewTool, Tool)

void	Activated () override
	Called when the tool gets activated. More...

void	Deactivated () override
	Called when the tool gets deactivated. More...

mitk::Label::AlgorithmType	GetAlgorithmType () const override
	Preview tools are SEMIAUTOMATIC by default (the user supplies seeds/parameters). Fully automatic preview tools (e.g. TotalSegmentator) override this again to AUTOMATIC. More...

void	ConfirmSegmentation ()
	Confirms the current preview segmentation and transfers it to the working image. More...

virtual void	SetCreateAllTimeSteps (bool _arg)
	If true, the preview is computed for all time steps at once. More...

virtual bool	GetCreateAllTimeSteps ()

virtual void	CreateAllTimeStepsOn ()

virtual void	CreateAllTimeStepsOff ()

virtual void	SetKeepActiveAfterAccept (bool _arg)
	If true, the tool stays active after the segmentation is accepted. More...

virtual bool	GetKeepActiveAfterAccept ()

virtual void	KeepActiveAfterAcceptOn ()

virtual void	KeepActiveAfterAcceptOff ()

virtual void	SetIsTimePointChangeAware (bool _arg)
	If true, the tool reacts to time point changes and updates the preview. More...

virtual bool	GetIsTimePointChangeAware ()

virtual void	IsTimePointChangeAwareOn ()

virtual void	IsTimePointChangeAwareOff ()

virtual void	SetResetsToEmptyPreview (bool _arg)
	If true, the preview is reset to empty on activation. More...

virtual bool	GetResetsToEmptyPreview ()

virtual void	ResetsToEmptyPreviewOn ()

virtual void	ResetsToEmptyPreviewOff ()

virtual void	SetUseSpecialPreviewColor (bool _arg)
	If true, a special color is used for the preview rendering. More...

virtual bool	GetUseSpecialPreviewColor ()

virtual void	UseSpecialPreviewColorOn ()

virtual void	UseSpecialPreviewColorOff ()

virtual void	SetRequestDeactivationConfirmation (bool _arg)
	If true, a confirmation dialog is shown before deactivating the tool. More...

virtual bool	GetRequestDeactivationConfirmation ()

virtual void	RequestDeactivationConfirmationOn ()

virtual void	RequestDeactivationConfirmationOff ()

Color	GetSpecialPreviewColor () const
	Returns the special preview color. More...

void	SetMergeStyle (MultiLabelSegmentation::MergeStyle mergeStyle)
	Sets how the preview content is merged into the working image upon confirmation. More...

virtual MultiLabelSegmentation::MergeStyle	GetMergeStyle ()

void	SetOverwriteStyle (MultiLabelSegmentation::OverwriteStyle overwriteStyle)
	Sets whether locked labels should be overwritten during transfer. More...

virtual MultiLabelSegmentation::OverwriteStyle	GetOverwriteStyle ()

void	SetLabelTransferScope (LabelTransferScope labelTransferScope)
	Sets which labels from the preview are transferred on confirmation. More...

virtual LabelTransferScope	GetLabelTransferScope ()

void	SetSelectedLabels (const SelectedLabelVectorType &labelsToTransfer)
	Sets the labels to transfer from preview to working image on confirmation. More...

virtual SelectedLabelVectorType	GetSelectedLabels ()

void	SetLabelTransferMode (LabelTransferMode labelTransferMode)
	Sets how labels are transferred from preview to the working image. More...

virtual LabelTransferMode	GetLabelTransferMode ()

bool	CanHandle (const BaseData referenceData, const BaseData workingData) const override
	Checks if a tool can handle the given reference data and optional working data. More...

void	UpdatePreview (bool ignoreLazyPreviewSetting=false)
	Triggers the update of the preview segmentation. More...

bool	IsUpdating () const

std::string	GetCurrentSegmentationName ()
	Returns the name of the currently selected segmentation node. More...

virtual DataNode *	GetTargetSegmentationNode () const
	Returns the currently selected segmentation node. More...

MultiLabelSegmentation *	GetTargetSegmentation () const

MultiLabelSegmentation *	GetPreviewSegmentation ()

const MultiLabelSegmentation *	GetPreviewSegmentation () const

DataNode *	GetPreviewSegmentationNode ()

void	SetPreviewOpacity (float opacity)

virtual float	GetPreviewOpacity () const

void	SetPreviewVisibility (bool visible)

virtual bool	GetPreviewVisibility () const

Public Member Functions inherited from mitk::Tool
	mitkClassMacro (Tool, EventStateMachine)

virtual us::ModuleResource	GetCursorIconResource () const
	Returns the cursor icon of the tool wrapped by a usModuleResource. 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...

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 ()

Protected Member Functions
	PickingTool ()

	~PickingTool () override

void	ConnectActionsAndFunctions () override

virtual void	OnAddPoint (StateMachineAction , InteractionEvent interactionEvent)
	Add point action of StateMachine pattern. More...

virtual void	OnDelete (StateMachineAction , InteractionEvent interactionEvent)
	Delete action of StateMachine pattern. More...

void	ClearSeeds ()
	Clear all seed points. More...

void	DoUpdatePreview (const Image inputAtTimeStep, const Image oldSegAtTimeStep, MultiLabelSegmentation *previewImage, TimeStepType timeStep) override

Protected Member Functions inherited from mitk::SegWithPreviewTool
	SegWithPreviewTool (bool lazyDynamicPreviews=false)

	SegWithPreviewTool (bool lazyDynamicPreviews, const char interactorType, const us::Module interactorModule=nullptr)

	~SegWithPreviewTool () override

const char *	GetGroup () const override
	Name of a group. More...

void	EnsureTargetSegmentationNodeInDataStorage () const

virtual void	InitiateToolByInput ()

virtual void	UpdatePrepare ()

virtual void	UpdateCleanUp ()

virtual void	ConfirmCleanUp ()

virtual void	PreparePreviewToResultTransfer (const LabelMappingType &labelMapping)
	Called before the preview content is transferred to the segmentation on confirmation. More...

const Image *	GetSegmentationInput () const

const Image *	GetReferenceData () const

void	ResetPreviewNode ()

void	ResetPreviewContent ()

void	ResetPreviewContentAtTimeStep (unsigned int timeStep)

TimePointType	GetLastTimePointOfUpdate () const

MultiLabelSegmentation::LabelValueType	GetActiveLabelValueOfPreview () const

virtual Label::PixelType	GetUserDefinedActiveLabel () const

virtual void	SetWorkingPlaneGeometry (PlaneGeometry *_arg)

virtual const PlaneGeometry *	GetWorkingPlaneGeometry ()

bool	ConfirmBeforeDeactivation () override
	Method call to invoke a dialog box just before exiting. More...

virtual void	OnTimePointChanged ()

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 ()

Protected Attributes
PointSet::Pointer	m_PointSet

DataNode::Pointer	m_PointSetNode

Protected Attributes inherited from mitk::SegWithPreviewTool
ToolCommand::Pointer	m_ProgressCommand

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

Additional Inherited Members
Public Types inherited from mitk::SegWithPreviewTool
enum class	LabelTransferScope { ActiveLabel , SelectedLabels , AllLabels }
	Defines which labels from the preview are transferred on confirmation. More...

enum class	LabelTransferMode { MapLabel , AddLabel }
	Defines how labels are transferred from preview to the working image. More...

using	SelectedLabelVectorType = std::vector< Label::PixelType >
	Type for the vector of selected label values. More...

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::SegWithPreviewTool
using	LabelMappingType = std::vector< std::pair< Label::PixelType, Label::PixelType > >

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::SegWithPreviewTool
static Image::ConstPointer	GetImageByTimeStep (const Image *image, TimeStepType timestep)

static Image::Pointer	GetImageByTimeStep (Image *image, TimeStepType timestep)

static Image::ConstPointer	GetImageByTimePoint (const Image *image, TimePointType timePoint)

static void	TransferLabelInformation (const LabelMappingType &labelMapping, const mitk::MultiLabelSegmentation source, mitk::MultiLabelSegmentation target)
	Copies label information (not pixel content) from one segmentation to another. More...

Detailed Description

Extracts a single region from a segmentation image and creates a new image with same geometry of the input image.

The region is extracted in 3D space. This is done by performing region growing within the desired region. Use shift click to add the seed point.

See also: mitk::Tool; QmitkInteractiveSegmentation

Definition at line 40 of file mitkPickingTool.h.

Constructor & Destructor Documentation

◆ PickingTool()

mitk::PickingTool::PickingTool ( )

protected

◆ ~PickingTool()

mitk::PickingTool::~PickingTool ( )

overrideprotected

Member Function Documentation

◆ Activated()

void mitk::PickingTool::Activated ( )

overridevirtual

Called when the tool gets activated.

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

Reimplemented from mitk::Tool.

◆ ClearPicks()

void mitk::PickingTool::ClearPicks ( )

Clears all seed picks and updates the preview.

◆ ClearSeeds()

void mitk::PickingTool::ClearSeeds ( )

protected

Clear all seed points.

◆ Clone()

Pointer mitk::PickingTool::Clone ( ) const

◆ ConnectActionsAndFunctions()

void mitk::PickingTool::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::PickingTool::Deactivated ( )

overridevirtual

Called when the tool gets deactivated.

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

Reimplemented from mitk::Tool.

◆ DoUpdatePreview()

void mitk::PickingTool::DoUpdatePreview	(	const Image *	inputAtTimeStep,
		const Image *	oldSegAtTimeStep,
		MultiLabelSegmentation *	previewImage,
		TimeStepType	timeStep
	)

overrideprotectedvirtual

This function does the real work. Here the preview for a given input image should be computed and stored in the also passed preview image at the passed time step. It also provides the current/old segmentation at the time point, which can be used, if the preview depends on the the segmentation so far.

Implements mitk::SegWithPreviewTool.

◆ GetIconResource()

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

overridevirtual

Returns the tool button icon of the tool wrapped by a usModuleResource.

Returns: A valid ModuleResource or an invalid one if this function is not reimplemented.

Reimplemented from mitk::Tool.

◆ GetName()

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

overridevirtual

Returns the name of this tool. Make it short!

This name has to fit into some kind of button in most applications, so take some time to think of a good name!

Note: The name is also recorded as label provenance via mitk::Label::AddToolUse, which reserves the separator characters "|" and ":". Avoid them in tool names (use plain spaces); names containing them are sanitized (separators replaced with "#") and a warning is logged.

Implements mitk::Tool.

◆ HasPicks()

bool mitk::PickingTool::HasPicks ( ) const

Returns whether any seed points have been placed.

Returns: true if there are picks, false otherwise.

◆ mitkClassMacro()

mitk::PickingTool::mitkClassMacro	(	PickingTool	,
		SegWithPreviewTool
	)

◆ New()

static Pointer mitk::PickingTool::New ( )

static

◆ OnAddPoint()

virtual void mitk::PickingTool::OnAddPoint	(	StateMachineAction *	,
		InteractionEvent *	interactionEvent
	)

protectedvirtual

Add point action of StateMachine pattern.

◆ OnDelete()

virtual void mitk::PickingTool::OnDelete	(	StateMachineAction *	,
		InteractionEvent *	interactionEvent
	)

protectedvirtual

Delete action of StateMachine pattern.

Member Data Documentation

◆ m_PointSet

PointSet::Pointer mitk::PickingTool::m_PointSet

protected

Definition at line 80 of file mitkPickingTool.h.

◆ m_PointSetNode

DataNode::Pointer mitk::PickingTool::m_PointSetNode

protected

Definition at line 81 of file mitkPickingTool.h.

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

mitkPickingTool.h

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ PickingTool()

◆ ~PickingTool()

Member Function Documentation

◆ Activated()

◆ ClearPicks()

◆ ClearSeeds()

◆ Clone()

◆ ConnectActionsAndFunctions()

◆ Deactivated()

◆ DoUpdatePreview()

◆ GetIconResource()

◆ GetName()

◆ HasPicks()

◆ mitkClassMacro()

◆ New()

◆ OnAddPoint()

◆ OnDelete()

Member Data Documentation

◆ m_PointSet

◆ m_PointSetNode