VR-Forces Development_Version Class Documentation
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
List of all members | Public Member Functions | Static Public Member Functions | Protected Member Functions | Protected Attributes
DtIfCreateVrfObject Class Reference

class DtIfCreateVrfObject: More...

Inheritance diagram for DtIfCreateVrfObject:
Inheritance graph
[legend]

Public Member Functions

 DtIfCreateVrfObject ()
 default constructor
virtual ~DtIfCreateVrfObject ()
 destructor
 DtIfCreateVrfObject (const DtIfCreateVrfObject &orig)
 copy constructor
DtIfCreateVrfObjectoperator= (const DtIfCreateVrfObject &orig)
 assignment operator
virtual DtSimInterfaceContentclone () const
 Returns a newly created instance of a DtIfCreateVrfObject.
virtual int type () const
 Returns the string type of message, DtCreateVrfObjectMessageType (defined in msgTypes.h).
virtual unsigned long requestId () const
 Set/get the request Id for the message.
virtual void setRequestId (unsigned long requestId)
virtual void setUUID (const DtUUID &)
 Use this UUID to create object (if specified). If the UUID exists will be regenerated on creation.
virtual const DtUUIDuuid () const
virtual void setVrfProcessAddress (const DtSimulationAddress &address)
 Set/get the address of the VR-Forces process that we want to create the new vrf object.
virtual const DtSimulationAddress & vrfProcessAddress () const
virtual void setMarkingText (const DtString &objectName)
 Set/get the object name of the vrf object to create.
virtual const DtStringmarkingText () const
virtual void setObjectType (const DtObjectType &objectType)
 Set/get the object type of the vrf object to create.
virtual const DtObjectTypeobjectType () const
virtual void setForceType (const DtForceType forceType)
 Set/get the force type of the vrf object to create.
virtual DtForceType forceType () const
virtual void setObjectLabel (const DtString &objectLabel)
 Set/get the object label of the vrf object to create.
virtual const DtStringobjectLabel () const
virtual void setExtendedLabels (const std::map< int, DtString > &extendedLabels)
 Set/get the object label of the vrf object to create.
virtual const std::map< int,
DtString > & 
extendedLabels () const
virtual void setOverlayParent (const DtString &overlayParent)
 Sets the overlay parent of this object.
virtual const DtStringoverlayParent () const
virtual const DtVectorposition () const
 In geocentric coordinates.
virtual void setPosition (const DtVector &position)
virtual DtReal heading () const
 0 is north, clockwise, in radians.
virtual void setHeading (DtReal heading)
virtual const std::vector
< DtVector > & 
vertexList () const
 This is where the actually object geometry goes position() is just an alias for the first vertex.
virtual const DtList & vertices () const
 Backwards compatible access to vertexList.
virtual void addVertex (const DtVector &vertex)
 Add a vertex to the end of the vertex list.
virtual bool projection () const
 Do the Z elements of the vectors in the vertex list have meaning?
virtual void setProjection (bool projection)
virtual bool closedFigure () const
 Does the last vertex connect back to the first? Obviously, this is undefined for a single vertex (but I suppose an argument could be made for that being a closed figure...)
virtual void setClosedFigure (bool closedFigure)
virtual const DtAppearance & appearance ()
 Appearance.
virtual void setAppearance (const DtAppearance &appearance)
virtual bool createSubObjects () const
 Create SubObjects.
virtual void setCreateSubObjects (bool createSubObjects)
virtual bool addToOrganization () const
 If True (the default) and the object being created is an orgainzed object type (as specified by the is-organized flag in the OPD file), the newly created object will be added to the organization manager directly below the force level aggregate of this object's force.
virtual void setAddToOrganization (bool addToOrg)
virtual bool clampToGround () const
 If True (the default) the object will be created and placed on the nearest polygon.
virtual void setClampToGround (bool clamp)
virtual DtAggregateState initialAggregateState () const
 Set/get the initial aggregate state when creating an aggregate.
virtual void setInitialAggregateState (DtAggregateState aggregateState)
virtual std::list
< DtAdminContent * > * 
initialAdminContent ()
 Set any Admin Content messages passed on initialization.
virtual void setInitialAdminContent (std::list< DtAdminContent * > adminContent)
virtual void addInitialAdminContent (DtAdminContent *adminContent)
virtual std::list
< DtSimInterfaceContent * > * 
initialInterfaceContent ()
 Set any Interface Content messages passed on initialization.
virtual void setInitialInterfaceContent (std::list< DtSimInterfaceContent * > adminContent)
virtual void addInitialInterfaceContent (DtSimInterfaceContent *adminContent)
void setStartPosition (const DtVector &position)
 These are here for back compatibility and should be removed after the next release.
const DtVectorstartPosition () const
void setEndPosition (const DtVector &position)
const DtVectorendPosition () const
virtual void setExtendedData (const std::map< std::string, std::string > &)
virtual void setExtendedData (const std::map< DtString, DtString > &)
virtual void setExtendedData (const DtString &keyword, const DtString &data)
virtual const std::map
< std::string, std::string > & 
extendedData () const
virtual void setUserData (const DtString &userData)
virtual DtString userData () const
virtual int netRepSize () const
virtual bool setFromNet (const char *contentBuffer, unsigned contentSize)
virtual bool setToNet ()
virtual void printDataToString (DtString &str)
virtual DtString initialFormation () const
 The formation name to set when creating an aggregate.
virtual void setInitialFormation (const DtString &formation)
 The formation name to set when creating an aggregate.
virtual bool publishObject () const
 Sets whether or not to publish the object on the network once created.
virtual void setPublishObject (bool)
 Sets whether or not to publish the object on the network once created.
virtual bool connectToRadioNetwork () const
 Sets whether or not the object will be connected to any applicable radio networks on creation.
virtual void setConnectToRadioNetwork (bool)
 Sets whether or not the object will be connected to any applicable radio networks on creation.
- Public Member Functions inherited from DtSimInterfaceContent
virtual ~DtSimInterfaceContent ()
virtual bool update (const DtSimInterfaceContent *data)
virtual charnetRep ()
virtual void printContentType (DtString &str)
virtual void setUseSessionId (bool yesNo)
virtual bool useSessionId () const

Static Public Member Functions

static DtSimInterfaceContentcreator ()
- Static Public Member Functions inherited from DtSimInterfaceContent
static DtSimInterfaceContentcreateInterfaceContent (int type)
static void addInterfaceContentCreatorFcn (int type, DtInterfaceContentCreatorFcn fcn)
static void setFactory (DtInterfaceContentFactory *factory)
static DtInterfaceContentFactoryfactory ()
static void registerContentTypePrinter (DtSimInterfaceContentTypePrinterFcn printFcn)

Protected Member Functions

void copyList (const DtList &fromList)
 Note that these next two methods are not virtual.
void emptyList ()
 Clean the list out.
- Protected Member Functions inherited from DtSimInterfaceContent
 DtSimInterfaceContent ()
 DtSimInterfaceContent (const DtSimInterfaceContent &orig)
const DtSimInterfaceContentoperator= (const DtSimInterfaceContent &orig)
virtual charcreateNetworkBuffer ()

Protected Attributes

DtU32 myRequestId
DtSimulationAddress myVrfProcessAddress
DtString myMarkingText
DtObjectType myObjectType
DtForceType myForceType
DtUUID myUUID
DtString myObjectLabel
std::map< int, DtStringmyExtendedLabels
DtReal myHeading
bool myClosedFigure
bool myProjection
std::vector< DtVectormyVertexList
DtList myVertices
 Backwards compatible vertex list as a DtList.
DtAppearance myAppearance
bool myCreateSubObjects
bool myAddToOrganization
bool myClampToGround
bool myPublishObject
DtString myInitialFormation
DtString myOverlayParent
DtU8 myInitialAggregateState
std::list< DtAdminContent * > myAdminContent
std::list
< DtSimInterfaceContent * > 
myInterfaceContent
DtString myUserData
std::map< std::string,
std::string > 
myExtendedData
bool myConnectToRadioNetwork
- Protected Attributes inherited from DtSimInterfaceContent
charmyNetRep
bool myUseSessionId

Additional Inherited Members

- Static Protected Attributes inherited from DtSimInterfaceContent
static DtInterfaceContentFactorymyFactory
static
DtSimInterfaceContentTypePrinterFcn 
theContentTypePrinterFcn

Detailed Description

class DtIfCreateVrfObject:

Instances of DtIfCreateVrfObject are the message content for create vrf object messages sent from one VR-Forces process to another. The purpose of the message is to request that a particular VR-Forces process instantiate and become responsible for locally simulating a new vrf object.

Content-Type: DtCreateVrfObjectMessageType

Parameters: vrf process address - A DtSimulationAddress identifying the particular VR-Forces back-end to create the object.

object name - A DtString used to uniquely identify the object. This string must be unique for all objects in the exercise.

object type - The DtObjectType of the new entity. DtObjectType is an extension of the DIS/RPR enumerated DtEntityType (from objTypeEnums.h).

force type - The DtForceType value for the new entity (from disE- nums.h).

object label - A DtString associated with the new object. This string provides an additional means to identify an object without the strict uniqueness requirement of object name.

extended labels - A key/value pair that will assign a label to a label index. Index 0 is reserved, so, that will be ignored if used

position - A DtVector that is the starting location of the object in geocentric coordinates. Set the position for those objects that have a single vertex (e.g. waypoints, entities).

heading - A DtReal value that is the initial heading of the object in radians. A value of 0.0 is north and positive values are clockwise.

vertices - A DtList of the DtVectors that make up the object's geom- etry (i.e. the vertices that make up the points along a route). Note that position is just an alias for the first vertex. Do not call setPosi- tion() if you have an object with multiple vertices (call addVertex() to set up the object's geometry instead). Vertices must be specified in geocentric coordinates.

projection - A bool flag indicating whether or not the Z elements in the object's vertex list have meaning. For example, phase lines do not have meaningful Z elements.

closed figure - A bool flag indicating whether the object's vertices make up a closed figure (i.e. does the last vertex connect with the first?). A control area is an example of an object that is a closed figure.

appearance - A DtAppearance indicating the initial appearance of the object (e.g. damage state, frozen status, concealed).

create subobjects - A bool flag indicating whether or not you wish to have sub-object created. The parameter file may contain a list of subobjects. When building from the bottom up (for example, using AggregateAs or explicitly calling addSubordinate) then the subobjects in the parameter list should be ignored.

Constructor & Destructor Documentation

DtIfCreateVrfObject::DtIfCreateVrfObject ( )

default constructor

virtual DtIfCreateVrfObject::~DtIfCreateVrfObject ( )
virtual

destructor

DtIfCreateVrfObject::DtIfCreateVrfObject ( const DtIfCreateVrfObject orig)

copy constructor

Member Function Documentation

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

assignment operator

virtual DtSimInterfaceContent* DtIfCreateVrfObject::clone ( ) const
virtual

Returns a newly created instance of a DtIfCreateVrfObject.

Implements DtSimInterfaceContent.

Reimplemented in DtIfModifyVrfObject.

virtual int DtIfCreateVrfObject::type ( ) const
virtual

Returns the string type of message, DtCreateVrfObjectMessageType (defined in msgTypes.h).

Implements DtSimInterfaceContent.

Reimplemented in DtIfModifyVrfObject.

virtual unsigned long DtIfCreateVrfObject::requestId ( ) const
virtual

Set/get the request Id for the message.

Request Id is used to associate this message with the DtIfVrfObjectCreated response message.

virtual void DtIfCreateVrfObject::setRequestId ( unsigned long  requestId)
virtual
virtual void DtIfCreateVrfObject::setUUID ( const DtUUID )
virtual

Use this UUID to create object (if specified). If the UUID exists will be regenerated on creation.

virtual const DtUUID& DtIfCreateVrfObject::uuid ( ) const
virtual
virtual void DtIfCreateVrfObject::setVrfProcessAddress ( const DtSimulationAddress &  address)
virtual

Set/get the address of the VR-Forces process that we want to create the new vrf object.

virtual const DtSimulationAddress& DtIfCreateVrfObject::vrfProcessAddress ( ) const
virtual
virtual void DtIfCreateVrfObject::setMarkingText ( const DtString objectName)
virtual

Set/get the object name of the vrf object to create.

Note that if the object name length is > 255 characters, it will be trimmed to 255 characters

Reimplemented in DtIfModifyVrfObject.

virtual const DtString& DtIfCreateVrfObject::markingText ( ) const
virtual
virtual void DtIfCreateVrfObject::setObjectType ( const DtObjectType objectType)
virtual

Set/get the object type of the vrf object to create.

Reimplemented in DtIfModifyVrfObject.

virtual const DtObjectType& DtIfCreateVrfObject::objectType ( ) const
virtual
virtual void DtIfCreateVrfObject::setForceType ( const DtForceType  forceType)
virtual

Set/get the force type of the vrf object to create.

Reimplemented in DtIfModifyVrfObject.

virtual DtForceType DtIfCreateVrfObject::forceType ( ) const
virtual
virtual void DtIfCreateVrfObject::setObjectLabel ( const DtString objectLabel)
virtual

Set/get the object label of the vrf object to create.

Reimplemented in DtIfModifyVrfObject.

virtual const DtString& DtIfCreateVrfObject::objectLabel ( ) const
virtual
virtual void DtIfCreateVrfObject::setExtendedLabels ( const std::map< int, DtString > &  extendedLabels)
virtual

Set/get the object label of the vrf object to create.

Reimplemented in DtIfModifyVrfObject.

virtual const std::map<int, DtString>& DtIfCreateVrfObject::extendedLabels ( ) const
virtual
virtual void DtIfCreateVrfObject::setOverlayParent ( const DtString overlayParent)
virtual

Sets the overlay parent of this object.

Reimplemented in DtIfModifyVrfObject.

virtual const DtString& DtIfCreateVrfObject::overlayParent ( ) const
virtual
virtual const DtVector& DtIfCreateVrfObject::position ( ) const
virtual

In geocentric coordinates.

Referenced by startPosition().

virtual void DtIfCreateVrfObject::setPosition ( const DtVector position)
virtual

Reimplemented in DtIfModifyVrfObject.

Referenced by setStartPosition().

virtual DtReal DtIfCreateVrfObject::heading ( ) const
virtual

0 is north, clockwise, in radians.

virtual void DtIfCreateVrfObject::setHeading ( DtReal  heading)
virtual

Reimplemented in DtIfModifyVrfObject.

virtual const std::vector<DtVector>& DtIfCreateVrfObject::vertexList ( ) const
virtual

This is where the actually object geometry goes position() is just an alias for the first vertex.

In geocentric coordinates.

virtual const DtList& DtIfCreateVrfObject::vertices ( ) const
virtual

Backwards compatible access to vertexList.

Use vertexList() instead.

virtual void DtIfCreateVrfObject::addVertex ( const DtVector vertex)
virtual

Add a vertex to the end of the vertex list.

Reimplemented in DtIfModifyVrfObject.

Referenced by setEndPosition().

virtual bool DtIfCreateVrfObject::projection ( ) const
virtual

Do the Z elements of the vectors in the vertex list have meaning?

virtual void DtIfCreateVrfObject::setProjection ( bool  projection)
virtual

Reimplemented in DtIfModifyVrfObject.

virtual bool DtIfCreateVrfObject::closedFigure ( ) const
virtual

Does the last vertex connect back to the first? Obviously, this is undefined for a single vertex (but I suppose an argument could be made for that being a closed figure...)

virtual void DtIfCreateVrfObject::setClosedFigure ( bool  closedFigure)
virtual

Reimplemented in DtIfModifyVrfObject.

virtual const DtAppearance& DtIfCreateVrfObject::appearance ( )
virtual

Appearance.

virtual void DtIfCreateVrfObject::setAppearance ( const DtAppearance &  appearance)
virtual

Reimplemented in DtIfModifyVrfObject.

virtual bool DtIfCreateVrfObject::createSubObjects ( ) const
virtual

Create SubObjects.

The parameter file may contain a list of subobjects. When building from the bottom up (for example, using AggregateAs or explicitly calling addSubordinate) then the subobjects in the parameter list should be ignored. Use this flag to indicate whether you wish to have sub objects created.

virtual void DtIfCreateVrfObject::setCreateSubObjects ( bool  createSubObjects)
virtual
virtual bool DtIfCreateVrfObject::addToOrganization ( ) const
virtual

If True (the default) and the object being created is an orgainzed object type (as specified by the is-organized flag in the OPD file), the newly created object will be added to the organization manager directly below the force level aggregate of this object's force.

Otherwise, it will not be added to the organization manager at all, and the caller should make a subsequent call or message to place it in the organization hierarchy.

virtual void DtIfCreateVrfObject::setAddToOrganization ( bool  addToOrg)
virtual
virtual bool DtIfCreateVrfObject::clampToGround ( ) const
virtual

If True (the default) the object will be created and placed on the nearest polygon.

Otherwise, it will be created and then placed at the altitude specified in the position. Subsurface entities will be constrained between the water surface and bottom.

virtual void DtIfCreateVrfObject::setClampToGround ( bool  clamp)
virtual
virtual DtString DtIfCreateVrfObject::initialFormation ( ) const
virtual

The formation name to set when creating an aggregate.

Not used for non-aggregate objects. Default is DtString::nullString().

virtual void DtIfCreateVrfObject::setInitialFormation ( const DtString formation)
virtual

The formation name to set when creating an aggregate.

Not used for non-aggregate objects. Default is DtString::nullString().

virtual bool DtIfCreateVrfObject::publishObject ( ) const
virtual

Sets whether or not to publish the object on the network once created.

Default is true

virtual void DtIfCreateVrfObject::setPublishObject ( bool  )
virtual

Sets whether or not to publish the object on the network once created.

Default is true

virtual bool DtIfCreateVrfObject::connectToRadioNetwork ( ) const
virtual

Sets whether or not the object will be connected to any applicable radio networks on creation.

This defaults to true.

virtual void DtIfCreateVrfObject::setConnectToRadioNetwork ( bool  )
virtual

Sets whether or not the object will be connected to any applicable radio networks on creation.

This defaults to true.

virtual DtAggregateState DtIfCreateVrfObject::initialAggregateState ( ) const
virtual

Set/get the initial aggregate state when creating an aggregate.

Not used for non-aggregate objects. Default is DtDisaggregated.

virtual void DtIfCreateVrfObject::setInitialAggregateState ( DtAggregateState  aggregateState)
virtual
virtual std::list<DtAdminContent*>* DtIfCreateVrfObject::initialAdminContent ( )
virtual

Set any Admin Content messages passed on initialization.

virtual void DtIfCreateVrfObject::setInitialAdminContent ( std::list< DtAdminContent * >  adminContent)
virtual
virtual void DtIfCreateVrfObject::addInitialAdminContent ( DtAdminContent adminContent)
virtual
virtual std::list<DtSimInterfaceContent*>* DtIfCreateVrfObject::initialInterfaceContent ( )
virtual

Set any Interface Content messages passed on initialization.

virtual void DtIfCreateVrfObject::setInitialInterfaceContent ( std::list< DtSimInterfaceContent * >  adminContent)
virtual
virtual void DtIfCreateVrfObject::addInitialInterfaceContent ( DtSimInterfaceContent adminContent)
virtual
void DtIfCreateVrfObject::setStartPosition ( const DtVector position)
inline

These are here for back compatibility and should be removed after the next release.

Reimplemented in DtIfModifyVrfObject.

References setPosition().

const DtVector & DtIfCreateVrfObject::startPosition ( ) const
inline

References position().

void DtIfCreateVrfObject::setEndPosition ( const DtVector position)
inline

Reimplemented in DtIfModifyVrfObject.

References addVertex().

const DtVector & DtIfCreateVrfObject::endPosition ( ) const
inline

References myVertices.

virtual void DtIfCreateVrfObject::setExtendedData ( const std::map< std::string, std::string > &  )
virtual

Reimplemented in DtIfModifyVrfObject.

virtual void DtIfCreateVrfObject::setExtendedData ( const std::map< DtString, DtString > &  )
virtual
virtual void DtIfCreateVrfObject::setExtendedData ( const DtString keyword,
const DtString data 
)
virtual

Reimplemented in DtIfModifyVrfObject.

virtual const std::map<std::string, std::string>& DtIfCreateVrfObject::extendedData ( ) const
virtual
virtual void DtIfCreateVrfObject::setUserData ( const DtString userData)
virtual

Reimplemented in DtIfModifyVrfObject.

virtual DtString DtIfCreateVrfObject::userData ( ) const
virtual
virtual int DtIfCreateVrfObject::netRepSize ( ) const
virtual

Reimplemented from DtSimInterfaceContent.

Reimplemented in DtIfModifyVrfObject.

virtual bool DtIfCreateVrfObject::setFromNet ( const char contentBuffer,
unsigned  contentSize 
)
virtual

Reimplemented from DtSimInterfaceContent.

Reimplemented in DtIfModifyVrfObject.

virtual bool DtIfCreateVrfObject::setToNet ( )
virtual

Reimplemented from DtSimInterfaceContent.

Reimplemented in DtIfModifyVrfObject.

virtual void DtIfCreateVrfObject::printDataToString ( DtString str)
virtual

Reimplemented from DtSimInterfaceContent.

Reimplemented in DtIfModifyVrfObject.

static DtSimInterfaceContent* DtIfCreateVrfObject::creator ( )
static

Reimplemented in DtIfModifyVrfObject.

void DtIfCreateVrfObject::copyList ( const DtList &  fromList)
protected

Note that these next two methods are not virtual.

They are called from copy constructors and assignment operator, as well as destructor Calls emptyList(), and then for each vertex on the 'from' list, allocates a DtVector, copies the contents, and puts on our list.

void DtIfCreateVrfObject::emptyList ( )
protected

Clean the list out.

Member Data Documentation

DtU32 DtIfCreateVrfObject::myRequestId
protected
DtSimulationAddress DtIfCreateVrfObject::myVrfProcessAddress
protected
DtString DtIfCreateVrfObject::myMarkingText
protected
DtObjectType DtIfCreateVrfObject::myObjectType
protected
DtForceType DtIfCreateVrfObject::myForceType
protected
DtUUID DtIfCreateVrfObject::myUUID
protected
DtString DtIfCreateVrfObject::myObjectLabel
protected
std::map<int, DtString> DtIfCreateVrfObject::myExtendedLabels
protected
DtReal DtIfCreateVrfObject::myHeading
protected
bool DtIfCreateVrfObject::myClosedFigure
protected
bool DtIfCreateVrfObject::myProjection
protected
std::vector<DtVector> DtIfCreateVrfObject::myVertexList
protected
DtList DtIfCreateVrfObject::myVertices
mutableprotected

Backwards compatible vertex list as a DtList.

Referenced by endPosition().

DtAppearance DtIfCreateVrfObject::myAppearance
protected
bool DtIfCreateVrfObject::myCreateSubObjects
protected
bool DtIfCreateVrfObject::myAddToOrganization
protected
bool DtIfCreateVrfObject::myClampToGround
protected
bool DtIfCreateVrfObject::myPublishObject
protected
DtString DtIfCreateVrfObject::myInitialFormation
protected
DtString DtIfCreateVrfObject::myOverlayParent
protected
DtU8 DtIfCreateVrfObject::myInitialAggregateState
protected
std::list<DtAdminContent*> DtIfCreateVrfObject::myAdminContent
protected
std::list<DtSimInterfaceContent*> DtIfCreateVrfObject::myInterfaceContent
protected
DtString DtIfCreateVrfObject::myUserData
protected
std::map<std::string, std::string> DtIfCreateVrfObject::myExtendedData
protected
bool DtIfCreateVrfObject::myConnectToRadioNetwork
protected

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

Document ID: Generated on Tue Mar 8 22:13:38 EST 2016 from SVN revision 162938
Copyright © 2005-2015 VT MÄK. All Rights Reserved (www.mak.com)