VR-Forces 4.2 Class Documentation
List of all members | Public Member Functions | Static Public Member Functions | Protected Member Functions
DtObstructionSensorDescriptor Class Reference

DtObstructionSensorDescriptor is a DtComponentDescriptor that has the name of the DtObstructionSensor (if any) being used by this entity. More...

Inheritance diagram for DtObstructionSensorDescriptor:
Inheritance graph
[legend]

Public Member Functions

 DtObstructionSensorDescriptor (const DtString &name, DtReaderWriterRegistry *parentRegistry=0)
 real constructor
 DtObstructionSensorDescriptor (const DtObstructionSensorDescriptor &orig, DtReaderWriterRegistry *parentRegistry=0)
 copy constructor
DtObstructionSensorDescriptoroperator= (const DtObstructionSensorDescriptor &orig)
 assignment
virtual ~DtObstructionSensorDescriptor ()
 destructor
virtual DtString type () const
 Returns the type of component this descriptor describes.
virtual DtComponentDescriptorclone (DtReaderWriterRegistry *parentRegistry=0) const
 returns a clone of this DtObstructionSensorDescriptor
virtual void setStoppingDistanceFactor (DtReal distance)
 Accessor/mutator for myStoppingDistanceFactor.
virtual DtReal stoppingDistanceFactor () const
 Accessor/mutator for myStoppingDistanceFactor.
virtual void setLateralClearance (DtReal distance)
 Accessor/mutator for myLateralClearance.
virtual DtReal lateralClearance () const
 Accessor/mutator for myLateralClearance.
virtual void setObjectTypes (const DtRwObjectTypeList &objectTypes)
 Accessor/mutator for myObjectTypes.
virtual DtRwObjectTypeListobjectTypes ()
 Accessor/mutator for myObjectTypes.
virtual const DtRwObjectTypeListobjectTypes () const
 Accessor/mutator for myObjectTypes.
virtual void setFeatureTypesToAvoid (const DtRwStringList &featureTypesToAvoid)
 Accessor/mutator for myFeatureTypesToAvoid.
virtual DtRwStringListfeatureTypesToAvoid ()
 Accessor/mutator for myFeatureTypesToAvoid.
virtual const DtRwStringListfeatureTypesToAvoid () const
 Accessor/mutator for myFeatureTypesToAvoid.
virtual void setCheckObstructionsIfEmbarked (bool)
 Accessor/mutator for myCheckObstructionsIfEmbarked.
virtual bool checkObstructionsIfEmbarked () const
 Accessor/mutator for myCheckObstructionsIfEmbarked.
- Public Member Functions inherited from DtComponentDescriptor
 DtComponentDescriptor (const DtComponentDescriptor &orig, DtReaderWriterRegistry *parentRegistry=NULL)
 copy constructor
DtComponentDescriptoroperator= (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 DtStringcomponentType () 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 DtStringprocessStateRepositoryName () 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 DtStringprocessStateRepositoryType () 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 DtReaderWriteroperator= (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 aliasContaineraliases () 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 DtReaderWriterRegistryregistry () const
 Collection of child DtReaderWriter nodes owned by this object.
DtReaderWriterRegistryregistry ()
 Collection of child DtReaderWriter nodes owned by this object.

Static Public Member Functions

static DtComponentDescriptorcreator ()
 
- Static Public Member Functions inherited from DtComponentDescriptor
static void addComponentDescriptorCreatorFcn (const DtString &type, DtComponentDescriptorCreatorFcn fcn)
 Adds a given component descriptor creation function and corresponding type (defined in compDescTypes.h) to the DtComponentDescriptorFactory.
static DtComponentDescriptorcreateComponentDescriptor (DtlObjPtr mtlStream, const DtFilename &searchPath, const DtVariableBindingsList &variableBindings)
 Creates and initializes a component descriptor when reading in from an MTL (MAK Technologies Lisp) file (i.e.
static DtComponentDescriptorcreateComponentDescriptor (const char *pName)
 Creates and initializes a new instance of this class.
static
DtComponentDescriptorFactory
factory ()
 The factory for creating objects of type DtComponentDescriptor.
static void setFactory (DtComponentDescriptorFactory *factory)
 The factory for creating objects of type DtComponentDescriptor.
- 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.
static void setFactoryCreatorFunction (DtReaderWriterFactoryCreatorFcn fcn)
 Sets the function to create the DtReaderWriterFactory.
static void createReaderWriterFactory ()

Protected Member Functions

 DtObstructionSensorDescriptor ()
 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

parameters to define the collision volume and how close to stop

These parameters are available for setting in the OPD files.

DtRwReal myLateralClearance
 Parameter Name: lateral-clearance
Parameter Description: Width added to the length of the bounding volume which is checked for potential collisions.
DtRwReal myStoppingDistanceFactor
 Parameter Name: stopping-distance-factor
Parameter Description: Factor by which the collision avoidance controller mulitiplies the current stopping distance to determine the length of the bounding volume which is checked for potential collisions.
DtRwBoolean myCheckObstructionsIfEmbarked
 Parameter Name: check-obstructions-if-embarked
Parameter Description: Flag indicating whether or not to check obstructions if the object is embarked.
DtRwObjectTypeList myObjectTypes
 Parameter Name: object-types
Parameter Description: Object types to treat as potential obstructions.
DtRwStringList myFeatureTypesToAvoid
 Parameter Name: feature-types-to-avoid
Parameter Description: Types of features to avoid
Parameter Default Value: N/A.
- 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

Detailed Description

DtObstructionSensorDescriptor is a DtComponentDescriptor that has the name of the DtObstructionSensor (if any) being used by this entity.

When available, this can be used to find out if the entity is colliding with or going to collide with an obstruction. The obstruction sensor can then report this current or impending collision via the appropriate ports.

Constructor & Destructor Documentation

DtObstructionSensorDescriptor::DtObstructionSensorDescriptor ( const DtString name,
DtReaderWriterRegistry parentRegistry = 0 
)

real constructor

DtObstructionSensorDescriptor::DtObstructionSensorDescriptor ( const DtObstructionSensorDescriptor orig,
DtReaderWriterRegistry parentRegistry = 0 
)

copy constructor

virtual DtObstructionSensorDescriptor::~DtObstructionSensorDescriptor ( )
virtual

destructor

DtObstructionSensorDescriptor::DtObstructionSensorDescriptor ( )
protected

default constructor; not implemented

Member Function Documentation

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

assignment

virtual DtString DtObstructionSensorDescriptor::type ( ) const
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.

Returns
DtObstructionSensorDescriptorType

Reimplemented from DtComponentDescriptor.

virtual void DtObstructionSensorDescriptor::setStoppingDistanceFactor ( DtReal  distance)
virtual

Accessor/mutator for myStoppingDistanceFactor.

virtual DtReal DtObstructionSensorDescriptor::stoppingDistanceFactor ( ) const
virtual

Accessor/mutator for myStoppingDistanceFactor.

virtual void DtObstructionSensorDescriptor::setLateralClearance ( DtReal  distance)
virtual

Accessor/mutator for myLateralClearance.

virtual DtReal DtObstructionSensorDescriptor::lateralClearance ( ) const
virtual

Accessor/mutator for myLateralClearance.

virtual void DtObstructionSensorDescriptor::setObjectTypes ( const DtRwObjectTypeList objectTypes)
virtual

Accessor/mutator for myObjectTypes.

virtual DtRwObjectTypeList& DtObstructionSensorDescriptor::objectTypes ( )
virtual

Accessor/mutator for myObjectTypes.

virtual const DtRwObjectTypeList& DtObstructionSensorDescriptor::objectTypes ( ) const
virtual

Accessor/mutator for myObjectTypes.

virtual void DtObstructionSensorDescriptor::setFeatureTypesToAvoid ( const DtRwStringList featureTypesToAvoid)
virtual

Accessor/mutator for myFeatureTypesToAvoid.

virtual DtRwStringList& DtObstructionSensorDescriptor::featureTypesToAvoid ( )
virtual

Accessor/mutator for myFeatureTypesToAvoid.

virtual const DtRwStringList& DtObstructionSensorDescriptor::featureTypesToAvoid ( ) const
virtual

Accessor/mutator for myFeatureTypesToAvoid.

virtual void DtObstructionSensorDescriptor::setCheckObstructionsIfEmbarked ( bool  )
virtual

Accessor/mutator for myCheckObstructionsIfEmbarked.

virtual bool DtObstructionSensorDescriptor::checkObstructionsIfEmbarked ( ) const
virtual

Accessor/mutator for myCheckObstructionsIfEmbarked.

virtual DtComponentDescriptor* DtObstructionSensorDescriptor::clone ( DtReaderWriterRegistry parentRegistry = 0) const
virtual

returns a clone of this DtObstructionSensorDescriptor

Reimplemented from DtComponentDescriptor.

static DtComponentDescriptor* DtObstructionSensorDescriptor::creator ( )
static

Returns
Newly created instance of this class, with an empty DtReaderWriter name. Creation methods are registered with a DtComponentDescriptorFactory, so they can be created on demand as they are read in from a parameter database file.

Reimplemented from DtComponentDescriptor.

Member Data Documentation

DtRwReal DtObstructionSensorDescriptor::myLateralClearance
protected

Parameter Name: lateral-clearance
Parameter Description: Width added to the length of the bounding volume which is checked for potential collisions.


Parameter Default Value: 6.
Parameter Units: meters

DtRwReal DtObstructionSensorDescriptor::myStoppingDistanceFactor
protected

Parameter Name: stopping-distance-factor
Parameter Description: Factor by which the collision avoidance controller mulitiplies the current stopping distance to determine the length of the bounding volume which is checked for potential collisions.


Parameter Default Value: 3.

DtRwBoolean DtObstructionSensorDescriptor::myCheckObstructionsIfEmbarked
protected

Parameter Name: check-obstructions-if-embarked
Parameter Description: Flag indicating whether or not to check obstructions if the object is embarked.

Parameter Default Value: false

DtRwObjectTypeList DtObstructionSensorDescriptor::myObjectTypes
protected

Parameter Name: object-types
Parameter Description: Object types to treat as potential obstructions.


Parameter Default Value:

DtRwStringList DtObstructionSensorDescriptor::myFeatureTypesToAvoid
protected

Parameter Name: feature-types-to-avoid
Parameter Description: Types of features to avoid
Parameter Default Value: N/A.


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

Document ID: Generated on Sun Nov 24 19:49:21 EST 2013 from SVN revision 133924
Copyright © 2005-2013 VT MÄK. All Rights Reserved (www.mak.com)