VR-Link API Documentation for DIS
Public Types | Public Member Functions | Static Public Member Functions | Protected Member Functions | Protected Attributes | Static Protected Attributes
DtRadioTransmitterPublisher Class Reference

Instances of DtRadioTransmitterPublisher are used for local or source simulations of radio transmitters, (i.e. More...

+ Inheritance diagram for DtRadioTransmitterPublisher:
+ Collaboration diagram for DtRadioTransmitterPublisher:

List of all members.

Public Types

typedef
DtRadioTransmitterRepository *(* 
DtStateRepCreator )()
 Function prototype for functions that create DtRadioTransmitterRepositorys.

Public Member Functions

 DtRadioTransmitterPublisher (DtRadioTransmitterRepository *stateRepToUse, DtExerciseConn *conn, const DtObjectId &entityId=DtObjectId::defaultId())
 Constructor -- State Rep must contain a radioId.
 DtRadioTransmitterPublisher (DtExerciseConn *conn, const DtObjectId &entityId=DtObjectId::defaultId(), int radioId=1)
 Constructor.
virtual ~DtRadioTransmitterPublisher ()
 Destructor.
virtual void tick ()
 This function should be called once per frame for each environment process object.
virtual
DtRadioTransmitterRepository
radioXmitRep ()
 Returns a pointer to the EnvironmentProcessRepository - through which you can set or inspect current state information.
virtual
DtRadioTransmitterRepository
tsr ()
 Synonym for environmentProcessStateRep()
virtual DtRadioTransmitterDecoderdecoder ()
 Returns a pointer to the Decoder being used to decode PDUs that we send back into the asSeenByRemote ESR.
virtual DtRadioTransmitterEncoderencoder ()
 Returns a pointer to the Encoder being used to encode current state into an entity state PDU.
virtual const DtObjectIdid () const
 Get the environment process's identifier.
virtual const DtObjectIdlocalId () 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 int radioId () const
 Get the radio ID.
virtual void sendFinalPduOnDestruction (bool onOff)
 Set flag indicating whether to send a final PDU with the "FinalPdu" appearance bit set, from within the DtRadioTransmitterPublisher 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.
virtual void setHeartbeatMoveTimer (DtTime time)
 Sets the time threshold used for moving radio transmitters.
virtual DtTime heartbeatMoveTimer () const
 Returns the time threshold used for moving radio transmitters.
virtual DtTime transmitterTimeThreshold () const
 Returns the time threshold being used.
virtual void setAntennaLocationThreshold (double threshold)
 Sets the antenna location threshold.
virtual double antennaLocationThreshold () const
 Returns the antenna location threshold.
virtual void setAntennaOrientationThreshold (double threshold)
 Sets the antenna orientation threshold.
virtual double antennaOrientationThreshold () const
 Returns the antenna orientation threshold.

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 setUseMovingThresholdFlag (bool flag)
 Sets the flag to determine whether to use a separate threshold value if the entity that the transmitter is attached to is moving.
static bool useMovingThresholdFlag ()
 Returns the flag described above.
static void setClassDfltTimeThreshold (DtTime threshold)

Protected Member Functions

void sendFinalPdu ()
 not virtual since called from destructor.
void init (const DtEntityIdentifier &vehId)
 not virtual since called from constructor
 DtRadioTransmitterPublisher (const DtRadioTransmitterPublisher &orig)
 copy constructor -- not implemented
DtRadioTransmitterPublisheroperator= (const DtRadioTransmitterPublisher &orig)
 copy constructor -- not implemented

Protected Attributes

DtObjectId myId
DtRadioTransmitterDecodermyDecoder
DtRadioTransmitterEncodermyEncoder
bool mySendFinalInDtor
DtTime myHeartbeatMoveTimer

Static Protected Attributes

static DtStateRepCreator theStateRepCreator
static bool theUseMovingThresholdFlag
static DtTime theClassDfltTimeThreshold
static bool theClassDfltIsSetFlag

Detailed Description

Instances of DtRadioTransmitterPublisher are used for local or source simulations of radio transmitters, (i.e.

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


Member Typedef Documentation

Function prototype for functions that create DtRadioTransmitterRepositorys.


Constructor & Destructor Documentation

Constructor -- State Rep must contain a radioId.

Constructor.

Destructor.

copy constructor -- not implemented


Member Function Documentation

virtual double DtRadioTransmitterPublisher::antennaLocationThreshold ( ) const [virtual]

Returns the antenna location threshold.

Returns:
The location threshold in meters.
Deprecated:
Users should now call: tsr()->thresholder()->antennaLocationThreshold()
Exceptions:
DtExceptionif state rep is null.

Returns the antenna orientation threshold.

Returns:
The orientation threshold in radians.
Deprecated:
Users should now call: tsr()->thresholder()->antennaOrientationThreshold()
Exceptions:
DtExceptionif state rep is null.

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

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

virtual void DtRadioTransmitterPublisher::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.

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

Implements DtObjectPublisher.

Returns the time threshold used for moving radio transmitters.

virtual const DtObjectId& DtRadioTransmitterPublisher::id ( ) const [virtual]

Get the environment process's identifier.

Implements DtObjectPublisher.

void DtRadioTransmitterPublisher::init ( const DtEntityIdentifier vehId) [protected]

not virtual since called from constructor

virtual const DtObjectId& DtRadioTransmitterPublisher::localId ( ) const [virtual]

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

Implements DtObjectPublisher.

DtRadioTransmitterPublisher& DtRadioTransmitterPublisher::operator= ( const DtRadioTransmitterPublisher orig) [protected]

copy constructor -- not implemented

virtual int DtRadioTransmitterPublisher::radioId ( ) const [virtual]

Get the radio ID.

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

not virtual since called from destructor.

virtual void DtRadioTransmitterPublisher::sendFinalPduOnDestruction ( bool  onOff) [virtual]

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

virtual void DtRadioTransmitterPublisher::setAntennaLocationThreshold ( double  threshold) [virtual]

Sets the antenna location threshold.

Sets the distance that the antenna must have moved for another PDU to be sent.

Parameters:
thresholdThreshold in meters defaulted to 500 m.
Deprecated:
Users should now call: tsr()->thresholder()->setAntennaLocationThreshold()
virtual void DtRadioTransmitterPublisher::setAntennaOrientationThreshold ( double  threshold) [virtual]

Sets the antenna orientation threshold.

Parameters:
thresholdThreshold in radians defaulted to 180 degrees.
Deprecated:
Users should now call: tsr()->thresholder()->setAntennaOrientationThreshold()

Sets the time threshold used for moving radio transmitters.

Give us a function to be used for creating SRs.

static void DtRadioTransmitterPublisher::setUseMovingThresholdFlag ( bool  flag) [static]

Sets the flag to determine whether to use a separate threshold value if the entity that the transmitter is attached to is moving.

virtual void DtRadioTransmitterPublisher::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.

Returns the time threshold being used.

Synonym for environmentProcessStateRep()

References DtObjectPublisher::myStateRep.

Returns the flag described above.

See also:
setUseMovingThresholdFlag

Member Data Documentation


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

Document ID: Generated on Mon May 14 08:06:18 EDT 2012 from SVN revision 114750
Copyright © 2005-2012 VT MÄK Inc. All Rights Reserved (www.mak.com)