Instances of DtEntityPublisher are used for local or source simulations of entities, (i.e. More...

Inheritance diagram for DtEntityPublisher:

Collaboration diagram for DtEntityPublisher:

Public Types
typedef DtEntityStateRepository (	DtStateRepCreator )()
	Function prototype for functions that create DtEntityStateRepositories. More...

Public Types inherited from DtObjectPublisher
typedef DtAttributePdu (	DtNonCoupledAttributePduCreator )(const DtPduWithAttributeRecordSets , void )
	Function prototype for functions that create DtAggregateStateRepositories. More...

Public Member Functions
	DtEntityPublisher (DtEntityStateRepository stateRepToUse, DtExerciseConn conn, const DtObjectId &id=DtObjectId::defaultId())
	Constructor. More...

	DtEntityPublisher (DtExerciseConn *conn, const DtObjectId &id=DtObjectId::defaultId())
	Constructor. More...

	DtEntityPublisher (const DtEntityType &type, DtExerciseConn *conn, const DtObjectId &id=DtObjectId::defaultId())
	Constructor. More...

	DtEntityPublisher (const DtEntityType &type, DtExerciseConn *conn, DtDeadReckonTypes algorithm, DtForceType forceId, const DtEntityType &guise=guiseSameAsType(), const DtObjectId &id=DtObjectId::defaultId())
	Constructor. More...

virtual	~DtEntityPublisher ()
	Destructors. More...

virtual bool	tick ()
	This function should be called once per frame for each entity. More...

virtual DtEntityStateRepository *	entityStateRep ()
	Returns a pointer to the EntityStateRepository - through which you can set or inspect current state information. More...

virtual DtEntityStateRepository *	esr ()
	Synonym for entityStateRep(). More...

virtual DtEntityStateDecoder *	decoder ()
	Returns a pointer to the Decoder being used to decode PDUs that we send back into the asSeenByRemote ESR. More...

virtual DtEntityStateEncoder *	encoder ()
	Returns a pointer to the Encoder being used to encode current state into an entity state PDU. More...

virtual DtOwnershipHandler *	setOwnershipHandler (DtOwnershipHandler *handler)
	Sets the current ownership handler to handler. More...

virtual const DtObjectId &	id () const
	Get the entity's identifier. More...

virtual const DtObjectId &	localId () const
	Get the entity's localId - same as id for DIS. More...

virtual const DtGlobalObjectDesignator &	globalId () const
	Get the global object designator - same as id for DIS. More...

virtual void	sendFinalPduOnDestruction (bool on)
	Set flag indicating whether to send a final PDU with the "FinalPdu" appearance bit set, from within the DtEntityPublisher destructor. More...

virtual void	forceUpdate ()
	Force a state update to be sent during the next call to tick, even if nothing would normally cause a send. More...

virtual void	enableDiGuyInformation (DtDiGuyDataSendMode sendMode=DtDiGuySendPdu)
	Tell the publisher to send DI Guy Data as either PDU's or attributes. More...

virtual void	setSendDiGuyAttributes (bool enableAttributes)
	Tell the publisher to send DI Guy Attributes. More...

virtual bool	sendDiGuyAttributes () const
	Determine whether this publisher will send DI Guy Attributes. More...

virtual void	setSendDiGuyPdus (bool enablePdu)
	Tell the publisher to send DI Guy PDU's. More...

virtual bool	sendDiGuyPdus () const
	Determine whether this publisher will send DI Guy PDU's. More...

virtual void	setSendSeesPdus (bool yesNo)
	Tell the publisher to send SEES PDU's. More...

virtual bool	sendSeesPdus () const
	Determine whether this publisher will send SEES PDU's. More...

virtual void	setSeesTimeThreshold (DtTime time)
	Set the SEES time threshold for sending a PDU. More...

virtual DtTime	seesTimeThreshold () const
	Return the SEES time threshold. More...

virtual void	setDiGuyTypeTimeThreshold (DtTime time)
	Set the DIGuy Type time threshold for sending a PDU. More...

virtual DtTime	diGuyTypeTimeThreshold () const
	Return the DIGuy Type time threshold. More...

virtual void	setDiGuyAppearanceTimeThreshold (DtTime time)
	Set the DIGuy Appearance time threshold for sending a PDU. More...

virtual DtTime	diGuyAppearanceTimeThreshold () const
	Return the DIGuy Appearance time threshold. More...

virtual void	setDiGuyActionTimeThreshold (DtTime time)
	Set the DIGuy Action time threshold for sending a PDU. More...

virtual DtTime	diGuyActionTimeThreshold () const
	Return the DIGuy Action time threshold. More...

DtTime	entityTypeHeartbeat (int type, int domain)
	Return the heartbeat based on entity Type. More...

virtual void	divestObject (DtU16 siteTarget, DtU16 applicationTarget)
	Begin a DIS 7 push request for this object. More...

virtual bool	createAndSendDiGuy ()
	Send DI Guy as Attributes or PDU's (if needed or if threshold has been exceeded). More...

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. More...

virtual	~DtObjectPublisher ()
	Destructor. More...

virtual DtStateRepository *	stateRep ()
	Returns a pointer to the DtStateRepository - through which you can set or inspect current state information. More...

virtual DtStateRepository *	sr ()
	Returns a pointer to the DtStateRepository - through which you can set or inspect current state information. More...

virtual DtExerciseConn *	exerciseConn ()
	Get our exercise connection. More...

virtual bool	parallelTick ()
	Tick (update) this object in parallel threads. More...

virtual void	setTimeThreshold (DtTime time)
	Set the heartbeat rate for this object. More...

virtual DtTime	timeThreshold () const
	The heartbeat rate for this object. More...

virtual void	setRelLocTimeThreshold (DtTime time)
	Set the heartbeat rate of relative location updates for this object. More...

virtual DtTime	relLocTimeThreshold () const
	The relative location heartbeat rate for this object. More...

virtual DtStateRepository *	approximateRemoteStateRep ()
	Returns a pointer to the approximate remote DtStateRepository – This state repository contains the contents of the last sent message. More...

virtual DtTime	lastTimeUpdated () const
	Returns the value of wallclock time at the time an update was last received for the entity. More...

virtual DtTime	lastTimeAttrUpdated () const

virtual DtTime	lastSimTimeUpdated () const
	Returns the value of sim time at the time an update was last received for the entity. More...

virtual void	setUseCustomThreshold (bool useCustom)
	Sets whether or not this object will use a custom threshold value, or the default. More...

virtual bool	useCustomThreshold ()
	Returns whether or not this object will use a custom threshold value, or the default. More...

virtual void	setAttributePduStrategy (DtAttributePduStrategy strat)
	Sets/Gets whether to couple the attribute PDU. More...

virtual DtAttributePduStrategy	attributePduStrategy () const

virtual void	encodeExtensions (DtStateRepository *stateRep, const DtStateRepository &asSeenByRemote)
	Encode State Repository Extensions. Extensions should be added to stateRep attributeRecords. More...

virtual void	decodeExtensions (DtPdu *pdu, const DtStateRepository &stateRep)
	Decode State Repository Extensions. More...

virtual void	setUpdateRateWarningThreshold (unsigned short updatesPerSecond)
	Overrides the default (static) updates per second for a specific instance Sets/Gets for private member. More...

virtual unsigned short	updateRateWarningThreshold () const

virtual void	checkForUpdateRateWarning () const
	Helper function that determines whether or not to trigger a spam warning. More...

DtNonCoupledAttributePduCreator	setNonCoupledAttributePduCreator (DtNonCoupledAttributePduCreator creator)
	Give us a function to be used for creating non-coupled Attribute PDUs. More...

DtNonCoupledAttributePduCreator	nonCoupledAttributePduCreator (void)

Static Public Member Functions
static const DtEntityType &	guiseSameAsType ()

static void	setStateRepCreator (DtStateRepCreator creator)
	Give us a function to be used for creating SRs. More...

static DtStateRepCreator	stateRepCreator (void)

static void	setClassDfltTimeThreshold (DtTime threshold)

static void	setStationaryDfltTimeThreshold (DtTime threshold)

static void	setEntityTypeDfltTimeThreshold (int type, int domain, DtTime threshold)


static void	setDfltRotationThreshold (double r)

static double	dfltRotationThreshold ()

static void	setDfltTranslationThreshold (double t)

static double	dfltTranslationThreshold ()

Static Public Member Functions inherited from DtObjectPublisher
static void	setDfltTimeThreshold (DtTime time)
	Set the default heartbeat rate. More...

static DtTime	dfltTimeThreshold ()
	The default heartbeat rate, see setDfltTimeThreshold(). More...

static void	setDfltUpdateRateWarningThreshold (unsigned short updatesPerSecond)
	Sets the default (static) updates per second for any instance. More...

static unsigned short	dfltUpdateRateWarningThreshold ()
	Return the value of theDfltUpdateRateWarningThreshold. More...

static void	setDfltRelLocTimeThreshold (DtTime time)
	Set the default heartbeat rate for relative location updates. More...

static DtTime	dfltRelLocTimeThreshold ()
	The default heartbeat rate for relative location updates, see setDfltRelLocTimeThreshold() More...

static DtNonCoupledAttributePduCreator	setDefaultNonCoupledAttributePduCreator (DtNonCoupledAttributePduCreator creator)
	Give us a function to be used for creating non-coupled Attribute PDUs. More...

static DtNonCoupledAttributePduCreator	defaultNonCoupledAttributePduCreator (void)

Protected Member Functions
void	sendFinalPdu ()
	Not virtual since called from destructor. More...

virtual void	createAndSendSeesPdu ()
	Send SEES PDU. More...

virtual bool	sendSeesNeeded () const

void	init (const DtObjectId &vehId)
	Not virtual since called from constructor. More...

Protected Member Functions inherited from DtObjectPublisher
virtual void	send (DtPdu *pdu) const
	Puts the PDU on the network and updates timestamps. More...

Protected Attributes
DtObjectId	myId

DtEntityStateDecoder *	myEntityDecoder

DtEntityStateEncoder *	myEntityEncoder

DtDIGuyCustomPduEncoder *	myDiGuyEncoder

bool	mySendFinalInDtor

DtDiGuyDataSendMode	mySendDiGuyMode

bool	mySendSeesPdus

DtTime	mySeesPdusTimeThreshold

DtTime	myLastSeesPdusUpdate

DtOwnershipHandler *	myOwnershipHandler

DtRelativeLocationPdu	myLastSentRelLocPdu

DtTime	myLastSentRelLocPduTime

Protected Attributes inherited from DtObjectPublisher
DtExerciseConn *	myExConn

DtStateRepository *	myStateRep

DtStateRepository *	myAsSeenByRemote

bool	myOkToDeleteStateRepFlag

bool	myUseCustomThreshold

DtTime	myTimeThreshold
	Time threshold for the heartbeat rate. More...

DtTime	myRelLocTimeThreshold
	Time threshold for heartbeat rate of relative location updates (only for embarked/attached entities) More...

DtTime	mySimTimeLastUpdate
	Set in const send() method. More...

DtTime	myRealTimeLastUpdate
	Set in const send() method. More...

DtTime	myRealTimeLastAttrUpdate

DtTime	myLastSpamCheckTime
	Set in constructor. More...

unsigned short	myNumberOfPdusPerSecond
	Set in constructor. More...

unsigned short	myUpdateRateWarningThreshold
	Set in constructor. More...

bool	myCanWarn
	Set in constructor. More...

DtNonCoupledAttributePduCreator	myNonCoupledAttributePduCreator

DtAttributePduStrategy	myAttributePduStrategy

std::vector < DtStateRepositoryExtensionEncoder * >	myStateRepositoryExtensionEncoderList

std::vector < DtStateRepositoryExtensionDecoder * >	myStateRepositoryExtensionDecoderList

Static Protected Attributes
static DtStateRepCreator	theStateRepCreator

static DtTime	theClassDfltTimeThreshold

static bool	theClassDfltIsSetFlag

static DtTime	theStationaryDfltTimeThreshold

static bool	theStationaryDfltIsSetFlag

static std::map< std::pair < int, int >, DtTime >	theEntityTypeHeartbeat

Static Protected Attributes inherited from DtObjectPublisher
static DtNonCoupledAttributePduCreator	theDefaultNonCoupledAttributePduCreator

static DtTime	theDfltTimeThreshold

static DtTime	theDfltRelLocTimeThreshold

static unsigned short	theDfltUpdateRateWarningThreshold

Private Member Functions
	DtEntityPublisher (const DtEntityPublisher &orig)
	copy constructor - Not Implemented More...

DtEntityPublisher &	operator= (const DtEntityPublisher &orig)
	assignment operator - Not Implemented More...

Detailed Description

Instances of DtEntityPublisher are used for local or source simulations of entities, (i.e.

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

Member Typedef Documentation

typedef DtEntityStateRepository*(* DtEntityPublisher::DtStateRepCreator)()

Function prototype for functions that create DtEntityStateRepositories.

Constructor & Destructor Documentation

DtEntityPublisher::DtEntityPublisher	(	DtEntityStateRepository *	stateRepToUse,
		DtExerciseConn *	conn,
		const DtObjectId &	id = `DtObjectId::defaultId()`
	)

Constructor.

DtObjectId::defaultId() returns a special DtObjectId that is a signal to the DtEntityPublisher constructor that it should obtain its own ObjectId.

DtEntityType::defaultType() returns a special DtEntityType that indicates to the DtEntityPublisher constructor that the entity type should also be used as the guise.

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

Constructor.

DtObjectId::defaultId() returns a special DtObjectId that is a signal to the DtEntityPublisher constructor that it should obtain its own ObjectId.

DtEntityType::defaultType() returns a special DtEntityType that indicates to the DtEntityPublisher constructor that the entity type should also be used as the guise.

DtEntityPublisher::DtEntityPublisher	(	const DtEntityType &	type,
		DtExerciseConn *	conn,
		const DtObjectId &	id = `DtObjectId::defaultId()`
	)

Constructor.

DtObjectId::defaultId() returns a special DtObjectId that is a signal to the DtEntityPublisher constructor that it should obtain its own ObjectId.

DtEntityType::defaultType() returns a special DtEntityType that indicates to the DtEntityPublisher constructor that the entity type should also be used as the guise.

DtEntityPublisher::DtEntityPublisher	(	const DtEntityType &	type,
		DtExerciseConn *	conn,
		DtDeadReckonTypes	algorithm,
		DtForceType	forceId,
		const DtEntityType &	guise = `guiseSameAsType()`,
		const DtObjectId &	id = `DtObjectId::defaultId()`
	)

Constructor.

DtObjectId::defaultId() returns a special DtObjectId that is a signal to the DtEntityPublisher constructor that it should obtain its own ObjectId.

DtEntityType::defaultType() returns a special DtEntityType that indicates to the DtEntityPublisher constructor that the entity type should also be used as the guise.

virtual DtEntityPublisher::~DtEntityPublisher ( )

virtual

Destructors.

DtEntityPublisher::DtEntityPublisher ( const DtEntityPublisher & orig )

private

copy constructor - Not Implemented

Member Function Documentation

virtual bool DtEntityPublisher::createAndSendDiGuy ( )

virtual

Send DI Guy as Attributes or PDU's (if needed or if threshold has been exceeded).

virtual void DtEntityPublisher::createAndSendSeesPdu ( )

protectedvirtual

Send SEES PDU.

DtEntityStateDecoder * DtEntityPublisher::decoder ( )

inlinevirtual

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

References myEntityDecoder.

double DtEntityPublisher::dfltRotationThreshold ( )

inlinestatic

Deprecated:: Please use the DtThresholder static member functions instead.

References DtThresholder::dfltRotationThreshold().

double DtEntityPublisher::dfltTranslationThreshold ( )

inlinestatic

Deprecated:: Please use the DtThresholder static member functions instead.

References DtThresholder::dfltTranslationThreshold().

virtual DtTime DtEntityPublisher::diGuyActionTimeThreshold ( ) const

virtual

Return the DIGuy Action time threshold.

virtual DtTime DtEntityPublisher::diGuyAppearanceTimeThreshold ( ) const

virtual

Return the DIGuy Appearance time threshold.

virtual DtTime DtEntityPublisher::diGuyTypeTimeThreshold ( ) const

virtual

Return the DIGuy Type time threshold.

virtual void DtEntityPublisher::divestObject	(	DtU16	siteTarget,
		DtU16	applicationTarget
	)

virtual

Begin a DIS 7 push request for this object.

This just passes through to the OwnershipHandler The entire process will by default be automated from here.

Parameters

siteTarget	the destination site where you want the object to go
appicationTarget	the destination application where you want the object to go.

virtual void DtEntityPublisher::enableDiGuyInformation ( DtDiGuyDataSendMode sendMode = DtDiGuySendPdu )

virtual

Tell the publisher to send DI Guy Data as either PDU's or attributes.

Sending is disabled for both if disabled mode is used.

DtEntityStateEncoder * DtEntityPublisher::encoder ( )

inlinevirtual

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

References myEntityEncoder.

DtEntityStateRepository * DtEntityPublisher::entityStateRep ( )

inlinevirtual

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

References esr().

DtTime DtEntityPublisher::entityTypeHeartbeat	(	int	type,
		int	domain
	)

Return the heartbeat based on entity Type.

DtEntityStateRepository * DtEntityPublisher::esr ( )

inlinevirtual

Synonym for entityStateRep().

References DtObjectPublisher::stateRep().

Referenced by entityStateRep().

virtual void DtEntityPublisher::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& DtEntityPublisher::globalId ( ) const

virtual

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

Implements DtObjectPublisher.

static const DtEntityType& DtEntityPublisher::guiseSameAsType ( )

static

const DtObjectId & DtEntityPublisher::id ( ) const

inlinevirtual

Get the entity's identifier.

Implements DtObjectPublisher.

References myId.

Referenced by localId().

void DtEntityPublisher::init ( const DtObjectId & vehId )

protected

Not virtual since called from constructor.

const DtObjectId & DtEntityPublisher::localId ( ) const

inlinevirtual

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

Implements DtObjectPublisher.

References id().

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

private

assignment operator - Not Implemented

virtual DtTime DtEntityPublisher::seesTimeThreshold ( ) const

virtual

Return the SEES time threshold.

virtual bool DtEntityPublisher::sendDiGuyAttributes ( ) const

virtual

Determine whether this publisher will send DI Guy Attributes.

virtual bool DtEntityPublisher::sendDiGuyPdus ( ) const

virtual

Determine whether this publisher will send DI Guy PDU's.

void DtEntityPublisher::sendFinalPdu ( )

protected

Not virtual since called from destructor.

void DtEntityPublisher::sendFinalPduOnDestruction ( bool on )

inlinevirtual

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

References mySendFinalInDtor.

virtual bool DtEntityPublisher::sendSeesNeeded ( ) const

protectedvirtual

virtual bool DtEntityPublisher::sendSeesPdus ( ) const

virtual

Determine whether this publisher will send SEES PDU's.

static void DtEntityPublisher::setClassDfltTimeThreshold ( DtTime threshold )

static

void DtEntityPublisher::setDfltRotationThreshold ( double r )

inlinestatic

Deprecated:: Please use the DtThresholder static member functions instead.

References DtThresholder::setDfltRotationThreshold().

void DtEntityPublisher::setDfltTranslationThreshold ( double t )

inlinestatic

Deprecated:: Please use the DtThresholder static member functions instead.

References DtThresholder::setDfltTranslationThreshold().

virtual void DtEntityPublisher::setDiGuyActionTimeThreshold ( DtTime time )

virtual

Set the DIGuy Action time threshold for sending a PDU.

virtual void DtEntityPublisher::setDiGuyAppearanceTimeThreshold ( DtTime time )

virtual

Set the DIGuy Appearance time threshold for sending a PDU.

virtual void DtEntityPublisher::setDiGuyTypeTimeThreshold ( DtTime time )

virtual

Set the DIGuy Type time threshold for sending a PDU.

static void DtEntityPublisher::setEntityTypeDfltTimeThreshold	(	int	type,
		int	domain,
		DtTime	threshold
	)

static

virtual DtOwnershipHandler* DtEntityPublisher::setOwnershipHandler ( DtOwnershipHandler * handler )

virtual

Sets the current ownership handler to handler.

A DtOwnershipHandler is an object that encapsulates callback function for a variety of ownership-management-related functions. Returns previous handler.

virtual void DtEntityPublisher::setSeesTimeThreshold ( DtTime time )

virtual

Set the SEES time threshold for sending a PDU.

virtual void DtEntityPublisher::setSendDiGuyAttributes ( bool enableAttributes )

virtual

Tell the publisher to send DI Guy Attributes.

virtual void DtEntityPublisher::setSendDiGuyPdus ( bool enablePdu )

virtual

Tell the publisher to send DI Guy PDU's.

Deprecated:: Use enableDiGuyInformation instead;

virtual void DtEntityPublisher::setSendSeesPdus ( bool yesNo )

virtual

Tell the publisher to send SEES PDU's.

static void DtEntityPublisher::setStateRepCreator ( DtStateRepCreator creator )

static

Give us a function to be used for creating SRs.

static void DtEntityPublisher::setStationaryDfltTimeThreshold ( DtTime threshold )

static

static DtStateRepCreator DtEntityPublisher::stateRepCreator ( void )

static

virtual bool DtEntityPublisher::tick ( )

virtual

This function should be called once per frame for each entity.

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

Implements DtObjectPublisher.

Member Data Documentation

DtDIGuyCustomPduEncoder* DtEntityPublisher::myDiGuyEncoder

protected

DtEntityStateDecoder* DtEntityPublisher::myEntityDecoder

protected

Referenced by decoder().

DtEntityStateEncoder* DtEntityPublisher::myEntityEncoder

protected

Referenced by encoder().

DtObjectId DtEntityPublisher::myId

protected

Referenced by id().

DtTime DtEntityPublisher::myLastSeesPdusUpdate

protected

DtRelativeLocationPdu DtEntityPublisher::myLastSentRelLocPdu

protected

DtTime DtEntityPublisher::myLastSentRelLocPduTime

protected

DtOwnershipHandler* DtEntityPublisher::myOwnershipHandler

protected

DtTime DtEntityPublisher::mySeesPdusTimeThreshold

protected

DtDiGuyDataSendMode DtEntityPublisher::mySendDiGuyMode

protected

bool DtEntityPublisher::mySendFinalInDtor

protected

Referenced by sendFinalPduOnDestruction().

bool DtEntityPublisher::mySendSeesPdus

protected

bool DtEntityPublisher::theClassDfltIsSetFlag

staticprotected

DtTime DtEntityPublisher::theClassDfltTimeThreshold

staticprotected

std::map<std::pair<int,int>,DtTime> DtEntityPublisher::theEntityTypeHeartbeat

staticprotected

DtStateRepCreator DtEntityPublisher::theStateRepCreator

staticprotected

bool DtEntityPublisher::theStationaryDfltIsSetFlag

staticprotected

DtTime DtEntityPublisher::theStationaryDfltTimeThreshold

staticprotected

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

entityPublisherDIS.h

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Static Protected Attributes

Private Member Functions

Detailed Description

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation