Home
Main Features
User Manual
Screenshots
Downloads
How to buy
Updates
Add-on boats
Add-on scenery
Add-on Library
Tools
Boat design
Scenery design
VS forum
User survey
Links
Mirror
Instrument panels
Boat data structure | Boat design sample | Instrument panels | Weapons


The instrument panels are used by all the boats in Virtual Sailor, each boat configuration file specifies a panel name and a position in which to place this panel.

The panel itself is made of a panel frame and a collection of instruments which are placed in this panel frame.

The panels directory inside the Virtual Sailor directory contains the available panels, each panel is placed inside a directory inside the Virtual Sailor\panels directory.

Inside each panel directory are the following files:

The Panel.cfg file

This file contains the name and positions of all the instruments in the panel, and a short description for it.

The structure of the panel.cfg file is as follows:

8 [instruments]

speed_1 [name]
-3.2 [xpos]
0.0 [ypos]
0.0 [zpos]
1.0 [scale]

dgstrip_1 [name]
-2.0 [xpos]
0.0 [ypos]
0.0 [zpos]
0.8 [scale]

rpm_1 [name]
-0.35 [xpos]
0.0 [ypos]
0.0 [zpos]
1.0 [scale]

fuel_1 [name]
0.7 [xpos]
0.0 [ypos]
0.0 [zpos]
1.0 [scale]

throt_1 [name]
1.4 [xpos]
-0.1 [ypos]
0.0 [zpos]
1.5 [scale]


autop_1 [name]
-1.1 [xpos]
0.0 [ypos]
0.0 [zpos]
0.8 [scale]


dggps [name]
3.2 [xpos]
-0.3 [ypos]
-0.3 [zpos]
1.0 [scale]
-0.5 [alfa]


dgradar [name]
0.7 [xpos]
-3.0 [ypos]
-0.6 [zpos]
1.5 [scale]
-0.5 [alfa]
0.5 [beta]
-0.3 [gama]

@
Basic panel

Explanation:


This file is composed of two sections:

1.the panel data:

instruments - number of instruments in the panel
instrument - name of instrument to be used ( repeated for each instrument )
xpos - the x position of the instrument ( repeated for each instrument )
ypos - the y position of the instrument ( repeated for each instrument )
zpos - the z position of the instrument ( repeated for each instrument )
scale - a scale factor for the instrument ( repeated for each instrument )
alfa - angle of pitch of the instrument in radians.
beta - angle of yaw of instrument in radians.
gama - angle of roll of instrument in radians.

2. The panel description :

this part is a simple text only section that must begin with @ and ends at the file end.

This picture shows the above panel.

Panel.x

This is an optional model file for the panel without the instruments.

This is a simple one frame hirarchy mesh file, it can be created by converting a 3DS file into an X file by using the command "conv3ds -m [filename.3ds]" , conv3ds.exe is a small freeware converter written by Microsoft.

Download source files and conv3ds

The Instruments:

The instrument panels configuration file contains names and positions of instruments that are placed into them.

Each instrument is made of an instrument frame and a collection of needles which are placed in this instrument frame, instrument name must contain the type of the instrument.

Instruments can only be of the following types:


"dgmap"            // dialog instruments
"dggps" 
"dgradar" 
"dgecho" 

"dgcomp"          // digital instruments
"dgspeed" 
"dgrpm1" 
"dgrpm2" 
"dgrpm" 
"dgfuel" 
"dgdepth" 
"dgclock" 
"dghoriz" 
"dgwind"
"dgsink" 
"dgballast" 
"dgflow"
"dgstrip"

"hcomp"            // analog instruments
"speed" 
"rpm1" 
"rpm2" 
"rpm" 
"fuel" 
"depth" 
"sink" 
"ballast" 
"flow" 
"comp" 
"clock" 
"horiz" 
"wind" 
"throt1" 
"throt2" 
"throt" 
"ball" 
"sailb" 
"sails" 
"dive" 
"autop" 
"autos" 
"lockb" 
"locks" 
"lockp" 
"winchb" 
"winchs" 
"wheel" 
"anchor" 
"dock" 
"rudder" 
"thrust1" 
"thrust2" 
"hand" 
"lights" 
"bridge" 

The instruments directory inside the Virtual Sailor directory contains the available instruments, each instrument is placed inside a directory inside the Virtual Sailor\instruments directory.

Inside each instrument directory are the following files:

The Instrument.cfg file

This file contains the name and positions of all the needles in the instrument, and a short description for it.

The structure of the panel.cfg file is as follows:

1 [needles]
0.0 [xpos]
-0.185 [ypos]
0.0 [zpos]
1.0 [scale]
5.555 [x0]
50.0 [x1]
1.998 [y0]
-1.963 [y1]
@
A simple air speed indicator

Explanation:


This file is composed of two sections:

1.the instrument data:

needles - the number of needles in the instrument
xpos - the x position of the instrument back
ypos - the y position of the instrument back
zpos - the z position of the instrument back
scale - a scale factor for the instrument back
instruments - number of instruments in the panel
x0 - the minimal measured value ( repeated for each instrument )
x1 - the maximal measured value ( repeated for each instrument )
y0 - the minimal needle angle ( radian ) ( repeated for each instrument )
y1 - the maximal needle angle ( radian ) ( repeated for each instrument )

2. The instrument description :

this part is a simple text only section that must begin with @ and endes at the file end.

 

The Dial.x file

This is the main model file for the instrument without the needles.

This is a simple one frame hirarchy mesh file, it can be created by converting a 3DS file into an X file by using the command "conv3ds -m [filename.3ds]" , conv3ds.exe is a small freeware converter written by Microsoft.

The Needle.x file

This is the 3D model file for one of the instrument needles, for each needle a different model must be created and named as needle0.x, needle1.x , needle2.x etc..

This is a simple one frame hirarchy mesh file, it can be created by converting a 3DS file into an X file by using the command "conv3ds -m [filename.3ds]" , conv3ds.exe is a small freeware converter written by Microsoft.

Download source files and conv3ds



Copyright Ilan Papini 1999 - 2017
All Right Reserved