home *** CD-ROM | disk | FTP | other *** search
/ Game Killer / Game_Killer.bin / 232.FALCNR.ZIP / FALCNR.DOC < prev    next >
Text File  |  1992-02-27  |  18KB  |  434 lines

  1.                                FALCONER
  2.                            A MANAGER PROGRAM
  3.                             FOR FALCON 3.0C
  4.  
  5.                              (Release 2.5)
  6.  
  7.                 By Rob "Orinoco" Heittman (72700,1067)
  8.                      Member Expert for Air Combat
  9.             CompuServe Flight Simulation Forum (GO FSFORUM)
  10.  
  11.                              DOCUMENTATION
  12.  
  13. IMPORTANT -----
  14.  
  15.   READ the file called README.NOW before continuing any further!
  16.  
  17. OVERVIEW -----
  18.  
  19.   Falconer is a freeware tool that lets you control every important 
  20.   aspect of your FALCON 3.0 ("F3") squadron and campaign.
  21.  
  22.   You can:
  23.  
  24.         Automatically reorganize the roster
  25.       Automatically create "super squadrons" with max abilities for
  26.           each pilot, and no fatigue
  27.         Automatically eliminate all fatigue from your squadron
  28.         Control ALL supplies and weaponry used on campaign
  29.       Edit pilot ability scores
  30.       Edit pilot rank
  31.       Edit pilot status (KIA, MIA, Active, etc.)
  32.       Export a single pilot to a file
  33.         Give or rescind any pilot's awards
  34.       Import a single pilot from a file
  35.       Print a pilot dossier
  36.       Print your Sierra Hotel sheet
  37.       Print a squadron roster
  38.       Reactivate/resurrect lost pilots
  39.         Replace any existing "pilot face" with part of a .PCX file
  40.         Replenish any planes lost in combat
  41.         Replenish ECM modules lost in combat
  42.         Replenish fuel used in combat
  43.  
  44.  
  45. INSTALLING FALCONER -----
  46.  
  47.   If you're reading this file you must have unZIPped the FALCNR.ZIP 
  48.   file already.  You must make sure that the file FALCNR.EXE is in 
  49.   your FALCON 3.0 directory (typically C:\FALCON3).  If FALCONER is 
  50.   not in your F3 directory, it will not start and display an error 
  51.   message asking you to install it correctly.
  52.  
  53.   To run FALCONER, just log to the F3 directory and type FALCNR at the 
  54.   DOS prompt.
  55.  
  56.  
  57. LOADING A SQUADRON -----
  58.  
  59.   The first thing you need is an active squadron.  If you don't 
  60.   already have one, go back to F3 and "FORM" a squadron.
  61.  
  62.   From FALCONER, select "File Open..." from the menu by pressing [ALT-
  63.   F], followed by [O].  Alternatively, you can make menu selections 
  64.   with the mouse.  (Note: where possible FALCONER uses a CUA-compliant 
  65.   interface, so it should be quite familiar to most PC users)
  66.  
  67.   FALCONER will present you with a list of available squadrons which 
  68.   you may modify.  Any squadrons which you have deleted using the 
  69.   "DEACTIVATE" option in F3 _cannot_ be recovered.  Only active 
  70.   squadrons can be modified.
  71.  
  72.   If you have more than 6 active squadrons (the release of F3 I have 
  73.   does not allow more than 6), you will only see the first 6 of them 
  74.   in the FALCONER menu.  You may not edit squadrons with a number 
  75.   higher than 6 in this release of FALCONER.
  76.  
  77.   The squadrons will be identified by name and number.  Select the 
  78.   number of the squadron you want to modify.
  79.  
  80.   The on-screen frame will fill with pilots and statistics, and the 
  81.   other menu options will be activated.
  82.  
  83.  
  84. SAVING YOUR FILE -----
  85.  
  86.   After you have made changes to your squadron, you can save the file 
  87.   back to disk by selecting "File Save..." from the menu.  If you do 
  88.   NOT select "File Save..." the squadron data will not be changed, no 
  89.   matter what you do to the on-screen representation.
  90.  
  91.  
  92. INTERACTIVE EDITING -----
  93.  
  94.   The interactive editor is started by selecting "Edit Interactive" 
  95.   from the menu [ALT-E],[I].  You may use the arrow keys to move the 
  96.   cursor around the roster, to highlight an item to edit.  You press
  97.   one of several keys to perform an action on that item or pilot.
  98.   These keys are listed at the bottom of the screen.
  99.  
  100.   Interactive editing has six functions:
  101.  
  102.   AWARDING - if you highlight any part of a pilot record and press
  103.   the [A] key, you will be presented with a dialog box where you can
  104.   give or rescind any awards that pilot possesses.
  105.  
  106.   EXPORTING - if you highlight any part of a pilot record and press 
  107.   the [X] key, you can export that pilot to a special file on disk, so 
  108.   he can be saved for later use, or "transferred" to another squadron.  
  109.   You will be prompted for a filename, which can be up to 8 
  110.   characters.  It will be given the extension .F3P -- for Falcon 3 
  111.   Pilot.
  112.  
  113.   FACE REPLACER - if you highlight any part of a pilot record and
  114.   press the [F] key, you will be able to replace that pilot's face
  115.   with part of a .PCX file.  This function is covered below in the
  116.   section "YFIF3 - Your Face in F3!"
  117.  
  118.   IMPORTING - if you highlight any part of a pilot record and press 
  119.   the [I] key, you can import a pilot from disk in that record slot.  
  120.   You will be prompted for an 8-character .F3P filename.  The .F3P 
  121.   file must already be in the F3 directory.  WARNING - the new pilot 
  122.   will be imported "over" the pilot you have highlighted.  The 
  123.   highlighted pilot will be lost permanently if you save the file to 
  124.   disk.
  125.  
  126.   CHANGING DATA
  127.  
  128.   Every field on the screen (except slot #) can be edited.  To edit a 
  129.   field, move the cursor to that field and press the [ENTER] key.  For 
  130.   text fields like NAME or CALLSIGN, or numerical fields like DGFT 
  131.   (see below for abbreviations) you will be asked to enter the new 
  132.   text in a dialog box.  For multiple-choice fields like STAT, each 
  133.   time you press the [ENTER] key, the field will toggle between its 
  134.   various states.
  135.  
  136.   VIEWING AND PRINTING DOSSIERS
  137.  
  138.   If you highlight any part of a pilot record and press the [?] key, 
  139.   you will view the complete dossier for the pilot, including their 
  140.   air-to-air and air-to-ground kills.  If you select the button <PRINT 
  141.   Dossier> (press [TAB] to move the cursor to the button, then press 
  142.   [SPACE] to select it, or select it with the mouse) you can print 
  143.   that information to the printer on LPT1:.  A printer MUST be 
  144.   connected to LPT1 and online for this option to work.  If FALCONER 
  145.   cannot access your printer, you will get an error message.
  146.  
  147.   You can exit Interactive Edit by pressing the [ESC] key.
  148.  
  149.  
  150. SETTING AVAILABLE PILOTS -----
  151.  
  152.   In addition to the individual status flags for each pilot (KIA, MIA, 
  153.   ACTIVE, etc.), F3 keeps a separate list of the number of pilots you 
  154.   currently have available.  During a campaign, KIA's and MIA's are 
  155.   pushed to the BOTTOM of your pilot roster.  If F3 says you have less 
  156.   than 30 available pilots, then the ones at the bottom of the roster 
  157.   are not shown in your Pilot Info. screen.
  158.  
  159.   To simulate this effect, FALCONER "grays out" the appropriate number 
  160.   of pilots at the bottom of the roster if you have less than 30 
  161.   active pilots.
  162.  
  163.   The "Edit Set Available Pilots..." menu option allows you to change 
  164.   this number, and make campaign mode think you have more active 
  165.   pilots than you really do.  Remember, though, just because you can 
  166.   access the pilot record, if he's KIA or MIA, he still can't fly.  
  167.   You must manually change the KIA and MIA flags for each "greyed" 
  168.   pilot that you put back on the roster by increasing the number of 
  169.   "available pilots."
  170.  
  171.   When you play around with this, you will see why I have dubbed this 
  172.   the "waterline" value.  By decreasing the Available field, you raise 
  173.   the "waterline" and more pilots are "sunk."
  174.  
  175.  
  176. AUTO-UNFATIGUE -----
  177.  
  178.   With one menu selection ("Edit Auto-Unfatigue") you can reset your 
  179.   entire squadron's fatigue scores to 100.
  180.  
  181.  
  182. AUTO-PERFECT -----
  183.  
  184.   If you want to quickly create a "super squadron" all you have to do 
  185.   is select Auto-Perfect.  All your pilots' ability scores will jump 
  186.   to 100, and all fatigue will be reset to 100.
  187.  
  188.  
  189. AUTO-ORGANIZE -----
  190.  
  191.   This performs several housekeeping functions in one fell swoop.  
  192.   First, it organizes your pilots according to the following criteria, 
  193.   in order:
  194.  
  195.       STAT (Status. Non-active pilots go to the bottom like F3 expects)
  196.       RANK (Colonel goes at the top, etc.)
  197.       NAME (Alphabetical order)
  198.  
  199.   Then it counts the number of non-active pilots and sets the 
  200.   waterline to the first non-active pilot -- just like F3 expects.
  201.  
  202.   I suggest ALWAYS using Auto-Organize after doing any squadron 
  203.   editing that involves rank or status.  I have not had any problems 
  204.   with setting the waterline to strange values, or having pilots out 
  205.   of rank order -- but you never can tell.  Also, Auto-Organize makes 
  206.   the roster a LOT easier to read.
  207.  
  208.  
  209. SQUADRON ROSTER -----
  210.  
  211.   You can print your squadron roster by selecting this menu option.  
  212.   Again, you must have a printer connected to LPT1 and active.
  213.  
  214.  
  215. SIERRA HOTEL -----
  216.  
  217.   This option prints your Sierra Hotel list.  It is based, like the one
  218.   in F3, on air to air kills alone.
  219.  
  220.   Release 2a includes a special routine that reorganizes information in
  221.   the .SQU file every time you save the file.  This routine prevents
  222.   the F3 "Sierra Hotel" display from showing erroneous information, as
  223.   is otherwise prone to happen when pilots are repeatedly resurrected.
  224.  
  225.  
  226. REPLENISH ECM -----
  227.  
  228.   If your squadron is on campaign, and you run out of ECM modules, you
  229.   can replenish the ECM modules by selecting this option.  This option
  230.   boosts the number of available ECM modules to 50.
  231.  
  232.  
  233. REPLENISH FUEL -----
  234.  
  235.   If your squadron runs out of fuel on campaign, you can replenish fuel
  236.   by selecting this option.  Boosts the amount of available fuel to
  237.   approximately 290,000 gallons.
  238.  
  239.  
  240. REPLENISH PLANES -----
  241.  
  242.   If your squadron is on campaign, and you are low on available planes,
  243.   you can replenish the planes using this option.  Also, if you want to
  244.   give yourself a challenge by _reducing_ the number of available
  245.   planes... you can use this option to do it.
  246.  
  247.   Enter a number of planes between 1 and 18.  If you attempt to use this
  248.   option on a squadron which is not active on campaign, you will receive
  249.   an error message.
  250.  
  251.  
  252. SUPPLY MANAGEMENT -----
  253.  
  254.   All other resources on campaign (weapons) can be controlled using this
  255.   function.  Your supply manifest will be shown.
  256.  
  257.   In the edit box provided, type in a new quantity you would like to
  258.   apply to the various weapons on the manifest.  To apply that quantity
  259.   to any weapon, either move the cursor to it using [TAB] and then
  260.   press [SPACE], or click on that weapon with the mouse.
  261.  
  262.  
  263. "YFIF3" - YOUR FACE IN F3! -----
  264.  
  265.   Version 2.5 of Falconer incorporates a new code module called YFIF3,
  266.   short for "Your Face in F3."  If you have a scanned photo of yourself
  267.   (or anyone else), in .PCX format and at the appropriate size, you
  268.   can replace one of the existing pilot faces with a cut-out from that
  269.   .PCX file!  The "correct" picture will then appear for you when you
  270.   fly in F3.
  271.  
  272.   IMPORTANT NOTE:  There is only one file that contains all 50 pilot
  273.   pictures, called PILOT.BIN.  Changes that Falconer makes to this
  274.   file are PERMANENT.  The first time you run Falconer 2.5, it will
  275.   make a copy of PILOT.BIN in PILOT.ABK.  If you need the stock faces
  276.   back for any reason, you may copy PILOT.ABK back over PILOT.BIN.
  277.   This method is inelegant and will be remedied in Falconer release 3,
  278.   but right now, it's the best I can do without waiting for further
  279.   testing.
  280.  
  281.   Select your pilot in INTERACTIVE mode, and press [F] to get to the
  282.   face editor.  You will first be asked to confirm the face to replace.
  283.   If you want to overwrite a different face, you may choose a different
  284.   face number, from 1 to 50.  If you do this, you will have to go back
  285.   into F3 to associate the new, replaced face with your pilot using the
  286.   "SELECT FACE" button.
  287.  
  288.   You will be asked for a .PCX filename.  The .PCX file must be 256
  289.   color, version 3-compatible, and preferably smaller than the 320x200
  290.   screen space (though this is not strictly necessary).  You will get
  291.   an error message or garbage on screen if you attempt to use a different
  292.   format of .PCX file.  The file should be in your Falcon 3 directory.
  293.  
  294.   If you are having format problems, the shareware program WINGIF does
  295.   an excellent job of converting other formats to .PCX and sizing them
  296.   appropriately.  Also, Windows 3.0 Paintbrush 256 color .PCX files are
  297.   compatible with FALCONER.  If you have a scanner program that runs
  298.   under Windows, try pasting to Paintbrush and saving as a .PCX file.
  299.  
  300.   You will be asked whether to use [A]rithmetic or [G]eometric palette
  301.   matching.  FALCONER must take the broad 256 color palette of your
  302.   picture, and try to mash it down into the narrow band of flesh tones
  303.   in the Falcon 3.0 palette.  The [A]rithmetic method is faster, and
  304.   weights all deviations in color equally.  The [G]eometric method
  305.   is slower, and prefers deviations in overall brightness to deviations
  306.   in hue.  Both may yield similar results, or either one may be markedly
  307.   better.  It depends on your original picture.  Experiment!
  308.  
  309.   NOTE:  When your picture is displayed, you may see bright "STARS" of
  310.   white at various points.  This is because Falconer keeps one attribute
  311.   to itself to display "white" text on-screen.  Don't worry about the
  312.   "stars", they are only a display problem, and won't be saved in the
  313.   final picture.
  314.  
  315.   When the picture is displayed and the palette matched, you can select
  316.   the region to clip by moving the small black box with the arrow keys.
  317.   Press [ENTER] to confirm the region you want.  You will be reminded
  318.   that the change to PILOT.BIN is permanent, and asked to confirm the
  319.   face save operation.  If you don't like the results so far, this is
  320.   the time to bail out!  If you press [Y] the new face will be stored
  321.   permanently in PILOT.BIN.
  322.  
  323.   Tips for best results: use pictures with high contrast and a broad
  324.   band of flesh tones in the source palette.  What that means is: the
  325.   better the source scan, the better the results, basically!
  326.  
  327.  
  328. CAUTIONARY NOTICES AND LEGAL MUMBO JUMBO -----
  329.  
  330.   This program is freeware.  It may be copied freely and distributed 
  331.   as long as it is not modified in any way, and this documentation 
  332.   file is packaged with the executable program.
  333.  
  334.   No guarantees are made as to the compatibility of this program with 
  335.   Falcon 3.0c.  It has been tested thoroughly, however, remember that
  336.   the purpose of this program is to allow you to modify data that 
  337.   Falcon 3.0c does not want modified!  A combination of changes you
  338.   engineer via this program could conceivably destabilize a F3 
  339.   campaign and thence the program, though I believe it is highly 
  340.   unlikely.  It is also possible that future upgrades of F3 may be 
  341.   incompatible with this program.
  342.  
  343.   But read this carefully and understand it:
  344.  
  345.   THIS PROGRAM ALTERS FALCON 3.0c DATA.  ANY DAMAGE TO YOUR SYSTEM OR
  346.   FILES, EITHER DIRECT, INCIDENTAL, OR CONSEQUENTIAL, WILL NOT BE THE 
  347.   RESPONSIBILITY OF THE AUTHOR OF "FALCONER."  ADDITIONALLY, NO 
  348.   GUARANTEES ARE MADE CONCERNING SUPPORT OF THIS SOFTWARE.
  349.  
  350.  
  351. SUPPORT ANYWAY -----
  352.  
  353.   At the present, I am available to support this file via the Flight 
  354.   Simulation Forum on Compuserve (GO FSFORUM).  Leave a message in 
  355.   section 8, Modern Air Combat, if you have questions, comments, or 
  356.   suggestions about this program, or would like to solicit help with a 
  357.   problem.
  358.  
  359.  
  360. ABBREVIATIONS USED IN THE SCREEN AND PRINTED ROSTERS -----
  361.  
  362.   DGFT    =    Dogfighting Skill
  363.   BOMB    =    Bombing Accuracy
  364.   FLYG    =    Flying Skill
  365.   FATG    =     Fatigue
  366.   RANK    =    Rank
  367.    COL    =    Colonel
  368.    LTC    =     Lt. Colonel
  369.    MAJ    =    Major
  370.    CAPT    =    Captain
  371.    LT    =    Lieutenant
  372.   STAT    =    Pilot Status
  373.    ACTV    =    Active
  374.    KIA    =    Killed in Action
  375.    MIA    =     Missing in Action
  376.    INJ    =    Injured
  377.    C.M.    =    Court-Martialled
  378.    RET    =    Retired
  379.  
  380.  
  381. ADDITIONAL ABBREVIATIONS IN THE PRINTED ROSTER -----
  382.  
  383.   SORT    =    Sorties Flown
  384.   ATAK    =    Air To Air Kills (total)
  385.   ATGK    =    Air To Ground Kills (total)
  386.  
  387.  
  388. AWARD ABBREVIATIONS -----
  389.  
  390.   MOH   =       Medal Of Honor
  391.   AFC   =       Air Force Cross
  392.   SS    =       Silver Star
  393.   FC    =       Flying Cross
  394.   BS    =       Bronze Star
  395.   AM    =       Air Medal
  396.   PH    =       Purple Heart
  397.  
  398.  
  399. RELEASE HISTORY -----
  400.  
  401.   Release 1 --- provided for editing of pilot abilities and fatigue only.
  402.  
  403.   Release 2 --- enhanced and redesigned version with export, import, and
  404.                 printing features, as well as pilot resurrection and
  405.                 waterline adjustment.  Uploaded to CIS for a brief
  406.                 period... few if any copies in existence.
  407.  
  408.   Release 2a -- stabilized Sierra Hotel system, added plane replenisher
  409.                 feature based on FSFORUM input prior to the LIB inclusion
  410.                 of Release 2.  Only one copy made, for Steve "Auger"
  411.                 Edwards of FSFORUM.
  412.  
  413.   Release 2b -- included award grant/rescind system at the request of
  414.                 Steve Edwards.  Uploaded to CIS.
  415.  
  416.   Release 2.5 - necessary because of new .CAM file structure in Falcon
  417.                 3.0c, incompatible with previous versions.  Incorporates
  418.                 basic SMS/YFIF3 functions.
  419.  
  420.  
  421. ENDNOTES -----
  422.  
  423.   Did you read the README.NOW file?  You really should, if you haven't!
  424.  
  425.   If you are getting this file from a BBS somewhere or another online
  426.   service --- please, drop in on FSFORUM, you don't know what you're
  427.   missing.  Give me a buzz in area 8.  Internet fiends, you can of course
  428.   reach me at 72700.1067@compuserve.com.
  429.  
  430.   Good luck, god speed, and for heaven's sake CHECK SIX!
  431.  
  432.                                          - Rob Heittman [FSFORUM]
  433.  
  434.