DtGlobalEnvironmentLocalNetInterface Class Reference

Local network interface for global environment state objects. More...

Inheritance diagram for DtGlobalEnvironmentLocalNetInterface:

Public Member Functions
	DtGlobalEnvironmentLocalNetInterface (const DtString &name, DtVrfObject *vrfObject, DtReaderWriterRegistry *parentRegistry=0, bool publishObject=true)
	read/writable contructor
	DtGlobalEnvironmentLocalNetInterface (const DtGlobalEnvironmentLocalNetInterface &orig, DtReaderWriterRegistry *parentRegistry=0)
	copy constructor; NOTE: The publisher is not copied, because VR-Link does not provide a copy constructor (or clone or assignment function) for a publisher.
const DtGlobalEnvironmentLocalNetInterface &	operator= (const DtGlobalEnvironmentLocalNetInterface &orig)
	assignment operator; see note on copy constructor above.
virtual	~DtGlobalEnvironmentLocalNetInterface ()
	destructor; calls destroyPublisher()
virtual bool	init ()
	Override of base class init(), calls createPublisher().
virtual void	updatePublisher ()
	Update this publisher's contents.
virtual DtString	type () const
	Return type string for publisher that can be refered to in ope files (see "vrfNetIfTypes.h")
Public Member Functions inherited from DtSimLocalEnvironmentalNetInterface
	DtSimLocalEnvironmentalNetInterface (const DtString &name, DtVrfObject *vrfObject, DtReaderWriterRegistry *parentRegistry=0, bool publishObject=true)
	read/writable contructor
	DtSimLocalEnvironmentalNetInterface (const DtSimLocalEnvironmentalNetInterface &orig, DtReaderWriterRegistry *parentRegistry=0)
	copy constructor; NOTE: The publisher is not copied, because VR-Link does not provide a copy constructor (or clone or assignment function) for a publisher.
const DtSimLocalEnvironmentalNetInterface &	operator= (const DtSimLocalEnvironmentalNetInterface &orig)
	assignment operator; see note on copy constructor above.
virtual	~DtSimLocalEnvironmentalNetInterface ()
	destructor; calls destroyPublisher()
virtual void	tick ()
	Override base class tick.
virtual void	setMinTickPeriod (double minTickPeriod)
	specifies a minimum tick period (which can also be thought of as
virtual double	minTickPeriod () const
	access the minimum tick period
virtual void	setMinTickPeriodVariance (double minTickPeriodVariance)
	set the variance in the minimum tick time
virtual double	minTickPeriodVariance () const
	access the variance in the minimum tick period
virtual void	setNextTickTime (double nextTickTime)
	The next tick time is normally calculated internally.
virtual double	nextTickTime () const
	access the next tick time
virtual double	calculateNextTickTime () const
	The next tick time is equal to mySimManager->exerciseClock()-> approximateElapsedRealTime() + myMinTickPeriod + a random # between -myMinTickPeriodVariance/2.
virtual void	onTick ()
	Override of base class onTick() Checks if VR-Forces-specific data has changed.
virtual bool	publisherUserSupplied () const
	A true return indicates that the publisher currently used by the interface was supplied by the user rather than created by init().
virtual bool	createPublisher ()
	Called by init() to create a VR-Link publisher, deriving classes create the type of publisher needed for that entity type.
virtual void	destroyPublisher ()
	Called by the destructor (and also by setPublisher() in some cases, deletes a publisher.
virtual bool	setEntityPublisher (DtEnvironmentProcessPublisher *publisher)
	If the user needs to supply a publisher other than the one created by the network interface, this call call be used.
virtual DtEnvironmentProcessPublisher *	environmentalPublisher () const
virtual void	setupNetworkRepository ()
	Initializes parts of the network repository created by the publisher This needs to be done after the local state repository has been intialized.
DtVrfObject *	vrfObject () const
virtual bool	isLocal () const
	This network interface is for local entities.
virtual bool	isEnvironmental () const
virtual void	processVerticesChanged (DtVrfObject *)
Public Member Functions inherited from DtSimEnvironmentalNetInterface
	DtSimEnvironmentalNetInterface (const DtString &name, DtVrfObject *simObject, DtReaderWriterRegistry *parentRegistry=0, bool publishObject=true)
	read/writable contructor
	DtSimEnvironmentalNetInterface (const DtSimEnvironmentalNetInterface &orig, DtReaderWriterRegistry *parentRegistry=0)
	copy constructor
const DtSimEnvironmentalNetInterface &	operator= (const DtSimEnvironmentalNetInterface &orig)
	assignment operator
virtual	~DtSimEnvironmentalNetInterface ()
	destructor
virtual DtControlObjectRepository *	environmentalNetworkState () const
virtual bool	isEntity () const
	Is this network interface for a local (true) or remote (false) object? Deriving network interfaces should implement this function to return the appropriate value.
Public Member Functions inherited from DtSimObjectNetInterface
	DtSimObjectNetInterface (const DtString &name, DtVrfObject *simObject, DtReaderWriterRegistry *parentRegistry=0, bool publishObject=true)
	read/writable contructor Publish object flag indicate whether or not locally simulated objects should actually publish the object on the network.
	DtSimObjectNetInterface (const DtSimObjectNetInterface &orig, DtReaderWriterRegistry *parentRegistry=0)
	copy constructor
const DtSimObjectNetInterface &	operator= (const DtSimObjectNetInterface &orig)
	assignment operator
virtual	~DtSimObjectNetInterface ()
	destructor
virtual DtVrfObject *	simObject () const
	This is a pointer to the simulation object for which this interface was created.
virtual DtStateRepository *	networkState () const
	this is a pointer to the VR-Link network state repository create by either the contained publisher or reflected object
virtual int	maxNameLength () const
Public Member Functions inherited from DtReaderWriter
	DtReaderWriter ()
	default constructor
	DtReaderWriter (const DtString &name, DtReaderWriterRegistry *parentRegistry=NULL, bool readonly=false)
	real constructor Setting the readonly flag prevents object from writing itself to the stream.
	DtReaderWriter (const DtSymbolString &name, DtReaderWriterRegistry *parentRegistry=NULL, bool readonly=false)
	DtReaderWriter (const DtString &name, const DtReaderWriter &orig, DtReaderWriterRegistry *parentRegistry=NULL)
	copy constructor
	DtReaderWriter (const DtSymbolString &name, const DtReaderWriter &orig, DtReaderWriterRegistry *parentRegistry=NULL)
const DtReaderWriter &	operator= (const DtReaderWriter &orig)
	assignment operator
virtual	~DtReaderWriter ()
	destructor
virtual void	putSelf (FILE *fp, int indentLevel=0, bool writeUnspecified=false, const DtFilename &path=DtFilename::nullFilename())
	Top level call to write itself to file.
virtual void	getSelf (DtlObjPtr args, const DtFilename &searchPath=DtFilename::nullFilename(), const DtVariableBindingsList &variableBindings=nullVariableReference())
	Top level to read itself from an input stream.
virtual void	writeSelf (FILE *fp, int indentLevel=0, bool writeUnspecified=false, const DtFilename &path=DtFilename::nullFilename())
	Called from putSelf, calls myRegistry.putSelf which in turn calls putSelf on each reader/writer in the registry.
virtual DtSymbolString	name () const
	Accessor for name of this readable/writable object.
virtual void	addAlias (const DtSymbolString &alias)
	Add an alias as an alternative name for this object.
virtual bool	hasAlias (const DtSymbolString &alias)
virtual const aliasContainer &	aliases () const
virtual void	setReadonly (bool flag)
	Set read-only flag.
virtual bool	isReadonly () const
virtual bool	variableIsBound () const
virtual void	unbindVariable ()
	Sets the myVariableIsBound flag to false.
virtual void	setName (const DtString &)
	Set the name of the object.
virtual const char *	readerWriterType () const
	Used to supply a string type that this reader writer type is.
virtual DtString	prettyPrint () const
	Routine to return a human readable form of the reader/writer variable.
virtual void	bindVariables (DtVariableBindingsList variableBindings)
	Runs a variable binding pass on this reader writer and any of its children.
virtual std::list < DtVariableNameType >	unboundVariables () const
bool	invalid () const
virtual bool	hasChild (const DtReaderWriter *p) const
	Returns true if this variable has a child p in it's chain.
virtual void	setValueSpecified (bool specified, bool recurse=false)
	The specified flags are used for optional values.
virtual bool	valueSpecified () const
	The specified flags are used for optional values.
virtual bool	isVariableReference () const
	Specifies whether or not this reader writer is really a variable that is specified elsewhere.
virtual void	setIsVariableReference (bool value)
virtual DtSymbolString	variableName () const
	The variable name, if this object is a variable reference.
virtual void	setVariableName (const DtSymbolString variableName)
	The variable name, if this object is a variable reference.
const DtReaderWriterRegistry &	registry () const
	Collection of child DtReaderWriter nodes owned by this object.
DtReaderWriterRegistry &	registry ()
	Collection of child DtReaderWriter nodes owned by this object.

Static Public Member Functions
static DtSimObjectNetInterface *	creator (const DtString &name, DtVrfObject *vrfObject, DtReaderWriterRegistry *parentRegistry, bool publishObject)
Static Public Member Functions inherited from DtSimLocalEnvironmentalNetInterface
static DtSimLocalEnvironmentalNetInterface *	isLocalEnvironmentalNetInterface (const DtSimObjectNetInterface *objNetInterface)
	This function will return the objNetInterface passed in, cast to a DtSimLocalEntityNetInterface*, provided the objNetInterface is indeed an local entity network interface.
static void	verticesChanged (DtVrfObject *, void *usr)
Static Public Member Functions inherited from DtSimEnvironmentalNetInterface
static DtSimEnvironmentalNetInterface *	isEnvironmentalNetInterface (const DtSimObjectNetInterface *objNetInterface)
	This function will return the objNetInterface passed in, cast to a DtSimEntityNetInterface*, provided the objNetInterface is indeed an entity network interface.
Static Public Member Functions inherited from DtSimObjectNetInterface
static void	addSimObjectNetInterfaceCreatorFcn (const DtString &type, DtSimObjectNetIfaceCreatorFcn fcn)
	Adds a net interface creator function to the net interface factory.
static void	setFactory (DtSimObjectNetInterfaceFactory *factory)
static DtSimObjectNetInterfaceFactory *	factory ()
static DtSimObjectNetInterface *	createNetInterface (const DtString &name, const DtString &type, DtVrfObject *simObject, DtReaderWriterRegistry *parentRegistry=0, bool publishObject=true)
	Creates a new net interface object using the factory.
static int	maxNameLengthForInterfaceType (const DtString &interfaceTypeString)
Static Public Member Functions inherited from DtReaderWriter
static void	putIndent (FILE *fp, int indentLevel)
static const DtVariableBindingsList &	nullVariableReference ()
static void	setPostGetSelfCallback (DtGetSelfCallbackFcn fcn, void *usrData)
static void	setPrePutSelfCallback (DtPutSelfCallbackFcn fcn, void *usrData)
static const DtFilename &	appPath ()
	Gets the current working directory.

Protected Member Functions
	DtGlobalEnvironmentLocalNetInterface ()
	default constructor
virtual DtEnvironmentProcessRepository *	epsr () const
	Shortcut for accessing the network repository.
virtual void	setupRecords ()
	Creates and sets the records to the VRL state repository.
virtual void	updateGeometryRecord (DtGlobalEnvironmentStateRepository *localState)
virtual void	updateStateRecord (DtGlobalEnvironmentStateRepository *localState)
virtual DtEnvironmentProcessPublisher *	_createPublisher () const
	Override this functions to use a subclass of DtEnvironmentProcessPublisher.
Protected Member Functions inherited from DtSimLocalEnvironmentalNetInterface
	DtSimLocalEnvironmentalNetInterface ()
	default constructor
virtual DtEnvironmentProcessRepository *	_createSR () const
	Override this functions to use a subclass of DtEnvironmentProcessStateRepository.
Protected Member Functions inherited from DtSimEnvironmentalNetInterface
	DtSimEnvironmentalNetInterface ()
	default constructor
Protected Member Functions inherited from DtSimObjectNetInterface
	DtSimObjectNetInterface ()
	default constructor
Protected Member Functions inherited from DtReaderWriter
virtual void	bindToRwAsVariable (const DtReaderWriter *rw)
	Copies values from the specified DtReaderWriter.
virtual void	bindLocalVariables (const DtVariableBindingsList &variableBindings)
	Checks to see if this RW object is a variable reference that can be bound using the provided bindings.
virtual void	putData (FILE *fp, int indentLevel=0)
	Deriving class overrides these to get/put class specific data.
virtual DtlObjPtr	getData (DtlObjPtr args, const DtFilename &searchPath, const DtVariableBindingsList &variableBindings)
	Deriving class overrides these to get/put class specific data.

Protected Attributes
DtVrfEnvironmentalWeatherStateRecord *	myEnvironmentalStateRecord
Protected Attributes inherited from DtSimLocalEnvironmentalNetInterface
bool	myPublisherUserSupplied
DtEnvironmentProcessPublisher *	myEnvironmentalPublisher
bool	myPublishObject
DtSimManager *	mySimManager
	Obtained from our DtVrfObject, and cached for use in sendVrfObject().
double	myMinTickPeriod
double	myMinTickPeriodVariance
double	myNextTickTime
bool	myVerticesChanged

Additional Inherited Members
Public Types inherited from DtReaderWriter
typedef std::vector < DtSymbolString >	aliasContainer
typedef std::vector < DtSymbolString >::iterator	aliasIter
typedef std::vector < DtSymbolString > ::const_iterator	aliasConstIter
typedef std::pair < DtSymbolString, DtString >	DtVariableNameType
Static Protected Attributes inherited from DtSimObjectNetInterface
static DtSimObjectNetInterfaceFactory *	theFactory

Detailed Description

Local network interface for global environment state objects.

These objects must have a DtGlobalEnvironmentStateRepository to work with this net interface.

Constructor & Destructor Documentation

DtGlobalEnvironmentLocalNetInterface::DtGlobalEnvironmentLocalNetInterface ( )

protected

default constructor

DtGlobalEnvironmentLocalNetInterface::DtGlobalEnvironmentLocalNetInterface	(	const DtString &	name,
		DtVrfObject *	vrfObject,
		DtReaderWriterRegistry *	parentRegistry = 0,
		bool	publishObject = true
	)

read/writable contructor

DtGlobalEnvironmentLocalNetInterface::DtGlobalEnvironmentLocalNetInterface	(	const DtGlobalEnvironmentLocalNetInterface &	orig,
		DtReaderWriterRegistry *	parentRegistry = 0
	)

copy constructor; NOTE: The publisher is not copied, because VR-Link does not provide a copy constructor (or clone or assignment function) for a publisher.

Therefore, you must call init() on the copy after construction, or call setPublisher() with a user constructed publisher.

virtual DtGlobalEnvironmentLocalNetInterface::~DtGlobalEnvironmentLocalNetInterface ( )

virtual

destructor; calls destroyPublisher()

Member Function Documentation

const DtGlobalEnvironmentLocalNetInterface& DtGlobalEnvironmentLocalNetInterface::operator=

(

const DtGlobalEnvironmentLocalNetInterface &

orig

)

assignment operator; see note on copy constructor above.

virtual bool DtGlobalEnvironmentLocalNetInterface::init ( )

virtual

Override of base class init(), calls createPublisher().

Reimplemented from DtSimLocalEnvironmentalNetInterface.

virtual void DtGlobalEnvironmentLocalNetInterface::updatePublisher ( )

virtual

Update this publisher's contents.

Implements DtSimLocalEnvironmentalNetInterface.

virtual DtString DtGlobalEnvironmentLocalNetInterface::type ( ) const

virtual

Return type string for publisher that can be refered to in ope files (see "vrfNetIfTypes.h")

Implements DtSimLocalEnvironmentalNetInterface.

static DtSimObjectNetInterface* DtGlobalEnvironmentLocalNetInterface::creator ( const DtString &  name, DtVrfObject *  vrfObject, DtReaderWriterRegistry *  parentRegistry, bool  publishObject  )

static

virtual DtEnvironmentProcessRepository* DtGlobalEnvironmentLocalNetInterface::epsr ( ) const

protectedvirtual

Shortcut for accessing the network repository.

virtual void DtGlobalEnvironmentLocalNetInterface::setupRecords ( )

protectedvirtual

Creates and sets the records to the VRL state repository.

virtual void DtGlobalEnvironmentLocalNetInterface::updateGeometryRecord ( DtGlobalEnvironmentStateRepository *  localState )

protectedvirtual

virtual void DtGlobalEnvironmentLocalNetInterface::updateStateRecord ( DtGlobalEnvironmentStateRepository *  localState )

protectedvirtual

virtual DtEnvironmentProcessPublisher* DtGlobalEnvironmentLocalNetInterface::_createPublisher ( ) const

protectedvirtual

Override this functions to use a subclass of DtEnvironmentProcessPublisher.

Reimplemented from DtSimLocalEnvironmentalNetInterface.

Member Data Documentation

DtVrfEnvironmentalWeatherStateRecord* DtGlobalEnvironmentLocalNetInterface::myEnvironmentalStateRecord

protected

---

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

• include/vrfobjcore/globalEnvironmentLocalNetIf.h