home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / F3MAPSD.ZIP / F3MAPS.DOC next >
Text File  |  1992-05-16  |  20KB  |  436 lines
  1.  
  2.              ***********************************************
  3.              *                FALCON MAPPER                *
  4.              *                                             *
  5.              *       A UTILITY PROGRAM FOR FALCON 3.0D     *
  6.              ***********************************************
  7.  
  8.                              (Release 3.1D)
  9.                            Copyright May 1992
  10.                        
  11.                        By Greg Prete [70720,2566]
  12.             CompuServe Flight Simulation Forum (GO FSFORUM)
  13.         
  14.                              DOCUMENTATION
  15.  
  16.  
  17. IMPORTANT
  18. ---------
  19.   READ the file called README.F3M before continuing any further!  This file
  20.   contains important information concerning new features.
  21.  
  22.  
  23. OVERVIEW:
  24. ---------
  25.   Falcon Mapper is a freeware tool that allows you to painlessly modify 
  26. FALCON3.EXE (version 3.0D only) and change the geographical locations for
  27. Instant Action (IA) and Red Flag (RF) modes to any part of the Falcon world.
  28.  
  29.   You can:
  30.      Quickly and easily change either the IA or RF modes to reference any 
  31.      one of the theaters currently defined for Falcon 3.0:
  32.  
  33.                    KUWAIT,
  34.                    ISRAEL,
  35.                    PANAMA or
  36.                    NELLIS
  37.  
  38.      Practice dissimilar A/C missions using Red Flag, but do it in the
  39.      same area you are currently campaigning in!!  
  40.  
  41.      Change the Instant Action theater location WITHOUT copying ANY map 
  42.      files, for more exciting modem or Network play.
  43.  
  44.      Do all this, and at the same time, run as many campaigns as you want,
  45.      in any theater!  F3MAPS *ONLY* modifies the FALCON3.EXE program
  46.      file, NOT the map files!!
  47.  
  48.  
  49.   OTHER PROGRAM UTILITY OPTIONS      
  50.   -----------------------------
  51.      Use the "Run Falconer" option to shell out to Falconer and then
  52.      back to Falcon Mapper for total Falcon-control!
  53.  
  54.      Use the "Decode Red Flag Mission" option to load any Red Flag Falcon
  55.      mission, and view all the information on Allied/Enemy flights,
  56.      aircraft armament loading, ground forces, waypoints, etc.
  57.  
  58.      
  59.   ***>>  New Utility options for version 3.1D  <<***
  60.      
  61.      New for version 3.1D is the "Auto-Generate" Red Flag Mission option.
  62.      One thing's for sure, you'll get into some NASTY furballs with this one,
  63.      as it will generate Red Flag Missions impossible to create using 
  64.      SpecHolo's mission editor!!
  65.  
  66.      Eliminate the dreaded ILS view-shift feature with the "ILS View Shift"
  67.      option!!  Thanks to my friends Steve Kramp and Rich Michta at Grumman 
  68.      for their tireless lunch-hour (well, *extended* lunch-hour) efforts to 
  69.      find the assembler code for the "view-shift" routine and nuke it!!
  70.  
  71.      Customize the F-16 HUD to suit YOUR preferences.
  72.  
  73.      Change the default magnification scale from "2X" to any of the other
  74.      legal scales (1,2,4 and 8) and have it STAY THAT WAY.  No more going
  75.      back to the menus between missions!  Once again, thanks go to Steve
  76.      Kramp for hacking the code for this option.
  77.  
  78.   
  79.   WOW, this sounds neat!
  80.  
  81.  
  82. INSTALLING FALCON MAPPER 
  83. ------------------------
  84.   If you're reading this file you must have unZIPped the F3MAPS.ZIP 
  85.   file already.  You should make sure that the file F3MAPS.EXE is in 
  86.   your FALCON 3.0 directory (typically C:\FALCON3).  If F3MAPS is 
  87.   not in your F3 directory, it will report an error saying it can't find 
  88.   the FALCON3.EXE file, and ask that you run F3MAPS from your Falcon
  89.   directory.
  90.  
  91.   Although the effects of F3MAPS on FALCON3.EXE are reversible by simply
  92.   re-running the program, making a backup copy of your original .EXE
  93.   file WOULD BE A VERY GOOD IDEA. <Ahem!>
  94.  
  95.         * IMPORTANT *        * IMPORTANT *       * IMPORTANT *
  96.  
  97.   Falcon Mapper will check your FALCON3.EXE file to make sure it is
  98.   version 3.0D, and will NOT run unless it finds version D.  Still.....
  99.   Please, Please, Please BACK UP your FALCON3.EXE file before running
  100.   Falcon Mapper!!!
  101.   
  102.   To check if you have 3.0D, you either know already, since you downloaded
  103.   the patch from GAMPUB, or you can check the file size - it should be 
  104.   1244898 bytes.
  105.   
  106.   If you don't have 3.0D, now is the time to get it!!! 
  107.  
  108.  
  109. RUNNING FALCON MAPPER      
  110. ---------------------
  111.   To run FALCON MAPPER, just log to the F3 directory and type F3MAPS at 
  112.   the DOS prompt.
  113.  
  114.   Note:  Falcon Mapper version 3.1D uses a CUA-compliant interface, so
  115.   it should be familiar to most PC-users.
  116.  
  117.   After running F3MAPS, Falcon Mapper presents an "About" dialog box.
  118.   Click on OK, hit escape, or Enter to clear this box.
  119.  
  120.  
  121. FROM THE MAIN MENU BAR, YOU CAN:
  122. --------------------------------
  123.   I.  Run Rob 'Orinoco' Heittman's Falconer program
  124.          
  125.       Selecting this menu option will bring you to Falconer, if the 
  126.       FALCNR.EXE file is in your FALCON directory.  Run Falconer just
  127.       as you did before.  Exiting Falconer will return you to Falcon
  128.       Mapper.
  129.   
  130.  
  131.  II.  View a text file 
  132.      
  133.       This option was added at the request of FSFORUM members who wanted
  134.       a means of viewing their own Red Flag mission texts along side of the
  135.       summaries produced by the "Decode Red Flag Mission" option in F3MAPS.
  136.       It will allow you to view any ordinary text file (including the .SUM
  137.       files) in a text window.
  138.  
  139.  
  140. III.  Change directory  
  141.  
  142.       All this does is let you change the default directory where F3MAPS
  143.       reads, writes and generates all of its files (except FALCON3.EXE).
  144.       Use this option if you have another utilities directory where you keep
  145.       Red Flag Missions or summaries.  In order for F3MAPS to begin executing,
  146.       the current directory must be the one where FACLON3.EXE is.  After
  147.       F3MAPS has started, however, you can change the directory to any valid
  148.       directory on any drive in your system.  If, after you change the 
  149.       directory, you attempt to run one of the utility options which is
  150.       looking for FALCON3.EXE, the program will request that you change the
  151.       directory back to the original FALCON3 directory.  F3MAPS will refuse
  152.       to patch any other copy of FALCON3.EXE that you may have laying around 
  153.       in another directory - it will ONLY patch the copy that was present in
  154.       the current directory at startup time.  
  155.  
  156.  
  157.  IV.  Select Falcon Mapper
  158.       
  159.       After selecting Falcon Mapper, a screen is presented containing the
  160.       current locations for the IA and RF modes present in FALCON3.EXE,
  161.       as well as a list of all possible theaters.  In addition, the file 
  162.       extension for Red Flag Missions (initially ".RFM") is displayed.
  163.  
  164.       To change the theater locations for either Instant Action or Red Flag  
  165.       modes, simply click the mouse on the text for the desired theater or
  166.       "TAB" to the correct box, then use the arrow keys to highlight your 
  167.       choice.
  168.  
  169.       When you are satisfied with your choices, click "Write changes" and
  170.       Falcon Mapper will update your copy of FALCON3.EXE.  To quit without
  171.       updating, simply select the eXit button or press escape.
  172.  
  173.       When you change the Red Flag theater location, FALCON3.EXE is patched
  174.       so that it will only recognize Red Flag missions with the file 
  175.       extension that goes with that particular theater, as follows:
  176.  
  177.          RED FLAG THEATER                    MISSION FILE EXTENSION
  178.          ----------------                    ----------------------
  179.              KUWAIT                                  .KFM
  180.              ISRAEL                                  .IFM
  181.              PANAMA                                  .PFM
  182.              NELLIS                                  .RFM
  183.  
  184.       This allows the Falcon pilot to create separate Red Flag missions that
  185.       are specific to one theater in particular.  (Thanks to FSFORUM member
  186.       Craig Allen for this idea, and the MANY of you who seconded his 
  187.       motion).
  188.  
  189.       Now run Falcon 3.0 the way you always have.  Same old program, only
  190.       now the IA and/or RF modes are the ones YOU specified, not the ones
  191.       Spectrum Holobyte wanted!  What a feeling of power!
  192.  
  193.       NOTE:  Changing the Red Flag location also effects the "Auto-Generate
  194.              Red Flag Mission" option.  Auto-Generate will create missions
  195.              with file extensions specific to the CURRENT Red Flag Theater,
  196.              as outlined in the above table.  To change the extension used
  197.              for the Auto-Generate option you must run Falcon Mapper to
  198.              change the actual theater location.
  199.  
  200.  
  201.   V.  Auto-Generate Red Flag Mission
  202.  
  203.       I don't know about any of you, but I quickly grew tired of the canned
  204.       "LESSONXX" missions that came with Falcon 3.0.  Soon after I bought
  205.       the sim, I began experimenting with Red Flag mode, creating my own
  206.       missions.  I have to admit, they were better than the canned ones,
  207.       but this also got tiring after a while.  I mean, you had to spend
  208.       quite a long time pecking away at the keyboard before you could sit
  209.       down and enjoy a mission.
  210.  
  211.       I wanted a way to randomly generate a "surprise" mission, with
  212.       completely unknown parameters.  I also hoped there was a way to bypass
  213.       certain annoying limitations in Spectrum Holobyte's mission generator
  214.       like "max number of airplanes=8" across an allied or enemy group of
  215.       flights.  Without going into all of the gory details (which would
  216.       ruin the fun anyway), suffice it to say that "Auto-Gen" accomplishes 
  217.       these goals, and generates missions with as many parameters randomized 
  218.       as possible while retaining logic which guarantees they will still make 
  219.       some sense and be FUN!!!
  220.  
  221.  
  222.       HERE'S THE NOT-TOO SPECIFICS
  223.       
  224.       You'll always be leading a flight consisting of yourself and two
  225.       wingmen flying F-16's.  Each of you will be given a general-purpose
  226.       combat load consisting of an ALQ-131 ECM pod, 2 AIM-9M sidewinder
  227.       missiles, 2 AIM-120 AMRAAMS, 2 AGM-65D Maverick air-to-ground missiles,
  228.       and 12 MK-82 500 lb. bombs.  Feel free to alter this armament if you
  229.       want to.  That's about all I can tell you.  Really, I don't even know
  230.       what all of the possibilities are.  Probably infinite.  I *can* tell 
  231.       you that any other allied flights will be somewhere in your vicinity,
  232.       flying in the general area you are, with any and all sorts of aircraft
  233.       carrying any and all sorts of armament loadings.  Watch out for enemies,
  234.       cause they're CERTAIN to cross your path at some time during the
  235.       mission!  Enemy and Allied ground forces may also be present in vary-
  236.       ing degrees of concentration within 5 miles of one of your waypoints.
  237.       Watch for them!  Remember, they could be allied or enemy and they MIGHT
  238.       be carrying SAMS.  DON'T BOMB YOUR ALLIES!!!!
  239.  
  240.       In addition, your flight will always begin in the air, and you will
  241.       never have a LAND or LOITER waypoint.  Just the fun stuff!!  
  242.       
  243.       Missions will be generated for the Red Flag Theater currently defined
  244.       by the Falcon Mapper portion of F3MAPS.  They will be titled with the
  245.       theater name (ISRAEL, PANAMA, KUWAIT, NELLIS) and a number.  For  
  246.       example, if you currently have KUWAIT defined as your Red Flag area,
  247.       the first time you "Auto-Generate", a mission will be created called
  248.       KUWAIT1.KFM.  The next will be KUWAIT2.KFM, etc.  If KUWAIT1 and
  249.       KUWAIT2 already existed, the first mission would be called KUWAIT3.KFM.
  250.       If you now want to generate NELLIS missions, select Falcon Mapper from
  251.       the main menu bar, and change the Red Flag theater to NELLIS.  Now,
  252.       Auto-Generate again, and you will have "NELLIS1.RFM".  In addition to
  253.       actually creating the mission file, Auto-Gen will also create a .SUM
  254.       file, just as if you created the mission yourself and "Decoded" it with 
  255.       the Decode Red Flag Mission option.
  256.  
  257.       NOTE ABOUT PANAMA MISSIONS
  258.  
  259.       I have to say, Panama was an annoying theater to create missions for.
  260.       If you happen to get a "BOMB" waypoint over water, or any of the ground
  261.       forces get generated over water, kindly re-locate them yourself after
  262.       you load the mission.  This problem should be minimal, but it was
  263.       impossible to avoid altogether without eliminating some of the *real*
  264.       terrain from the waypoint possibilities.
  265.  
  266.       I have found in play-testing that I had the most fun generating a 
  267.       mission, loading it, but NOT peeking at anything before actually
  268.       playing.  If you do it this way, you get the uncertainty and surprise 
  269.       of Falcon's Campaign mode, without the committment or aggravation.
  270.  
  271.  
  272.  VI.  Select "Decode Red Flag Mission" option.
  273.        
  274.       This option will allow you to read in any Red Flag Mission File
  275.       and generate a report for that mission.  The  mission reports 
  276.       are saved with the same filename as the Red Flag Mission, and
  277.       an extension of ".SUM."  Multiple missions may be read in and
  278.       viewed on the Falcon Mapper desktop, and they may be printed
  279.       from DOS using "PRINT ____.SUM" or "COPY _____.SUM LPT1:"
  280.  
  281.       You may open as many Red Flag mission summaries as the memory space
  282.       in your machine allows.  The program will default to looking for
  283.       Red Flag missions with the file extension for the theater currently
  284.       selected (RFM, IFM, KFM or PFM) but this can be altered by editing
  285.       the input line.
  286.  
  287.       If you find there are too many Mission summaries cluttering the 
  288.       desktop, simply use the Tile or Cascade Functions from the Window 
  289.       menu to clean things up.
  290.  
  291.       To simply view a ".SUM" file (or any text file) that already exists
  292.       on your hard disk, use the "View Text File" option from the File
  293.       menu.
  294.  
  295.  
  296.       NOTE ABOUT WAYPOINTS        
  297.       --------------------
  298.       No matter what theater you are operating in, the Falcon world 
  299.       consists of a square grid 320 nautical miles by 320 nautical
  300.       miles, for a whopping 102,400 square miles to fly around in.
  301.  
  302.       The Red Flag Mission viewer reports waypoints using a Cartesian
  303.       X-Y system, with 0,0 in the lower left corner, and 320,320 in the
  304.       upper right.  These waypoints are accurate down to 118.6738281
  305.       feet, for those of you who care!!  Just thought it would be a good 
  306.       idea to explain how I oriented the waypoints with respect to the
  307.       map, to avoid confusion!
  308.  
  309.  
  310. VII.  Select the "ILS View Shift" option
  311.  
  312.       New for version 3.1D is an option to patch away the insidious code in 
  313.       FALCON3.EXE responsible for the ILS and gear-down view-shift BUG.
  314.       Previously published as Steve Kramp's NUKILS program on FSFORUM, that
  315.       functionality has now been added to F3MAPS.  Thanks go to Steve for
  316.       all of his work.  (Thanks Steve...)
  317.  
  318.  
  319. VIII. Customize the HUD with "HUD Declutter" option
  320.  
  321.       If you use the F-16C HUD in Falcon 3.0, you might have wondered (as I
  322.       have) why the static legends "SPD," "ALT," and "HEADING," are display-
  323.       ed at all.  All they seem to do is clutter up an already restricted
  324.       HUD field of view - and they never change!  After you've flown the 
  325.       Falcon around for a while you *know* which readout is which, you don't 
  326.       need a reminder!!  Now you can selectively NUKE some or all of these 
  327.       annoying legends.  For either the F-16C or A HUD, you can also 
  328.       eradicate the "ARM" legend, and both the "R XX X" and "C XXXX" legends
  329.       which appear on the HUD even when you have no radar lock-on.  Go ahead
  330.       and nuke'em, they'll still pop back up when you re-establish radar
  331.       lock-on, but they won't be blocking your view when you don't!! 
  332.  
  333.  
  334.   IX. Change the default scale 
  335.       
  336.       Everybody who flies the Falcon knows that only real men (and real
  337.       women) use "1X" magnification.  Unfortunately, the designers of
  338.       FALCON 3.0 decided 2X magnification would be best.  In fact, they
  339.       must have thought this so strongly, they decided to always revert you
  340.       back to 2X after every mission, even AFTER you've selected the scale
  341.       you want.  Well, we've taken care of them this time!!  Select the
  342.       "change scale" option and change that default scale to be any value
  343.       you desire (1X, 2X, 4X or 8X).  But remember, REAL pilots use 1X!!
  344.       Thanks to my friend Steve Kramp for scratching his head and plugging
  345.       himself into his PC for a few hours to find this one!!
  346.  
  347.  
  348.  
  349. IT'S NOT MY FAULT, DEPT.
  350. ------------------------
  351.   This program is freeware.  It may be copied freely and distributed 
  352.   as long as it is not modified in any way, and this documentation 
  353.   file is packaged with the executable program.  You may NOT sell F3MAPS
  354.   for profit, or upload it to any BBS that operates for profit.
  355.  
  356.   No guarantees are made as to the compatibility of this program with 
  357.   Falcon 3.0D.  Remember, F3MAPS is essentially PATCHING the Falcon 
  358.   machine language program.  F3MAPS will NOT work with any Falcon 3.0
  359.   version other than 3.0D, and is NOT likely to work with any future
  360.   upgrades.  As new versions of Falcon 3.0 are released, I will evaluate
  361.   them as to their compatibility with F3MAPS and make updates as necessary.
  362.  
  363.  
  364.   In short:
  365.  
  366.   PORTIONS OF THE FALCON MAPPER PROGRAM ALTER THE FALCON 3.0 EXECUTABLE 
  367.   IMAGE!  ANY DAMAGE TO YOUR SYSTEM OR FILES, EITHER DIRECT, INCIDENTAL, OR 
  368.   CONSEQUENTIAL, WILL NOT BE THE RESPONSIBILITY OF THE AUTHOR OF "F3MAPS."  
  369.   ADDITIONALLY, NO GUARANTEES ARE MADE CONCERNING SUPPORT OF THIS SOFTWARE.
  370.   IF YOU ARE NOT WILLING TO ACCEPT INCIDENTAL RISKS TO YOUR DATA AND CANNOT
  371.   ENSURE ITS SAFETY VIA BACKUPS, DO NOT USE THIS PROGRAM!
  372.  
  373.  
  374. SUPPORT ANYWAY 
  375. --------------
  376.   At the present, I am available to support this software via the Flight 
  377.   Simulation Forum on Compuserve (GO FSFORUM).  Leave a message in 
  378.   section 8, Modern Air Combat, if you have questions, comments, or 
  379.   suggestions about this program, or would like to solicit help with a 
  380.   problem.  I do check in fairly often, so I will respond to your
  381.   pleas as soon as possible!
  382.  
  383.   Good luck, and may you be free of flying telephone poles!!
  384.  
  385.  
  386.  
  387. RELEASE HISTORY        * = Internal release only
  388. ---------------
  389.   
  390.   Release 1   --- Provided as a supplement to Rob "Orinoco" Heittman's 
  391.                   FALCONER version 2.5 program.  Allows IA and RF locations
  392.                   to be patched to any Falcon 3.0 theater.
  393.   
  394.   Release 2   --- CUA-compliant user interface.  
  395.                   Incorporated Craig Allen's suggestions for modifying the
  396.                   Red Flag mission file extensions along with the theater
  397.                   location.
  398.  
  399. * Release 2.1 --- Cosmetic fixes.  
  400.                   "Shell to Falconer" option using new FSFORUM Skunk Works
  401.                   API.
  402.   
  403.   Release 3.0 --- Red Flag Mission Viewer
  404.  
  405.   Release 3.1 --- Waypoint distance computations added to Red Flag Mission 
  406.                   Report.
  407.                   
  408.                   Auto-Generate Red Flag Mission option.  Allows pseudo-
  409.                   random Red Flag missions to be created with a click of the
  410.                   mouse. 
  411.  
  412.                   ILS View-Shift remover option.  A million thanks to my
  413.                   good friends Steve Kramp (author of the original NUKEILS 
  414.                   program) and Rich Michta at Grumman Aerospace for their 
  415.                   wonderful detective work in getting this feature in. Rich, 
  416.                   you did it all with serial ports and DOS debug!  Steve,
  417.                   you restrained Rich when he ran at the PC with his solder-
  418.                   ing iron and chip puller!
  419.  
  420.                   HUD Declutter and Change Scale options. 
  421.                   
  422.                   Miscellaneous features - "change directory" and "view a
  423.                   text file" options.
  424.  
  425.  
  426.   Release 3.1D--- Identical to version 3.1, updated to work with Falcon 3.0,
  427.                   version D
  428.  
  429.  
  430.  
  431.                               - Greg Prete [FSFORUM]
  432.                                 CIS ID [70720,2566]
  433.  
  434.  
  435.  
  436.