VR-Forces 4.8 Class Documentation
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
List of all members | Public Types | Public Member Functions | Protected Member Functions | Protected Attributes | Private Member Functions
DtArticulatedPartManager Class Reference

The articulated part manager maintains a tree of articulated and attached parts for the state repository class. More...

Inheritance diagram for DtArticulatedPartManager:
Inheritance graph
[legend]

Public Types

typedef std::map
< DtArtPartType,
DtArticulatedPartStateRepository * > 
ArtPartMap
 
- 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::vector< DtFilename > SearchPaths
 
typedef std::pair
< DtSymbolString, DtString
DtVariableNameType
 
typedef DtReaderWriterFactory *(* DtReaderWriterFactoryCreatorFcn )()
 

Public Member Functions

 DtArticulatedPartManager (DtVrfObject *owner, const DtString &name, DtReaderWriterRegistry *parentRegistry=NULL)
 Constructor. More...
 
 DtArticulatedPartManager (const DtArticulatedPartManager &other, DtReaderWriterRegistry *parentRegistry=NULL)
 Copy constructor. More...
 
virtual ~DtArticulatedPartManager ()
 Destructor. More...
 
virtual
DtArticulatedPartStateRepository
attachPart (DtArtPartType partType)
 Creates a new manager calling the copy constructor and returns the result. More...
 
virtual
DtArticulatedPartStateRepository
attachPart (DtArtPartType partType, DtArtPartType parentPartType)
 Attach a part of the given type to another part on the parent object. More...
 
virtual
DtArticulatedPartStateRepository
attachPart (DtArtPartType partType, DtArtPartType parentPartType, const DtArticulatedPartStateRepository &partState)
 Attach an existing part to a new parent. More...
 
virtual bool detachPart (DtArtPartType partType, DtArticulatedPartStateRepository *partState=0)
 Detaches a part of the given type. More...
 
virtual
DtArticulatedPartStateRepository
findPartByType (DtArtPartType partType)
 Goes through all articulated parts and their own parts looking for the part with the specified type. More...
 
virtual const
DtArticulatedPartStateRepository
findPartByType (DtArtPartType partType) const
 
virtual int numParts () const
 Returns the number of parts attached, including parts attached to those parts. More...
 
const DtArtPartMaparticulatedParts () const
 
virtual void mergeInPartAttachments (const DtArticulatedPartManager &other)
 Updates part attachments (adding missing parts) from the other part manager. More...
 
virtual void setAllPartValuesUnspecified ()
 Mark all part settings as unspecified. More...
 
virtual void preGetSelf ()
 Before getSelf is called we must save off our previous state to perform proper merging after read. More...
 
virtual void postGetSelf ()
 After getSelf is called we must merge the new parts with the old parts. More...
 
virtual void prePutSelf ()
 Before putSelf, mark unspecified items as read only so that they are not saved. More...
 
virtual void printAllParts (std::ostream &strm) const
 Prints all parts to the given stream. More...
 
- Public Member Functions inherited from DtReaderWriter
 DtReaderWriter ()
 default constructor More...
 
 DtReaderWriter (const DtString &name, DtReaderWriterRegistry *parentRegistry=NULL, bool readonly=false)
 real constructor Setting the readonly flag prevents object from writing itself to the stream. More...
 
 DtReaderWriter (const DtSymbolString &name, DtReaderWriterRegistry *parentRegistry=NULL, bool readonly=false)
 
 DtReaderWriter (const DtString &name, const DtReaderWriter &orig, DtReaderWriterRegistry *parentRegistry=NULL)
 pseudo-copy constructor More...
 
 DtReaderWriter (const DtSymbolString &name, const DtReaderWriter &orig, DtReaderWriterRegistry *parentRegistry=NULL)
 
 DtReaderWriter (const DtReaderWriter &, DtReaderWriterRegistry *parentRegistry=NULL)
 copy constructor More...
 
const DtReaderWriteroperator= (const DtReaderWriter &orig)
 assignment operator More...
 
bool operator== (const DtReaderWriter &) const
 Equivalence operator. More...
 
bool operator!= (const DtReaderWriter &rhs)
 
virtual ~DtReaderWriter ()
 destructor More...
 
virtual void putSelf (std::string &fp, int indentLevel=0, bool writeUnspecified=false, const DtFilename &path=DtFilename::nullFilename())
 Top level call to write itself to file. More...
 
virtual void postPutSelf ()
 Called after either version of put self (file or environment). Default is no-op. More...
 
virtual void getSelf (DtlObjPtr args, const DtReaderWriter::SearchPaths &searchPaths=SearchPaths(), const DtVariableBindingsList &variableBindings=nullVariableReference())
 Top level to read itself from an input stream. More...
 
virtual void writeSelf (std::string &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. More...
 
virtual DtSymbolString name () const
 Accessor for name of this readable/writable object. More...
 
virtual void addAlias (const DtSymbolString &alias)
 Add an alias as an alternative name for this object. More...
 
virtual void addAlias (const DtString &alias)
 
virtual bool hasAlias (const DtSymbolString &alias)
 
virtual const aliasContaineraliases () const
 
virtual void setReadonly (bool flag)
 Set read-only flag. More...
 
bool isReadonly () const
 
virtual void reset ()
 For those reader/writer items that support it, resets the reader/writer value to original state Default is no-op. More...
 
virtual int alignment () const
 For those items that are sent over the network via HLA, this will give the network alignment. More...
 
virtual bool variableIsBound () const
 
virtual void unbindVariable ()
 Sets the myVariableIsBound flag to false. More...
 
virtual void setName (const DtString &)
 Set the name of the object. More...
 
virtual const charreaderWriterType () const
 Used to supply a string type that this reader writer type is. More...
 
virtual const charxmlType () const
 
virtual DtString prettyPrint () const
 Routine to return a human readable form of the reader/writer variable. More...
 
std::string debugText () const
 
virtual void bindVariables (DtVariableBindingsList variableBindings)
 Runs a variable binding pass on this reader writer and any of its children. More...
 
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. More...
 
virtual bool hasVariableReference () const
 Returns true if this item or any item in the registry (recursive) is a variable reference. More...
 
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. More...
 
virtual void recordUpdateTime () const
 Can be implemented in subclasses to stamp the time when updated. More...
 
virtual bool wasUpdatedSince (DtTime t) const
 Can be implemented in subclasses to return true if an update occurred after the specified time. More...
 
virtual bool changedSinceLastChecked ()
 Returns true if this objects value has changed since the last time this function was called. More...
 
virtual bool peekChangedSinceLastChecked () const
 Returns the value that changedSinceLastChecked would return but does not reset the internal flag. More...
 
virtual void putData (std::string &fp, int indentLevel=0)
 Deriving class overrides these to get/put class specific data. More...
 
virtual DtlObjPtr getData (DtlObjPtr args, const SearchPaths &searchPaths, const DtVariableBindingsList &variableBindings)
 
virtual void setValueSpecified (bool specified, bool recurse=false)
 The specified flags are used for optional values. More...
 
virtual bool valueSpecified () const
 
virtual bool isVariableReference () const
 Specifies whether or not this reader writer is really a variable that is specified elsewhere. More...
 
virtual void setIsVariableReference (bool value)
 
virtual void clearAllVariableReferenceFlags ()
 Clears out all variable reference flags from all readerwriter items in registry recursively. More...
 
virtual DtSymbolString variableName () const
 The variable name, if this object is a variable reference. More...
 
virtual void setVariableName (const DtSymbolString variableName)
 
virtual const DtReaderWriterdefaultRWValue () const
 The default value to use if the reader/writer object is a variable and that variable is not specified. More...
 
virtual DtReaderWriterdefaultRWValue ()
 
virtual void setDefaultRWValue (DtReaderWriter *)
 Previous default value, if exists, will be removed and replaced with a clone of the supplied variable. More...
 
virtual bool checkAndSetDefaultRWValue (DtlObjPtr args, const DtReaderWriter::SearchPaths &searchPaths=SearchPaths(), const DtVariableBindingsList &variableBindings=nullVariableReference())
 Give the stream, if the stream contains a default value then set it here. More...
 
const DtReaderWriterRegistryregistry () const
 Collection of child DtReaderWriter nodes owned by this object. More...
 
DtReaderWriterRegistryregistry ()
 
virtual DtPropertyInterfaceproperty ()
 
virtual const DtPropertyInterfaceproperty () const
 
virtual DtString toXml () const
 
virtual DtRwVariableBindingsgenerateVariableBindings () const
 Iterates over the registry (recursively) and returns a variable bindings object that contains all the variables that are contained in this read/writer class. More...
 
virtual bool toXml (const DtFilename &) const
 Writes contents of xml result to the given filename. More...
 
virtual bool fromXml (const DtString &)
 Restores object from given xml string. Returns true if valid. More...
 
virtual bool fromXmlFile (const DtFilename &)
 Restores object from given xml file. More...
 
virtual void putSelf (DtEnvironmentSP, DtEnvValueSP parent) const
 
virtual void putData (DtEnvironmentSP, DtEnvValueSP value) const
 Override to add attributes of actual data. More...
 
virtual void putVariableReference (DtEnvironmentSP, DtEnvValueSP value) const
 Called when the item is a variable reference. More...
 
virtual void getSelf (const DtEnvironmentSP, const DtEnvValueSP root, const SearchPaths &searchPaths=SearchPaths(), const DtVariableBindingsList &bindings=DtVariableBindingsList())
 
virtual void getData (const DtEnvironmentSP, const DtEnvValueSP, const SearchPaths &searchPaths=SearchPaths(), const DtVariableBindingsList &bindings=DtVariableBindingsList())
 Gets data from the environment value. More...
 
virtual void unrecognizedItem (const DtEnvironmentSP env, const DtEnvValueSP root, const SearchPaths &searchPaths, const DtVariableBindingsList &varBindings)
 Called when the xml reader tries to parse an unknown reader/writer item. Default is a no-op. More...
 
virtual void getVariableReference (DtEnvironmentSP, DtEnvValueSP value)
 Called when the item is a variable reference. More...
 

Protected Member Functions

const
DtArticulatedPartStateRepository
findPartOnOtherPart (DtArtPartType partType, const DtArticulatedPartStateRepository &parentPart) const
 
bool detatchPartFromOtherPart (DtArtPartType partType, DtArticulatedPartStateRepository &parentPart, DtArticulatedPartStateRepository *partState=0)
 
int countPartsOnOtherPart (const DtArticulatedPartStateRepository &parentPart) const
 
void mergeIntoPartsMap (const DtArtPartMap &otherMap)
 
- Protected Member Functions inherited from DtReaderWriter
virtual void bindToRwAsVariable (const DtReaderWriter *rw)
 Copies values from the specified DtReaderWriter. More...
 

Protected Attributes

DtArtPartMap myParts
 
DtArtPartMap myTempParts
 
DtVrfObjectmyOwner
 
- Protected Attributes inherited from DtReaderWriter
const DtSymbolString myName
 
DtReaderWriterRegistry myRegistry
 
DtReaderWriterRegistrymyParentRegistry
 
bool myValueSpecified
 
bool myReadOnlyFlag
 
bool myIsVariableReference
 
DtSymbolString myVariableName
 
bool myVariableIsBound
 
DtReaderWritermyDefaultValue
 
aliasContainer myAliases
 Container for the aliases which represent alternative names for the object. More...
 
bool myInvalid
 Set to true if there is a problem reading this item. More...
 
bool myChangedFlag
 Set to true when value changes Set to false when value checked with changedSinceLastChecked. More...
 

Private Member Functions

 DtArticulatedPartManager ()
 Default Constructor. Not implemented. More...
 

Additional Inherited Members

- Static Public Member Functions inherited from DtReaderWriter
static void putIndent (std::string &fp, int indentLevel)
 
static const
DtVariableBindingsList
nullVariableReference ()
 
static void setPostGetSelfCallback (DtGetSelfCallbackFcn fcn, void *usrData)
 
static void setPrePutSelfCallback (DtPutSelfCallbackFcn fcn, void *usrData)
 
static void setPutIndent (bool)
 
static bool putIndent ()
 
static const chartheXmlType ()
 The type that is used when archiving to an XML stream. More...
 
static const DtFilename & appPath ()
 Gets the current working directory. More...
 
static void setFactoryCreatorFunction (DtReaderWriterFactoryCreatorFcn fcn)
 Sets the function to create the DtReaderWriterFactory. More...
 
static void createReaderWriterFactory ()
 
static void cleanupFactory ()
 
static DtReaderWriterFactoryfactory ()
 
static void setOutputStream (DtOutputStream *stream)
 
static DtOutputStream & outputStream ()
 
static DtReaderWritercreateFromXmlFile (const DtFilename &, bool createAsProperty=false)
 Given a filename, returns a newly created reader/writer object from the object found within. More...
 
static DtReaderWritercreateFromXml (const DtString &, bool createAsProperty=false)
 Given a xml string, returns a newly created reader/writer object from the object found within. More...
 
static DtReaderWritercreateFromEnvironment (DtEnvironmentSP, bool createAsProperty=false)
 Given a xml environment, returns a newly created reader/writer object from the object found within. More...
 
static DtString getAttribute (DtEnvironmentSP env, const DtString &name, DtEnvValueSP root)
 Gets the named attribute from a DtEnvValueSP. More...
 
- Static Protected Attributes inherited from DtReaderWriter
static DtString theUnspecifiedValue
 
static DtGetSelfCallbackInfo thePostGetSelfCallback
 
static DtPutSelfCallbackInfo thePrePutSelfCallback
 
static const DtVariableBindingsList theEmptyVariableBindingsList
 
static bool theCreatorFcnSet
 
static DtReaderWriterFactorytheFactory
 
static
DtReaderWriterFactoryCreatorFcn 
theFactoryCreatorFcn
 
static bool thePutIndent
 
static DtOutputStream * theOutputStream
 

Detailed Description

The articulated part manager maintains a tree of articulated and attached parts for the state repository class.

These parts are each represented by a DtArticulatedPartStateRepository.

Member Typedef Documentation

Constructor & Destructor Documentation

DtArticulatedPartManager::DtArticulatedPartManager ( )
private

Default Constructor. Not implemented.

DtArticulatedPartManager::DtArticulatedPartManager ( DtVrfObject owner,
const DtString name,
DtReaderWriterRegistry parentRegistry = NULL 
)

Constructor.

DtArticulatedPartManager::DtArticulatedPartManager ( const DtArticulatedPartManager other,
DtReaderWriterRegistry parentRegistry = NULL 
)
explicit

Copy constructor.

virtual DtArticulatedPartManager::~DtArticulatedPartManager ( )
virtual

Destructor.

Member Function Documentation

virtual DtArticulatedPartStateRepository* DtArticulatedPartManager::attachPart ( DtArtPartType  partType)
virtual

Creates a new manager calling the copy constructor and returns the result.

Attach a part of the given type directly to the parent object. Returns a pointer to the new part if successful.

virtual DtArticulatedPartStateRepository* DtArticulatedPartManager::attachPart ( DtArtPartType  partType,
DtArtPartType  parentPartType 
)
virtual

Attach a part of the given type to another part on the parent object.

Returns a pointer to the new part if successful.

virtual DtArticulatedPartStateRepository* DtArticulatedPartManager::attachPart ( DtArtPartType  partType,
DtArtPartType  parentPartType,
const DtArticulatedPartStateRepository partState 
)
virtual

Attach an existing part to a new parent.

virtual bool DtArticulatedPartManager::detachPart ( DtArtPartType  partType,
DtArticulatedPartStateRepository partState = 0 
)
virtual

Detaches a part of the given type.

Searches the tree of parts to find it. If partState is a valid pointer then it will be filled in with the state of the detached part. Returns true if found.

virtual DtArticulatedPartStateRepository* DtArticulatedPartManager::findPartByType ( DtArtPartType  partType)
virtual

Goes through all articulated parts and their own parts looking for the part with the specified type.

virtual const DtArticulatedPartStateRepository* DtArticulatedPartManager::findPartByType ( DtArtPartType  partType) const
virtual
virtual int DtArticulatedPartManager::numParts ( ) const
virtual

Returns the number of parts attached, including parts attached to those parts.

const DtArtPartMap& DtArticulatedPartManager::articulatedParts ( ) const
inline
virtual void DtArticulatedPartManager::mergeInPartAttachments ( const DtArticulatedPartManager other)
virtual

Updates part attachments (adding missing parts) from the other part manager.

virtual void DtArticulatedPartManager::setAllPartValuesUnspecified ( )
virtual

Mark all part settings as unspecified.

That way only values loaded from the scenario will be marked specified.

virtual void DtArticulatedPartManager::preGetSelf ( )
virtual

Before getSelf is called we must save off our previous state to perform proper merging after read.

Reimplemented from DtReaderWriter.

virtual void DtArticulatedPartManager::postGetSelf ( )
virtual

After getSelf is called we must merge the new parts with the old parts.

Reimplemented from DtReaderWriter.

virtual void DtArticulatedPartManager::prePutSelf ( )
virtual

Before putSelf, mark unspecified items as read only so that they are not saved.

That way configuration values will be used instead.

Reimplemented from DtReaderWriter.

virtual void DtArticulatedPartManager::printAllParts ( std::ostream &  strm) const
virtual

Prints all parts to the given stream.

const DtArticulatedPartStateRepository* DtArticulatedPartManager::findPartOnOtherPart ( DtArtPartType  partType,
const DtArticulatedPartStateRepository parentPart 
) const
protected
bool DtArticulatedPartManager::detatchPartFromOtherPart ( DtArtPartType  partType,
DtArticulatedPartStateRepository parentPart,
DtArticulatedPartStateRepository partState = 0 
)
protected
int DtArticulatedPartManager::countPartsOnOtherPart ( const DtArticulatedPartStateRepository parentPart) const
protected
void DtArticulatedPartManager::mergeIntoPartsMap ( const DtArtPartMap otherMap)
protected

Member Data Documentation

DtArtPartMap DtArticulatedPartManager::myParts
protected
DtArtPartMap DtArticulatedPartManager::myTempParts
protected
DtVrfObject* DtArticulatedPartManager::myOwner
protected

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

Document ID: Generated on Thu Aug 27 10:56:05 EDT 2020 from SVN revision 217100
Copyright © 2005-2020 MAK Technologies. All Rights Reserved (www.mak.com)