Red Baron 3D
Optional Gunsights - Readme File 
10/01/98

*********************************************

To view this document in Notepad with correct formatting, select the Edit menu above and enable Word Wrap.

This document contains information on how to add a gunsight to your Forward Lockdown cockpit views, for all planes.  The custom gunsight will be displayed in Forward, Forward Up, and Forward Down Lockdown views.  The gunsight will be drawn in red so that it can be seen at night.

*********************************************


OVERVIEW
--------

A gunsight will be displayed in the Forward Lockdown views by defining its shape--through a number of line segments--in a configuration file called RB2SIGHT.INF (instructions provided below), and placing the file in the RedBaron3d\Data folder.  (If you ever want to remove the gunsight from these views, either delete the RB2SIGHT.INF file, rename it, or move it to another folder.) 


CREATING THE CONFIGURATION FILE (RB2SIGHT.INF)
----------------------------------------------

Once you've designed your gunsight (in your head, on paper, etc.), define the gunsight as follows:

STEP 1:  Consider the point on the screen at which the bullets converge to be the origin (0,0) of the x,y plane.

STEP 2:  Create a configuration (text) file called RB2SIGHT.INF in the RedBaron3d\Data folder.

STEP 3:  On the first line of the configuration file, list the number of line segments that will be used in the gunsight.

STEP 4:  Using a separate line in the configuration file for each line segment of the gunsight, list the (x,y) coordinates of both endpoints of the line segments, separated by commas (there are four numbers:  the first two are the coordinates of one endpoint; the second two, the other).  The x and y values represent the distance--in pixels--from the origin.  (For example, -10,0,10,0 represents a line segment 20 pixels in length along the x-axis, with one endpoint at (-10,0)--ten pixels left of the origin--and the other endpoint at (10,0)--ten pixels right of the origin.)


EXAMPLE
-------

The following example represents the contents of the RB2SIGHT.INF file for a simple cross as the gunsight.  The cross consists of two line segments, both 20 pixels in length, that intersect at the origin (the point at which the bullets converge).  Each line below contains an explanation of the contents of that line; these comments are NOT supported in the real RB2SIGHT.INF file.


2              // This gunsight will consist of two lines, defined below
-10,0,10,0     // A line segment on the x-axis with endpoints of (-10,0) and (10,0)
0,10,0,-10     // A line segment on the y-axis with endpoints of (0,10) and (0,-10)


For your convenience, the example above has been saved in a file called CROSS.INF in the RedBaron3d\Data folder.  If you would like to use this cross as your custom gunsight, simply rename the file to RB2SIGHT.INF.


Copyright/Trademarks

(c) 1998 Sierra On-Line, Inc. (R) and (TM) designate trademarks of, 
or licensed to Sierra On-Line, Inc.  All rights reserved.





