This action launchs an activity according to the selected data. More...

#include <SActivityLauncher.hpp>

Inheritance diagram for activities::action::SActivityLauncher:

Collaboration diagram for activities::action::SActivityLauncher:

Public Member Functions
virtual bool	isA (const std::string &type) const override

ACTIVITIES_API	SActivityLauncher () noexcept
	Constructor. Do nothing.

virtual ACTIVITIES_API	~SActivityLauncher () noexcept
	Destructor. Do nothing.

virtual ACTIVITIES_API KeyConnectionsType	getObjSrvConnections () const override
	Returns proposals to connect service slots to associated object signals, this method is used for obj/srv auto connection. More...

Public Member Functions inherited from fwGui::IActionSrv
FWGUI_API void	actionServiceStopping ()
	Method called when the action service is stopping.

FWGUI_API void	actionServiceStarting ()
	Method called when the action service is starting.

virtual FWGUI_API void	setIsActive (bool isActive)
	Set the action service is active/inactive.

virtual FWGUI_API void	activate ()
	Set the action service is active.

virtual FWGUI_API void	deactivate ()
	Set the action service is not active.

FWGUI_API bool	getIsActive () const
	Return true if action service is active.

bool	getActiveStateValue () const
	Return true if action 'check' feedback is inverted.

virtual FWGUI_API void	setIsExecutable (bool isExecutable)
	Set the action service executable or not.

virtual FWGUI_API void	setExecutable ()
	Set the action service executable.

virtual FWGUI_API void	setInexecutable ()
	Set the action service not executable.

FWGUI_API bool	getIsExecutable () const
	Return action service is executable.

FWGUI_API void	setVisible (bool isVisible)
	Show or hide the action.

FWGUI_API void	show ()
	Show the action.

FWGUI_API void	hide ()
	Hide the action.

FWGUI_API bool	isVisible () const
	Returns true if action is visible.

FWGUI_API bool	confirmAction ()
	Confirm that the action must be executed. More...

Public Member Functions inherited from fwServices::IService
FWSERVICES_API void	registerInput (const ::fwData::Object::csptr &obj, const std::string &key, const bool autoConnect=false, const bool optional=false)
	Register an input object for this service. More...

FWSERVICES_API void	registerInOut (const ::fwData::Object::sptr &obj, const std::string &key, const bool autoConnect=false, const bool optional=false)
	Register an in/out object for this service. More...

FWSERVICES_API void	setConfiguration (const ::fwRuntime::ConfigurationElement::sptr _cfgElement)
	Affect the configuration, using a generic XML like structure. More...

FWSERVICES_API void	setConfiguration (const Config &_configuration)
	Set the configuration. More...

FWSERVICES_API void	setConfiguration (const ConfigType &ptree)
	Affect the configuration, using a boost property tree. More...

FWSERVICES_API void	configure ()
	Invoke configuring() if m_globalState == STOPPED. Invoke reconfiguring() if m_globalState == STARTED. Does nothing otherwise. More...

FWSERVICES_API SharedFutureType	start ()
	Invoke starting() if m_globalState == STOPPED. Does nothing otherwise. More...

FWSERVICES_API SharedFutureType	stop ()
	Invoke stopping() if m_globalState == STARTED. Does nothing otherwise. Stops all observations. More...

FWSERVICES_API SharedFutureType	update ()
	Invoke updating() if m_globalState == STARTED. Does nothing otherwise. More...

FWSERVICES_API SharedFutureType	swap (::fwData::Object::sptr _obj)
	Associate the service to another object. More...

FWSERVICES_API SharedFutureType	swapKey (const KeyType &_key,::fwData::Object::sptr _obj)
	Associate the service to another object. More...

FWSERVICES_API GlobalStatus	getStatus () const noexcept
	Return the global process status. More...

FWSERVICES_API bool	isStarted () const noexcept
	Test if the service is started or not. More...

FWSERVICES_API bool	isStopped () const noexcept
	Test if the service is stopped or not. More...

FWSERVICES_API ConfigurationStatus	getConfigurationStatus () const noexcept
	Return the configuration process status. More...

FWSERVICES_API UpdatingStatus	getUpdatingStatus () const noexcept
	Return the update process status. More...

FWSERVICES_API::fwRuntime::ConfigurationElement::sptr	getConfiguration () const
	Return the configuration, in an xml format read using runtime library. More...

FWSERVICES_API ConfigType	getConfigTree () const
	Return the configuration, in an boost property tree.

FWSERVICES_API::fwData::Object::sptr	getObject ()
	Return the object associated to service. More...

template<class DATATYPE >
std::shared_ptr< DATATYPE >	getObject ()
	Return the object associated to service. The object is casted. More...

FWSERVICES_API const InputMapType &	getInputs () const
	Return the inputs map associated to service. More...

FWSERVICES_API const InOutMapType &	getInOuts () const
	Return the inouts map associated to service. More...

FWSERVICES_API const OutputMapType &	getOutputs () const
	Return the outouts map associated to service. More...

FWSERVICES_API std::vector< ::fwData::Object::csptr >	getObjects () const
	Return the objects associated to service. More...

template<class DATATYPE >
std::shared_ptr< const DATATYPE >	getInput (const KeyType &key) const
	Return the input object at the given key. Asserts if the data is not of the right type. More...

template<class DATATYPE >
std::shared_ptr< DATATYPE >	getInOut (const KeyType &key) const
	Return the inout object at the given key. Asserts if the data is not of the right type. More...

template<class DATATYPE >
std::shared_ptr< DATATYPE >	getOutput (const KeyType &key) const
	Return the output object at the given key. Asserts if the data is not of the right type. More...

template<class DATATYPE >
std::shared_ptr< const DATATYPE >	getInput (const KeyType &keybase, size_t index) const
	Return the input object at the given key. Asserts if the data is not of the right type. More...

template<class DATATYPE >
std::shared_ptr< DATATYPE >	getInOut (const KeyType &keybase, size_t index) const
	Return the inout object at the given key. Asserts if the data is not of the right type. More...

template<class DATATYPE >
std::shared_ptr< DATATYPE >	getOutput (const KeyType &keybase, size_t index) const
	Return the output object at the given key. Asserts if the data is not of the right type. More...

FWSERVICES_API void	setOutput (const ::fwServices::IService::KeyType &key, const ::fwData::Object::sptr &object, size_t index=0)
	Register an output object at a given key in the OSR, replacing it if it already exists. More...

size_t	getKeyGroupSize (const KeyType &keybase) const
	Return the number of key in a group of keys. More...

FWSERVICES_API void	setWorker (std::shared_ptr< ::fwThread::Worker > worker)
	Initializes m_associatedWorker and associates this worker to all service slots.

FWSERVICES_API std::shared_ptr< ::fwThread::Worker >	getWorker () const
	Returns associate worker.

FWSERVICES_API bool	hasObjectId (const KeyType &_key) const
	Return true if the object with the given key has an identifier. More...

FWSERVICES_API IdType	getObjectId (const KeyType &_key) const
	Return the id of the object, throw if it is not found.

FWSERVICES_API void	setObjectId (const KeyType &_key, const IdType &_id)
	Set the id of an object key.

Public Member Functions inherited from fwTools::Object
Public Member Functions inherited from fwCore::BaseObject
Public Member Functions inherited from fwCom::HasSlots
std::shared_ptr< SlotBase >	slot (const Slots::SlotKeyType &key) const

template<typename SlotType >
std::shared_ptr< SlotType >	slot (const Slots::SlotKeyType &key) const

template<typename F , typename A >
std::shared_ptr< Slot< typename::fwCom::util::convert_function_type< F >::type > >	newSlot (const Slots::SlotKeyType &key, F f, A a)

Public Member Functions inherited from fwCom::HasSignals
std::shared_ptr< SignalBase >	signal (const Signals::SignalKeyType &key) const

template<typename SignalType >
std::shared_ptr< SignalType >	signal (const Signals::SignalKeyType &key) const

template<typename SignalType >
std::shared_ptr< SignalType >	newSignal (const Signals::SignalKeyType &key)

Static Public Member Functions
static bool	isTypeOf (const std::string &type)

Static Public Member Functions inherited from fwGui::IActionSrv
static bool	isTypeOf (const std::string &type)

static const std::string &	leafClassname ()
	return object's classname without its namespace, i.e. BaseObject

static const std::string &	classname ()
	return object's classname without its namespace, i.e. BaseObject

Static Public Member Functions inherited from fwServices::IService
static bool	isTypeOf (const std::string &type)

static const std::string &	leafClassname ()
	return object's classname without its namespace, i.e. BaseObject

static const std::string &	classname ()
	return object's classname without its namespace, i.e. BaseObject

Static Public Member Functions inherited from fwTools::Object
static bool	isTypeOf (const std::string &type)

static const std::string &	classname ()
	return full object's classname with its namespace, i.e. fwCore::BaseObject

Static Public Member Functions inherited from fwCore::BaseObject
static bool	isTypeOf (const std::string &type)

static const std::string &	leafClassname ()
	return object's classname without its namespace, i.e. BaseObject

static const std::string &	classname ()
	return object's classname without its namespace, i.e. BaseObject

Static Public Attributes
Slot API
static ACTIVITIES_APIconst::fwCom::Slots::SlotKeyType	s_LAUNCH_SERIES_SLOT

static ACTIVITIES_APIconst::fwCom::Slots::SlotKeyType	s_LAUNCH_ACTIVITY_SERIES_SLOT = "launchActivitySeries"

static ACTIVITIES_APIconst::fwCom::Slots::SlotKeyType	s_UPDATE_STATE_SLOT = "updateState"

Static Public Attributes inherited from fwGui::IActionSrv
static const ::fwCom::Slots::SlotKeyType	s_SET_VISIBLE_SLOT = "setVisible"
	Slot to show/hide the action.

static const ::fwCom::Slots::SlotKeyType	s_SHOW_SLOT = "show"
	Slot to disable the action.

static const ::fwCom::Slots::SlotKeyType	s_HIDE_SLOT = "hide"
	Slot to disable the action.

static const ::fwCom::Slots::SlotKeyType	s_SET_IS_ACTIVE_SLOT = "setIsActive"
	Slot to activate/deactivate the action.

static const ::fwCom::Slots::SlotKeyType	s_ACTIVATE_SLOT = "activate"
	Slot to activate the action.

static const ::fwCom::Slots::SlotKeyType	s_DEACTIVATE_SLOT = "deactivate"
	Slot to desactivate the action.

static const ::fwCom::Slots::SlotKeyType	s_SET_IS_EXECUTABLE_SLOT = "setIsExecutable"
	Slot to enable/disable the action.

static const ::fwCom::Slots::SlotKeyType	s_SET_EXECUTABLE_SLOT = "setExecutable"
	Slot to enable the action.

static const ::fwCom::Slots::SlotKeyType	s_SET_INEXECUTABLE_SLOT = "setInexecutable"
	Slot to disable the action.

static const ::fwCom::Signals::SignalKeyType	s_ENABLED_SIG = "enabled"
	Signal emitted when action is enabled.

static const ::fwCom::Signals::SignalKeyType	s_DISABLED_SIG = "disabled"
	Signal emitted when action is enabled.

static const ::fwCom::Signals::SignalKeyType	s_CHECKED_SIG = "checked"
	Signal emitted when action is enabled.

static const ::fwCom::Signals::SignalKeyType	s_UNCHECKED_SIG = "unchecked"
	Signal emitted when action is enabled.

Static Public Attributes inherited from fwServices::IService
static FWSERVICES_API const std::string	s_DEFAULT_OBJECT = "defaultObject"

static FWSERVICES_APIconst::fwCom::Slots::SlotKeyType	s_STARTED_SIG = "started"

static FWSERVICES_APIconst::fwCom::Slots::SlotKeyType	s_UPDATED_SIG = "updated"

static FWSERVICES_APIconst::fwCom::Slots::SlotKeyType	s_STOPPED_SIG = "stopped"

static FWSERVICES_APIconst::fwCom::Slots::SlotKeyType	s_START_SLOT = "start"
	Slot to call start method.

static FWSERVICES_APIconst::fwCom::Slots::SlotKeyType	s_STOP_SLOT = "stop"
	Slot to call start method.

static FWSERVICES_APIconst::fwCom::Slots::SlotKeyType	s_UPDATE_SLOT = "update"
	Slot to call start method.

static FWSERVICES_APIconst::fwCom::Slots::SlotKeyType	s_SWAP_SLOT = "swap"
	Slot to call start method.

static FWSERVICES_APIconst::fwCom::Slots::SlotKeyType	s_SWAPKEY_SLOT = "swapKey"
	Slot to call start method.

Protected Types
typedef ::fwActivities::registry::ActivityAppConfig::ActivityAppConfigParamsType	ParametersType

typedef std::vector< std::string >	KeysType

typedef std::map< std::string, std::string >	QuickLaunchType

Protected Types inherited from fwGui::IActionSrv
typedef ::fwRuntime::ConfigurationElement::sptr	ConfigurationType

Protected Types inherited from fwTools::fwID
enum	Policy { EMPTY = 1, GENERATE, MUST_EXIST }

typedef std::string	IDType

Protected Member Functions
virtual ACTIVITIES_API KeyConnectionsMap	getAutoConnections () const override
	Returns proposals to connect service slots to associated object signals, this method is used for obj/srv auto connection. More...

virtual void	starting () override
	This method launches the IAction::starting method.

virtual void	stopping () override
	This method launches the IAction::stopping method.

virtual void	updating () override
	Show activity selector.

virtual void	configuring () override
	Initialize the action. More...

virtual void	updateState ()

ParametersType	translateParameters (const ParametersType &parameters)
	Interpret configuration parameters.

Protected Member Functions inherited from fwGui::IActionSrv
FWGUI_API void	initialize ()
	Initialize the action. More...

Protected Member Functions inherited from fwServices::IService
FWSERVICES_API	IService ()
	IService constructor. More...

virtual FWSERVICES_API	~IService ()
	IService desctructor. More...

virtual void	swapping ()
	Swap the service from associated object to another object. More...

virtual void	swapping (const KeyType &key)
	Swap the service from an associated object to another object. The key in parameter indicates allows to retrieve the new data with getInput(), getInOut() or getOutput(). If you need the old object, you need to keep a shared pointer on it inside your service implementation. More...

virtual FWSERVICES_API void	reconfiguring ()
	Reconfigure the service activity when is started. More...

virtual FWSERVICES_API void	info (std::ostream &_sstream)
	Write information in a stream. More...

Protected Member Functions inherited from fwTools::fwID
FWTOOLS_API bool	hasID () const
	Return true if the object has an id set. More...

FWTOOLS_API IDType	getID (Policy policy=GENERATE) const
	Returns the id of the object. If it is not set and the policy value is. More...

virtual FWTOOLS_API void	setID (IDType newID)
	Set a newID for the object, (newID must not exist in fwID), the oldest one is released. More...

FWTOOLS_API void	resetID ()
	Release the id for the object. More...

	fwID ()
	Constructor : does nothing.

Protected Member Functions inherited from fwCom::HasSlots
	HasSlots (const HasSlots &)
	Copy constructor forbidden.

HasSlots &	operator= (const HasSlots &)
	Copy operator forbidden.

Protected Member Functions inherited from fwCom::HasSignals
	HasSignals (const HasSignals &)
	Copy constructor forbidden.

HasSignals &	operator= (const HasSignals &)
	Copy operator forbidden.

Friends
template<class , class , class >
class	::fwTools::ClassFactory

class	::fwTools::Factory

Demangling methods
virtual const std::string &	getLeafClassname () const override
	return object's classname without its namespace, i.e. BaseObject

virtual const std::string &	getClassname () const override
	return full object's classname with its namespace, i.e. fwCore::BaseObject

static const std::string &	leafClassname ()
	return object's classname without its namespace, i.e. BaseObject

static const std::string &	classname ()
	return object's classname without its namespace, i.e. BaseObject

Signal API
typedef ::fwCom::Signal< void(::fwActivities::registry::ActivityMsg) >	ActivityLaunchedSignalType
	Key in m_signals map of signal m_sigActivityLaunched.

static ACTIVITIES_APIconst::fwCom::Signals::SignalKeyType	s_ACTIVITY_LAUNCHED_SIG = "activityLaunched"
	Key in m_signals map of signal m_sigActivityLaunched.

Additional Inherited Members
Public Types inherited from fwGui::IActionSrv
typedef ::fwCom::Signal< void()>	EnabledSignalType
	Signal emitted when action is enabled.

typedef ::fwCom::Signal< void()>	DisabledSignalType
	Signal emitted when action is disabled.

typedef ::fwCom::Signal< void()>	CheckedSignalType
	Signal emitted when action is checked.

typedef ::fwCom::Signal< void()>	UncheckedSignalType
	Signal emitted when action is unchecked.

Public Types inherited from fwServices::IService
enum	AccessType : std::uint8_t { INPUT, OUTPUT, INOUT }

typedef ::boost::property_tree::ptree	ConfigType

typedef std::string	IdType

typedef std::string	KeyType

typedef std::map< KeyType, std::weak_ptr< const ::fwData::Object > >	InputMapType

typedef std::map< KeyType, std::weak_ptr< ::fwData::Object > >	InOutMapType

typedef std::map< KeyType, std::shared_ptr< ::fwData::Object > >	OutputMapType

enum	GlobalStatus { STARTED, STARTING, SWAPPING, STOPPED, STOPPING }
	Defines all possible global status for a service, including transitions. More...

enum	UpdatingStatus { UPDATING, NOTUPDATING }
	Defines all possible status for an update process. More...

enum	ConfigurationStatus { CONFIGURING, CONFIGURED, UNCONFIGURED }
	Defines all possible status for a configuration process. More...

typedef ::fwCom::Signal< void()>	StartedSignalType

typedef ::fwCom::Signal< void()>	UpdatedSignalType

typedef ::fwCom::Signal< void()>	StoppedSignalType

typedef std::shared_future< void >	SharedFutureType
	Slot to call start method.

typedef std::packaged_task< void()>	PackagedTaskType
	Slot to call start method.

typedef std::future< void >	UniqueFutureType
	Slot to call start method.

typedef ::fwCom::Slot< SharedFutureType()>	StartSlotType
	Slot to call start method.

typedef ::fwCom::Slot< SharedFutureType()>	StopSlotType
	Slot to call start method.

typedef ::fwCom::Slot< SharedFutureType()>	UpdateSlotType
	Slot to call start method.

typedef ::fwCom::Slot< SharedFutureType(::fwData::Object::sptr)>	SwapSlotType
	Slot to call start method.

typedef ::fwCom::Slot< SharedFutureType(const KeyType &,::fwData::Object::sptr)>	SwapKeySlotType
	Slot to call start method.

typedef ::fwCom::helper::SigSlotConnection::KeyConnectionsType	KeyConnectionsType
	Returns proposals to connect service slots to associated object signals, this method is used for obj/srv auto connection. More...

Public Types inherited from fwCom::HasSlots
typedef std::shared_ptr< HasSlots >	sptr

typedef std::shared_ptr< const HasSlots >	csptr

Public Types inherited from fwCom::HasSignals
typedef std::shared_ptr< HasSignals >	sptr

typedef std::shared_ptr< const HasSignals >	csptr

Static Protected Member Functions inherited from fwTools::fwID
static bool	isTypeOf (const std::string &type)

static FWTOOLS_API bool	exist (IDType _id)

static FWTOOLS_API std::shared_ptr< ::fwTools::Object >	getObject (IDType requestID)
	Retrieve the object attached to the given id. Return a null sptr if no correspondence exist. More...

static const std::string &	leafClassname ()
	return object's classname without its namespace, i.e. BaseObject

static const std::string &	classname ()
	return object's classname without its namespace, i.e. BaseObject

Protected Attributes inherited from fwServices::IService
::fwRuntime::ConfigurationElement::sptr	m_configuration
	Configuration element used to configure service internal state using a generic XML like structure TODO Make this const, we are not supposed to edit that !

::fwData::Object::wptr	m_associatedObject
	associated object of service More...

StartSlotType::sptr	m_slotStart
	Slot to call start method.

StopSlotType::sptr	m_slotStop
	Slot to call stop method.

UpdateSlotType::sptr	m_slotUpdate
	Slot to call update method.

SwapSlotType::sptr	m_slotSwap
	Slot to call swap method.

SwapKeySlotType::sptr	m_slotSwapKey
	Slot to call swap method.

std::shared_ptr< ::fwThread::Worker >	m_associatedWorker
	Associated worker.

Protected Attributes inherited from fwTools::Object
std::shared_ptr< ::fwTools::UUID >	m_uuid
	UUID used to identify the object, notably for serialization.

Protected Attributes inherited from fwCom::HasSlots
Slots	m_slots

Protected Attributes inherited from fwCom::HasSignals
Signals	m_signals

Detailed Description

This action launchs an activity according to the selected data.

This action works on a fwData::Vector. It proposes all the available activity according to the selected data and the given configuration. And then, send a signal with all the activity information.

This action should be followed by the service 'guiQt::editor::DynamicView' : this service listens the action signals and launchs the activity in a new tab.

Slots

launchSeries(::fwMedData::Series::sptr) : This slot allows to launch the series. If series is an ActivitySeries, it is launched, otherwise it launches the first available activity for this series or used m_quickLaunch information if a default association is defined for this series type. It sends the signal 'activityLaunched' with all the activity information.
launchActivitySeries(::fwMedData::ActivitySeries::sptr) : This slot allows to launch the given activity series. It sends the signal 'activityLaunched' with all the activity information.
updateState() : Updates action state (enable if activities are available for current selection).

Signal

activityLaunched(::fwActivities::registry::ActivityMsg) : This signal is emitted when the activity is created, it contains the activity information. It should be connected to the slot 'createTab' of the service 'guiQt::editor::SDynamicView'.

XML Configuration

 <service uid="action_newActivity" type="::activities::action::SActivityLauncher" autoConnect="yes" >
     <in key="series" uid="..." />
     <config>
         <!-- SActivityLauncher mode : immediate or message(default)
              Immediate mode starts and stop immediatly the activity's config -->
         <mode>immediate</mode>
         <parameters>
             <parameter replace="SERIESDB" by="medicalData" />
             <parameter replace="IMAGE" by="@values.ImageSeries.image" />
         </parameters>
 
         <!-- Filter mode 'include' allows all given activity id-s.
              Filter mode 'exclude' allows all activity id-s excepted given ones. -->
         <filter>
             <mode>include</mode>
             <id>2DVisualizationActivity</id>
             <id>3DVisualizationActivity</id>
             <id>VolumeRenderingActivity</id>
         </filter>
 
         <!-- Definition of quick association between series type and an activity id.
              This mapping is used by launchSeries slot (see the function to have few details ) -->
         <quickLaunch>
             <association type="::fwMedData::ImageSeries" id="2DVisualizationActivity" />
             <association type="::fwMedData::ModelSeries" id="3DVisualizationActivity" />
         </quickLaunch>
     </config>
 </service>

Input

series [fwData::Vector]: vector containg series inherited from fwMedData::Series

Configuration

mode (optional): there are two mode: "message" and "immediate"
- message (used by default): the action send a signal containing the information needed to launch the chosen activity. The service 'guiQt::editor::DynamicView' allows to launch the activity in a new tab. For that, it must listen the action signal.
- immediate: the activity is automatically started et stopped by this action. It is used to run a process without creating a new tab, for example, to save the selected data.
parameters (optional): list of the parameters used to launch the activity, it is the parameters for the AppConfig associated to the activity.
- parameter: defines a parameter
  - replace: name of the parameter as defined in the AppConfig
  - by: defines the string that will replace the parameter name. It should be a simple string (ex. frontal) or define a sesh@ path (ex. @values.myImage). The root object of the sesh@ path if the composite contained in the ActivitySeries.
filter (optional): it allows to filter the activity that can be proposed.
- mode: 'include' or 'exclude'. Defines if the activity in the following list are proposed (include) or not (exclude).
- id: id of the activity
quickLaunch (optional): defines the activity that will be launched on a double-click on a series. The launched activity depends of the series type (ImageSeries, ModelSeries, ...).
- association: allows to associate an activity to launch with a type of series
  - type: type of series (fwMedData::ImageSeries, fwMedData::ModelSeries, ....)
  - id: identifier of the activity.

Note

A sesh@ path is a path used to browse an object (and sub-object) using the introspection (see fwDataCamp). The path begins with a '@' or a '!'.

'@' : the returned string is the fwID of the sub-object defined by the path.
'!' : the returned string is the value of the sub-object, it works only on String, Integer, Float and Boolean object.

Definition at line 114 of file SActivityLauncher.hpp.