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

DtHumanMoveAlongControllerDescriptor; descriptor for the DtHumanMoveAlongController component. More...

Inheritance diagram for DtHumanMoveAlongControllerDescriptor:
Inheritance graph
[legend]

Public Member Functions

 DtHumanMoveAlongControllerDescriptor (const DtString &componentName, DtReaderWriterRegistry *parentRegistry=0)
 real constructor
 DtHumanMoveAlongControllerDescriptor (const DtHumanMoveAlongControllerDescriptor &orig, DtReaderWriterRegistry *parentRegistry=0)
 copy constructor
virtual ~DtHumanMoveAlongControllerDescriptor ()
DtHumanMoveAlongControllerDescriptoroperator= (const DtHumanMoveAlongControllerDescriptor &orig)
 assignment
virtual DtString type () const
 Returns the type of component this descriptor describes.
virtual DtComponentDescriptorclone (DtReaderWriterRegistry *parentRegistry=0) const
virtual double atDistance () const
 Accessor/mutator for myAtDistance.
virtual void setAtDistance (double distance)
 Accessor/mutator for myAtDistance.
virtual bool stayOnRoute () const
 Accessor/mutator for myStayOnRoute.
virtual void setStayOnRoute (bool trueFalse)
 Accessor/mutator for myStayOnRoute.
virtual double minCorrectionDistance () const
 Accessor/mutator for myMinCorrectionDistance.
virtual void setMinCorrectionDistance (double distance)
 Accessor/mutator for myMinCorrectionDistance.
virtual double maxCorrectionDistance () const
 Accessor/mutator for myMaxCorrectionDistance.
virtual void setMaxCorrectionDistance (double distance)
 Accessor/mutator for myMaxCorrectionDistance.
virtual double maxCorrectionAngle () const
 Accessor/mutator for myMaxCorrectionAngle.
virtual void setMaxCorrectionAngle (double angle)
 Accessor/mutator for myMaxCorrectionAngle.
- 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.
 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.
- 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
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 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.

Protected Member Functions

 DtHumanMoveAlongControllerDescriptor ()
 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.

Protected Attributes

parameters

These parameters are available for setting in the OPD files.

DtRwReal myAtDistance
 Parameter Name: at-distance
Parameter Description: Maximum distance from goal entity is considered to be 'at' desired location.
DtRwBoolean myStayOnRoute
 Parameter Name: stay-on-route
Parameter Description: If true, will attempt to closely follow route segments as it moves along a route.
DtRwReal myMinCorrectionDistance
 Parameter Name: min-correction-distance
Parameter Description: Minimum distance from route that entity will attempt to correct heading to stay on route segment.
DtRwReal myMaxCorrectionDistance
 Parameter Name: max-correction-distance
Parameter Description: Maximum distance from route that entity will attempt to correct heading to stay on route segment.
DtRwReal myMaxCorrectionAngle
 Parameter Name: max-correction-angle
Parameter Description: Maximum absolute angular corrections entity will make to attempt to move the entity closer to the route segment.
- Protected Attributes inherited from DtComponentDescriptor
DtRwBoolean myIsEnabled
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
- Static Protected Attributes inherited from DtComponentDescriptor
static
DtComponentDescriptorFactory
myFactory

Detailed Description

DtHumanMoveAlongControllerDescriptor; descriptor for the DtHumanMoveAlongController component.

Instances of DtHumanMoveAlongControllerDescriptor are used to specify the parameters for a DtHumanMoveAlongController component.

Constructor & Destructor Documentation

DtHumanMoveAlongControllerDescriptor::DtHumanMoveAlongControllerDescriptor ( const DtString componentName,
DtReaderWriterRegistry parentRegistry = 0 
)

real constructor

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

copy constructor

virtual DtHumanMoveAlongControllerDescriptor::~DtHumanMoveAlongControllerDescriptor ( )
virtual
DtHumanMoveAlongControllerDescriptor::DtHumanMoveAlongControllerDescriptor ( )
protected

default constructor; not implemented

Member Function Documentation

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

assignment

virtual DtString DtHumanMoveAlongControllerDescriptor::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
DtHumanMoveAlongControllerDescriptorType

Reimplemented from DtComponentDescriptor.

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

Reimplemented from DtComponentDescriptor.

static DtComponentDescriptor* DtHumanMoveAlongControllerDescriptor::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.

virtual double DtHumanMoveAlongControllerDescriptor::atDistance ( ) const
virtual

Accessor/mutator for myAtDistance.

virtual void DtHumanMoveAlongControllerDescriptor::setAtDistance ( double  distance)
virtual

Accessor/mutator for myAtDistance.

virtual bool DtHumanMoveAlongControllerDescriptor::stayOnRoute ( ) const
virtual

Accessor/mutator for myStayOnRoute.

virtual void DtHumanMoveAlongControllerDescriptor::setStayOnRoute ( bool  trueFalse)
virtual

Accessor/mutator for myStayOnRoute.

virtual double DtHumanMoveAlongControllerDescriptor::minCorrectionDistance ( ) const
virtual

Accessor/mutator for myMinCorrectionDistance.

virtual void DtHumanMoveAlongControllerDescriptor::setMinCorrectionDistance ( double  distance)
virtual

Accessor/mutator for myMinCorrectionDistance.

virtual double DtHumanMoveAlongControllerDescriptor::maxCorrectionDistance ( ) const
virtual

Accessor/mutator for myMaxCorrectionDistance.

virtual void DtHumanMoveAlongControllerDescriptor::setMaxCorrectionDistance ( double  distance)
virtual

Accessor/mutator for myMaxCorrectionDistance.

virtual double DtHumanMoveAlongControllerDescriptor::maxCorrectionAngle ( ) const
virtual

Accessor/mutator for myMaxCorrectionAngle.

virtual void DtHumanMoveAlongControllerDescriptor::setMaxCorrectionAngle ( double  angle)
virtual

Accessor/mutator for myMaxCorrectionAngle.

Member Data Documentation

DtRwReal DtHumanMoveAlongControllerDescriptor::myAtDistance
protected

Parameter Name: at-distance
Parameter Description: Maximum distance from goal entity is considered to be 'at' desired location.

Parameter Units: meters Parameter Default Value: 0.5

DtRwBoolean DtHumanMoveAlongControllerDescriptor::myStayOnRoute
protected

Parameter Name: stay-on-route
Parameter Description: If true, will attempt to closely follow route segments as it moves along a route.

If false, will only attempt to reach each waypoint in turn as it moves along the route. Parameter Units: Parameter Default Value: true

DtRwReal DtHumanMoveAlongControllerDescriptor::myMinCorrectionDistance
protected

Parameter Name: min-correction-distance
Parameter Description: Minimum distance from route that entity will attempt to correct heading to stay on route segment.

If entity is within this distance from route segment, it will move directly toward the next waypoint. Parameter Units: meters Parameter Default Value: 0.1

DtRwReal DtHumanMoveAlongControllerDescriptor::myMaxCorrectionDistance
protected

Parameter Name: max-correction-distance
Parameter Description: Maximum distance from route that entity will attempt to correct heading to stay on route segment.

If entity is within the min-correction-distance and max-correction-distance from the route segment, it will correct its heading toward the next waypoint in such a way that it 'pulls' the entity closer to the route as it travels. If distance from route segment is greater than this threshold, it will move directly toward the next waypoint. Parameter Units: meters Parameter Default Value: 10.0

DtRwReal DtHumanMoveAlongControllerDescriptor::myMaxCorrectionAngle
protected

Parameter Name: max-correction-angle
Parameter Description: Maximum absolute angular corrections entity will make to attempt to move the entity closer to the route segment.

Default is ~45 degrees. Parameter Units: radians Parameter Default Value: 0.785398


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

Document ID: Generated on Tue Jan 29 18:21:16 EST 2013 from SVN revision 123193
Copyright © 2005-2013 VT MÄK Inc. All Rights Reserved (www.mak.com)