home *** CD-ROM | disk | FTP | other *** search
/ Game Killer / Game_Killer.bin / 765.SHOWF3.DOC < prev    next >
Text File  |  1992-03-11  |  5KB  |  123 lines

  1. ===============================================================================
  2. SHOWF3.EXE - Falcon 3.0 Screen Viewer  v1.0  March 1992
  3.  
  4. By Steve Kramp [73647,1647] for CIS FSFORUM
  5. ===============================================================================
  6.  
  7. Files contained in this archive:
  8.  
  9.      SHOWF3.DOC - Documentation file
  10.      SHOWF3.EXE - DOS Executable file
  11.  
  12.  
  13. What's SHOWF3?
  14. --------------
  15. SHOWF3 is a utility to allow viewing of the screen shot files that are
  16. produced from the Falcon 3.0 debug screen.
  17.  
  18.  
  19. What's the Debug Screen?
  20. ------------------------
  21. The debug screen is a hidden feature(?) in Falcon 3.0 that allowed the
  22. programmers and beta testers to directly modify, and display the viewing
  23. parameters.  In addition, it provides the capability to 'snapshot' the
  24. screen to a file.
  25.  
  26. To get to the debug screen, type
  27.  
  28.      [P] [Tab]
  29.       |    |
  30.       |    |- Hold until screen changes
  31.       |
  32.       |- PAUSE
  33.  
  34. The screen will change to a view of "PAUSED" with you looking down the
  35. tailpipe of your F-16.  You can manipulate the viewing eye position (not the
  36. plane's) with the following keys:
  37.  
  38.       PgUp   - Altitude +
  39.       PgDn   - Altitude -
  40.       arrows - X,Y position
  41.       F3,F4  - rotation
  42.       T      - Transporter room (direct input of x,y coordinates)
  43.       D      - Display info (x, y, frames per sec)
  44.  
  45. (Note: There's probably more, try all key combinations)
  46.  
  47. Once you're happy with the screen, it's time to save it.  Pressing [N] will
  48. produce a file called FALCON3.000 in the FALCON3 directory.  Subsequent
  49. [N]'s will produce FALCON3.001, .002, etc.  Falcon starts with the .000
  50. extension each session, so it's wise to rename the files if you don't want
  51. them overwritten.
  52.  
  53. To exit the debug screen, press [P] to un-pause the game.  You will return
  54. to your original location and orientation, and the game will proceed.
  55.  
  56. After exiting Falcon, check your directory for the FALCON3.00x files.  The
  57. length should be 64768 bytes.
  58.  
  59.  
  60. To View Screen Shots
  61. --------------------
  62. Type SHOWF3 followed by the name of the file(s) to view (wildcards are OK).
  63.  
  64. Examples:      SHOWF3 FALCON3.000
  65.                SHOWF3 FALCON3.000  FALCON3.001
  66.                SHOWF3 c:\falcon3\scrshot.1
  67.                SHOWF3 falcon3.*
  68.                SHOWF3 falcon3.00?
  69.  
  70.                etc... You get the idea.
  71.  
  72. Press any key to advance to the next file if you are viewing more than one.
  73.  
  74. Error checking:
  75. --------------
  76.      File length must be 64768 bytes.
  77.      Improper length and non-existent files skipped.
  78.  
  79.  
  80. In Conclusion...
  81. ----------------
  82.  
  83. Try it, use it, and abuse it.  Any problem reports, wish-lists, or praise
  84. can be sent to me, Steve Kramp [73647,1647].  I'll be happy to incorporate
  85. any suggestions (doing this stuff is more fun than playing the game!).
  86.  
  87. Give us your best shots.  The files compress well and upload time is free.
  88.  
  89. Remember to check out FALCONER and Falcon Mapper, 2 great Falcon utilities.
  90.  
  91.  
  92. Technobabble For Those Interested
  93. ---------------------------------
  94. Falcon 3.0 runs in a non-standard 320x200 256 color graphics mode.  Standard
  95. VGA mode 13h provides the same resolution and color capability, but only
  96. supports one video page.  By reprogramming the VGA card at the register level,
  97. you can squeeze 4+ video pages out of this mode to allow for page flipping
  98. animation (the mode is nearly identical to Michael Abrash's ModeX outlined in
  99. his Doctor Dobbs Journal columns, except he increased the horizontal line count
  100. to 240).  This new mode uses all 4 bitplanes to store screen data.
  101. Consequently, to snapshot the screen, you have to dump the contents of each
  102. bitplane separately.  This leads to the following kind of file format:
  103.  
  104. Bitplane 0 data - 16000 bytes   Linear screen addresses 0, 4,  8, 12, etc.
  105. Bitplane 1 data - 16000 bytes   Linear screen addresses 1, 5,  9, 13, etc.
  106. Bitplane 2 data - 16000 bytes   Linear screen addresses 2, 6, 10, 14, etc.
  107. Bitplane 3 data - 16000 bytes   Linear screen addresses 3, 7, 11, 15, etc.
  108. -----------------------------
  109.           Total - 64000 bytes = 320x200 x 1 byte/pixel
  110.  
  111. This is followed by 768 bytes of color palette values (256 * 3 bytes/color RGB)
  112. for a grand total of 64768 bytes.
  113.  
  114. Since one page is adequate for displaying a single picture, I used the standard
  115. VGA mode 13h and 'unwound' the file data for the linear mode.
  116.  
  117. It hurts your head to think about it, and my lousy explanation doesn't help.
  118. If you're interested in the unspectacular source code, let me know.
  119.  
  120. 'Nuff said.
  121.  
  122.                 Steve Kramp [73647,1647]
  123.