Bridge Command - Ship Models

Introduction

There are two classes of other ship models that can be defined in Bridge Command. These are 'own ships' and 'other ships.' Ownships are models that have their full dynamics modelled, and are for use as the user's own ship. 'Other ships' are used to model all other ships in the environment. For details of what you can do with these, and how to load them in scenarios, please see the Scenario specification and the Scenario writer.

The most fundamental part of any ship model to load in Bridge Command is the 3D model itself. This can be in DirectX (.x) or 3DS Max format (.3ds). With this, the text file boat.ini is used to define the other characteristics of the model. The specification of this file is detailed below, but for a general introduction to the .ini file format used by Bridge Command, please read the .ini file format.

Each vessel is contained in a folder, with the vessel's name, under Models\Othership or Models\Ownship as appropriate. So if Bridge Command is installed in its default location, an own ship model called 'Protis' would be at 'C:\Program Files\Bridge Command 5.0\models\Ownship\Protis'. Bridge Command also looks in the user directory (%appdata%/Bridge Command/5.0 on Windows, ~/.Bridge Command/5.0 on Linux and ~/Library/Application Support/Bridge Command/5.0 on OSX), so users can add new ship models without needing to be able to make changes in the installation directory.

Sections

Own ships

The 3D model to load, and all of the characteristics of the own ship model are defined in the file Boat.ini in the model's folder. In addition, a file Radar.ini sets up the parameters for the radar. A complete example of both files is given below, and the effect of each line is explained below this:

Boat.ini


FileName="boat.x"

ScaleFactor=0.3

YCorrection=-3

AngleCorrection=0



Depth=3.0



Views=3



ViewX(1)=-0.3

ViewY(1)=15.74

ViewZ(1)=-6.0



ViewX(2)=9.4

ViewY(2)=16.0

ViewZ(2)=-9.8



ViewX(3)=-9.4

ViewY(3)=16.0

ViewZ(3)=-9.8



Max_propulsion_force=3000

AsternEfficiency=0.667

Mass=5000



MaxRevs=2500



DynamicsSpeedA=18.71

DynamicsSpeedB=100



PropSpace=2.0

DynamicsTurnDragA=180000

DynamicsTurnDragB=12000

DynamicsLateralDragA=187.1

DynamicsLateralDragB=1000

Inertia=120000

RudderA=5

RudderB=0.05

RudderBAstern=0

RudderAngularVelocity=10



BowThrusterForce=2000

SternThrusterForce=2000

BowThrusterDistance=3.0

SternThrusterDistance=2.5



Buffet=3.0

Swell=1.0

RollPeriod=8

PitchPeriod=12



Radar.ini

If no radar.ini file is present in the vessel's ownship folder, defaults will be used for all of the Radar's parameters.


NumberOfRadarRanges=6

RadarRange(1) = 12

RadarRange(2) = 6

RadarRange(3) = 3

RadarRange(4) = 2

RadarRange(5) = 1

RadarRange(6) = 0.5



radar_sensitivity=3.0

radar_range_sensitivity=5.0

radar_height=10

radar_noise=0.000000000005

radar_sea_clutter=0.000000001

radar_rain_clutter=0.00001



Other ships

The 3D model to load, and all of the characteristics of the own ship model are defined in the file Boat.ini in the model's folder. A complete example is given below, and the effect of each line is explained below this:


FileName="boat.x"

ScaleFactor=0.3038

YCorrection=-17

SolidHeight=45

AngleCorrection=0



NumberOfLights=5



LightX(1)=26.4

LightY(1)=59.2

LightZ(1)=105.4

LightRange(1)=6

LightRed(1)=0

LightGreen(1)=255

LightBlue(1)=0

LightStartAngle(1)=-1

LightEndAngle(1)=112.5



LightX(2)=-26.2

LightY(2)=59.2

LightZ(2)=105.4

LightRange(2)=6

LightRed(2)=255

LightGreen(2)=0

LightBlue(2)=0

LightStartAngle(2)=247.5

LightEndAngle(2)=361



LightX(3)=0

LightY(3)=103.3

LightZ(3)=93.3

LightRange(3)=6

LightRed(3)=255

LightGreen(3)=255

LightBlue(3)=255

LightStartAngle(3)=247.5

LightEndAngle(3)=472.5



LightX(4)=0

LightY(4)=35.1

LightZ(4)=-171.6

LightRange(4)=6

LightRed(4)=255

LightGreen(4)=255

LightBlue(4)=255

LightStartAngle(4)=112.5

LightEndAngle(4)=247.5



LightX(5)=0

LightY(5)=116

LightZ(5)=6.6

LightRange(5)=6

LightRed(5)=255

LightGreen(5)=255

LightBlue(5)=255

LightStartAngle(5)=247.5

LightEndAngle(5)=472.5