![]() |
VR-Forces 4.2 Class Documentation
|
DtBallisticGunDescriptor; a descriptor for the DtBallisticGun component. More...

Public Member Functions | |
| DtBallisticGunDescriptor (const DtString &name, DtReaderWriterRegistry *parentRegistry=NULL) | |
| constructor | |
| DtBallisticGunDescriptor (const DtSymbolString &name, DtReaderWriterRegistry *parentRegistry=NULL) | |
| DtBallisticGunDescriptor (const DtBallisticGunDescriptor &orig, DtReaderWriterRegistry *parentRegistry=NULL) | |
| copy constructor | |
| DtBallisticGunDescriptor & | operator= (const DtBallisticGunDescriptor &orig) |
| assignment | |
| virtual | ~DtBallisticGunDescriptor () |
| destructor | |
| virtual DtString | type () const |
| Returns the type of component this descriptor describes. | |
| virtual DtComponentDescriptor * | clone (DtReaderWriterRegistry *parentRegistry=NULL) const |
| virtual DtReal | muzzleSpeed () const |
| Accessor/mutator for myMuzzleSpeed. | |
| virtual void | setMuzzleSpeed (DtReal muzzleSpeed) |
| Accessor/mutator for myMuzzleSpeed. | |
| virtual int | roundsPerMagazine () const |
| Accessor/mutator for myRoundsPerMagazine. | |
| virtual void | setRoundsPerMagazine (int roundsPerMagazine) |
| Accessor/mutator for myRoundsPerMagazine. | |
| virtual int | roundsPerMinute () const |
| Accessor/mutator for myRoundsPerMinute. | |
| virtual void | setRoundsPerMinute (const int roundsPerMinute) |
| Accessor/mutator for myRoundsPerMinute. | |
| virtual DtReal | extraTimeBetweenBursts () const |
| Accessor/mutator for myExtraTimeBetweenBursts. | |
| virtual void | setExtraTimeBetweenBursts (const DtReal extraTimeBetweenBursts) |
| Accessor/mutator for myExtraTimeBetweenBursts. | |
| virtual const DtString & | rangeName () const |
| Accessor/mutator for myRangeName. | |
| virtual void | setRangeName (const DtString &rangeName) |
| Accessor/mutator for myRangeName. | |
| virtual DtReal | elevationRate () const |
| Accessor/mutator for myElevationRate. | |
| virtual void | setElevationRate (DtReal pElevationRate) |
| Accessor/mutator for myElevationRate. | |
| virtual DtReal | maxElevationRange () const |
| Accessor/mutator for myMaxElevationRange. | |
| virtual void | setMaxElevationRange (DtReal pElevationRange) |
| Accessor/mutator for myMaxElevationRange. | |
| virtual DtReal | minElevationRange () const |
| Accessor/mutator for myMinElevationRange. | |
| virtual void | setMinElevationRange (DtReal pElevationRange) |
| Accessor/mutator for myMinElevationRange. | |
| virtual DtReal | neutralElevation () const |
| Accessor/mutator for myNeutralElevation. | |
| virtual void | setNeutralElevation (DtReal elevation) |
| Accessor/mutator for myNeutralElevation. | |
| virtual const DtVector & | muzzleOffset () const |
| Accessor/mutator for myMuzzleOffset. | |
| virtual void | setMuzzleOffset (const DtVector &muzzleOffset) |
| Accessor/mutator for myMuzzleOffset. | |
| virtual bool | velocityCheck () const |
| Accessor/mutator for myVelocityCheck. | |
| virtual void | setVelocityCheck (bool check) |
| Accessor/mutator for myVelocityCheck. | |
| virtual const DtString & | hitProbabilityFilename () |
| Accessor/mutator for myHitProbabilityFile. | |
| virtual void | setHitProbabilityFilename (const DtString &filename) |
| Accessor/mutator for myHitProbabilityFile. | |
| virtual const DtRangeProbabilityTable & | hitProbabilityTable () const |
| Accessor/mutator for myHitProbabilityTable. | |
| virtual void | setHitProbabilityTable (const DtRangeProbabilityTable &table) |
| Accessor/mutator for myHitProbabilityTable. | |
| virtual bool | detonateOnMiss () const |
| Accessor/mutator for myDetonateOnMiss. | |
| virtual void | setDetonateOnMiss (bool detonateOnMiss) |
| Accessor/mutator for myDetonateOnMiss. | |
Public Member Functions inherited from DtActuatorComponentDescriptor | |
| DtActuatorComponentDescriptor (const DtString &componentName, DtReaderWriterRegistry *parentRegistry=NULL) | |
| constructor | |
| DtActuatorComponentDescriptor (const DtSymbolString &componentName, DtReaderWriterRegistry *parentRegistry=NULL) | |
| DtActuatorComponentDescriptor (const DtActuatorComponentDescriptor &orig, DtReaderWriterRegistry *parentRegistry=NULL) | |
| copy constructor | |
| DtActuatorComponentDescriptor & | operator= (const DtActuatorComponentDescriptor &orig) |
| assignment | |
| virtual | ~DtActuatorComponentDescriptor () |
| destructor | |
| virtual void | setArtPartDescriptorList (const DtSimArtPartDescriptorList &artPartDescriptorList) |
| Accessor/mutator for myArtPartDescriptorList. | |
| virtual const DtSimArtPartDescriptorList & | artPartDescriptorList () const |
| Accessor/mutator for myArtPartDescriptorList. | |
Public Member Functions inherited from DtComponentDescriptor | |
| DtComponentDescriptor (const DtComponentDescriptor &orig, DtReaderWriterRegistry *parentRegistry=NULL) | |
| copy constructor | |
| DtComponentDescriptor & | operator= (const DtComponentDescriptor &orig) |
| assignment | |
| virtual | ~DtComponentDescriptor () |
| virtual void | putData (FILE *fp, int indentLevel=0) |
| Overrides base class putData to output our type. | |
| virtual DtlObjPtr | getData (DtlObjPtr args, const DtFilename &searchPath, const DtVariableBindingsList &variableBindings) |
| getData is just used to get us past the type in the data stream, since it's not actually stored. | |
| virtual bool | init () |
| Base class init does nothing, but will be called by createComponentDescriptor(), allowing derived classes to do memory allocation if necessary. | |
| bool | operator== (const DtComponentDescriptor &) const |
| DtComponentDescriptor (const DtString &componentName, DtReaderWriterRegistry *parentRegistry=NULL) | |
| DtComponentDescriptor (const DtSymbolString &componentName, DtReaderWriterRegistry *parentRegistry=NULL) | |
| virtual void | setComponentType (const DtString &componentType) |
| Type of DtSimComponent this descriptor is associated with. | |
| virtual const DtString & | componentType () const |
| Type of DtSimComponent this descriptor is associated with. | |
| virtual void | setMinTickPeriod (DtReal minTickPeriod) |
| virtual DtReal | minTickPeriod () const |
| virtual void | setMinTickPeriodVariance (DtReal minTickPeriodVariance) |
| virtual DtReal | minTickPeriodVariance () const |
| virtual void | setTickPeriodUsesRealTime (bool value) |
| Accessor/mutator for myTickPeriodUsesRealTime. | |
| virtual bool | tickPeriodUsesRealTime () const |
| Accessor/mutator for myTickPeriodUsesRealTime. | |
| virtual const DtString & | processStateRepositoryName () const |
| Name which this component will assign to its PSR. | |
| virtual void | setProcessStateRepositoryName (const DtString &name) |
| Name which this component will assign to its PSR. | |
| virtual const DtString & | processStateRepositoryType () const |
| Type of PSR this component will create. | |
| virtual void | setProcessStateRepositoryType (const DtString &type) |
| Type of PSR this component will create. | |
| virtual void | setIsEnabled (bool yesNo) |
| Is the component enabled or not. | |
| virtual bool | isEnabled () const |
| Is the component enabled or not. | |
| virtual void | setDebugActive (bool active) |
| Should detailed debug info be printed for this component. | |
| virtual bool | debugActive () |
| Should detailed debug info be printed for this component. | |
| virtual void | setCreateComponent (bool yesNo) |
| Should the component be created or not. | |
| virtual bool | createComponent () const |
| Should the component be created or not. | |
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 | |
| bool | operator== (const DtReaderWriter &) const |
| Equivalence operator. | |
| bool | operator!= (const DtReaderWriter &rhs) |
| 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 void | clearAllVariableReferenceFlags () |
| Clears out all variable reference flags from all readerwriter items in registry recursively. | |
| 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 DtComponentDescriptor * | creator () |
| | |
Protected Member Functions | |
| DtBallisticGunDescriptor () | |
| default constructor; not implemented | |
Protected Member Functions inherited from DtActuatorComponentDescriptor | |
| DtActuatorComponentDescriptor () | |
| default constructor; not implemented | |
Protected Member Functions inherited from DtComponentDescriptor | |
| DtComponentDescriptor () | |
| default constructor; not implemented | |
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 DtlObjPtr | getData (DtlObjPtr args, const DtFilename &searchPath, const DtVariableBindingsList &variableBindings) |
| Deriving class overrides these to get/put class specific data. | |
Protected Attributes | |
parameters | |
These parameters are available for setting in the OPD files. | |
| DtRwReal | myElevationRate |
| Parameter Name: max-elevation-rate Parameter Description: The elevation rate for the gun. | |
| DtRwReal | myMaxElevationRange |
| Parameter Name: max-elevation-range Parameter Description: The maximum elevation angle for the gun. | |
| DtRwReal | myMinElevationRange |
| Parameter Name: min-elevation-range Parameter Description: The minimum elevation angle for the gun. | |
| DtRwReal | myNeutralElevation |
| Parameter Name: neutral-elevation Parameter Description: The elevation that the gun starts at, and returns to when there are no targets. | |
| DtRwReal | myMuzzleSpeed |
| Parameter Name: muzzle-speed Parameter Description: This is used to find the muzzle velocity vector for the fire pdu and determine flyout time. | |
| DtRwInt | myRoundsPerMagazine |
| Parameter Name: rounds-per-magazine Parameter Description: This parameter allows modeling magazines that permit multiple shots/bursts before becoming unloaded. | |
| DtRwInt | myRoundsPerMinute |
| Parameter Name: rounds-per-minute Parameter Description: This parameter determines the gun cyclic rate when firing a burst. | |
| DtRwReal | myExtraTimeBetweenBursts |
| Parameter Name: extra-time-between-bursts Parameter Description: This parameter defines the extra time required between bursts before the gun is ready to fire again. | |
| DtRwVector | myMuzzleOffset |
| Parameter Name: muzzle-offset Parameter Description: This vector is an offset used to set the position of a fire PDU/interaction when the gun is fired. | |
| DtRwBoolean | myVelocityCheck |
| Parameter Name: velocity-affects-hit-chance Parameter Description: This parameter determines whether or not the relative velocity between the shooter and the target will affect the chance of hitting the target. | |
| DtReaderWriterFile | myHitProbabilityFile |
| Parameter Name: hit-probability-file Parameter Description: The file name of the hit probability table used to determine if a target was hit. | |
| DtRangeProbabilityTable | myHitProbabilityTable |
| Parameter Name: hit-probability-table Parameter Description: Table containing entries for probability of a hit versus target entity type and range. | |
| DtRwString | myRangeName |
| Name given to any range item associated with this descriptor. | |
| DtRwBoolean | myDetonateOnMiss |
| Parameter Name: detonate-on-miss Parameter Description: This parameter determines whether or not a detonation interaction should be created when a shot misses. | |
Protected Attributes inherited from DtActuatorComponentDescriptor | |
| DtSimArtPartDescriptorList | myArtPartDescriptorList |
| Parameter Name: art-part-list Parameter Description: List of articulated parts associated with this actuator. | |
Protected Attributes inherited from DtComponentDescriptor | |
| DtRwBoolean | myIsEnabled |
| DtRwBoolean | myDebug |
| This parameter defaults to false. | |
| DtRwBoolean | myCreateComponent |
| DtRwString | myComponentType |
| Parameter Name: component-type Parameter Description: String identifying type of component. | |
| DtRwReal | myMinTickPeriod |
| Parameter Name: min-tick-period Parameter Description: Minimum tick period for this component. | |
| DtRwReal | myMinTickPeriodVariance |
| Parameter Name: min-tick-period-variance Parameter Description: Minimum tick period for this component. | |
| DtRwBoolean | myTickPeriodUsesRealTime |
| Parameter Name: tick-period-uses-real-time Parameter Description: Specified whether the min-tick-period and min-tick-period-variance parameters are based on real time or simulation time. | |
| DtRwString | myProcessStateRepositoryName |
| Parameter Name: process-state-repository-name Parameter Description: Name of the process state repository associated with this component. | |
| DtRwString | myProcessStateRepositoryType |
| Parameter Name: process-state-repository-type Parameter Description: Type of the process state repository assoicated with this component. | |
Protected Attributes inherited from DtReaderWriter | |
| const DtSymbolString | myName |
| DtReaderWriterRegistry | myRegistry |
| bool | myValueSpecified |
| bool | myReadOnlyFlag |
| bool | myIsVariableReference |
| DtSymbolString | myVariableName |
| bool | myVariableIsBound |
| aliasContainer | myAliases |
| Container for the aliases which represent alternative names for the object. | |
| bool | myInvalid |
| Set to true if there is a problem reading this item. | |
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 |
| typedef DtReaderWriterFactory *(* | DtReaderWriterFactoryCreatorFcn )() |
Static Protected Attributes inherited from DtComponentDescriptor | |
| static DtComponentDescriptorFactory * | myFactory |
DtBallisticGunDescriptor; a descriptor for the DtBallisticGun component.
A DtComponentDescriptor that has additional information needed for providing parameters to the ballistic gun model – hit probabilities, muzzle offset, and muzzle velocity.
The muzzleSpeed() and setMuzzleSpeed() member functions are used for the muzzle velocity specified in VR-Link fire interactions.
| DtBallisticGunDescriptor::DtBallisticGunDescriptor | ( | const DtString & | name, |
| DtReaderWriterRegistry * | parentRegistry = NULL |
||
| ) |
constructor
| DtBallisticGunDescriptor::DtBallisticGunDescriptor | ( | const DtSymbolString & | name, |
| DtReaderWriterRegistry * | parentRegistry = NULL |
||
| ) |
| DtBallisticGunDescriptor::DtBallisticGunDescriptor | ( | const DtBallisticGunDescriptor & | orig, |
| DtReaderWriterRegistry * | parentRegistry = NULL |
||
| ) |
copy constructor
|
virtual |
destructor
|
protected |
default constructor; not implemented
| DtBallisticGunDescriptor& DtBallisticGunDescriptor::operator= | ( | const DtBallisticGunDescriptor & | orig | ) |
assignment
|
virtual |
Returns the type of component this descriptor describes.
Used to create the descriptor on read from an mtl file. Component descriptor type strings are defined in compDescTypes.h.
Reimplemented from DtActuatorComponentDescriptor.
|
virtual |
Reimplemented from DtActuatorComponentDescriptor.
|
virtual |
Accessor/mutator for myMuzzleSpeed.
|
virtual |
Accessor/mutator for myMuzzleSpeed.
|
virtual |
Accessor/mutator for myRoundsPerMagazine.
|
virtual |
Accessor/mutator for myRoundsPerMagazine.
|
virtual |
Accessor/mutator for myRoundsPerMinute.
|
virtual |
Accessor/mutator for myRoundsPerMinute.
|
virtual |
Accessor/mutator for myExtraTimeBetweenBursts.
|
virtual |
Accessor/mutator for myExtraTimeBetweenBursts.
|
virtual |
Accessor/mutator for myRangeName.
|
virtual |
Accessor/mutator for myRangeName.
|
virtual |
Accessor/mutator for myElevationRate.
|
virtual |
Accessor/mutator for myElevationRate.
|
virtual |
Accessor/mutator for myMaxElevationRange.
|
virtual |
Accessor/mutator for myMaxElevationRange.
|
virtual |
Accessor/mutator for myMinElevationRange.
|
virtual |
Accessor/mutator for myMinElevationRange.
|
virtual |
Accessor/mutator for myNeutralElevation.
|
virtual |
Accessor/mutator for myNeutralElevation.
|
virtual |
Accessor/mutator for myMuzzleOffset.
|
virtual |
Accessor/mutator for myMuzzleOffset.
|
virtual |
Accessor/mutator for myVelocityCheck.
|
virtual |
Accessor/mutator for myVelocityCheck.
|
virtual |
Accessor/mutator for myHitProbabilityFile.
|
virtual |
Accessor/mutator for myHitProbabilityFile.
|
virtual |
Accessor/mutator for myHitProbabilityTable.
|
virtual |
Accessor/mutator for myHitProbabilityTable.
|
virtual |
Accessor/mutator for myDetonateOnMiss.
|
virtual |
Accessor/mutator for myDetonateOnMiss.
|
static |
Reimplemented from DtActuatorComponentDescriptor.
|
protected |
Parameter Name: max-elevation-rate
Parameter Description: The elevation rate for the gun.
Parameter Default Value: 0.0
Parameter Units: radians/second
|
protected |
Parameter Name: max-elevation-range
Parameter Description: The maximum elevation angle for the gun.
Assumed to be between 0.0 and +pi/2.
Parameter Default Value: 0.0
Parameter Units: radians
|
protected |
Parameter Name: min-elevation-range
Parameter Description: The minimum elevation angle for the gun.
Assumed to be between 0.0 and -pi/2.
Parameter Default Value: 0.0
Parameter Units: radians
|
protected |
Parameter Name: neutral-elevation
Parameter Description: The elevation that the gun starts at, and returns to when there are no targets.
Parameter Default Value: 0.0
Parameter Units: radians
|
protected |
Parameter Name: muzzle-speed
Parameter Description: This is used to find the muzzle velocity vector for the fire pdu and determine flyout time.
In body coordinates of the gun (may be an articulated part, or the entity itself).
Parameter Default Value: 0.0
Parameter Units: meters/second
|
protected |
Parameter Name: rounds-per-magazine
Parameter Description: This parameter allows modeling magazines that permit multiple shots/bursts before becoming unloaded.
The gun system only pays the reloading time cost when the magazine is empty.
Parameter default value: 1
Parameter unit: Rounds per magazine
|
protected |
Parameter Name: rounds-per-minute
Parameter Description: This parameter determines the gun cyclic rate when firing a burst.
It is used to determine the length (time) of a burst.
Parameter default value: 500
Parameter unit: Rounds per minute.
|
protected |
Parameter Name: extra-time-between-bursts
Parameter Description: This parameter defines the extra time required between bursts before the gun is ready to fire again.
This can be used, for example, to define a cooling off period to prevent the gun from overheating. Most semi-auto and single-shot weapons should leave this 0.
Parameter default value: 0
Parameter unit: seconds
|
protected |
Parameter Name: muzzle-offset
Parameter Description: This vector is an offset used to set the position of a fire PDU/interaction when the gun is fired.
If an articulated part has been specified to represent the gun, then this offset is in the body coordinate system of the gun articulated part. If no articulated part is specified to represent the gun, then this offset is in the body coordinate system of the entity. In a body coordinate system, the axes are specified as follows:
|
protected |
Parameter Name: velocity-affects-hit-chance
Parameter Description: This parameter determines whether or not the relative velocity between the shooter and the target will affect the chance of hitting the target.
Parameter Default Value: false
|
protected |
Parameter Name: hit-probability-file
Parameter Description: The file name of the hit probability table used to determine if a target was hit.
Parameter Default Value: ""
|
protected |
Parameter Name: hit-probability-table
Parameter Description: Table containing entries for probability of a hit versus target entity type and range.
Parameter Default Value:
|
protected |
Name given to any range item associated with this descriptor.
Parameter Default Value:
|
protected |
Parameter Name: detonate-on-miss
Parameter Description: This parameter determines whether or not a detonation interaction should be created when a shot misses.
Parameter Default Value: true