Airfix DogFighter Programmer's Manual

The Briefing File

The Briefing-file contains the information needed to fly a particular Mission. This includes the text for the Briefing Outline, the Primary Objective, the Secondary Objective and the Briefing Text itself. Apart from that, it contains a list of available aircraft and the suggested Default Aircraft for the Mission.

When you progress through a Campaign with a newly enlisted Pilot all info for the new Mission will be taken from the same Briefing-file. If you decide,however, to re-play one of the earlier Missions in the Campaign, the Text of the Briefingfile for that Mission will be used, but the Aircraft Selection will be taken from the Briefingfile of the Mission you have yet to complete. See also Chapter 4 in the UPX-page.


General Layout

The general structure of the Briefing File is as follows: (e.g. Allied Briefing 9)

BRIF D7 03 00 00

FileType Identifier and Total Length (hex 03 D7)

NAME 0C 00 00 00 Sub Station 00 

Name Section Identifier, Length, Mission Name, closing NULL

OUTL 5D 01 00 00 outline text 00 

Outline Section Identifier, Length, Outline Text and closing NULL

TEXT 54 01 00 00 briefing text 00 

Text Section Identifier, Length, Briefing Text and closing NULL

PRIM 5A 00 00 00 text 00 

Primary Objective Section Identifier, Length, Text and closing NULL

SCND 52 00 00 00 text 00 

Secondary Objective Section Identifier, Length, Text and closing NULL

AIRS 2E 00 00 00 Aircraft List 00 

Aircraft Section Identifier, Length, Aircraft List and closing NULL

SELA 08 00 00 00 AcMe262 00 

Default Section Identifier, Length, Selected (Default) Aircraft and closing NULL


The AIRS- and SELA- Sections in this example look like this:
41 49 52 53 2E 00 00 00 41 63 46 77 31 39 30 0D
0A 41 63 46 69 61 74 47 35 30 0D 0A 41 63 42 66
31 30 39 0D 0A 41 63 53 74 75 6B 61 0D 0A 41 63
4D 65 32 36 32 00 53 45 4C 41 08 00 00 00 41 63
4D 65 32 36 32 00
sp AIRS.... AcFw190.
.AcFiatG50..AcBf
109..AcStuka..Ac
Me262.
SELA.... Ac
Me262.
Note that the names of the aircraft are separated by 0D 0A.
These names are references to the Object Files in the folder Game\Objects\AirCrafts.

Hyperlinks

Most of the Briefing files in the original game have the layout as described above. There is one exception however, and that is Axis3.brf. This briefing file contains a second page in the Outline-section, and has as header OUT2. When this Section is encountered by the Game Engine, it automatically displays hyperlink-style buttons on the Outline-pages: On the first page a link to 'Next Page', and on Page 2 there's one for 'Previous Page'.

In the Briefing-screen you will notice an area with photographs.
The image-files for these pictures are in the GTI-format and are kept in the folder: Graphics\Frontend\MissionBriefing.
To include one (or more) of these pictures in the briefing, you need to specify the name with an IMG-tag, for example:

<img 'unit_factory'> German Factories</img> will show a picture of the Steam Engine with the text German Factories underlined in blue.