VR-Forces 5.0.2 Developer's Guide
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
List of all members | Public Member Functions | Protected Member Functions | Protected Attributes
DtScenarioExplorer Class Reference

class DtScenarioExplorer:

The DtScenarioExplorer class will inspect a scenario for any simulation model set files. If any exist, it will load the files and then present the user, through the interface, the files that are contained within those model set files

Inheritance diagram for DtScenarioExplorer:
Inheritance graph
[legend]

Public Member Functions

 DtScenarioExplorer ()
 
 DtScenarioExplorer (const DtScenario &scenario)
 
virtual ~DtScenarioExplorer ()
 
 DtScenarioExplorer (const DtScenarioExplorer &orig)
 
DtScenarioExploreroperator= (const DtScenarioExplorer &orig)
 
virtual bool init ()
 
virtual bool init (const DtSimulationModelSet &sms)
 
virtual bool readScenarioFile (const DtFilename &filename)
 
virtual DtFilename terrainDatabaseFilename () const
 
virtual DtFilename componentAttachmentTableFilename () const
 
virtual DtFilename orderOfBattleFilename () const
 
virtual DtFilename scenarioScriptsFilename () const
 
virtual DtFilename orbatFilename () const
 
virtual DtFilename planFilename () const
 
virtual DtFilename parameterDatabaseFilename () const
 
virtual DtFilename forceHostilityFilename () const
 
virtual DtFilename scenarioExtrasFilename () const
 
virtual const std::vector
< DtFilename > & 
physicalWorldFilenames () const
 
virtual const std::vector
< DtFilename > & 
detonationParametersFilenames () const
 
virtual const std::vector
< DtFilename > & 
detonationTerrainDeformParametersFilenames () const
 
virtual const std::vector
< DtFilename > & 
ammunitionParametersFilenames () const
 
virtual const std::vector
< DtFilename > & 
indirectArtilleryTypesFilenames () const
 
virtual const std::vector
< DtFilename > & 
commModelFilenames () const
 
virtual DtFilename objectMapFilename () const
 
virtual DtReal timeMultiplier () const
 
virtual bool autoReorganize () const
 
virtual long int randomNumberSeed () const
 
virtual DtString frameRateModeString () const
 
virtual DtFrameMode frameRateMode () const
 
virtual DtReal frameDeltaTime () const
 
virtual DtTime runDurationTime ()
 
virtual DtTime simTime () const
 
virtual DtTime runDurationTime () const
 
virtual DtTime exerciseStartTime () const
 
virtual DtFilename filename () const
 
virtual bool isValid (bool allowEmptyFilenames=true) const
 
virtual double version () const
 
virtual void processModelSets ()
 
virtual void loadCoreModelSets ()
 
virtual void processSimulationModelSets (const std::vector< DtString > &smsFiles)
 
virtual DtSimulationModelSetcreateSimulationModelSet () const
 
virtual const std::vector
< DtFilename > & 
modelSetForceFilenames () const
 
DtScenarioscenario () const
 
virtual void addFilename (std::vector< DtFilename > &, const DtFilename &map) const
 
virtual void setSimulationModelSetFilenames (const std::vector< DtFilename > &s)
 
virtual void setSimulationModelSetFilenames (const DtRwNLengthStringVector &)
 
virtual DtFilename globalPlanFilename () const
 
virtual const std::vector
< DtFilename > & 
additionalOpdFilenames () const
 
virtual DtRwNLengthStringVector simulationModelSetFilenames ()
 
std::vector
< DtSimulationModelSet * > & 
modelSets ()
 
const std::vector
< DtSimulationModelSet * > & 
modelSets () const
 
virtual const std::vector
< DtFilename > & 
modelSetFilenames () const
 

Protected Member Functions

virtual void clearModelSets ()
 
virtual void mergeAdditionalOpdFiles ()
 
virtual void processModelSet (DtSimulationModelSet *)
 
virtual void processIncludedSMSs (std::vector< DtSimulationModelSet * > &loadedSets, DtSimulationModelSet *set, DtReaderWriter::SearchPaths &searchPaths)
 
virtual void loadIncludedSets (DtSimulationModelSet *set, std::vector< DtSimulationModelSet * > &loadedSetsStarted, std::vector< DtSimulationModelSet * > &loadedSetsCompleted, DtReaderWriter::SearchPaths &parentSearchPaths, DtReaderWriter::SearchPaths &childSearchPaths, DtReaderWriter::SearchPaths &allPaths)
 

Protected Attributes

DtScenariomyScenario
 
DtFilename myParameterDatabaseFilename
 
DtFilename myForceHostilityFilename
 
DtFilename myScenarioExtrasFilename
 
std::vector
< DtSimulationModelSet * > 
myModelSets
 
std::vector< DtFilename > myPhysicalWorldFilenames
 
std::vector< DtFilename > myDetonationParametersFilenames
 
std::vector< DtFilename > myDetTerrainDeformParametersFilenames
 
std::vector< DtFilename > myAmmunitionParametersFilenames
 
std::vector< DtFilename > myIndirectArtilleryTypesFilenames
 
std::vector< DtFilename > myAdditionalOpdFilenames
 
std::vector< DtFilename > myCommModelFilenames
 
std::vector< DtFilename > myModelSetForceFilenames
 
std::vector< DtFilename > myModelSetFilenames
 

Constructor & Destructor Documentation

DtScenarioExplorer::DtScenarioExplorer ( )

default constructor

DtScenarioExplorer::DtScenarioExplorer ( const DtScenario scenario)

real constructor

virtual DtScenarioExplorer::~DtScenarioExplorer ( )
virtual

destructor

DtScenarioExplorer::DtScenarioExplorer ( const DtScenarioExplorer orig)

copy constructor

Member Function Documentation

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

assignment operator

virtual bool DtScenarioExplorer::init ( )
virtual

Initialization. Must be called before any other functions are called.

This method will read in all simulation model sets and place the results into the mySimulationModelSets array. All methods that are affected by the results of this read are marked above. This method will be called from those methods that use it if the model sets have not already been read

virtual bool DtScenarioExplorer::init ( const DtSimulationModelSet sms)
virtual

Initializes from supplied sms file. Does not need to have a seed scenario to parse sms files.

virtual bool DtScenarioExplorer::readScenarioFile ( const DtFilename &  filename)
virtual

Read itself from file.

virtual DtFilename DtScenarioExplorer::terrainDatabaseFilename ( ) const
virtual

Get the terrain database filename. This is terrain database used by the backend and Gui (unless a different Gui terrain database is specified).

virtual DtFilename DtScenarioExplorer::componentAttachmentTableFilename ( ) const
virtual

Get the component attachment table filename.

virtual DtFilename DtScenarioExplorer::orderOfBattleFilename ( ) const
virtual

Get the order of battle filename.

virtual DtFilename DtScenarioExplorer::scenarioScriptsFilename ( ) const
virtual

Get the scenario scripts filename.

virtual DtFilename DtScenarioExplorer::orbatFilename ( ) const
virtual

Get the orbat filename.

virtual DtFilename DtScenarioExplorer::planFilename ( ) const
virtual

Get the plan filename.

virtual DtFilename DtScenarioExplorer::globalPlanFilename ( ) const
virtual

Get the global plan filename.

virtual DtFilename DtScenarioExplorer::parameterDatabaseFilename ( ) const
virtual

Get the parameter database filename.

virtual DtFilename DtScenarioExplorer::forceHostilityFilename ( ) const
virtual
virtual DtFilename DtScenarioExplorer::scenarioExtrasFilename ( ) const
virtual
virtual const std::vector<DtFilename>& DtScenarioExplorer::physicalWorldFilenames ( ) const
virtual

Get the physical world settings files.

virtual const std::vector<DtFilename>& DtScenarioExplorer::detonationParametersFilenames ( ) const
virtual

Get the detonation parameters files.

virtual const std::vector<DtFilename>& DtScenarioExplorer::detonationTerrainDeformParametersFilenames ( ) const
virtual

Get the detonation terrain deformation parameters files.

virtual const std::vector<DtFilename>& DtScenarioExplorer::ammunitionParametersFilenames ( ) const
virtual

Get the ammunition parameters files.

virtual const std::vector<DtFilename>& DtScenarioExplorer::indirectArtilleryTypesFilenames ( ) const
virtual

Get the indirect artillery types files.

virtual const std::vector<DtFilename>& DtScenarioExplorer::commModelFilenames ( ) const
virtual

Get the comm model settings files.

virtual DtFilename DtScenarioExplorer::objectMapFilename ( ) const
virtual

Get the object map filename.

virtual DtReal DtScenarioExplorer::timeMultiplier ( ) const
virtual

Get the time multiplier.

virtual bool DtScenarioExplorer::autoReorganize ( ) const
virtual

Get the auto reorganize flag.

virtual long int DtScenarioExplorer::randomNumberSeed ( ) const
virtual

Get the random number seed.

virtual DtString DtScenarioExplorer::frameRateModeString ( ) const
virtual

Get frame rate mode.

virtual DtFrameMode DtScenarioExplorer::frameRateMode ( ) const
virtual
virtual DtReal DtScenarioExplorer::frameDeltaTime ( ) const
virtual

Get frame delta time.

virtual DtTime DtScenarioExplorer::runDurationTime ( )
virtual

Get the run duration time. By default, the run duration time is set to -1 (run indefinitely).

virtual DtTime DtScenarioExplorer::simTime ( ) const
virtual

Get simulation time.

virtual DtTime DtScenarioExplorer::runDurationTime ( ) const
virtual

Get run duration time.

virtual DtTime DtScenarioExplorer::exerciseStartTime ( ) const
virtual

Get exercise start date and time.

virtual const std::vector<DtFilename>& DtScenarioExplorer::additionalOpdFilenames ( ) const
virtual

Additional OPD files that will be appended (in the order specified) to the main OPD file for this scenario.

virtual DtRwNLengthStringVector DtScenarioExplorer::simulationModelSetFilenames ( )
virtual

Simulation model set files that want to be loaded for this scenario. Note that the first file will be considered the "master" file. All others will merge into the "master" (subsequent model set files that contain .opd files will be considered "additional .opds")

virtual DtFilename DtScenarioExplorer::filename ( ) const
virtual
virtual bool DtScenarioExplorer::isValid ( bool  allowEmptyFilenames = true) const
virtual

Returns true if all information necessary to load the scenario is present. If allowEmptyFilenames is false, do not allow empty filenames for order of battle or plan.

virtual double DtScenarioExplorer::version ( ) const
virtual

The version of the scenario file.

virtual void DtScenarioExplorer::processModelSets ( )
virtual

Processes all the model sets found in the myScenario object.

virtual void DtScenarioExplorer::loadCoreModelSets ( )
virtual

Loads the "core" model sets, which are the ones automatically loaded before any others, if they exist in the directory structure.

virtual void DtScenarioExplorer::processSimulationModelSets ( const std::vector< DtString > &  smsFiles)
virtual

Processes all model sets, adding to existing sets. Call clearModelSets() to clear out existing information first to start with a clean slate.

virtual DtSimulationModelSet* DtScenarioExplorer::createSimulationModelSet ( ) const
virtual

Creates a new simulation model set.

std::vector< DtSimulationModelSet * > & DtScenarioExplorer::modelSets ( )
inline

The following methods are used for the front-end only.

return the array of DtSimulationModelSet pointers.

References myModelSets.

const std::vector< DtSimulationModelSet * > & DtScenarioExplorer::modelSets ( ) const
inline

The following methods are used for the front-end only.

return the array of DtSimulationModelSet pointers.

References myModelSets.

virtual const std::vector<DtFilename>& DtScenarioExplorer::modelSetForceFilenames ( ) const
virtual
Returns
A list of all (unique) force definition file names that support this scenario. (Pulled from the SMS files)
virtual const std::vector<DtFilename>& DtScenarioExplorer::modelSetFilenames ( ) const
virtual

Returns a list of all (unique) model set palette names that should be loaded in support of this scenario.

DtScenario * DtScenarioExplorer::scenario ( ) const
inline

Returns scenario associated with explorer.

References myScenario.

virtual void DtScenarioExplorer::addFilename ( std::vector< DtFilename > &  ,
const DtFilename &  map 
) const
virtual
virtual void DtScenarioExplorer::setSimulationModelSetFilenames ( const std::vector< DtFilename > &  s)
virtual
virtual void DtScenarioExplorer::setSimulationModelSetFilenames ( const DtRwNLengthStringVector )
virtual
virtual void DtScenarioExplorer::clearModelSets ( )
protectedvirtual
virtual void DtScenarioExplorer::mergeAdditionalOpdFiles ( )
protectedvirtual
virtual void DtScenarioExplorer::processModelSet ( DtSimulationModelSet )
protectedvirtual
virtual void DtScenarioExplorer::processIncludedSMSs ( std::vector< DtSimulationModelSet * > &  loadedSets,
DtSimulationModelSet set,
DtReaderWriter::SearchPaths searchPaths 
)
protectedvirtual
virtual void DtScenarioExplorer::loadIncludedSets ( DtSimulationModelSet set,
std::vector< DtSimulationModelSet * > &  loadedSetsStarted,
std::vector< DtSimulationModelSet * > &  loadedSetsCompleted,
DtReaderWriter::SearchPaths parentSearchPaths,
DtReaderWriter::SearchPaths childSearchPaths,
DtReaderWriter::SearchPaths allPaths 
)
protectedvirtual

Loads SMSs included by "set", and recurses into those if necessary. Adds relevant search paths to each set. Search paths will need to be reordered once all sets are loaded, according to the order in "allPaths".

Parameters
setModel sets included by this set are loaded.
loadedSetsStarted"set" is added to this list before recursing, to prevent a set from being loaded twice.
loadedSetsCompleted"set" is added to this list after recursing. This represents SMS priority order.
parentSearchPathsUsed to set up search paths for included sets.
childSearchPathsUsed to add included SMS's search paths to the current set.
allPathsThis will contain all paths loaded by included sets, in their correct priority order (last == highest priority).

Member Data Documentation

DtScenario* DtScenarioExplorer::myScenario
protected

Referenced by scenario().

DtFilename DtScenarioExplorer::myParameterDatabaseFilename
protected
DtFilename DtScenarioExplorer::myForceHostilityFilename
protected
DtFilename DtScenarioExplorer::myScenarioExtrasFilename
protected
std::vector<DtSimulationModelSet*> DtScenarioExplorer::myModelSets
protected

Referenced by modelSets().

std::vector<DtFilename> DtScenarioExplorer::myPhysicalWorldFilenames
protected
std::vector<DtFilename> DtScenarioExplorer::myDetonationParametersFilenames
protected
std::vector<DtFilename> DtScenarioExplorer::myDetTerrainDeformParametersFilenames
protected
std::vector<DtFilename> DtScenarioExplorer::myAmmunitionParametersFilenames
protected
std::vector<DtFilename> DtScenarioExplorer::myIndirectArtilleryTypesFilenames
protected
std::vector<DtFilename> DtScenarioExplorer::myAdditionalOpdFilenames
protected
std::vector<DtFilename> DtScenarioExplorer::myCommModelFilenames
protected
std::vector<DtFilename> DtScenarioExplorer::myModelSetForceFilenames
protected

The following member variables are used in the front-end only.

std::vector<DtFilename> DtScenarioExplorer::myModelSetFilenames
protected

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

Document ID: Generated on Sun Dec 4 20:22:03 EST 2022 from SVN revision 249613
Copyright © 2005-2021 MAK Technologies. All Rights Reserved (www.mak.com)