Instances of DtExerciseConn are used to provide an application's interface or connection to the network in a DIS environment. More...

Inheritance diagram for DtExerciseConn:

Collaboration diagram for DtExerciseConn:

Public Types
enum	{ DtNET_READ_SUCCESS =0, DtNET_READ_NO_PACKETS =1, DtNET_READ_BAD_PACKET =2, DtNET_READ_SERVER_MSG =3, DtNET_READ_SIZE_MISMATCH =4 }
	Status return codes for DtExerciseConn methods. More...

enum	{ DtPROCESS_PDU_SUCCESS =0, DtPROCESS_PDU_WRONG_EXID =5, DtPROCESS_PDU_NO_PDU =6, DtNET_READ_FILTERED_PACKET =7 }

enum	InitializationStatus { DtINIT_SUCCESS =0, DtCOULD_NOT_CREATE_SOCKET =1 }
	InitializationStatus enumerates possible values to be returned by the ExerciseConns's optional 'status' variable. More...

typedef int(*	DtPredicate )(DtPdu pdu, void arg)

Public Member Functions
	DtExerciseConn (const DtExerciseConnInitializer &initial, InitializationStatus *status=0)
	The preferred constructor. More...

	DtExerciseConn (int port, int exercise_id, int site_id, int application_num, InitializationStatus *status=0, bool use_async_io=false, bool useIpv6=false, bool suppressSelfReflect=false)
	Constructor. More...

	DtExerciseConn (int port, const DtInetAddr &destAddr, int exercise_id, int site_id, int application_num, InitializationStatus *status=0, bool use_async_io=false, bool suppressSelfReflect=false)
	Constructor. More...

	DtExerciseConn (DtInetSocket skt, int exercise_id, int site_id, int application_num, InitializationStatus status=0)
	Constructor. More...

virtual	~DtExerciseConn ()
	Destructor. More...

virtual void	addPduCallback (DtPduKind pduKind, DtPduCallbackFcn fcn, void *usr)
	Register callbacks by PDU kind, should not be called directly. More...

virtual void	removePduCallback (DtPduKind pduKind, DtPduCallbackFcn fcn, void *usr)
	Deregister callbacks by PDU kind, should not be called directly. More...

virtual int	drainInput (DtTime timeout=-1, int nReadPerTimeCheck=100)
	Normal way of processing input from the network. More...

virtual int	readAndProcess (void)
	Called by drainInput, so application code rarely needs to use this. More...

virtual int	processPdu (DtPdu *pdu)
	Called by readAndProcess (which is called by drainInput). More...

virtual DtPdu *	netRead (int *retCode=0)
	Reads the network, users should seldom need to call this function. More...

virtual void	addInterestInPduKind (DtPduKind kind)
	Adds interest in a PDU kind, users should not call directly. More...

virtual void	subtractInterestInPduKind (DtPduKind kind)
	Subtracts interest in a PDU kind, users should not call directly. More...

virtual DtPduKind	readUntil (DtPredicate predicate, void *arg, DtTime timeout, DtTime sleepTime=0.1)
	Repeatedly call readAndProcess until predicate holds on the PDU that is being read, or until timeout seconds have elapsed. More...

virtual void	addInterestInMcastAddr (const DtInetAddr &addr)
	Add interest in a multicast address. More...

virtual void	subtractInterestInMcastAddr (const DtInetAddr &addr)
	Subtract interest in a multicast address. More...

virtual void	send (const DtStateMsg &msg)
	Send a message - call down to send(DtPdu &pdu....) More...

virtual void	send (const DtInteraction &msg)
	Send an interaction - call down to send(DtPdu &pdu....) More...

virtual void	sendStamped (const DtStateMsg &msg)
	Send a stamped message - call down to sendStamped(DtPdu &pdu....) More...

virtual void	sendStamped (const DtInteraction &msg)
	Send a stamped message - call down to sendStamped(DtPdu &pdu....) More...

virtual int	send (const DtPdu &pdu, const DtInetAddr *addr=0)
	Send a PDU to the specified address, or the DtExerciseConn's default destination address if addr is 0. More...

virtual int	sendStamped (const DtPdu &pdu, const DtInetAddr *addr=0)
	Send a PDU to the specified address, or the DtExerciseConn's default destination address if addr is 0. More...

virtual DtInetAddr *	destinationAddr (const DtPdu &pdu)
	Returns the current destination address for the PDU. More...

virtual bool	addDestination (const DtInetAddr &destination, DtU16 port=0)
	Add an additional destination. More...

virtual bool	removeDestination (const DtInetAddr &destination, DtU16 port=0)
	Remove a destination. More...

virtual void	setExerciseId (int exercise_id)
	Set the current exercise ID. More...

virtual DtExerciseId	exerciseId () const
	Get the current exercise ID. More...

virtual const DtEventID &	nextEventId ()
	Return an event ID consisting of the DtExerciseConn's site and host numbers, and the current value of an event number counter. More...

virtual DtInetSocket *	socket ()
	Returns the current DtDisSocket that we are using for communication. More...

virtual DtPduFactory *	pduFactory ()
	Get the PDU factory used by netRead to create the right kind of derived DtPDU. More...

virtual DtPduEncoderFactory *	pduEncoderFactory ()
	Get the factory used to convert pdu information from the VR-Link State Repositories. More...

virtual DtPduDecoderFactory *	pduDecoderFactory ()
	Get the factory used to convert pdu information to the VR-Link State Repositories. More...

virtual void	setPduFactory (DtPduFactory *fact)
	Rather than just modifying the ExerciseConn's current PDU factory, you can tell the ExerciseConn to use a different PDU factory object. More...

virtual DtStateRepositoryExtensionEncoderFactory *	stateRepoExtensionEncoderFactory ()
	Get the factory used to convert information from the VR-Link State Repositories Extensions to attribute records. More...

virtual DtStateRepositoryExtensionDecoderFactory *	stateRepoExtensionDecoderFactory ()
	Get the factory used to convert PDU attribute records to the VR-Link State Repositories Extensions. More...

virtual void	enableFiltering ()
	EnablePDU filtering. More...

virtual void	disableFiltering ()
	Disable PDU filtering. More...

virtual void	setTimeStampType (DtTimeStampType relOrAbs)
	set time stamp type (DtTimeStampAbsolute or DtTimeStampRelative). More...

virtual DtTimeStampType	timeStampType () const
	Get time stamp type (DtTimeStampAbsolute or DtTimeStampRelative). More...

virtual void	setTimeStampType (int relOrAbs)
	This function has been obsoleted by the version above that use the DtTimeStampType enumeration, but is included for backwards compatibility. More...

virtual DtDisObjectManager *	disObjectManager ()
	Get the disObjectManager. More...

Public Member Functions inherited from DtBaseExerciseConn
virtual	~DtBaseExerciseConn ()
	destructor More...

virtual void	addPostDrainCallback (DtPostDrainCb cb, void *usr)
	Add/remove callbacks to be executed from within drainInput right before it returns. More...

virtual void	removePostDrainCallback (DtPostDrainCb cb, void *usr)

virtual void	removeAllPostDrainCallbacks ()

virtual void	setClock (DtClock *clock)
	This function allows one to set the exercise connection's clock – overriding the default clock and setting the simulation time to zero. More...

virtual DtClock *	clock ()
	Get reference to exercise connection's clock. More...

virtual int	lastDrainInputReceiveCount () const

virtual void	incrementNumberOfMessagesProcessed ()
	Increments myNumberOfMessagesProcessed. More...

virtual void	setApplicationId (int siteId, int applNum)
	----------------—— ID MANAGEMENT ----------------—— More...

virtual DtSimulationAddress	applicationId ()

virtual const DtEntityIdentifier &	nextId ()
	Returns the next valid entity ID formed by calling makeEntityId with the current value of a entity number counter. More...

virtual DtEntityIdentifier	makeEntityId (int entityNum)
	Returns an entity ID consisting of the DtExerciseConn's site and host numbers, and entityNum as the entity number. More...

Private Member Functions
	DtExerciseConn (const DtExerciseConn &orig)
	Copy constructor - not implemented. More...

DtExerciseConn &	operator= (const DtExerciseConn &orig)
	Assignment operator - not implemented. More...

static const int	nSizeMismatchComplain
	For VR-Link use only, should not be considered part of the public interface. More...

DtExerciseId	myExerciseId
	For VR-Link use only, should not be considered part of the public interface. More...

int	availEventNum
	For VR-Link use only, should not be considered part of the public interface. More...

int	deleteSocket
	For VR-Link use only, should not be considered part of the public interface. More...

DtPduCallbackManager	myPduCbMgr
	For VR-Link use only, should not be considered part of the public interface. More...

int	pduInterest [DtMAX_PDU_KINDS+1]
	For VR-Link use only, should not be considered part of the public interface. More...

int	nSizeMismatch
	For VR-Link use only, should not be considered part of the public interface. More...

bool	filtering
	For VR-Link use only, should not be considered part of the public interface. More...

DtHashlist	mcastAddrs
	For VR-Link use only, should not be considered part of the public interface. More...

DtPduFactory *	myPduFact
	For VR-Link use only, should not be considered part of the public interface. More...

DtPduFactory *	myDfltPduFact
	For VR-Link use only, should not be considered part of the public interface. More...

DtPduEncoderFactory *	myPduEncFact
	For VR-Link use only, should not be considered part of the public interface. More...

DtPduDecoderFactory *	myPduDecFact
	For VR-Link use only, should not be considered part of the public interface. More...

DtStateRepositoryExtensionEncoderFactory *	myStateRepoExtensionEncFac
	For VR-Link use only, should not be considered part of the public interface. More...

DtStateRepositoryExtensionDecoderFactory *	myStateRepoExtensionDecFac
	For VR-Link use only, should not be considered part of the public interface. More...

DtEventID	myCurrentEventId
	For VR-Link use only, should not be considered part of the public interface. More...

DtTimeStampType	myRelOrAbs
	For VR-Link use only, should not be considered part of the public interface. More...

DtDisObjectManager *	myDisObjectManager
	For VR-Link use only, should not be considered part of the public interface. More...

DtOwnershipHandler *	myOwnershipHandler
	For VR-Link use only, should not be considered part of the public interface. More...

DtPduInterceptFcn	myPduInterceptor
	For VR-Link use only, should not be considered part of the public interface. More...

DtInetSocket *	mySocket
	For VR-Link use only, should not be considered part of the public interface. More...

DtInetEndpoint	myRemoteEndpoint
	For VR-Link use only, should not be considered part of the public interface. More...

DtInetBufferChain	myBufferChain
	For VR-Link use only, should not be considered part of the public interface. More...

DtInetBuffer	myBuffer
	For VR-Link use only, should not be considered part of the public interface. More...

char *	myPacketBuffer
	For VR-Link use only, should not be considered part of the public interface. More...

DtInetEndpoint	myEndpointReceivedFrom
	For VR-Link use only, should not be considered part of the public interface. More...

float	myRelativeTimeRatio
	For VR-Link use only, should not be considered part of the public interface. More...

DtAttributePduStrategy	myAttributePduStrategy
	For VR-Link use only, should not be considered part of the public interface. More...

virtual void	setDefaultOwnershipHandler (DtOwnershipHandler *ownershipHandler)
	If you are using Ownership Management, you want to give each DIS Object an ownership handler. More...

virtual DtOwnershipHandler *	defaultOwnershipHandler ()
	For VR-Link use only, should not be considered part of the public interface. More...

void	setRelativeTimeRatio (float ratio)
	For VR-Link use only, should not be considered part of the public interface. More...

float	relativeTimeRatio ()
	For VR-Link use only, should not be considered part of the public interface. More...

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

virtual DtAttributePduStrategy	attributePduStrategy () const
	For VR-Link use only, should not be considered part of the public interface. More...

void	setPduInterceptor (DtPduInterceptFcn interceptor)
	Sets/Gets function to intercept, reject or re-write PDU. More...

DtPduInterceptFcn	pduInterceptor () const
	For VR-Link use only, should not be considered part of the public interface. More...

static DtString	vrlinkVersion ()
	Returns a string indicating the VR-Link version number. More...

virtual DtTime	currentTimeForStamping ()
	Return time to send with outgoing messages (default is sim time if absolute timestamping, real time otherwise.) More...

void	init0 (int port, int exerId, int siteId, int applNum, InitializationStatus *status, bool async_io, bool useIpv6, bool suppressSelfReflect)
	Called by constructor. More...

void	init0 (DtInetSocket s, int exerId, int siteId, int applNum, InitializationStatus status)
	Called by constructor. More...

virtual void	setRemoteEndpoint (const DtInetAddr &addr, int port)
	For VR-Link use only, should not be considered part of the public interface. More...

void	init (DtInetSocket s, int deleteSkt, int exerId, int siteId, int applNum, InitializationStatus status)
	Called by constructor. More...

DtDisSocket *	initializeSocket (const DtInetAddr &address, int port, bool useAsyncIo, DtInetDevice *device, bool suppressSelfReflect)
	For VR-Link use only, should not be considered part of the public interface. More...

void	zeroPduInterestList ()
	For VR-Link use only, should not be considered part of the public interface. More...

Additional Inherited Members
Protected Member Functions inherited from DtBaseExerciseConn
	DtBaseExerciseConn ()
	Constructors are protected since this is an abstract base class. More...

	DtBaseExerciseConn (const DtBaseExerciseConn &)
	copy constructor – Not implemented More...

DtBaseExerciseConn &	operator= (const DtBaseExerciseConn &)
	Assignment Operator – Not Implemented. More...

virtual void	executePostDrainCbs ()
	Should be called by derived class's drainInputs. More...

Protected Attributes inherited from DtBaseExerciseConn
DtSimulationAddress	myAppId

DtEntityIdentifier	myCurrentId

DtList	myPostDrainCbs

DtClock *	myClock

int	myNumberOfMessagesProcessed

Detailed Description

Instances of DtExerciseConn are used to provide an application's interface or connection to the network in a DIS environment.

The DtExerciseConn instance is the central class in a VR-Link application.

Examples

See Also: DtExerciseConnInitializer

Member Typedef Documentation

typedef int(* DtExerciseConn::DtPredicate)(DtPdu *pdu, void *arg)

Member Enumeration Documentation

anonymous enum

Status return codes for DtExerciseConn methods.

Enumerator
DtNET_READ_SUCCESS	No error, call was sucessful.
DtNET_READ_NO_PACKETS	No packets were read.
DtNET_READ_BAD_PACKET	A packet read error occured.
DtNET_READ_SERVER_MSG
DtNET_READ_SIZE_MISMATCH	Received a packet with an invalid size.

anonymous enum

Enumerator
DtPROCESS_PDU_SUCCESS
DtPROCESS_PDU_WRONG_EXID
DtPROCESS_PDU_NO_PDU
DtNET_READ_FILTERED_PACKET

enum DtExerciseConn::InitializationStatus

InitializationStatus enumerates possible values to be returned by the ExerciseConns's optional 'status' variable.

When status is non-null, DtFatalError will not get called, allowing users to check programmatically for initialization errors and hence deal with them as they wish. If no errors occur, status will equal DtINIT_SUCCESS.

Note: Do not attempt to use a DtExerciseConn instance when an error is indicated: VR-Link's behavior will be undefined.

Enumerator
DtINIT_SUCCESS	Class initialized with no error.
DtCOULD_NOT_CREATE_SOCKET	Class could not open socket, the class is not usable.

Constructor & Destructor Documentation

DtExerciseConn::DtExerciseConn	(	const DtExerciseConnInitializer &	initial,
		InitializationStatus *	status = `0`
	)

The preferred constructor.

Use status when you want to know whether the exercise connection has successfully initialized itself. When status is non-null, DtFatalError will not get called, allowing users to check programmatically for errors and hence deal with them as they wish.

Note: Do not attempt to use a DtExerciseConn instance when status is not DtINIT_SUCESS, VR-Link's behavior will be undefined.

DtExerciseConn::DtExerciseConn	(	int	port,
		int	exercise_id,
		int	site_id,
		int	application_num,
		InitializationStatus *	status = `0`,
		bool	use_async_io = `false`,
		bool	useIpv6 = `false`,
		bool	suppressSelfReflect = `false`
	)

inline

Constructor.

Deprecated:: Users should now use the DtExeciseConnInitializer CTOR

References init0().

DtExerciseConn::DtExerciseConn	(	int	port,
		const DtInetAddr &	destAddr,
		int	exercise_id,
		int	site_id,
		int	application_num,
		InitializationStatus *	status = `0`,
		bool	use_async_io = `false`,
		bool	suppressSelfReflect = `false`
	)

Constructor.

Deprecated:: Users should now use the DtExeciseConnInitializer CTOR

DtExerciseConn::DtExerciseConn	(	DtInetSocket *	skt,
		int	exercise_id,
		int	site_id,
		int	application_num,
		InitializationStatus *	status = `0`
	)

inline

Constructor.

Deprecated:: Users should now use the DtExeciseConnInitializer CTOR

References init0().

virtual DtExerciseConn::~DtExerciseConn ( )

virtual

Destructor.

DtExerciseConn::DtExerciseConn ( const DtExerciseConn & orig )

private

Copy constructor - not implemented.

Member Function Documentation

virtual bool DtExerciseConn::addDestination	(	const DtInetAddr &	destination,
		DtU16	port = `0`
	)

virtual

Add an additional destination.

Packets will be sent to these destinations in addition to the sockets destination. Use the given port to create the destination endpoint to be added. By default (port == 0), the destination port of the exercise connection's socket will be used unless specified otherwise. Return indicates if destination was added successfully (true) or not (false).

virtual void DtExerciseConn::addInterestInMcastAddr ( const DtInetAddr & addr )

virtual

Add interest in a multicast address.

Valid multicast addresses are between 224.0.0.0 and 239.255.255.255.

virtual void DtExerciseConn::addInterestInPduKind ( DtPduKind kind )

virtual

Adds interest in a PDU kind, users should not call directly.

PDUs in which no interest has been registered are filtered out below the level of netRead (possibly by the packet server). All PDU kinds for which user callbacks have been registered automatically are "interesting", so there is rarely a need to application code to call these functions.

virtual void DtExerciseConn::addPduCallback	(	DtPduKind	pduKind,
		DtPduCallbackFcn	fcn,
		void *	usr
	)

virtual

Register callbacks by PDU kind, should not be called directly.

Called by each derived DtPdu's addCallback function, which should be called instead of these by user code.

virtual DtAttributePduStrategy DtExerciseConn::attributePduStrategy ( ) const

virtual

For VR-Link use only, should not be considered part of the public interface.

virtual DtTime DtExerciseConn::currentTimeForStamping ( )

protectedvirtual

Return time to send with outgoing messages (default is sim time if absolute timestamping, real time otherwise.)

virtual DtOwnershipHandler* DtExerciseConn::defaultOwnershipHandler ( )

virtual

For VR-Link use only, should not be considered part of the public interface.

virtual DtInetAddr* DtExerciseConn::destinationAddr ( const DtPdu & pdu )

virtual

Returns the current destination address for the PDU.

Defaults to a null pointer. The pointer should be deleted by the calling code.

virtual void DtExerciseConn::disableFiltering ( )

virtual

Disable PDU filtering.

DtDisObjectManager * DtExerciseConn::disObjectManager ( )

inlinevirtual

Get the disObjectManager.

References myDisObjectManager.

virtual int DtExerciseConn::drainInput	(	DtTime	timeout = `-1`,
		int	nReadPerTimeCheck = `100`
	)

virtual

Normal way of processing input from the network.

Repeatedly calls readAndProcess to read PDUs and execute user callbacks. If timeout is -1, return only when there are no PDUs left to read. Otherwise, read for a maximum of timeout seconds. nReadPerTimeCheck is the number of PDUs to read in between checks to see if timeout has expired.

virtual void DtExerciseConn::enableFiltering ( )

virtual

EnablePDU filtering.

DtExerciseId DtExerciseConn::exerciseId ( ) const

inlinevirtual

Get the current exercise ID.

References myExerciseId.

void DtExerciseConn::init	(	DtInetSocket *	s,
		int	deleteSkt,
		int	exerId,
		int	siteId,
		int	applNum,
		InitializationStatus *	status
	)

protected

Called by constructor.

void DtExerciseConn::init0	(	int	port,
		int	exerId,
		int	siteId,
		int	applNum,
		InitializationStatus *	status,
		bool	async_io,
		bool	useIpv6,
		bool	suppressSelfReflect
	)

protected

Called by constructor.

Referenced by DtExerciseConn().

void DtExerciseConn::init0	(	DtInetSocket *	s,
		int	exerId,
		int	siteId,
		int	applNum,
		InitializationStatus *	status
	)

protected

Called by constructor.

DtDisSocket* DtExerciseConn::initializeSocket	(	const DtInetAddr &	address,
		int	port,
		bool	useAsyncIo,
		DtInetDevice *	device,
		bool	suppressSelfReflect
	)

protected

For VR-Link use only, should not be considered part of the public interface.

virtual DtPdu* DtExerciseConn::netRead ( int * retCode = 0 )

virtual

Reads the network, users should seldom need to call this function.

Caller, (usually readAndProcess()), is responsible for deleting it when through. netRead() creates a new DtPdu on the heap. Caller,

Referenced by readAndProcess().

virtual const DtEventID& DtExerciseConn::nextEventId ( )

virtual

Return an event ID consisting of the DtExerciseConn's site and host numbers, and the current value of an event number counter.

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

private

Assignment operator - not implemented.

DtPduDecoderFactory * DtExerciseConn::pduDecoderFactory ( )

inlinevirtual

Get the factory used to convert pdu information to the VR-Link State Repositories.

Not every class has an encoder, but the ones that do can be changed here.

References myPduDecFact.

DtPduEncoderFactory * DtExerciseConn::pduEncoderFactory ( )

inlinevirtual

Get the factory used to convert pdu information from the VR-Link State Repositories.

Not every class has an encoder, but the ones that do can be changed here.

References myPduEncFact.

DtPduFactory * DtExerciseConn::pduFactory ( )

inlinevirtual

Get the PDU factory used by netRead to create the right kind of derived DtPDU.

You can use DtPduFactory member function, including its assignment operator to configure it to "know" about various PDU classes. For example, you can use *(exConn.pduFactory()) = DtDisPduFactory(); to configure the PDU factory to know about all DIS PDUs and the VR-Link classes that represent them.

References myPduFact.

DtPduInterceptFcn DtExerciseConn::pduInterceptor ( ) const

For VR-Link use only, should not be considered part of the public interface.

virtual int DtExerciseConn::processPdu ( DtPdu * pdu )

virtual

Called by readAndProcess (which is called by drainInput).

The default behavior is to execute any user callbacks that have been registered on the pdu's kind.

Referenced by readAndProcess().

int DtExerciseConn::readAndProcess ( void )

inlinevirtual

Called by drainInput, so application code rarely needs to use this.

Reads and processes (via netRead and processPdu) a single PDU.

References DtNET_READ_SUCCESS, netRead(), and processPdu().

virtual DtPduKind DtExerciseConn::readUntil	(	DtPredicate	predicate,
		void *	arg,
		DtTime	timeout,
		DtTime	sleepTime = `0.1`
	)

virtual

Repeatedly call readAndProcess until predicate holds on the PDU that is being read, or until timeout seconds have elapsed.

sleepTime indicates the amount of time to sleep in between polling the network when there are no packets to read.

float DtExerciseConn::relativeTimeRatio ( )

For VR-Link use only, should not be considered part of the public interface.

virtual bool DtExerciseConn::removeDestination	(	const DtInetAddr &	destination,
		DtU16	port = `0`
	)

virtual

Remove a destination.

Address will be removed from the list of additional destinations for sending packets. Use the given port to create the destination endpoint to be removed. By default (port == 0), the destination port of the exercise connection's socket will be used unless specified otherwise. Return indicates if destination was removed successfully (true) or not (false).

virtual void DtExerciseConn::removePduCallback	(	DtPduKind	pduKind,
		DtPduCallbackFcn	fcn,
		void *	usr
	)

virtual

Deregister callbacks by PDU kind, should not be called directly.

Called by each derived DtPdu's addCallback function, which should be called instead of these by user code.

virtual void DtExerciseConn::send ( const DtStateMsg & msg )

virtual

Send a message - call down to send(DtPdu &pdu....)

Implements DtBaseExerciseConn.

virtual void DtExerciseConn::send ( const DtInteraction & msg )

virtual

Send an interaction - call down to send(DtPdu &pdu....)

Implements DtBaseExerciseConn.

virtual int DtExerciseConn::send	(	const DtPdu &	pdu,
		const DtInetAddr *	addr = `0`
	)

virtual

Send a PDU to the specified address, or the DtExerciseConn's default destination address if addr is 0.

PDU must be completely filled out, as it is not touched by this call. Return the number of bytes sent or -1 if there was an error.

virtual void DtExerciseConn::sendStamped ( const DtStateMsg & msg )

virtual

Send a stamped message - call down to sendStamped(DtPdu &pdu....)

Implements DtBaseExerciseConn.

virtual void DtExerciseConn::sendStamped ( const DtInteraction & msg )

virtual

Send a stamped message - call down to sendStamped(DtPdu &pdu....)

Implements DtBaseExerciseConn.

virtual int DtExerciseConn::sendStamped	(	const DtPdu &	pdu,
		const DtInetAddr *	addr = `0`
	)

virtual

Send a PDU to the specified address, or the DtExerciseConn's default destination address if addr is 0.

The outgoing PDU is stamped with the current timeStamp (obtained using currentTimeForStamping()), and the current exerciseId. Return the number of bytes sent or -1 if there was an error.

virtual void DtExerciseConn::setAttributePduStrategy ( DtAttributePduStrategy strat )

virtual

Sets/Gets whether to couple the attribute PDU.

virtual void DtExerciseConn::setDefaultOwnershipHandler ( DtOwnershipHandler * ownershipHandler )

virtual

If you are using Ownership Management, you want to give each DIS Object an ownership handler.

If you set this value, Objects created will receive a copy of this handler automatically.

virtual void DtExerciseConn::setExerciseId ( int exercise_id )

virtual

Set the current exercise ID.

virtual void DtExerciseConn::setPduFactory ( DtPduFactory * fact )

virtual

Rather than just modifying the ExerciseConn's current PDU factory, you can tell the ExerciseConn to use a different PDU factory object.

The object passed belongs to the ExerciseConn, and should not be deleted until after a subsequent call to setPduFactory, or the ExerciseConn is deleted.

void DtExerciseConn::setPduInterceptor ( DtPduInterceptFcn interceptor )

Sets/Gets function to intercept, reject or re-write PDU.

void DtExerciseConn::setRelativeTimeRatio ( float ratio )

For VR-Link use only, should not be considered part of the public interface.

virtual void DtExerciseConn::setRemoteEndpoint	(	const DtInetAddr &	addr,
		int	port
	)

protectedvirtual

For VR-Link use only, should not be considered part of the public interface.

virtual void DtExerciseConn::setTimeStampType ( DtTimeStampType relOrAbs )

virtual

set time stamp type (DtTimeStampAbsolute or DtTimeStampRelative).

virtual void DtExerciseConn::setTimeStampType ( int relOrAbs )

virtual

This function has been obsoleted by the version above that use the DtTimeStampType enumeration, but is included for backwards compatibility.

DtInetSocket * DtExerciseConn::socket ( )

inlinevirtual

Returns the current DtDisSocket that we are using for communication.

References mySocket.

DtStateRepositoryExtensionDecoderFactory * DtExerciseConn::stateRepoExtensionDecoderFactory ( )

inlinevirtual

Get the factory used to convert PDU attribute records to the VR-Link State Repositories Extensions.

References myStateRepoExtensionDecFac.

DtStateRepositoryExtensionEncoderFactory * DtExerciseConn::stateRepoExtensionEncoderFactory ( )

inlinevirtual

Get the factory used to convert information from the VR-Link State Repositories Extensions to attribute records.

References myStateRepoExtensionEncFac.

virtual void DtExerciseConn::subtractInterestInMcastAddr ( const DtInetAddr & addr )

virtual

Subtract interest in a multicast address.

Valid multicast addresses are between 224.0.0.0 and 239.255.255.255.

virtual void DtExerciseConn::subtractInterestInPduKind ( DtPduKind kind )

virtual

Subtracts interest in a PDU kind, users should not call directly.

PDUs in which no interest has been registered are filtered out below the level of netRead (possibly by the packet server). All PDU kinds for which user callbacks have been registered automatically are "interesting", so there is rarely a need to application code to call these functions.

virtual DtTimeStampType DtExerciseConn::timeStampType ( ) const

virtual

Get time stamp type (DtTimeStampAbsolute or DtTimeStampRelative).

static DtString DtExerciseConn::vrlinkVersion ( )

static

Returns a string indicating the VR-Link version number.

void DtExerciseConn::zeroPduInterestList ( )

protected

For VR-Link use only, should not be considered part of the public interface.

Member Data Documentation

int DtExerciseConn::availEventNum

protected

For VR-Link use only, should not be considered part of the public interface.

int DtExerciseConn::deleteSocket

protected

For VR-Link use only, should not be considered part of the public interface.

bool DtExerciseConn::filtering

protected

For VR-Link use only, should not be considered part of the public interface.

DtHashlist DtExerciseConn::mcastAddrs

protected

For VR-Link use only, should not be considered part of the public interface.

DtAttributePduStrategy DtExerciseConn::myAttributePduStrategy

protected

For VR-Link use only, should not be considered part of the public interface.

DtInetBuffer DtExerciseConn::myBuffer

protected

For VR-Link use only, should not be considered part of the public interface.

DtInetBufferChain DtExerciseConn::myBufferChain

protected

For VR-Link use only, should not be considered part of the public interface.

DtEventID DtExerciseConn::myCurrentEventId

protected

For VR-Link use only, should not be considered part of the public interface.

DtPduFactory* DtExerciseConn::myDfltPduFact

protected

For VR-Link use only, should not be considered part of the public interface.

DtDisObjectManager* DtExerciseConn::myDisObjectManager

protected

For VR-Link use only, should not be considered part of the public interface.

Referenced by disObjectManager().

DtInetEndpoint DtExerciseConn::myEndpointReceivedFrom

protected

For VR-Link use only, should not be considered part of the public interface.

DtExerciseId DtExerciseConn::myExerciseId

protected

For VR-Link use only, should not be considered part of the public interface.

Referenced by exerciseId().

DtOwnershipHandler* DtExerciseConn::myOwnershipHandler

protected

For VR-Link use only, should not be considered part of the public interface.

char* DtExerciseConn::myPacketBuffer

protected

For VR-Link use only, should not be considered part of the public interface.

DtPduCallbackManager DtExerciseConn::myPduCbMgr

protected

For VR-Link use only, should not be considered part of the public interface.

DtPduDecoderFactory* DtExerciseConn::myPduDecFact

protected

For VR-Link use only, should not be considered part of the public interface.

Referenced by pduDecoderFactory().

DtPduEncoderFactory* DtExerciseConn::myPduEncFact

protected

For VR-Link use only, should not be considered part of the public interface.

Referenced by pduEncoderFactory().

DtPduFactory* DtExerciseConn::myPduFact

protected

For VR-Link use only, should not be considered part of the public interface.

Referenced by pduFactory().

DtPduInterceptFcn DtExerciseConn::myPduInterceptor

protected

For VR-Link use only, should not be considered part of the public interface.

float DtExerciseConn::myRelativeTimeRatio

protected

For VR-Link use only, should not be considered part of the public interface.

DtTimeStampType DtExerciseConn::myRelOrAbs

protected

For VR-Link use only, should not be considered part of the public interface.

DtInetEndpoint DtExerciseConn::myRemoteEndpoint

protected

For VR-Link use only, should not be considered part of the public interface.

DtInetSocket* DtExerciseConn::mySocket

protected

For VR-Link use only, should not be considered part of the public interface.

Referenced by socket().

DtStateRepositoryExtensionDecoderFactory* DtExerciseConn::myStateRepoExtensionDecFac

protected

For VR-Link use only, should not be considered part of the public interface.

Referenced by stateRepoExtensionDecoderFactory().

DtStateRepositoryExtensionEncoderFactory* DtExerciseConn::myStateRepoExtensionEncFac

protected

For VR-Link use only, should not be considered part of the public interface.

Referenced by stateRepoExtensionEncoderFactory().

int DtExerciseConn::nSizeMismatch

protected

For VR-Link use only, should not be considered part of the public interface.

const int DtExerciseConn::nSizeMismatchComplain

static

For VR-Link use only, should not be considered part of the public interface.

int DtExerciseConn::pduInterest[DtMAX_PDU_KINDS+1]

protected

For VR-Link use only, should not be considered part of the public interface.

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

exerciseConnDIS.h

Public Types

Public Member Functions

Private Member Functions

Additional Inherited Members

Detailed Description

Member Typedef Documentation

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation