![]() |
VR-Forces 5.0.3 Developer's Guide
|
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.

Public Member Functions | |
| DtIfCreateVrfObject () | |
| virtual | ~DtIfCreateVrfObject () |
| DtIfCreateVrfObject (const DtIfCreateVrfObject &orig) | |
| DtIfCreateVrfObject & | operator= (const DtIfCreateVrfObject &orig) |
| virtual DtSimInterfaceContent * | clone () const |
| virtual int | type () const |
| virtual unsigned long | requestId () const |
| virtual void | setRequestId (unsigned long requestId) |
| virtual void | setUUID (const DtUUID &) |
| virtual const DtUUID & | uuid () const |
| virtual void | setVrfProcessAddress (const DtSimulationAddress &address) |
| virtual const DtSimulationAddress & | vrfProcessAddress () const |
| virtual void | setMarkingText (const DtString &objectName) |
| virtual const DtString & | markingText () const |
| virtual void | setMarkingTextPrefix (const DtString &objectName) |
| virtual const DtString & | markingTextPrefix () const |
| virtual void | setObjectType (const DtObjectType &objectType) |
| virtual const DtObjectType & | objectType () const |
| virtual void | setForceType (const DtForceType forceType) |
| virtual DtForceType | forceType () const |
| virtual void | setObjectLabel (const DtString &objectLabel) |
| virtual const DtString & | objectLabel () const |
| virtual void | setExtendedLabels (const std::map< int, DtString > &extendedLabels) |
| virtual const std::map< int, DtString > & | extendedLabels () const |
| virtual void | setOverlayParent (const DtString &overlayParent) |
| virtual const DtString & | overlayParent () const |
| virtual DtVector | position () const |
| virtual void | setPosition (const DtVector &position) |
| virtual DtReal | heading () const |
| virtual void | setHeading (DtReal heading) |
| virtual DtReal | pitch () const |
| virtual void | setPitch (DtReal pitch) |
| virtual bool | isPitchSpecified () const |
| virtual void | clearPitchSpecified () |
| virtual const std::vector < DtVector > & | vertexList () const |
| virtual const std::vector < DtVector > & | vertices () const |
| virtual void | setVertices (const std::vector< DtVector > &vertices) |
| virtual void | setVertices (const DtList &vertices) |
| virtual void | addVertex (const DtVector &vertex) |
| virtual bool | projection () const |
| virtual void | setProjection (bool projection) |
| virtual bool | closedFigure () const |
| virtual void | setClosedFigure (bool closedFigure) |
| virtual DtAppearance | appearance () const |
| virtual void | setAppearance (const DtAppearance &appearance) |
| virtual bool | createSubObjects () const |
| virtual void | setCreateSubObjects (bool createSubObjects) |
| virtual bool | addToOrganization () const |
| virtual void | setAddToOrganization (bool addToOrg) |
| virtual bool | clampToGround () const |
| virtual void | setClampToGround (bool clamp) |
| virtual DtAggregateState | initialAggregateState () const |
| virtual void | setInitialAggregateState (DtAggregateState aggregateState) |
| virtual const std::list < DtAdminContent * > & | initialAdminContent () const |
| virtual void | setInitialAdminContent (const std::list< DtAdminContent * > &adminContent) |
| virtual void | addInitialAdminContent (DtAdminContent *adminContent) |
| virtual const std::list < DtSimInterfaceContent * > & | initialInterfaceContent () const |
| virtual void | setInitialInterfaceContent (const std::list< DtSimInterfaceContent * > &adminContent) |
| virtual void | addInitialInterfaceContent (DtSimInterfaceContent *adminContent) |
| virtual void | setAddToOrbat (bool) |
| virtual bool | addToOrbat () const |
| virtual void | setSuperior (const DtUUID &) |
| virtual const DtUUID & | superior () const |
| void | setStartPosition (const DtVector &position) |
| DtVector | startPosition () const |
| void | setEndPosition (const DtVector &position) |
| DtVector | endPosition () 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 bool | isValid () const |
| virtual DtString | initialFormation () const |
| virtual void | setInitialFormation (const DtString &formation) |
| virtual bool | publishObject () const |
| virtual void | setPublishObject (bool) |
| virtual bool | connectToRadioNetwork () const |
| virtual void | setConnectToRadioNetwork (bool) |
Public Member Functions inherited from DtSimInterfaceContent | |
| virtual | ~DtSimInterfaceContent () |
| virtual bool | update (const DtSimInterfaceContent *data) |
| virtual char * | netRep () |
| virtual void | printContentType (DtString &str) |
| virtual void | setUseSessionId (bool yesNo) |
| virtual bool | useSessionId () const |
Static Public Member Functions | |
| static DtSimInterfaceContent * | creator () |
Static Public Member Functions inherited from DtSimInterfaceContent | |
| static DtSimInterfaceContent * | createInterfaceContent (int type) |
| static void | addInterfaceContentCreatorFcn (int type, DtInterfaceContentCreatorFcn fcn) |
| static void | setFactory (DtInterfaceContentFactory *factory) |
| static DtInterfaceContentFactory * | factory () |
| static void | registerContentTypePrinter (DtSimInterfaceContentTypePrinterFcn printFcn) |
Protected Attributes | |
| DtLocalObjectCreateInformation | myLocalObjectCreateInformation |
| DtSimulationAddress | myVrfProcessAddress |
| bool | myPitchSpecified |
Protected Attributes inherited from DtSimInterfaceContent | |
| char * | myNetRep |
| bool | myUseSessionId |
Additional Inherited Members | |
Protected Member Functions inherited from DtSimInterfaceContent | |
| DtSimInterfaceContent () | |
| DtSimInterfaceContent (const DtSimInterfaceContent &orig) | |
| const DtSimInterfaceContent & | operator= (const DtSimInterfaceContent &orig) |
| virtual char * | createNetworkBuffer () |
Static Protected Attributes inherited from DtSimInterfaceContent | |
| static DtInterfaceContentFactory * | myFactory |
| static DtSimInterfaceContentTypePrinterFcn | theContentTypePrinterFcn |
| DtIfCreateVrfObject::DtIfCreateVrfObject | ( | ) |
default constructor
|
virtual |
destructor
| DtIfCreateVrfObject::DtIfCreateVrfObject | ( | const DtIfCreateVrfObject & | orig | ) |
copy constructor
| DtIfCreateVrfObject& DtIfCreateVrfObject::operator= | ( | const DtIfCreateVrfObject & | orig | ) |
assignment operator
|
virtual |
Returns a newly created instance of a DtIfCreateVrfObject.
Implements DtSimInterfaceContent.
Reimplemented in DtIfModifyVrfObject.
|
virtual |
Returns the string type of message, DtCreateVrfObjectMessageType (defined in msgTypes.h).
Implements DtSimInterfaceContent.
Reimplemented in DtIfModifyVrfObject.
Set/get the request Id for the message. Request Id is used to associate this message with the DtIfVrfObjectCreated response message.
|
virtual |
Use this UUID to create object (if specified). If the UUID exists will be regenerated on creation.
|
virtual |
|
virtual |
Set/get the address of the VR-Forces process that we want to create the new vrf object.
|
virtual |
|
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 |
|
virtual |
Set/get the prefix for the object name of the vrf object to create. If markingText is not set, this prefix will be used to generate a unique object name.
|
virtual |
|
virtual |
Set/get the object type of the vrf object to create.
Reimplemented in DtIfModifyVrfObject.
|
virtual |
|
virtual |
Set/get the force type of the vrf object to create.
Reimplemented in DtIfModifyVrfObject.
|
virtual |
|
virtual |
Set/get the object label of the vrf object to create.
Reimplemented in DtIfModifyVrfObject.
|
virtual |
|
virtual |
Set/get the object label of the vrf object to create.
Reimplemented in DtIfModifyVrfObject.
|
virtual |
Sets the overlay parent of this object.
Reimplemented in DtIfModifyVrfObject.
|
virtual |
|
virtual |
In geocentric coordinates.
|
virtual |
Reimplemented in DtIfModifyVrfObject.
|
virtual |
0 is north, clockwise, in radians.
|
virtual |
Reimplemented in DtIfModifyVrfObject.
|
virtual |
Set to specify pitch. Call the clearPitchSpecified method if the pitch does not want to be specified. Note this will only have an effect on non ground-clamped created entities. The default is 0 pitch and pitch not specified. The pitch is in topographic coordinates. Note this will not be used in modification of the object. This is only for create and only for individual simulation objects.
|
virtual |
|
virtual |
|
virtual |
|
virtual |
This is where the actually object geometry goes position() is just an alias for the first vertex. In geocentric coordinates.
|
virtual |
Backwards compatible access to vertexList. Use vertexList() instead.
|
virtual |
|
virtual |
|
virtual |
Add a vertex to the end of the vertex list.
Reimplemented in DtIfModifyVrfObject.
|
virtual |
Do the Z elements of the vectors in the vertex list have meaning?
|
virtual |
Reimplemented in DtIfModifyVrfObject.
|
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 |
Reimplemented in DtIfModifyVrfObject.
|
virtual |
Appearance.
|
virtual |
Reimplemented in DtIfModifyVrfObject.
|
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 |
|
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 |
|
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 |
|
virtual |
The formation name to set when creating an aggregate. Not used for non-aggregate objects. Default is DtString::nullString().
|
virtual |
The formation name to set when creating an aggregate. Not used for non-aggregate objects. Default is DtString::nullString().
|
virtual |
Sets whether or not to publish the object on the network once created. Default is true.
|
virtual |
Sets whether or not to publish the object on the network once created. Default is true.
|
virtual |
Sets whether or not the object will be connected to any applicable radio networks on creation. This defaults to true.
|
virtual |
Sets whether or not the object will be connected to any applicable radio networks on creation. This defaults to true.
|
virtual |
Set/get the initial aggregate state when creating an aggregate. Not used for non-aggregate objects. Default is DtDisaggregated.
|
virtual |
|
virtual |
Set any Admin Content messages passed on initialization.
|
virtual |
|
virtual |
|
virtual |
Set any Interface Content messages passed on initialization.
|
virtual |
|
virtual |
|
virtual |
Whether or not this item (if it can be) is also added to the orbat. Default is false.
|
virtual |
|
virtual |
Sets the unit which should be the superior of this object.
|
virtual |
| void DtIfCreateVrfObject::setStartPosition | ( | const DtVector & | position | ) |
These are here for back compatibility and should be removed after the next release.
| DtVector DtIfCreateVrfObject::startPosition | ( | ) | const |
| void DtIfCreateVrfObject::setEndPosition | ( | const DtVector & | position | ) |
| DtVector DtIfCreateVrfObject::endPosition | ( | ) | const |
|
virtual |
Reimplemented in DtIfModifyVrfObject.
|
virtual |
|
virtual |
Reimplemented in DtIfModifyVrfObject.
|
virtual |
|
virtual |
Reimplemented in DtIfModifyVrfObject.
|
virtual |
|
virtual |
Reimplemented from DtSimInterfaceContent.
Reimplemented in DtIfModifyVrfObject.
|
virtual |
Reimplemented from DtSimInterfaceContent.
Reimplemented in DtIfModifyVrfObject.
|
virtual |
Reimplemented from DtSimInterfaceContent.
Reimplemented in DtIfModifyVrfObject.
|
virtual |
Reimplemented from DtSimInterfaceContent.
Reimplemented in DtIfModifyVrfObject.
|
static |
|
virtual |
Calls down to the myLocalObjectCreateInformation to make sure this object is valid to create.
|
protected |
|
protected |
|
protected |