home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / BBS_GAME / GTERM400.ZIP / GTERM.DOC < prev    next >
Text File  |  1993-04-23  |  14KB  |  341 lines
  1. GTERM - Graphics Terminal for LAND OF DEVESTATION (EGA/VGA version)
  2. Programming by Scott M. Baker
  3. Graphics by Shane Chambers and Scott Baker
  4.  
  5. What is GTERM?
  6.          GTERM is a terminal program for use with my land of devestation
  7.   doorgame. It provides EGA graphics support. Basically, the wasteland
  8.   map and user inventory have pictures.
  9.  
  10. Requirements:
  11.      * IBM PC or compatible (12mhz AT or better recommended)
  12.      * EGA or VGA graphics support (the 640x350 16 color mode)
  13.      * A modem
  14.      * Access to a bbs running Land of Devestation
  15.  
  16. Quick Start up:
  17.   1)  Copy gterm and it's respecive files into a subdirectory. Preferrably
  18.       a directory off of your comm program's directory since you will most
  19.       likely be using gterm as an external protocol.
  20.  
  21.   2)  Set up GTERM as an external protocol to your terminal program. This
  22.       will usually involve using the setup portion of your terminal program
  23.       and/or modifying batch files. The command line directives "COM <com port
  24.       number> BAUD <baud rate>" may be used to set the com port and baud rate
  25.       that gterm will use.
  26.  
  27.       If you are not able to set up GTERM as an external protocol then go to
  28.       step #3.
  29.  
  30.   4)  If you can't set up GTERM as an external protocol then you will have to
  31.       call GTERM up manually each time you want to use it. You will probably
  32.       have to type the command line directives on the command line to set the
  33.       com port and baud rate to use. For example, "GTERM COM 1 BAUD 2400" would
  34.       set GTERM to use COM1 at 2400 baud.
  35.  
  36.   5)  At this point, GTERM should be installed an ready to run, either as an
  37.       external protocol (step 2) or manually (step 3).
  38.  
  39.   6)  Call up a bbs that has Land Of Devestation running using your terminal
  40.       program and go into the Land of Devestation door.
  41.  
  42.   7)  Now, it is time to activate GTERM. If you have GTERM set up as an
  43.       external protocol then simply press the key(s) that activate the
  44.       protocol.
  45.  
  46.       If you have GTERM set up by use of the manual method (not the external
  47.       protocol method), then exit your terminal program (without hanging
  48.       up) and type the command to activate GTERM (i.e. GTERM COM 1 BAUD
  49.       2400)
  50.  
  51.   8)  Press return. If you are at LOD's main menu or wasteland menu, then
  52.       GTERM should automatically activate itself.
  53.  
  54.  
  55. Command line parameters:
  56.  
  57.          "BAUD x"      Specifies the baud rate to use. EXAMPLE: "BAUD 2400"
  58.  
  59.          "COM x"       Specifies the com port to use.  EXAMPLE: "COM 2"
  60.  
  61.          "FOSSIL"      Enable fossil support.
  62.  
  63.          "OLDINTNERAL" This will tell GTERM to use some older comm routines
  64.                        which may work if you're having some communications
  65.                        related problems. (Note: Don't use FOSSIL and
  66.                        OLDINTERNAL at the same time!)
  67.  
  68.          "EMS"         Use EMS memory if possible
  69.  
  70.          "/AUDIOSB"    Will start up the audio sound system using soundblaster
  71.                        sound card. (Requires LODxxxF.ARJ)
  72.  
  73.          "/AUDIOSPKR"  Will start up the audio sound system using the PC
  74.                        speaker. Quality isn't very good.
  75.                        (Requires LODxxxF.ARJ)
  76.  
  77.          "/AQHIGH"     High audio quality. May slow down performance.
  78.  
  79.          "/AQMED"      Medium audio quality. default.
  80.  
  81.          "/AQLOW"      Low audio quality. Should increase performance compared
  82.                        to AQHIGH/AQMED. May be necessary for some slower
  83.                        machines.
  84.  
  85. Examples:
  86.  
  87.        "GTERM COM 2 BAUD 19200 FOSSIL"
  88.  
  89.          Load gterm using COM2, at 19200 baud. Use fossil driver. (note fossil
  90.          driver such as BNU or X00 must be loaded)
  91.  
  92.  
  93.        "GTERM COM 1 BAUD 38400 /AUDIOSB /AQHIGH"
  94.  
  95.          Load gterm using internal com routines on com1 at 38400 baud. Play
  96.          sound through the soundblaster at high quality.
  97.  
  98.  
  99. Audio Support:
  100.  
  101.      Starting with version 3.60, Land Of Devastation and GTERM now have some
  102.  sound/music capability. Here is how to get the sound system to work:
  103.  
  104.      1) You must have downloaded and unarchived LODxxxF.ARJ into the
  105.         directory where you are running LOD (or GTERM).
  106.  
  107.      2) You must use either the option /AUDIOSB or /AUDIOSPKR to initialize
  108.         the sound system. Optionally you may wish to use one of the /AQxxx
  109.         switches to set audio quality.
  110.  
  111.      Examples: (For Land Of Devastation - on the sysop's side)
  112.  
  113.         "GAMEEGA /L /EMS /AUDIOSB"
  114.           Load LOD with Soundblaster enabled.
  115.  
  116.         "GAMEEGA /L /EMS /AUDIOSB /AQLOW /FR"
  117.           Load LOD with Soundblaster at low quality, force music to play
  118.           when remote users are on.
  119.  
  120.      Examples: (For GTERM - on the remote user's side)
  121.  
  122.         "GTERM COM 2 BAUD 19200 /AUDIOSPKR /AQHIGH"
  123.           Load GTERM with PC-Speaker set to high quality.
  124.  
  125.         "GTERM COM 1 BAUD 2400 /AUDIOSB"
  126.           Load GTERM with soundblaster at default (medium) quality.
  127.  
  128.  
  129.  Notes:
  130.  
  131.      The audio system is relatively new to LOD and hasn't been fully tested
  132.  and therefore might have some bugs. In fact, with some people's machines,
  133.  it might not work at all. If you have trouble running LOD with audio
  134.  turned on, then try turning it off!
  135.  
  136.      The audio system eats up quite a bit of memory (almost 150k). Therefore,
  137.  when running LOD or GTERM, you might not have enough conventional memory to
  138.  initialize the audio system and you won't hear anything.
  139.  
  140.      Having music active on one side does not require having music active
  141.  on the other. For example, a user with GTERM might have music enabled, but
  142.  the sysop might have it disabled - this will work fine - the user will hear
  143.  his music and the sysop will have some nice silence!
  144.  
  145.      If you like, you can bring up a display of the current MOD system
  146.  status (also shows any possible errors) by pressing ALT-3. This works with
  147.  either GTERM or the EGA (GAMEEGA.EXE) version of LOD. The non-EGA (GAME.EXE)
  148.  version of LOD does not have the mod status screen.
  149.  
  150.  
  151.  Music system credits:
  152.  
  153.      The code that is used to play the MOD music in LOD was supplied by
  154.  Mark J Cox. It's called MOD-OBJ and it's an excellent unit and I
  155.  recommend it to anyone who wants to add MOD music to their program.
  156.  
  157.      Most (if not all!) of our songs were composed by Chris Azure.
  158.  
  159. PROBLEMS AND SOLUTIONS
  160. ----------------------
  161.  
  162. Problem:   Gterm locks up when I load it!
  163.  
  164. Solutions: 1) Try using the FOSSIL option and a fossil driver. The internal
  165.               com routines sometimes do not work right on all people's
  166.               systems. When you turn on fossil support, you will need to have
  167.               a fossil loaded - try looking for BNU or X00 on your local
  168.               bbs.
  169.  
  170.  
  171. Problem:   I don't hear any sound!
  172.  
  173. Solutions: 1) Make sure you have unzipped LODxxxF.ARJ into your GTERM
  174.               directory. GTERM can't play any sound without these files.
  175.  
  176.            2) Make sure you have used either /AUDIOSB or /AUDIOSPKR on
  177.               the command line.
  178.  
  179.            3) If you have used /AUDIOSB, then you'd better have a
  180.               SoundBlaster or compatible card installed!
  181.  
  182.            4) You have to be connected to a version of LOD that is 3.60
  183.               or greater.
  184.  
  185.            5) You might simply not have enough free memory. Try pressing
  186.               ALT-3 while GTERM is loaded and see what the display says.
  187.  
  188.  
  189. Problem:   All I get is garbage!
  190.  
  191. Solutions: 1) Make sure you have the baud rate set properly. If you are
  192.               using a locked baud rate (19200, 38400, etc), then you
  193.               must put that on your command line rather than the actual
  194.               rate.
  195.  
  196.            2) Make sure you have specified the proper COM port.
  197.  
  198.  
  199. Problem:   GTERM Used to work great, but it stopped working when I
  200.            upgraded to version 3.70.
  201.  
  202. Solutions: 1) We did add some new comm routines which could possibly
  203.               be causing a problem. You might want to try using
  204.               "/OLDINTERNAL" on the command line.
  205.  
  206.            2) If you decided to start using the music "/AUDIOSB"
  207.               or "/AUDIOSPKR", then you might need to lower your
  208.               sound quality by using "/AQLOW".
  209.  
  210.  
  211.  
  212.  
  213. Screen Format:
  214.  
  215. :--------------------:------------------------------------:-------------------:
  216. :                    :                                    :                   :
  217. :   WASTELAND MAP    :       MULTIPURPOSE WINDOW          :   PLAYER STATUS   :
  218. :                    :                                    :                   :
  219. :      WINDOW        :                                    :                   :
  220. :                    :                                    :                   :
  221. :--------------------:------------------------------------:-------------------:
  222. \
  223. /
  224. 25 LINE TEXT SCREEN
  225. \
  226. /
  227.  
  228. WASTELAND MAP
  229.       The wasteland map is a 3x3 grid of map tiles. Each tile corresponds to
  230.       one location on thew Land of Devestation wasteland map. These tiles are
  231.       synonymous to the normal ANSI/ASCII text tiles in LOD, but they are
  232.       using EGA graphics. If OBJECTS or a BASE is located in a tile, the word
  233.       "OBJS" or "BASE" will appear in the lower right hand corner of the
  234.       tile.
  235.  
  236. MULTIPURPOSE WINDOW
  237.       The multipurpose window supports a variety of purposes. Initially, it
  238.       will display the GTERM commands that are available. Pressing a
  239.       function key (F1-F10) will change the display to the various options.
  240.       The options are as follows:
  241.  
  242.          F1: GTERM MENU  -  List available GTERM commands
  243.  
  244.          F2: INV DISPLAY -  A graphic representation of player's inventory
  245.                             items.
  246.  
  247.          F3: WASTE. MENU -  A copy of LOD's wasteland menu. Provided simply
  248.                             for the users reference
  249.  
  250.          F4: GTERM INFO  -  A small text screen of info about GTERM. Includes
  251.                             the selected com port and baud rate.
  252.  
  253.          F5: MAP LEGEND  -  A description of the symbols used in the MAP
  254.                             window.
  255.  
  256.          F6: LR SCAN     -  Displays the last LR scan obtained (if any)
  257.  
  258.          F7: HOST INFO   -  Displays some information about the host system
  259.                             such as the sysop's name, regisration data, etc.
  260.  
  261.          F8: COMBAT      -  When in combat, this will display a bar graph
  262.                             indicating your hit pts versus the enemy's hit
  263.                             points.
  264.  
  265.          F9: UTILITIES   -  A utility window for such information as the
  266.                             packet status, MOD sound system display, etc.
  267.  
  268.         F10: QUIT        -  Quit GTERM
  269.  
  270. PLAYER STATUS
  271.       The player status window displays data about your character and the
  272.       current terrain.
  273.  
  274. 25 LINE TEXT SCREEN
  275.       The 25 line text window at the bottom of the screen emulates a normal
  276.       25 line text screen.
  277.  
  278. The inventory screen:
  279.          The inventory screen (F2 in the multipurpose window) provides a
  280.   visual representation of your character's currently selected equipment
  281.   and the currently possessed inventory. Eight items are show; Five of them
  282.   are your selected equipment and the other three are a scrollable inventory
  283.   display (it can be scrolled with PGUP/PGDN).
  284.  
  285.          CLS: Selected close range weapon (hand-to-hand)
  286.          RNG: Selected ranger weapon
  287.          ARM: Selected armor
  288.          RAD: Selected radiation suit
  289.          MED: Selected medical lining
  290.     1,2,3...: These numbered items are your inventory. Pressing PGUP/PGDN
  291.               will scroll these so you can view your entire 16 element
  292.               inventory.
  293.  
  294. Mouse Support:
  295.  
  296.          If a mouse driver (i.e. MOUSE.COM) is loaded, then GTERM will enable
  297.   mouse support. Currently, this support is quite limited and only involves
  298.   movement. Basically, you can click on the north,south,east,or west map
  299.   squares and GTERM will send the corresponding move command to LOD. You
  300.   cannot as of yet use diaganols.
  301.  
  302. Technical Information:
  303.  
  304.          GTERM's operation is possible by using a packetized data transfer
  305.   scheme. When the host (Land of Devestation) needs to update the display, it
  306.   sends an "update packet" to GTERM. This packet is a binary (i.e. not ASCII)
  307.   representation of the map, character status, inventory, etc. It also
  308.   includes a checksum. When GTERM recieves the packet, it tests the checksum
  309.   and if the packet is error free, it sends an ACK else it sends a NAK. If
  310.   a NAK is received by the host, then the host will re-transmit the packet.
  311.          The packet is compressed for speed purposes. Since map data can
  312.   be repetetive, the compression scheme is able to obtain about a 30-50%
  313.   compression rate on the transmitted data.
  314.          There are several different packet types that LOD will send to
  315.   GTERM. Packet type #1 is a complete update including map data, inventory,
  316.   status, etc. Packet type #2 is a partial update including everything except
  317.   the map data. This smaller packet is used in such situations as combat
  318.   where map updates are not necessary.
  319.          In addition to these main packets, there are also some other
  320.   specialty packets for performing such tasks as displaying an ANSI screen,
  321.   playing MOD music, etc.
  322.  
  323.  
  324. Credits:
  325.  
  326.    SHANE CHAMBERS       ANSI and EGA graphics designer.
  327.  
  328.    MARK COX             Author of MOD-OBJ, the code that was used to provide
  329.                         .MOD music support to LOD.
  330.  
  331.    CHRIS AZURE          Composer of most of our MOD music.
  332.  
  333.    CHRISTOPHER DARQUE   Lots of EGA pictures, some plot ideas, and some
  334.                         great beta testing.
  335.  
  336.    RICK ARMSTRONG       EGA Pictures
  337.  
  338.    DAVE ROSSON          EGA Pictures
  339.  
  340.    DOUG MERHA           EGA Pictures
  341.