DtEnvironmentProcessPublisher Class Reference

Instances of DtEnvironmentProcessPublisher are used for local or source simulations of environment processes, (i.e. More...

Inheritance diagram for DtEnvironmentProcessPublisher:

Collaboration diagram for DtEnvironmentProcessPublisher:

Public Types
typedef DtEnvironmentProcessRepository *(*	DtStateRepCreator )()
	Function prototype for functions that create DtEnvironmentProcessRepositories.

Public Member Functions
	DtEnvironmentProcessPublisher (DtEnvironmentProcessRepository *stateRepToUse, DtExerciseConn *conn, const DtObjectId &id=DtObjectId::defaultId())
	constructor
	DtEnvironmentProcessPublisher (DtExerciseConn *conn, const DtObjectId &id=DtObjectId::defaultId())
	constructor
virtual	~DtEnvironmentProcessPublisher ()
	destructor
virtual void	tick ()
	This function should be called once per frame for each environment process object.
virtual DtEnvironmentProcessRepository *	environmentProcessStateRep ()
	Returns a pointer to the EnvironmentProcessRepository - through which you can set or inspect current state information.
virtual DtEnvironmentProcessRepository *	epsr ()
	Synonym for environmentProcessStateRep().
virtual DtEnvironmentProcessDecoder *	decoder ()
	Returns a pointer to the Decoder being used to decode PDUs that we send back into the asSeenByRemote ESR.
virtual DtEnvironmentProcessEncoder *	encoder ()
	Returns a pointer to the Encoder being used to encode current state into an entity state PDU.
virtual const DtObjectId &	id () const
	Get the environment process's identifier.
virtual const DtObjectId &	localId () const
	Get the environment process's localId - same as id for DIS.
virtual const DtGlobalObjectDesignator &	globalId () const
	Get the global object designator - same as id for DIS.
virtual void	sendFinalPduOnDestruction (bool onOff)
	Set flag indicating whether to send a final PDU with the "FinalPdu" appearance bit set, from within the DtEnvironmentProcessPublisher destructor.
virtual void	forceUpdate ()
	Force a state update to be sent during the next call to tick, even if nothing would normally cause a send.
Public Member Functions inherited from DtObjectPublisher
	DtObjectPublisher (DtExerciseConn *conn, DtStateRepository *stateRep, DtStateRepository *asSeenByRemote, bool okToDeleteStateRep=true)
	Constructor takes an DtExerciseConn which must have a lifetime greater than the ObjectPubliser.
virtual	~DtObjectPublisher ()
	Destructor.
virtual DtStateRepository *	stateRep ()
	Returns a pointer to the DtStateRepository - through which you can set or inspect current state information.
virtual DtStateRepository *	sr ()
	Returns a pointer to the DtStateRepository - through which you can set or inspect current state information.
virtual DtExerciseConn *	exerciseConn ()
	Get our exercise connection.
virtual void	setTimeThreshold (DtTime time)
	Set the heartbeat rate for this object.
virtual DtTime	timeThreshold () const
	The heartbeat rate for this object.
virtual DtStateRepository *	approximateRemoteStateRep ()
	Returns a pointer to the approximate remote DtStateRepository – This state repository contains the contents of the last sent message.
virtual DtTime	lastTimeUpdated () const
	Returns the value of wallclock time at the time an update was last received for the entity.
virtual DtTime	lastSimTimeUpdated () const
	Returns the value of sim time at the time an update was last received for the entity.

Static Public Member Functions
static void	setStateRepCreator (DtStateRepCreator creator)
	Give us a function to be used for creating SRs.
static DtStateRepCreator	stateRepCreator (void)
static void	setClassDfltTimeThreshold (DtTime threshold)
Static Public Member Functions inherited from DtObjectPublisher
static void	setDfltTimeThreshold (DtTime time)
	Set the default heartbeat rate.
static DtTime	dfltTimeThreshold ()
	The default heartbeat rate, see setDfltTimeThreshold().

Protected Member Functions
void	sendFinalPdu ()
	Not virtual since called from destructor.
void	init (const DtEntityIdentifier &vehId)
	Not virtual since called from constructor.
	DtEnvironmentProcessPublisher (const DtEnvironmentProcessPublisher &orig)
DtEnvironmentProcessPublisher &	operator= (const DtEnvironmentProcessPublisher &orig)
	copy constructor – not implemented
Protected Member Functions inherited from DtObjectPublisher
void	send (DtPdu *pdu) const
	Puts the PDU on the network and updates timestamps.

Protected Attributes
DtObjectId	myId
DtEnvironmentProcessDecoder *	myDecoder
DtEnvironmentProcessEncoder *	myEncoder
bool	mySendFinalInDtor
Protected Attributes inherited from DtObjectPublisher
DtExerciseConn *	myExConn
DtStateRepository *	myStateRep
DtStateRepository *	myAsSeenByRemote
bool	myOkToDeleteStateRepFlag
DtTime	myTimeThreshold
DtTime	mySimTimeLastUpdate
	Set in const send() method.
DtTime	myRealTimeLastUpdate
	Set in const send() method.

Static Protected Attributes
static DtStateRepCreator	theStateRepCreator
static DtTime	theClassDfltTimeThreshold
static bool	theClassDfltIsSetFlag
Static Protected Attributes inherited from DtObjectPublisher
static DtTime	theDfltTimeThreshold

Detailed Description

Instances of DtEnvironmentProcessPublisher are used for local or source simulations of environment processes, (i.e.

these entities are not dependent on data being produced elsewhere on the network for their existence).

Examples: Environmental Process Example

Member Typedef Documentation

typedef DtEnvironmentProcessRepository*(* DtEnvironmentProcessPublisher::DtStateRepCreator)()

Function prototype for functions that create DtEnvironmentProcessRepositories.

Constructor & Destructor Documentation

DtEnvironmentProcessPublisher::DtEnvironmentProcessPublisher	(	DtEnvironmentProcessRepository *	stateRepToUse,
		DtExerciseConn *	conn,
		const DtObjectId &	id = DtObjectId::defaultId()
	)

constructor

DtEnvironmentProcessPublisher::DtEnvironmentProcessPublisher	(	DtExerciseConn *	conn,
		const DtObjectId &	id = DtObjectId::defaultId()
	)

constructor

virtual DtEnvironmentProcessPublisher::~DtEnvironmentProcessPublisher ( )

virtual

destructor

DtEnvironmentProcessPublisher::DtEnvironmentProcessPublisher ( const DtEnvironmentProcessPublisher &  orig )

protected

Member Function Documentation

DtEnvironmentProcessDecoder * DtEnvironmentProcessPublisher::decoder ( )

inlinevirtual

Returns a pointer to the Decoder being used to decode PDUs that we send back into the asSeenByRemote ESR.

References myDecoder.

DtEnvironmentProcessEncoder * DtEnvironmentProcessPublisher::encoder ( )

inlinevirtual

Returns a pointer to the Encoder being used to encode current state into an entity state PDU.

References myEncoder.

DtEnvironmentProcessRepository * DtEnvironmentProcessPublisher::environmentProcessStateRep ( )

inlinevirtual

Returns a pointer to the EnvironmentProcessRepository - through which you can set or inspect current state information.

References epsr().

DtEnvironmentProcessRepository * DtEnvironmentProcessPublisher::epsr ( )

inlinevirtual

Synonym for environmentProcessStateRep().

References DtObjectPublisher::myStateRep.

Referenced by environmentProcessStateRep().

virtual void DtEnvironmentProcessPublisher::forceUpdate ( )

virtual

Force a state update to be sent during the next call to tick, even if nothing would normally cause a send.

Implements DtObjectPublisher.

virtual const DtGlobalObjectDesignator& DtEnvironmentProcessPublisher::globalId ( ) const

virtual

Get the global object designator - same as id for DIS.

Implements DtObjectPublisher.

const DtObjectId & DtEnvironmentProcessPublisher::id ( ) const

inlinevirtual

Get the environment process's identifier.

Implements DtObjectPublisher.

References myId.

Referenced by localId().

void DtEnvironmentProcessPublisher::init ( const DtEntityIdentifier &  vehId )

protected

Not virtual since called from constructor.

const DtObjectId & DtEnvironmentProcessPublisher::localId ( ) const

inlinevirtual

Get the environment process's localId - same as id for DIS.

Implements DtObjectPublisher.

References id().

DtEnvironmentProcessPublisher& DtEnvironmentProcessPublisher::operator= ( const DtEnvironmentProcessPublisher &  orig )

protected

copy constructor – not implemented

void DtEnvironmentProcessPublisher::sendFinalPdu ( )

protected

Not virtual since called from destructor.

void DtEnvironmentProcessPublisher::sendFinalPduOnDestruction ( bool  onOff )

inlinevirtual

Set flag indicating whether to send a final PDU with the "FinalPdu" appearance bit set, from within the DtEnvironmentProcessPublisher destructor.

References mySendFinalInDtor.

static void DtEnvironmentProcessPublisher::setClassDfltTimeThreshold ( DtTime  threshold )

static

static void DtEnvironmentProcessPublisher::setStateRepCreator ( DtStateRepCreator  creator )

static

Give us a function to be used for creating SRs.

static DtStateRepCreator DtEnvironmentProcessPublisher::stateRepCreator ( void  )

static

virtual void DtEnvironmentProcessPublisher::tick ( )

virtual

This function should be called once per frame for each environment process object.

It determines if any data needs to be sent to the other exercise participants, and sends that data.

Implements DtObjectPublisher.

Member Data Documentation

DtEnvironmentProcessDecoder* DtEnvironmentProcessPublisher::myDecoder

protected

Referenced by decoder().

DtEnvironmentProcessEncoder* DtEnvironmentProcessPublisher::myEncoder

protected

Referenced by encoder().

DtObjectId DtEnvironmentProcessPublisher::myId

protected

Referenced by id().

bool DtEnvironmentProcessPublisher::mySendFinalInDtor

protected

Referenced by sendFinalPduOnDestruction().

bool DtEnvironmentProcessPublisher::theClassDfltIsSetFlag

staticprotected

DtTime DtEnvironmentProcessPublisher::theClassDfltTimeThreshold

staticprotected

DtStateRepCreator DtEnvironmentProcessPublisher::theStateRepCreator

staticprotected

---

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

• environmentProcessPublisherDIS.h