ito::PluginThreadCtrl Class Reference

Base class for DataIOThreadCtrl and ActuatorThreadCtrl. More...

#include <pluginThreadCtrl.h>

Inheritance diagram for ito::PluginThreadCtrl:

Public Member Functions
	PluginThreadCtrl ()
	default constructor. No plugin instance is currently under control.
	PluginThreadCtrl (const ito::ParamBase &pluginParameter, ito::RetVal *retval=NULL)
	Creates the control object for a plugin instance. More...
	PluginThreadCtrl (ito::AddInBase *plugin, ito::RetVal *retval=NULL)
	Creates the control object for a plugin instance. More...
	PluginThreadCtrl (const PluginThreadCtrl &other)
	copy constructor. The reference counter of the covered plugin by other will be incremented another time.
virtual	~PluginThreadCtrl ()
	destructor. Decrements the reference counter of the covered plugin and deletes it, if it drops to zero. More...
PluginThreadCtrl &	operator= (const PluginThreadCtrl &other)
	assigment operator. Gets control over the plugin currently covered by other. Decrements the reference counter of the former plugin and increments it of the plugin controlled by other.
ito::RetVal	getParam (ito::Param &val, int timeOutMS=PLUGINWAIT)
ito::RetVal	setParam (ito::ParamBase val, int timeOutMS=PLUGINWAIT)
ito::RetVal	waitForSemaphore (int timeOutMS=PLUGINWAIT)

Protected Attributes
ito::AddInBase *	m_pPlugin
ItomSharedSemaphoreLocker	m_semaphoreLocker

Detailed Description

Base class for DataIOThreadCtrl and ActuatorThreadCtrl.

This base class only provides access to setParam and getParam of the covered plugin in order to get or set internal parameters of the plugin. This is common for actuators and dataIO instances.

Constructor & Destructor Documentation

ito::PluginThreadCtrl::PluginThreadCtrl	(	const ito::ParamBase &	pluginParameter,
		ito::RetVal *	retval = NULL
	)

Creates the control object for a plugin instance.

This implementation gets the controlled instance from a ito::ParamBase object of param type ito::ParamBase::HWRef. Use this version, if the controlled plugin is passed to an algorithm or other plugin via a vector of mandatory or optional parameters in terms of ito::ParamBase objects.

This constructor increments the reference of the controlled plugin such that the plugin is not deleted until the reference has been decremented in the destructor of this class.

Parameters

pluginParameter	is a plugin parameter of type ito::ParamBase::HWRef.
retval	is an optional pointer to ito::RetVal. An error is set to this retval if the given plugin is no valid dataIO plugin instance.

Returns

(void)

See also

CameraThreadCtrl

ito::PluginThreadCtrl::PluginThreadCtrl	(	ito::AddInBase *	plugin,
		ito::RetVal *	retval = NULL
	)

Creates the control object for a plugin instance.

This implementation gets the controlled instance from the real pointer to a ito::AddInBase instance.

This constructor increments the reference of the controlled plugin such that the plugin is not deleted until the reference has been decremented in the destructor of this class.

Parameters

plugin	is the pointer to the controlled plugin.
retval	is an optional pointer to ito::RetVal. An error is set to this retval if the given plugin is no valid plugin instance.

ito::PluginThreadCtrl::~PluginThreadCtrl ( )

virtual

destructor. Decrements the reference counter of the covered plugin and deletes it, if it drops to zero.

The destructor

Member Function Documentation

ito::RetVal ito::PluginThreadCtrl::getParam	(	ito::Param &	val,
		int	timeOutMS = PLUGINWAIT
	)

Get a parameter of the plugin

Get any parameter of the camera defined by val.name. val must be initialised and name must be correct. After correct execution, val has the correct value.

Parameters

	[in|out]	val Initialised tParam (correct name | in)
[in]	timeOutMS	TimeOut for the semaphore-wait

Returns

retOk or retError

ito::RetVal ito::PluginThreadCtrl::setParam	(	ito::ParamBase	val,
		int	timeOutMS = PLUGINWAIT
	)

Set a parameter of the plugin

Get the parameter of the plugin defined by val.name to the value of val.

Parameters

[in]	val	Initialised tParam (correct name | value)
[in]	timeOutMS	TimeOut for the semaphore-wait

Returns

retOk or retError

ito::RetVal ito::PluginThreadCtrl::waitForSemaphore

(

int

timeOutMS = PLUGINWAIT

)

Wait until plugin thread has finished the last command

After the invoke-command this thread must wait / be synchronize with the plugin-thread. Therefore the wait-Function of m_semaphoreLocker is called. If the plugin do not answer within timeOutMS and the pMyCamera is not alive anymore, the function returns a timeout.

Parameters

[in]

timeOutMS

timout for the wait. -1: endless wait until the plugin finished the last invokation or it is not 'alive' anymore, 0: no wait (this method does nothing), >0: time in ms

Returns

retOk if semaphore was successfully released, retError if semaphore returned an error message or if a timeout occurred (error code: 256)

Member Data Documentation

ito::AddInBase* ito::PluginThreadCtrl::m_pPlugin

protected

Handle to the plugin

ItomSharedSemaphoreLocker ito::PluginThreadCtrl::m_semaphoreLocker

protected

Handle to the semaphore needed for thread save communication. Allocated in constructor, deleted in destructor

---

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

• C:/itom/sources/itom/common/pluginThreadCtrl.h
• C:/itom/sources/itom/common/sources/pluginThreadCtrl.cpp