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

Instances of DtVrfParameterDb are the database of DtVrfObjectParameters objects used in the construction of DtVrfObjects. More...

Inheritance diagram for DtVrfParameterDb:
Inheritance graph
[legend]

Public Member Functions

 DtVrfParameterDb ()
 default constructor
virtual ~DtVrfParameterDb ()
 destructor
virtual bool init ()
 initialization - must be called before any other public member functions are called.
virtual DtVrfParameterDbEntryadd (const DtObjectType &objectType, DtVrfObjectParameters *parameters)
 Add a new parameter entry to database.
virtual DtVrfObjectParameterslookup (const DtObjectType &objectType, DtObjectType *matchingType=NULL, DtString *source=NULL) const
 Lookup entry in parameter database that most closely matches given objectType.
virtual void remove (const DtObjectType &objectType)
 Remove the entry for the given object type from the database.
virtual void removeAll ()
 Remove all entries in the parameter database.
virtual const DtList & parameterList () const
 List of all DtVrfParameterDbEntry* items in the database.
virtual bool load (const DtFilename &filename)
 Load the contents of a file into the parameter database.
virtual bool save (const DtFilename &filename)
 Save current contents of the parameter database to file.
virtual void addParameters (const DtObjectType &objectType, DtVrfObjectParameters *newParameters)
virtual DtVrfObjectParameterslookupParameters (const DtObjectType &objectType, DtObjectType *matchingType) const
virtual void removeParameters (const DtObjectType &objectType)
virtual void removeAndDeleteAll ()
virtual DtVrfParameterDbEntrylookupParameterDbEntry (const DtObjectType &objectType, DtObjectType *matchingType) const
 Returns entry most closely matching given object type.
virtual int numParameterEntries () const
 Returns the number of parameter entries.
virtual std::list< DtString > * getSysDefExtensionList ()
 Get the list of sysdef extensions currently accepted.
virtual void addExtension (DtString)
 Add a new extension to the back of the line.

Static Public Member Functions

static DtVrfParameterDbcreate ()
 Returns a new instance of this class.

Protected Member Functions

virtual void addParameterDbEntry (DtVrfParameterDbEntry *newParameterEntry)
 Add news item to database.
virtual DtListItem * lookupParameters (const DtObjectType &objectType) const
 Returns DtListItem (containing DtVrfParameterDbEntry*) for given object type.
void emptyList ()
 Empties contents of database, deleting memory associated with each entry.
virtual DtVrfParameterDbEntrycreateParameterEntry () const
 Creates a new type of parameter entry. Override to create your own derived type.

Protected Attributes

DtList myParameterList
 List of DtVrfParameterDbEntry* objects.

Private Member Functions

 DtVrfParameterDb (const DtVrfParameterDb &orig)
 copy constructor - not implemented
DtVrfParameterDboperator= (const DtVrfParameterDb &orig)
 assignment operator - not implemented

Detailed Description

Instances of DtVrfParameterDb are the database of DtVrfObjectParameters objects used in the construction of DtVrfObjects.

The database is a collection of DtVrfObjectParameters objects, keyed on DtObjectType. When a new DtVrfObject is created through the DtVrfObjectManager, it looks up the appropriate DtVrfObjectParameters entry in the database, and uses the information contained in the entry to direct its construction.

Constructor & Destructor Documentation

DtVrfParameterDb::DtVrfParameterDb ( )

default constructor

virtual DtVrfParameterDb::~DtVrfParameterDb ( )
virtual

destructor

DtVrfParameterDb::DtVrfParameterDb ( const DtVrfParameterDb orig)
private

copy constructor - not implemented

Member Function Documentation

virtual bool DtVrfParameterDb::init ( )
virtual

initialization - must be called before any other public member functions are called.

Reimplemented in DtMtlParameterDb.

virtual DtVrfParameterDbEntry* DtVrfParameterDb::add ( const DtObjectType objectType,
DtVrfObjectParameters parameters 
)
virtual

Add a new parameter entry to database.

It will replace the current entry for the given object type, if one exists. This class assumes responsibility for deleting memory associated with parameters added through addParameters.

virtual DtVrfObjectParameters* DtVrfParameterDb::lookup ( const DtObjectType objectType,
DtObjectType matchingType = NULL,
DtString source = NULL 
) const
virtual

Lookup entry in parameter database that most closely matches given objectType.

If matchingType is specified, return the object type of the entry (which may be less specific than the object type being looked up). If source is specified, it will be set to a string indicating the source data for the parameters which is appropriate for displaying on the console.

Reimplemented in DtMtlParameterDb.

virtual void DtVrfParameterDb::remove ( const DtObjectType objectType)
virtual

Remove the entry for the given object type from the database.

Deletes the memory associated with the entry.

virtual void DtVrfParameterDb::removeAll ( )
virtual

Remove all entries in the parameter database.

Deletes memory associated with entries in the database.

Reimplemented in DtMtlParameterDb.

virtual const DtList& DtVrfParameterDb::parameterList ( ) const
virtual

List of all DtVrfParameterDbEntry* items in the database.

virtual bool DtVrfParameterDb::load ( const DtFilename &  filename)
inlinevirtual

Load the contents of a file into the parameter database.

Reimplemented in DtMtlParameterDb.

virtual bool DtVrfParameterDb::save ( const DtFilename &  filename)
inlinevirtual

Save current contents of the parameter database to file.

Reimplemented in DtMtlParameterDb.

virtual void DtVrfParameterDb::addParameters ( const DtObjectType objectType,
DtVrfObjectParameters newParameters 
)
virtual
Deprecated:
To be removed after VR-Forces version 3.11 Call add() instead.
virtual DtVrfObjectParameters* DtVrfParameterDb::lookupParameters ( const DtObjectType objectType,
DtObjectType matchingType 
) const
virtual
Deprecated:
To be removed after VR-Forces version 3.11 Call lookup() instead.
virtual void DtVrfParameterDb::removeParameters ( const DtObjectType objectType)
virtual
Deprecated:
To be removed after VR-Forces version 3.11 Call remove() instead.
virtual void DtVrfParameterDb::removeAndDeleteAll ( )
virtual
Deprecated:
To be removed after VR-Forces version 3.11 Call removeAll() instead.
virtual DtVrfParameterDbEntry* DtVrfParameterDb::lookupParameterDbEntry ( const DtObjectType objectType,
DtObjectType matchingType 
) const
virtual

Returns entry most closely matching given object type.

Returns object type of the entry that was found (which may be less specific than given object type).

virtual int DtVrfParameterDb::numParameterEntries ( ) const
virtual

Returns the number of parameter entries.

virtual std::list<DtString>* DtVrfParameterDb::getSysDefExtensionList ( )
virtual

Get the list of sysdef extensions currently accepted.

This can be modified so you may add, remove, or reorder the extensions. Extensions are used to load alternate sysdefs. For example, if you add an extension of "myextension", your human-myextension.sysdef file will load if it exists, instead of human.sysdef.

virtual void DtVrfParameterDb::addExtension ( DtString  )
virtual

Add a new extension to the back of the line.

The extensions added last are considered more important than the extensions added first.

static DtVrfParameterDb* DtVrfParameterDb::create ( )
static

Returns a new instance of this class.

Reimplemented in DtMtlParameterDb.

virtual void DtVrfParameterDb::addParameterDbEntry ( DtVrfParameterDbEntry newParameterEntry)
protectedvirtual

Add news item to database.

If entry with an exactly matching DtObjectType already exists, removes and deletes the existing entry before adding the new one. Inserts new entry into list of entries in the order of most general DtObjectType (e.g. -1 -1 -1 -1 -1 -1 -1 -1) to most specific (e.g. 1 1 225 3 1 3 1 1), where -1 is a wildcard, and fields are ordered from left to right as most general to most specific.

virtual DtListItem* DtVrfParameterDb::lookupParameters ( const DtObjectType objectType) const
protectedvirtual

Returns DtListItem (containing DtVrfParameterDbEntry*) for given object type.

void DtVrfParameterDb::emptyList ( )
protected

Empties contents of database, deleting memory associated with each entry.

Not virtual because its called by the destructor.

virtual DtVrfParameterDbEntry* DtVrfParameterDb::createParameterEntry ( ) const
protectedvirtual

Creates a new type of parameter entry. Override to create your own derived type.

Reimplemented in DtMtlParameterDb.

DtVrfParameterDb& DtVrfParameterDb::operator= ( const DtVrfParameterDb orig)
private

assignment operator - not implemented

Member Data Documentation

DtList DtVrfParameterDb::myParameterList
protected

List of DtVrfParameterDbEntry* objects.


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

Document ID: Generated on Thu Mar 23 18:54:12 EDT 2017 from SVN revision 174804
Copyright © 2005-2017 VT MÄK. All Rights Reserved (www.mak.com)