vsTASKER 7 User Manual
×
Menu
Index

Directories

 
Directories
1

Bin

1. Bin
Here as stored some DLL needed by vsTASKER GUI and some generated simulation engines, according to the libraries used.
You will also find the vst2008_pro.msi and vst2010_pro.msi redistributable package normally called at installation time. They are requested if you do not have Visual Studio installed.
 
2

Data

2. Data
This directory contains all the databases needed by vsTASKER for design and runtime.
 
3DS
Contains some 3DS Max models to use for OpenGL perspective mode or OSG viewer
4586
Editions 2 and 3 of the STANAG 4586 definitions
ArcInfo
vsTerrainBuilder converted .geo terrain data from .shp files
Coast
vsTerrainBuilder converted coast line terrain data from .dat or .lin files
Db
Contains all design database vsTASKER loads at design time. The database node file .db is inside a directory holding the same name.
Elev
vsTerrainBuilder converted elevation terrain data from .dem or .dted files
Fom
Contains HLS federation files in 1.3 (.fed) or 1516 (.xml) format needed by the HLA module
HMI
Contains all textures needed by the Sprites. Files are going by pair. One is the .tga with alpha-channel for transparency. The second one is the .bmp for display in the File selection window (as .tga cannot appear as bitmap)
Log
Directory used to store Record & Playback files from the Logger
Map
Contains all the image terrain files used for Raster maps and the tiled-map databases (x.map file and associated x directory)
NavChart
vsTerrainBuilder converted s57 .000 maritime files
Omt
Contains the OMT definitions used by the HLA module, for 1.3 federations mainly.
OpenDrive
To come...
OpenFlt
vsTerrainBuilder converted .opf terrain data from OpenFlight .flt files
OsgFrame
vsTerrainBuilder converted .osg terrain data from OpenSceneGraph. Only vertex are imported.
Rep
Contains all Repositories created by the user. A Repository is made by a file.rep and its corresponding directory holding the same name.
Resource
Contains all the different resources used by the GUI. Some files are editable manually (using notepad). 2525b and Entity symbols are also stored here.
RNav
Contains the translated ARINC 424 databases to be used by
Satellites
Norad satellite TLE files
Samples
Get all loadable samples organized by types. Any loaded sample must be copied into the Db directory in order to be modified.
Shared
Contains all Exported objects.
Snap
Contains snapshot & restore runtime data, stamped by scenario name and time.
Sprites
Not used at the moment
Template
Contains all database templates, built-in and user defined.
WFrame
vsTerrainBuilder converted .wrf wire frame terrain data. Each file is associated with a texture that is mapped to the wire frame.
 
3

Doc

3. Doc
This directory contains some documentations, like the licensing instruction manual.
The release_notes HTML file lists all updates added to the previous versions.
 
4

Feature

4. Feature
Contains all scenarios Features available. User can modify any of them, add his own using the template provided or rebuild the corresponding .lib (need of Visual Studio) and .dll (need of C++ Builder 2010 or higher) to resolve some problems that might occur on some systems at dll load time.
features.lst lists all built-in Features. features_user.lst lists all user added Features (if any).
 
 
5

Gen

5. Gen
Contains all generated code files.
A database named foo will produce three files:
foo.h
foo_intf.cpp
foo_code.cpp
Because of the first file, it is for now advisable to mind the name given to the database (a database named windows for example will conflict the system windows.h header file).
db_config.h/cpp contains the latest generated header file.
 
6

Gui

6. Gui
Contains some samples on how to create a custom GUI replacing vsTASKER GUI for runtime environment.
chinese and simple are two basic applications written in Visual C++ to load a scenario, control some entities and run it, from inside a specific panel and using some vsTASKER dll map plugins (see below).
QT is a simple GUI developed under QT.
 
7

Help

7. Help
Contains the vsTASKER User Manual (this document, that also includes the online help), the Reference Manual (automatically generated using Doxygen), the TerrainBuilder User Manual and the deprecated Tutorial document.
 
8

Import

8. Import
Contains the Importer and Exporter dll, like the STK Importer/Exporter module.
User can create his own Importer/Exporter module using the provided samples.
import.lst lists all build-in importers.
import_user.lst lists all user-added importers. Use this file to add/remove your own importers.
 
See the documentation regarding expending the Import/Export functionalities
Built-in lists must not be modified as each new release/update will replace them with a new version.
9

Include

9. Include
Needed to compile simulation engines and to build custom GUI.
See Utilities for a list of convenient API and Classes.
 
10

Lib

10. Lib
Needed to link simulation engines against vsTASKER libraries and to build custom GUI.
Note that C++ Builder libraries are listed in /lib while Visual C++ libraries are listed in /vc90 (for Visual 2008) and /vc100 (for Visual 2010)
 
11

Linux

11. Linux
Contains the Linux ANSI compatible source code to create Ubuntu libraries.
Linux integration is not a plug & play process. VirtualSim engineer must be part of the process.
12

Model

12. Model
Contains all Components and DataModels used as built-in items in vsTASKER GUI and linked against the simulation engine.
The user can add his own Components and DataModels in specific directories (to avoid mixing built-in with his own) either by using the template_cpt.h/cpp, template_dml.h/cpp (see src/user and include/user) or by using the button of the Component or DataModel object. See Models.
 
built-in items:
default_cp.lst lists all default components
military_cp.lst lists all defense related components
vrvantage_cp.lst lists some vrVantage components used to integrate vsTASKER Sim engine with the MAK 3D Viewer (use them as an example)
satellite_cp.lst lists all components used with the Satellite version, like orbit propagators
stk_cp.lst lists all STK components (used with STK software or to replace some STK capabilities, after scenario import)
 
default_dm.lst lists all default built-in data-models
military_dm.lst lists all military data-models, mostly used by military components
 
User items:
user_cp.lst template for user components
 
user_dm.lst template for user data-models
Built-in lists must not be modified as each new release/update will replace them with a new version.
13

Plugins

13. Plugins
Contains all Scenario map layers used by vsTASKER GUI or any custom GUI to draw OpenGL terrain data.
User can modify any of them or create its own by using the empty Extra plugin.
Source code files and makefiles (for Visual Studio 2010 and 2017) are available for each.
See Plugins.
 
ArcInfo
Draw converted arc-info data on the terrain map
Coast
Draw converted coastlines data on the terrain map
DrawFont
Display Chinese characters on OpenGL map
Editor3D
Draw the scenario area in the 3D Editor panel, using Delta3D or OSG libraries.
Elev
Draw the elevation data on the terrain map
Entity
Draw the entity symbols. Modify this plugin if you want to draw your own symbol.
Extra
User plugin template for any use.
Flight-Plan
Draw all Flight-Plans on the GUI map
Gfx
Draw all runtime graphics sent and updated to the GUI by the Simulation Engine.
Grid
Display the grid of the terrain
Make
Rebuild all plugin DLL for Visual Studio 2010 and 2017
Mesh
Draw all the Meshes defined in the Scenario Meshes pane
NavChart
Draw converted S57 maritime charts
OpenFlt
Draw converted Open-Flight data on the terrain
Orbit
Draw orbits in terrain and globe modes
Overlay
Draw all Overlay windows like the Vertical View
Plan
Draw the entity plan (if any) with all localized routines
Raster
Display the raster maps on the terrain area
RNav
Draw all ARINC 424 air navigation database
Road
Draw all roads defined in the Scenario Roads pane
Runtime
Build and returns the list to be displayed in the runtime tree-list environment
Scenario
Draw all scenario level data like LOS, distance string, coordinates labels, etc.
Wind
Draw all wind tubes and area in all terrain modes
Wireframe
Draw the converted polygonal wire frame of the terrain data
 
14

Runtime

14. Runtime
Contains directories per Viewer or third party software.
It is not mandatory for a user to keep these directories for his own database development but all vsTASKER samples are using them.
So, in each directory, you will find the corresponding vc10 (Visual Studio 2010) or vc14 (Visual Studio 2017/19) .sln project file to debug the generated simulation engine. Each project has already libraries and include path set, ready to compile, link and run.
 
If you need to create a specific target environment for your simulation engines, it is advisable to create your own directory under Runtime, set the path in Database Runtime setup and include there the Visual Studio project file and relocate here all models or directory the environment will need at runtime.
 
15

Snapshot

15. Snapshot
Contains some promotional GUI screen shots.
Can be deleted after install to gain some space.
 
16

Sprite

16. Sprite
Contains all Sprites available to build HMI. User can modify any of them and rebuild the corresponding .lib (need of Visual Studio) and .dll (need of C++ Builder 2010 or higher).
sprites.lst lists all built-in Sprites.
sprites_user.lst lists all user-added Sprites. Use this file to add/remove your own Sprites (you will need C++ Builder 2009 or higher)
Built-in lists must not be modified as each new release/update will replace them with a new version.
17

Src

17. Src
Contains the HLA ambassador class file needed to link with the respective RTI (1.3, 1516 or Evolved)
Template directory has some template.cpp files needed as #include if used by the code.
OSG directory contains the layer vsTASKER is adding to provide some visual effect for the user (to be used from logics). SilverLining and Triton source files are also provided.
4586 directory has some glue modules for Edition 2 or Edition 3. These files are automatically built.
 
18

Tools

18. Tools
Directory used for the vsTerrainBuilder application and the USB key dongle.
Data directory contains some data samples to be loaded by vsTerrainBuilder for conversion to vsTASKER terrain map format.
UsbLic directory contains the install.exe for KeyLok dongle driver installation/removal, plus some documentation. See Licensing.
 
19

Validation

19. Validation
Contains some subroutines that are attached to a specific Dyn-UI and are called every time a change is made by the user on any of the Dyn-UI variables.
validation.lst lists all built-in validation functions.
validation_user.lst lists all user-added validation functions. Use this file to add/remove your own validation.
Built-in lists must not be modified as each new release/update will replace them with a new version.