A specialization of WsfMessageProcessor that implements an example image processor. More...

#include <WsfImageProcessor.hpp>

Inheritance diagram for WsfImageProcessor:

[legend]

Collaboration diagram for WsfImageProcessor:

[legend]

Classes
class	ObjectTest
class	State
class	Status

Target recognition attributes.
enum	TargetRecognitionState { cST_UNDETECTED , cST_WAITING_DETECTION , cST_DETECTED , cST_WAITING_CLASSIFICATION , cST_CLASSIFIED , cST_WAITING_IDENTIFICATION , cST_IDENTIFIED }
	WsfImageProcessor (WsfScenario &aScenario)
	Constructor.
	~WsfImageProcessor () override
	Destructor.
WsfProcessor *	Clone () const override
bool	Initialize (double aSimTime) override
bool	ProcessInput (UtInput &aInput) override
bool	ProcessMessage (double aSimTime, const WsfMessage &aMessage) override
bool	ReceiveMessage (double aSimTime, const WsfMessage &aMessage) override
	This implementation rejects messages that are not a WsfImageMessage or WsfVideoMessage.
void	TurnOff (double aSimTime) override
double	GetCoastTime () const
	Return the value of 'coast_time'.
	WsfImageProcessor (const WsfImageProcessor &aSrc)
	Copy constructor for Clone().
WsfImageProcessor &	operator= (const WsfImageProcessor &)=delete
virtual void	ImageProcessingCompleted (double aSimTime, const WsfImage &aImage)
virtual void	ImageProcessingInitiated (double aSimTime, const WsfImage &aImage)
virtual bool	IsDetectable (double aSimTime, const WsfImage &aImage, const WsfImage::Object &aObject)
virtual void	TrackDropped (double aSimTime, const WsfTrack &aTrack)
virtual void	UpdateTrack (double aSimTime, WsfTrack &aTrack, const WsfImage &aImage, const WsfImage::Object &aObject)

Additional Inherited Members
using	ComponentList = WsfComponentListT<WsfProcessorComponent>
Public Types inherited from WsfPlatformPart
enum	{ cLEVEL_ONE_DEBUG = 0x00000001 , cLEVEL_TWO_DEBUG = 0x00000002 }
using	InternalMessageQueue = std::queue<WsfMessage*>
using	RecipientMessageQueue = std::queue<std::pair<WsfPlatformPart, WsfMessage>>
Public Types inherited from WsfObject
typedef std::vector< WsfStringId >	TypeList
	The list of types returned by GetTypeList.
Public Types inherited from WsfComponentT< WsfPlatform >
typedef WsfPlatform	ParentType
	This is needed to support the WsfComponentList template.
Public Member Functions inherited from WsfMessageProcessor
	WsfMessageProcessor (WsfScenario &aScenario)
WsfMessageProcessor &	operator= (const WsfMessageProcessor &)=delete
	~WsfMessageProcessor () override
WsfProcessor *	Clone () const override
bool	Initialize (double aSimTime) override
bool	ProcessInput (UtInput &aInput) override
bool	ProcessMessage (double aSimTime, const WsfMessage &aMessage) override
bool	ReceiveMessage (double aSimTime, const WsfMessage &aMessage) override
void	SendMessage (double aSimTime, const WsfMessage &aMessage) override
void	TurnOff (double aSimTime) override
void	TurnOn (double aSimTime) override
void	Update (double aSimTime) override
bool	ProcessAction (double aSimTime, const WsfMessage &aMessage)
	Execute custom actions (scripts) based on the message type.
Public Member Functions inherited from WsfScriptProcessor
	WsfScriptProcessor (const WsfScenario &aScenario)
	WsfScriptProcessor (const WsfScenario &aScenario, WsfStringId aPartClass, const std::string &aPartVarName)
	~WsfScriptProcessor () override
WsfProcessor *	Clone () const override
bool	Initialize (double aSimTime) override
bool	Initialize2 (double aSimTime) override
bool	ProcessInput (UtInput &aInput) override
void	Update (double aSimTime) override
bool	ProcessMessage (double aSimTime, const WsfMessage &aMessage) override
void	SendMessage (double aSimTime, const WsfMessage &aMessage) override
virtual void	ExecuteOnMessageCreate (double aSimTime, WsfMessage &aMessage)
virtual bool	ExecuteScript (double aSimTime, const std::string &aScriptName)
virtual bool	ExecuteScript (double aSimTime, WsfStringId aScriptName, UtScriptData &aScriptRetVal, const UtScriptDataList &aScriptArgs=UtScriptDataList())
void	ExecuteScriptAtTime (double aTime, WsfStringId aScriptName, const UtScriptDataList &aScriptArgs)
virtual void	SuppressMessage (bool aSuppressMessage)
WsfScriptMessageHandler *	GetMessageHandler ()
WsfScriptContext &	GetScriptContext ()
UtScriptContext *	GetScriptAccessibleContext () const override
void	SetPlatform (WsfPlatform *aPlatformPtr) override
const WsfBehaviorTree *	BehaviorTree () const
WsfAdvancedBehaviorTree *	AdvancedBehaviorTree () const
virtual const WsfScriptStateMachine *	GetStateMachine () const
wsf::ExternalLinks &	GetExternalLinks ()
std::string	State ()
std::string	StateAll ()
void	SetState (std::string &stateName)
void	SetStateAll (std::string &stateNameAll)
Public Member Functions inherited from WsfProcessor
	WsfProcessor (const WsfScenario &aScenario)
	~WsfProcessor () override=default
ComponentList &	GetComponents ()
const ComponentList &	GetComponents () const
virtual void	ProcessCallback (double aSimTime, const WsfCallback &aCallback)
WsfComponent *	CloneComponent () const override
const int *	GetComponentRoles () const override
void *	QueryInterface (int aRole) override
int	GetComponentInitializationOrder () const override
const char *	GetScriptClassName () const override
bool	PreInitialize (double aSimTime) override
void	PreInput () override
void	TurnOff (double aSimTime) override
void	TurnOn (double aSimTime) override
void	SetNonOperational (double aSimTime) override
void	SetOperational (double aSimTime) override
void	PartBroken (double aSimTime) override
double	GetUpdateInterval () const override
void	SetUpdateInterval (double aUpdateInterval) override
Public Member Functions inherited from WsfPlatformPart
	WsfPlatformPart (const WsfScenario &aScenario, int aPartType)
WsfPlatformPart &	operator= (const WsfPlatformPart &aRhs)=delete
	~WsfPlatformPart () override
bool	DebugEnabled () const
	Returns 'true' if debugging is enabled for this instance.
void	SetDebugEnabled (bool aDebugEnabled)
unsigned int	GetDebugMask ()
bool	IsExternallyControlled () const
virtual void	SetExternallyControlled (double aSimTime, bool aIsExternallyControlled)
int	GetPartType () const
const char *	GetScriptClassName () const override
WsfSimulation *	GetSimulation () const
const WsfScenario &	GetScenario () const
WsfStringId	GetComponentName () const override
void	ComponentParentChanged (WsfPlatform *aPlatformPtr) override
WsfPlatform *	GetPlatform () const
virtual void	PlatformAdded (double aSimTime, WsfPlatform *aPlatformPtr)
virtual void	PlatformDeleted (WsfPlatform *aPlatformPtr)
double	GetLastStatusChangeTime () const
void	SetLastStatusChangeTime (double aSimTime)
	Allows a system to set the time at which the device was initialized.
bool	CanBeMadeOperational () const
	Returns an indication that this system can be made operational.
bool	CanBeMadeNonOperational () const
	Returns an indication that this system can be made non-operational.
bool	CanBeTurnedOn () const
	Returns an indication that this system can be turned on.
bool	CanBeTurnedOff () const
	Returns an indication that this system can be turned off.
bool	IsTurnedOn () const
bool	InitiallyTurnedOn () const
	Is the system to be turned 'on' when added to the simulation?
void	SetInitiallyTurnedOn (bool aInitiallyTurnedOn)
	Sets if the system is turned on when added to the simulation.
virtual void	Restore (double aSimTime)
bool	IsOperational () const
bool	SetOperational (double aSimTime, bool aMakeOperational)
double	GetDamageFactor () const
bool	SetDamageFactor (double aSimTime, double aDamageFactor)
bool	IsCritical () const
void	SetCritical (bool aValue)
virtual void	OnPlatformBrokenEvent (double aSimTime)
	Owning platform has issued a broken event.
bool	IsBroken () const
WsfInternalLinks &	GetInternalLinks ()
	Return the internal links for this part.
virtual bool	HasInternalLinks () const
	Does this platform part have a communication link to other platform parts?
virtual void	SendMessageTo (double aSimTime, const WsfMessage &aMessage, WsfStringId aRecipientId)
void	SendMessageToProcessor (double aSimTime, const WsfMessage &aMessage, WsfStringId aRecipientId)
virtual void	SendQueuedMessages (double aSimTime)
const WsfCategoryList &	GetCategories () const
	Get the categories to which this part belongs.
void	AddCategory (WsfStringId aCategoryId)
	Adds the provided category to the platform part's category list.
bool	IsCategoryMember (WsfStringId aCategoryId) const
const WsfGroupList &	GetGroups () const
	Get the groups to which this platform part belongs.
void	JoinGroup (WsfGroup *aGroupPtr)
	Join the given group.
void	LeaveGroup (WsfGroup *aGroupPtr)
	Leave the given group.
bool	IsGroupMember (WsfStringId aGroupId)
unsigned int	GetUpdateEventEpoch () const
void	IncrementUpdateEventEpoch ()
bool	UpdateEventActive () const
	Is an 'Update' event active?
void	SetUpdateEventActive (bool aUpdateEventActive)
	Indicate if the 'Update' event is active.
Public Member Functions inherited from WsfObject
	WsfObject ()
	This is the constructor for the WsfObject class.
	~WsfObject () override
	This is the destructor for the WsfObject class.
const char *	GetScriptClassName () const override
const std::string &	GetType () const
WsfStringId	GetTypeId () const
	Get the string ID of the 'type' of the object.
void	SetType (WsfStringId aType)
const std::string &	GetBaseType () const
WsfStringId	GetBaseTypeId () const
const TypeList &	GetTypeList () const
bool	IsA_TypeOf (WsfStringId aType) const
WsfObject &	operator= (const WsfObject &aRhs)
	Assignment operator.
template<typename T>
void	Serialize (T &aBuff)
	For XIO (de)serialization.
const std::string &	GetName () const
WsfStringId	GetNameId () const
void	SetName (WsfStringId aName)
Public Member Functions inherited from WsfComponentT< WsfPlatform >
	WsfComponentT ()
	WsfComponentT (const WsfComponentT &) noexcept
WsfComponentT &	operator= (const WsfComponentT &) noexcept
	~WsfComponentT () override=default
ParentType *	GetComponentParent () const
void	SetComponentParent (ParentType *aParentPtr)
Public Member Functions inherited from WsfComponent
virtual	~WsfComponent ()=default
template<typename T>
bool	QueryInterfaceT (T *&aRolePtr)
bool	ComponentHasRole (int aRole)
	Returns true if the component has the specified role.
Public Member Functions inherited from WsfUniqueId
	WsfUniqueId ()
	Construtor initializes the unique identifier to 0.
	WsfUniqueId (const WsfUniqueId &)
	Copy constructor initializes the unique identifier to 0.
WsfUniqueId &	operator= (const WsfUniqueId &)
unsigned int	GetUniqueId () const
	Get the unique identifier assigned to this object.
template<typename T>
void	Serialize (T &aBuff)
	For XIO (de)serialization.
Public Member Functions inherited from WsfAuxDataEnabled
	WsfAuxDataEnabled ()=default
	WsfAuxDataEnabled (const WsfAuxDataEnabled &aSrc)=default
WsfAuxDataEnabled &	operator= (const WsfAuxDataEnabled &aRhs)
	WsfAuxDataEnabled (WsfAuxDataEnabled &&)=default
WsfAuxDataEnabled &	operator= (WsfAuxDataEnabled &&)=default
virtual	~WsfAuxDataEnabled () noexcept
void	SetAuxData (const WsfAttributeContainer &aAuxData)
void	DeleteAuxData ()
	Delete the aux data container from the object.
void	MergeAuxData (const WsfAuxDataEnabled &aSrc)
	Merge the object's aux data with aux data from an existing object.
void	UpdateAuxData (const WsfAuxDataEnabled &aSrc)
	Update the object's aux data with aux data from an existing object.
bool	HasAuxData () const
	Returns true if this object has aux data.
bool	ProcessInput (UtInput &aInput)
template<typename T>
void	Serialize (T &aBuff)
	(De)serialization for XIO
WsfAttributeContainer &	GetAuxData ()
const WsfAttributeContainer &	GetAuxData () const noexcept
const WsfAttributeContainer &	GetAuxDataConst () const noexcept
Static Public Attributes inherited from WsfAuxDataEnabled
static UtCallbackListN< void(const WsfAuxDataEnabled *)>	AuxDataAccessed
static UtCallbackListN< void(const WsfAuxDataEnabled *)>	AuxDataDestroyed
	WsfMessageProcessor (const WsfMessageProcessor &aSrc)
	Copy constructor (for Clone()).
Protected Member Functions inherited from WsfScriptProcessor
	WsfScriptProcessor (const WsfScriptProcessor &aSrc)
	WsfProcessor (const WsfProcessor &aSrc)
	Copy constructor (for Clone()).
WsfProcessor &	operator= (const WsfProcessor &aRhs)=delete
	WsfPlatformPart (const WsfPlatformPart &aSrc)
	Copy constructor (for Clone()).
	WsfObject (const WsfObject &aSrc)
	Copy constructor (for Clone()).
Protected Member Functions inherited from WsfUniqueId
void	AssignUniqueId (WsfSimulation *aSimulationPtr)
Protected Attributes inherited from WsfScriptProcessor
WsfScriptContext *	mContextPtr
	Pointer to the script context.
WsfScriptMessageHandler *	mMessageHandlerPtr
	Pointer to the 'on_message' handler.
UtScript *	mOnMessageCreateScriptPtr
	Pointer to the 'on_message_create' script.
UtScriptClass *	mMessageClassPtr
wsf::ExternalLinks	mExternalLinks
	The external recipients.
WsfBehaviorTree *	mBehaviorTreePtr
ut::CloneablePtr< WsfAdvancedBehaviorTree >	mAdvancedBehaviorTreePtr
std::unique_ptr< WsfScriptStateMachine >	mStateMachinePtr
int	mStateIndex
bool	mSuppressMessage

Detailed Description

A specialization of WsfMessageProcessor that implements an example image processor.

Member Enumeration Documentation

◆ TargetRecognitionState

enum WsfImageProcessor::TargetRecognitionState

Enumerator
cST_UNDETECTED
cST_WAITING_DETECTION
cST_DETECTED
cST_WAITING_CLASSIFICATION
cST_CLASSIFIED
cST_WAITING_IDENTIFICATION
cST_IDENTIFIED

Constructor & Destructor Documentation

◆ WsfImageProcessor() [1/2]

WsfImageProcessor::WsfImageProcessor ( WsfScenario & aScenario )

Constructor.

References WsfMessageProcessor::WsfMessageProcessor().

Referenced by Clone(), operator=(), and WsfImageProcessor().

◆ ~WsfImageProcessor()

WsfImageProcessor::~WsfImageProcessor ( )

override

Destructor.

◆ WsfImageProcessor() [2/2]

WsfImageProcessor::WsfImageProcessor ( const WsfImageProcessor & aSrc )

protected

Copy constructor for Clone().

References WsfImageProcessor(), and WsfMessageProcessor::WsfMessageProcessor().

Member Function Documentation

◆ Clone()

WsfProcessor * WsfImageProcessor::Clone ( ) const

overridevirtual

Create a clone of this object.

Returns: A pointer to the new copy.

Implements WsfProcessor.

References WsfImageProcessor(), and WsfProcessor::WsfProcessor().

◆ GetCoastTime()

double WsfImageProcessor::GetCoastTime ( ) const

inline

Return the value of 'coast_time'.

◆ ImageProcessingCompleted()

void WsfImageProcessor::ImageProcessingCompleted	(	double	aSimTime,
		const WsfImage &	aImage )

protectedvirtual

Hook to notify a derived class the processing of an image has been completed.

Parameters

aSimTime	The current simulation time.
aImage	The image that was processed.

References WsfImageProcessor::Status::CoastTimeExceeded(), cST_CLASSIFIED, cST_DETECTED, cST_IDENTIFIED, cST_UNDETECTED, WsfImageProcessor::Status::CurrentState(), WsfImageProcessor::Status::EnterState(), WsfObject::GetName(), WsfPlatformPart::GetPlatform(), WsfImageProcessor::Status::IsStale(), WsfImageProcessor::Status::StateEntryTime(), and WsfImageProcessor::Status::TruthName().

Referenced by operator=().

◆ ImageProcessingInitiated()

void WsfImageProcessor::ImageProcessingInitiated	(	double	aSimTime,
		const WsfImage &	aImage )

protectedvirtual

Hook to notify a derived class the processing of an image is beginning.

Parameters

aSimTime	The current simulation time.
aImage	The image that will be processed.

Referenced by operator=().

◆ Initialize()

bool WsfImageProcessor::Initialize ( double aSimTime )

overridevirtual

Perform phase 1 initialization. This is called by WsfPlatform::Initialize() during phase 1 initialization of the platform. The component should complete validation of input data that could not be done by ProcessInput, as well as any other functions to prepare for simulation use (subject to the next paragraph).

The order in which components are initialized is defined by GetComponentInitializationOrder. In general a component implementation of this method should not be dependent on the state of another component, i.e.: it should not assume that the other components Initialize() method has been called. If such a dependency exists one should use Initialize2() if possible, or specify a value GetComponentInitializationOrder to force things to initialize in a particular order.

Parameters

aSimTime The current simulation time.

Returns: true if successful or false if unsuccessful (bad input data, etc.)

Note: This method should NOT add any other components to the platform. This MUST be done in PreInitialize().

Reimplemented from WsfComponent.

References WsfSimulation::GetScriptContext(), WsfPlatformPart::GetSimulation(), WsfMessageProcessor::Initialize(), WsfScriptProcessor::mContextPtr, and ok.

◆ IsDetectable()

bool WsfImageProcessor::IsDetectable	(	double	aSimTime,
		const WsfImage &	aImage,
		const WsfImage::Object &	aObject )

protectedvirtual

Hook to allow derived classes to determine if an object is visible.

This is called by ProcessImage to allow the base class to determine if the object is even detectable. The base class always returns true, but the derived class may provide other functionality.

Parameters

aSimTime	The current simulation time.
aImage	The image being processed.
aObject	The object within the image.

Returns: true if the object is detectable.

References WsfPlatformPart::DebugEnabled(), WsfImage::Object::GetPixelCount(), WsfPlatformPart::GetSimulation(), and WsfImage::Object::GetTruthName().

Referenced by operator=().

◆ operator=()

WsfImageProcessor & WsfImageProcessor::operator= ( const WsfImageProcessor & )

protecteddelete

References ImageProcessingCompleted(), ImageProcessingInitiated(), IsDetectable(), TrackDropped(), UpdateTrack(), and WsfImageProcessor().

◆ ProcessInput()

bool WsfImageProcessor::ProcessInput ( UtInput & aInput )

overridevirtual

Process input from a generic source.

Examine the current input command. If it is NOT one of the commands recognized by this class then it simply returns 'false'. If it is one of the commands recognized by this class then it processes the command and returns 'true'.

Parameters

aInput a reference to a UtInput object.

Returns: 'true' if the command was one recognized by the class or 'false' if not.

Exceptions

UtInput::ExceptionBase (or an object derived from it) if the command was recognized but contains some sort of error.

Note: If a derived class does not recognize the command (i.e.: the return value is false) then it should call the base class ProcessInput method. This chain should continue until either the command is recognized or the top-level base class is encountered.

Reimplemented from WsfObject.

References WsfFilterTypes::Get(), WsfPlatformPart::GetScenario(), and WsfMessageProcessor::ProcessInput().

◆ ProcessMessage()

bool WsfImageProcessor::ProcessMessage	(	double	aSimTime,
		const WsfMessage &	aMessage )

overridevirtual

Process a received message.

Parameters

aSimTime	The current simulation time.
aMessage	The message that is being sent.

Returns: 'true' if the message was processed or 'false' if not.

Note: A message is first received by ReceiveMessage which then calls ProcessMessage to process the message. A derived class ReceiveMessage method may choose to delay the message before calling ProcessMessage or may choose to ignore the message altogether.

Reimplemented from WsfPlatformPart.

References WsfPlatformPart::DebugEnabled(), WsfImageMessage::GetImage(), WsfVideoMessage::GetImage(), WsfImageMessage::GetMessageType(), WsfVideoMessage::GetMessageType(), WsfMessage::GetType(), WsfScriptProcessor::mMessageHandlerPtr, WsfScriptProcessor::mSuppressMessage, and WsfMessageProcessor::ProcessAction().

◆ ReceiveMessage()

bool WsfImageProcessor::ReceiveMessage	(	double	aSimTime,
		const WsfMessage &	aMessage )

overridevirtual

This implementation rejects messages that are not a WsfImageMessage or WsfVideoMessage.

Reimplemented from WsfPlatformPart.

References WsfMessage::GetType(), WsfImageMessage::GetTypeId(), WsfVideoMessage::GetTypeId(), and WsfMessageProcessor::ReceiveMessage().

◆ TrackDropped()

void WsfImageProcessor::TrackDropped	(	double	aSimTime,
		const WsfTrack &	aTrack )

protectedvirtual

Hook to notify a derived class that a track representing an object is being dropped.

Parameters

aSimTime	The current simulation time.
aTrack	The track being dropped.

References WsfTrack::GetTargetIndex().

Referenced by operator=().

◆ TurnOff()

void WsfImageProcessor::TurnOff ( double aSimTime )

overridevirtual

Turn off the platform part (system).

Parameters

aSimTime The current simulation time.

Reimplemented from WsfPlatformPart.

References WsfMessageProcessor::TurnOff().

◆ UpdateTrack()

void WsfImageProcessor::UpdateTrack	(	double	aSimTime,
		WsfTrack &	aTrack,
		const WsfImage &	aImage,
		const WsfImage::Object &	aObject )

protectedvirtual

Hook to allow derived classes to update the track prior to it being sent.

This is called by ProcessImage just before sending a track that reflects the perceived state of an object extracted from the image. The base class implementation does nothing except issue some optional debug output. A derived class may provide an implementation to perform whatever special processing they desire.

Parameters

aSimTime	The current simulation time.
aTrack	The track about to be sent.
aImage	The image being processed.
aObject	The object within the image.

References WsfPlatformPart::DebugEnabled(), WsfAuxDataEnabled::GetAuxData(), WsfAuxDataEnabled::GetAuxDataConst(), WsfPlatform::GetMasterTrackList(), WsfImage::GetNoiseLevel(), WsfImage::Object::GetPixelCount(), WsfImage::Object::GetPixelIntensity(), WsfPlatformPart::GetPlatform(), WsfImage::Object::GetSignalLevel(), WsfTrack::GetTargetIndex(), WsfTrack::GetTargetName(), WsfTrack::GetTargetType(), WsfTrackListT< T >::GetTrackCount(), WsfTrackListT< T >::GetTrackEntry(), and WsfImage::Object::GetTruthType().

Referenced by operator=().

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

Classes

Target recognition attributes.

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ TargetRecognitionState

Constructor & Destructor Documentation

◆ WsfImageProcessor() [1/2]

◆ ~WsfImageProcessor()

◆ WsfImageProcessor() [2/2]

Member Function Documentation

◆ Clone()

◆ GetCoastTime()

◆ ImageProcessingCompleted()

◆ ImageProcessingInitiated()

◆ Initialize()

◆ IsDetectable()

◆ operator=()

◆ ProcessInput()

◆ ProcessMessage()

◆ ReceiveMessage()

◆ TrackDropped()

◆ TurnOff()

◆ UpdateTrack()