home *** CD-ROM | disk | FTP | other *** search
/ Chip 1998 March / Chip_1998-03_cd.bin / zkuste / SVET_OS2 / MROIDS10 / README.TXT < prev   
Text File  |  1996-07-29  |  41KB  |  818 lines

  1.                  ┌─────────────────────────────┐
  2.                  │   MASTERROIDS Version 1.0   │
  3.                  └─────────────────────────────┘
  4.  
  5.     MASTERROIDS is a shoot'em-up game running as a multithreaded
  6.     PM-program for up to four players.
  7.  
  8. FIRST NOTE:
  9.     When you try to start the game first time (without having changed the
  10.     configuration), it could happen, that the game won't start, cause the
  11.     configuration does not fit to your computer. Use the delivered program
  12.     "MRRESET" first to set critical options to non-critical values
  13.     and then try to start the game again.
  14.     ( Especially, if you enable DART in the "Configuration" and you do not
  15.     have installed the DART-DLLs, the game will crash immediately. For this,
  16.     use "MRRESET". )
  17.  
  18.     Configuration helps:
  19.     Below, I am speaking of threads. If you don't know what this is, don't
  20.     panic. The only thing you must know here is that you can make the game
  21.     faster when you set a thread's priority higher ( see below ). If you
  22.     don't know what to do with the options described below ( belonging to
  23.     the threads or the sound ), just press the Default-Button ( which is
  24.     present for all difficult-to-handle options ). This should do it.
  25.  
  26. NEW NOTE FOR VERSION 1.0:
  27.     In this version, you can double click with the left mouse button in the
  28.     game-area of the window. This will make appear/disappear the System-menu,
  29.     Titlebar, Min-Max-Buttons and the Menu ( these are called the Frame-
  30.     Controls ). But still you can access the menu-functions through the
  31.     keys ( pressing the Alt-key and after releasing it pressing a key that
  32.     is drawn underlined in the menu ).
  33.  
  34. INSTALLING:
  35.     NO CHANGES to your CONFIG.SYS and .INI-files are done :-)
  36.  
  37.     EITHER copy the files in a directory you like and if
  38.         you like create a program-object on the desktop. 
  39.     OR (EVEN EASIER) start the INSTALL.CMD-file, which asks you whether
  40.         you want to copy the important files into a seperate directory
  41.         and whether you like a program-object on the desktop.
  42.  
  43. UNINSTALLING:
  44.     In case you should not like MASTERROIDS :-(
  45.     Simple as can be : Just delete the files and desktop-object (if created)
  46.     Maybe you would be so kind and send me a short message  WHY?????
  47.  
  48. IMPORTANT:
  49.     MASTERROIDS loads up to 3 MB data, so your computer should have a
  50.     minimum of 8 MB RAM. ( Sorry about that, but I had no chance to test the
  51.     game on a computer with 4 MB. I even don't know, if 4 MB is enough for
  52.     OS/2 itself. )
  53.     You should have a 486 or better ( 66 MHz or more. 33 MHz is possilbe,
  54.     but slow. Sorry. )
  55.     Cause the game puts your graphic-card to its limits ( and the processor
  56.     as well ) it would be the best, you have no other programs running in the
  57.     background.
  58.  
  59.     ( Please don't change the name "MROIDS" of the program cause this
  60.     is required, else the game won't function. )
  61.  
  62. FEATURES
  63.    -  up to 4 players
  64.    -  the keys and spacecraft functions can be edited.
  65.    -  Shooting another spacecraft will make this one move in that
  66.       direction.
  67.    -  Reducing graphics is possible to gain some execution speed and
  68.       reduces the need of memory.
  69.    -  You can manipulate some system-near parameters ( the threads' priorities
  70.       etc. ) to fit them best for your computer.
  71.       You don't have to change them. The game works with every possible
  72.       configuration, except MMPM and palette manager ( see below ).
  73.       ( If you don't know what to do then press the
  74.       Default-Button in the settings and configuration option. )
  75.    -  You can use your own sounds as well as the timings.
  76.  
  77. CHANGES FROM VERSION 0.9 TO VERSION 1.0
  78.    -  You can see and hear thrust-flames when you fly foreward.
  79.    -  In the unregistered version, you can now pick up all extras.
  80.       ( see below )
  81.    -  New Extra: Store-Extra ( see below )
  82.       With this extra, you won't loose any extras you have when your
  83.       ship is destroyed once more ( but after the explosion, you don't
  84.       have the Store-Extra any more ). With a Store-Extra you even won't
  85.       loose a Turret-Gun, if you have one.
  86.    -  Turret-Gun: You can turn yourself into a turret gun and be picked up by
  87.       another player to shoot in team-work.
  88.       In one-player mode or when only one player has survived, the ship cannot
  89.       be turned into a Turret-Gun any more.
  90.       VERSION 1.0 IS BETA: The Special-Function-Key does not have any function,
  91.       when a Turret-Gun sits on a Ship, but this will change in later versions.
  92.       ( Let me surprise you ).
  93.    -  HiScore:
  94.       If you have enough points at the end of the game, so that you will be
  95.       in the hiscore, you have to enter your name (like in version 0.9).
  96.       But after that, a dialog appears which shows you the name, score and
  97.       place in the hiscore of the players to be included in the hiscore.
  98.       If you played a game with more than one player, at the top of that
  99.       dialog, you will see the winner of the game. (The winner has the most
  100.       points. That does not mean, that he has lived longer than the other
  101.       players.)
  102.    -  HiScore:
  103.       There is now a hiscore for every different numbers of players.
  104.    -  The game now consist of 2 threads. In one thread, the keys are
  105.       handled, in the other thread, the drawing is performed. This has been
  106.       implemented, cause in Version 0.9, the keys sometimes did not react
  107.       immediately, cause so much sprites are drawn at the same time. Using
  108.       2 threads (you should set the priority of the main thread, that's the
  109.       key-thread, higher than the draw thread's one) prevents the keys to
  110.       be handled too late.
  111.    -  You can enable DART in the "Configuration". But do this only, if you
  112.       have installed DART. If not and you enable it and start the program
  113.       again, the program will crash immediately. The only chance you have now,
  114.       is to start "MRRESET" to switch critical options ( where DART is part
  115.       of ) to uncritical values.
  116.    -  The comets order has been sorted in a different way.
  117.    -  The differences between the difficulty-levels have been made greater.
  118.    -  A reset function for each of the 4 hiscore lists.
  119.    -  A Demo-play: This is for those of you, who just like too look.
  120.       This plays all levels one after each other and after the last
  121.       level (this is level 200), it starts automatically from level 1 again.
  122.       But in the unregistered version, the Demo aborts after Level 5.
  123.       In the Demo: If there are only few comets left on the screen, they will
  124.       be destroyed automatically one after each other, so that you must not
  125.       wait till the Enemy (described below) has destroyed even the last comet.
  126.       The speed of the Demo depends of the Difficulty Level you have chosen
  127.       in the Settings-Options.
  128.       When the Demo plays, you can stop it with the "Stop"-function in the
  129.       menu or by pressing Ctrl+Break. The Pause-Key pauses the demo.
  130.    -  The correct window postition will be saved in the INI-file (only in the
  131.       registered version). That means, that it will be stored as well, if
  132.       the window is maximized or not.
  133.    -  In this version, you can double click with the left mouse button in the
  134.       game-area of the window. This will make appear/disappear the System-menu,
  135.       Titlebar, Min-Max-Buttons and the Menu ( these are called the Frame-
  136.       Controls ). But still you can access the menu-functions through the
  137.       keys ( pressing the Alt-key and after releasing it pressing a key that
  138.       is drawn underlined in the menu ).
  139.    -  A volume slider has been implemented in the settings-options as well
  140.       as a separate option to be accessed while playing, too.
  141.  
  142. PLAYING THE GAME:
  143.    You are flying a little spacecraft and have to shoot all comets flying
  144.    around as well as other dangerous objects.
  145.    Use the keys defined in the players-dialog to move your ship, to shoot,
  146.    to activate your special function ( flying into hyperspace, a shield or
  147.    flying with extra speed ) or to turn yourself into a Turret-Gun.
  148. OBJECTS IN THE GAME:
  149.    -  Comets:
  150.       Shoot them ! Destroy them !
  151.       ( Do they really seam to be comets ? )
  152.    -  Extras:
  153.       They appear when you shoot at the alien (the gray ball) and will remain
  154.       for 20 seconds. After your spacecraft was destroyed, all extras except
  155.       the protector ( the dark shield-extra-ball ) were freed so they can be
  156.       picked up again by someone. If you lost your last live, the protector
  157.       as well will be freed.
  158.       If you have picked up a Store-Extra, you won't loose any extras and
  159.       Turret-Gun for the next destruction.
  160.       WHEN YOU HAVE A TURRET-GUN ON YOUR SHIP:
  161.       the next extra will get the Ship or the Turret-Gun, depending on
  162.       which one has less of that extra-category. So if the Ship has 3 green
  163.       balls and the Turret-Gun has 2 -> the Turret-Gun will get the next
  164.       green extra.
  165.       >  Shield-Balls:
  166.           You can get 2 yellow shield balls and/or 1 protector.
  167.           They have all a specific rotation speed around the ship.
  168.          Yellow Shield-Balls:
  169.           You can have up to 2 yellow shield-balls.
  170.           Each one has only some lives ( that means that a yellow shield-
  171.           ball can only resist a number of chrashes and then it
  172.           disappears ).
  173.           The first one has the lowest number of lives and the lowest
  174.           rotation-speed. The second one lives longer and is faster.
  175.           If the spacecraft explodes, all yellow shield-balls were freed and
  176.           can be picked up again, but their number of lives won't be
  177.           refreshed.
  178.          Dark Shield-Balls ( Protectors ):
  179.           You can have up to 1 dark shield-ball.
  180.           They are much faster than the yellow ones, they live forever
  181.           so you won't loose them if your ship explodes.
  182.           They were freed only if your ship has lost all of its lives.
  183.       >  Green Extras:
  184.           You can pick up up to 5 green extras. They are responsible for
  185.           better moves, rotations und speeds of the spacecrafts.
  186.           If you have picked up neither:
  187.            The values you chose in the settings-dialog were used.
  188.            ( The settings-dialog is accessible when you have started the
  189.            game and chosen the menu Options/Settings )
  190.           If you pick up one after another:
  191.           1. : increases the rotation speed.
  192.           2. : enables the backward-key: You can break the spacecraft's
  193.                movement now.
  194.           3. : sets the maximum speed of the spacecraft to a higher value.
  195.                ( That does not include a higher acceleration ! )
  196.           4. : the backward-key still can break the movement of the space-
  197.                craft, but if you hold the key a little bit longer, you
  198.                can drift backward as well.
  199.           5. : doubles the acceleration of the spacecraft.
  200.       >  Red Extras:
  201.           You can pick up up to 5 red extras. They are responsible for
  202.           a better weapon-system.
  203.           If you have picked up neither:
  204.            The normal bullet is used. It's a little white point.
  205.            You can choose it's range in the settings-dialog.
  206.           If you pick up one after another:
  207.           1. : The speed of the bullet will be increased.
  208.           2. : You get a bigger bullet. The range will be increased.
  209.           3. : The speed will be increased again.
  210.           4. : You get a laser. You can target easier.
  211.                The range and speed will be increased again.
  212.           5. : The speed will be increased again.
  213.       >  Blue Extras:
  214.           You can pick up up to 2 blue extras. They are responsible for
  215.           a quicker reloading of special-energy.
  216.       >  Store-Extras ( a red, wobbling ball ):
  217.           You can pick up 1 store extra.
  218.           If your ship is destroyed and you have a store extra, all other
  219.           extras and the Turret-Gun you have you will not loose. Only the
  220.           store extra will be lost. So the next time your ship is destroyed,
  221.           all extras (except the protector) will be lost (if you don't have
  222.           picked up another store extra meanwhile).
  223.       >  Missiles:
  224.           You can pick up a maximum of 1 missile.
  225.           They fly directly to the nearest target. A target is anything,
  226.           which is dangerous for the player (this does not include the alien,
  227.           this is the gray flying ball).
  228.           If there are radioactive balls ( these are yellow balls with a
  229.           radioactive sign and they turn into blue boxes ),
  230.           they are used as targets first.
  231.    -  Mine:
  232.       If the mine explodes ( by shooting or collision ), everything within
  233.       a certain radius will explode.
  234.    -  Alien ( the gray ball ):
  235.       It is mostly resistable against collisions, but not bullets and lasers.
  236.       It contains the extras. Shoot it !
  237.       It will contain more extras depending on the level and
  238.       the number of (still living) player-ships.
  239.    -  Enemy ( the white and red spacecraft shooting around ):
  240.       It's making you nervous, doesn't it ?
  241.    -  Hunting Radioactive Yellow Balls:
  242.       These are balls with a radioactive-sign and they transform themselves
  243.       into blue boxes. Sometimes they are coming out of comets, hunting
  244.       the nearest spacecrafts or the Enemy. Be careful, you've been warned !
  245.    -  TURRET-GUN:
  246.       With the Turret-Key you can turn yourself into a Turret-Gun or back to
  247.       the Ship. Being a Turret-Gun flying around, you cannot move or rotate
  248.       with your keys. You just have a Shield-Function as Special-Function
  249.       and you can shoot.
  250.       A Turret-Gun can be picked up by another Ship. Since a Turret-Gun sits
  251.       on a Ship, they cannot be removed one from each other except when they
  252.       were destroyed and noone of them had a Store-Extra.
  253.       When A Turret-Gun has been picked up, it will rotate automatically with
  254.       its Ship. When the player rotates the Turret-Gun by hand, it won't rotate
  255.       together with the Ship any more.
  256.  
  257. SCORING:
  258.    10 points for an alien ( the gray ball containing the extras )
  259.       but only if it were destroyed
  260.    20 points for each large comet
  261.    50 paints for each medium comet
  262.    100 points for each small comet
  263.    150 points for a mine
  264.       and you get the points for all other destroyed objects, that were
  265.       exploding with the mine.
  266.    200 points for a hunting radioactive yellow ball
  267.    250 points for an enemy ( the shooting ball-like spavecraft )
  268.  
  269.    You get a new life every 10000 points.
  270.  
  271.    You get points if you shoot something with your gun or with your missile
  272.    but you get no points if an object was destroyed cause it collided with
  273.    one of your shield-extra-balls.
  274.  
  275. CONTENTS OF ARCHIVE
  276.   The following files are contained in this archive:
  277.  
  278.    mroids.exe     - MASTERROIDS
  279.    mroids.pic     - contains all sprites
  280.    mroids.cmt     - contains all comet sprites
  281.    mroids.dig     - contains other bitmaps
  282.    mroids.ico     - the icon
  283.    wave.dll       - contains all sound functions for the game (is only loaded,
  284.                     when MMPM used)
  285.    alien.wav
  286.    blaster.wav
  287.    crash.wav
  288.    danger.wav
  289.    destroy.wav
  290.    dieshldx.wav
  291.    disappr.wav
  292.    enemy.wav
  293.    espeed.wav
  294.    explode.wav
  295.    extra.wav
  296.    hitsteel.wav
  297.    hyper.wav
  298.    laser.wav
  299.    newextra.wav
  300.    newlife.wav
  301.    plasma.wav
  302.    shield.wav
  303.    shldoff.wav
  304.    shldon.wav
  305.    shot.wav
  306.    takeprtc.wav
  307.    takeshld.wav
  308.    taketgun.wav
  309.    tgunrot.wav
  310.    thrust.wav
  311.    transfrm.wav
  312.    warp.wav
  313.  
  314.    readme.1st     - this file
  315.    order.frm      - Masterroids order form
  316.    install.cmd    - Installation-utility
  317.                     ( doesn't manipulate any of your system's config files )
  318.    mrreset.exe    - Resets the configuration to some non-critical values.
  319.                     If you chose a configuration ( especially MMPM or
  320.                     palette manager ) that your system does not support,
  321.                     the game could crash after it was started. This program
  322.                     will solve the problem. Don't start it when the game is
  323.                     running, cause the the game could write back the
  324.                     critical values.
  325.                     This program only manipulate some settings and
  326.                     configurations of Masterroids. Your system's config files
  327.                     won't be touched.
  328.    waveinfo.exe   - This program tells you some informations of a wavefile.
  329.                     ( If you don't want to use your own sounds but only the
  330.                     sounds delivered with this package, you don't need this
  331.                     program. )
  332.                     If you are playing with sounds and want to use your own
  333.                     sounds, then it would be the best, that the wavefile's
  334.                     parameters are the same for all of the used wavefiles.
  335.                     If they are different, the game will function as well
  336.                     ( except your MMPM-Version has the bug ), but only the
  337.                     game could get a little bit slower ( maybe you even won't
  338.                     recognize it ).
  339.                     This program prints the following parameters:
  340.                         FormatTag
  341.                         Channels
  342.                         SamplesPerSec
  343.                         AvgBytesPerSec
  344.                         BlockAlign
  345.                         BitsPerSample
  346.                     You don't have to know what these parameters mean.
  347.                     The program will tell you the length of the sounds in
  348.                     bytes as well, but this is the only parameter that need
  349.                     not to be equal for all used sounds.
  350. ADDITION:
  351.    emx.dll        - was necessary ONLY in Version 0.9
  352.                     Since Version 1.0 you can delete this file if you want.
  353.                     The installation-utility won't delete it !
  354.  
  355.  
  356. SETTINGS AND CONFIGURATION:
  357.  
  358. Chosen from menu "Options":
  359. -  "Players":
  360.    Players:
  361.       Choose the player to edit his options.
  362.    Properties of Spacecraft:
  363.    >  Shooting Range:
  364.         How far you can shoot.
  365.    >  Spacecraft Thrust:
  366.          That's the acceleration of the spacecraft.
  367.    >  Maximum speed:
  368.          The maximum speed possible for the spacecraft.
  369.    >  Rotation speed:
  370.          How fast the spacecraft will rotate.
  371.    >  Special Function:
  372.          The energy level of the special function.
  373.    Special Function:
  374.       Which function should be done when pressing the special-key.
  375.    >  Hyperspace:
  376.          The spacecraft will fly into hyperspace an little bit later it comes
  377.          back on another position.
  378.    >  Shield:
  379.          A shield will be activated.
  380.    >  Extra Speed:
  381.          For the time you press the special-key, you will be able to fly very
  382.          fast.
  383.    Color:
  384.       You can choose one of 4 colors for your ship.
  385.    Key Codes:
  386.       The backward-key will be enabled if you have picked up a certain
  387.        number of green extras. ( See the Extras-Section above )
  388.       Between the Ok- and Cancel-button there are 7 round buttons with
  389.        a text-field. They are used for the keys up/down/left/right,
  390.        weapon and special-function and turret-gun. To choose a different
  391.        key click on the round button of the function you want change ( e.g. of
  392.        the up-key ) and then click on the key in the drawed keyboard in the
  393.        middle of the dialog. You can only choose black or white keys.
  394.        The red ones indicate, that they are used by another player and the
  395.        white ones are your keys.
  396.       The Turret-Key will function only if there are currently more than
  397.        one ship living. It will only function, when you don't have a Turret-Gun
  398.        and when you are not a Turret-Gun sitting on a ship.
  399.        VERSION 1.0 IS BETA: I will implement a function in later versions, so
  400.        that a Ship with Turret-Gun can be released as well. In Version 1.0
  401.        there is no possibility (except the destruction of the Ship with
  402.        Turret-Gun), to remove a Turret-Gun from a Ship.
  403.  
  404. -  "Settings":
  405.    Difficulty: The difficulty level.
  406.    Graphic-Detail:
  407.    >  Stars in background:
  408.          If you switch off the stars in background, no bitmap will be loaded.
  409.          This will reduce the need of memory.
  410.    >  Sprites overlapping:
  411.          If you switch this off, the drawing runs a bit faster, but the
  412.          objects will flicker when they overlap. And sometimes moving
  413.          objects delete parts of other not moving objects, when they overlap.
  414.    >  Background pass through sprites:
  415.          If you switch this off, the background will not be painted in the
  416.          rectangle area of an object. This makes the drawing a bit faster.
  417.    >  short Explosions:
  418.          This will draw only short explosions in order to draw quicker.
  419.          This option is helpful for slow computers.
  420.          This option does not use more or less memory.
  421.    >  Thrust Flames of the Ship:
  422.          You can see and hear, when you are flying foreward.
  423.          Also this en/disables the sound when a Turret-Gun is rotating
  424.          on a Ship.
  425.    Sound:
  426.    >  Volume-Slider:
  427.          Sets the volume.
  428.    >  ON:
  429.          Switch Sound on/off. Maybe after you switched on the sound you must
  430.          wait a certain time for the soundfiles to be loaded into memory.
  431.          WARNING: If you have set a priority to IDLETIME ( see below ),
  432.          the harddisk access will be very slow. Maybe you have to wait some
  433.          minutes till the sounds are loaded.
  434.    >  share:
  435.          I implemeted this function for flexibility.
  436.          You should switch it off. Otherwise another program that starts to
  437.          play a sound could hang the game ( if you have another program
  438.          running in background ).
  439.    Emulate mathematic functions:
  440.       If you don't have a mathematic coprocessor, some sqrt-functions must
  441.       be simulated by the system. Then switch this button to on and the
  442.       game will use its own (faster) functions. But if you have a
  443.       coprocessor, switch this button off cause the coprocessor is the
  444.       fastest possibility.
  445.    Pause when game inactive:
  446.       When switched on, the game will stop when you click on another window.
  447.    Hide mouse pointer in the window:
  448.       You can show/hide the mouse pointer when it is over the game-area.
  449.    "More":
  450.       This enables the more system-near settings:
  451.       This is the Priority Class and the Priority Level of the threads.
  452.       Here you can edit the priority of execution.
  453.       Try out some values, if you want to.
  454.       If you don't know what to do with these values then ignore them
  455.       ( or set them to default with the Default-Button ).
  456.    Thread:
  457.    >  Main Thread:
  458.          If this button is selected, the following (priority) options
  459.          belong to the main thread.
  460.          The main thread handles all necessary parts of the program
  461.          ( this includes the key functions ).
  462.    >  Draw Thread:
  463.          If this button is selected, the following (priority) options
  464.          belong to the draw thread.
  465.          The draw thread is responsible only for the graphics and
  466.          animations as well as playing sounds.
  467.          I recommend to set the draw thread's poriority lower than the
  468.          main thread's one. Else it could happen, that your keys will
  469.          react a second later.
  470.    Priority Class:
  471.    >  Idletime:
  472.          This is the lowest priority. The thread will run very slow.
  473.          WARNING: All harddriveoperations will work very solw, even if
  474.          there is no other program running in background. So you better
  475.          should not use this setting.
  476.          ( It is implemented only for some exotic wishes. )
  477.    >  Regular:
  478.          This the default value.
  479.    >  Foregoundserver:
  480.          This is better than Regular, but not so good as Timecritical.
  481.          As I fingured out, this parameter sometimes does not work
  482.          correctly. Better you choose only "Regular" or "Timecritical".
  483.    >  Timecritical:
  484.          This allows the best performance, but other programs will run very
  485.          slow in background.
  486.    Priority Level:
  487.       In addition to the priority class you can change the priority within
  488.       a priority class.
  489.       Minimum level: -31
  490.       Maximum level: +31
  491.       ( By the way: If you choose a Priority Class of Timecritical and you set
  492.       the Level to a value greater or equal to 1, maybe the sound won't
  493.       function correctly. Set the priority level to a lower value, or don't
  494.       use sounds. )
  495.    Default:
  496.       Sets the threads' parameters back to normal
  497.    By the way: The program "MRRESET" sets the threads' parameters to
  498.    their defaults.
  499.    Check out some values for the main and the draw thread.
  500.    Some good settings for the priorities I found out are:
  501.       main thread: timecritical, level -1
  502.       draw thread: regular, level 0
  503.    These are the defaults.
  504.  
  505. -  "Configuration":
  506.    All Options edited in this dialog will be activated at the next start of
  507.    MASTERROIDS. If you don't know what to do with these options, just press
  508.    the button "Set All to Default".
  509.    If you change some options in here (especially the MMPM and the palette
  510.    manager to force their usage) and the game crashes the next time you try
  511.    to start it, start MRRESET.EXE first. Then critical options will be set to
  512.    non-critical values and the game should work again. ( Now the MMPM
  513.    and the palette manager will be switched off. ) Now can edit the settings
  514.    and configurations again.
  515.  
  516.    Reduce graphics details:
  517.       With this button the animations are reduced, but the game loads faster
  518.       at startup and not so much memory will be used.
  519.       This is helpful for computers with low main memory.
  520.       Default is deactived.
  521.    Palette manager:
  522.       Normally the program determines automatically if a palette manager is
  523.       available. But I have implemented these option for flexibility.
  524.       So the default is the automatic detection and this should be chosen
  525.       normally.
  526.       Without palette manager, the colors in the game won't be as beautiful
  527.       al with palette manager. But this will only happen, when you are using
  528.       a OS/2-graphic-resolution with 256 colors. A resolution with 32768,
  529.       65536 or 16 million colors doesn't need a palette manager.
  530.       If you set it to "force usage", the game could hang the next time you
  531.       try to start it (if your OS/2-system has no palette manager). In that
  532.       case start MRRESET.EXE. It sets some values back as well as this one
  533.       here to "don't use palette manager".
  534.       Default is autodetection.
  535.    MMPM:
  536.       Here is the same to say like at the palette manager. The MRRESET.EXE
  537.       will set this value to "don't use MMPM".
  538.       Default is autodetection.
  539.    DART: "Direct Audio Real Time".
  540.       This is a new feature from OS/2 to perform faster sound commands.
  541.       To use this, you must have installed DART on your comupter or the
  542.       program crashed when it is started. (In that case, start "MRRESET"
  543.       to switch off DART in the configuration.)
  544.       To use DART, you also must enable MMPM in the MMPM-Section.
  545.       (So "don't use MMPM" will switch off DART as well).
  546.    Sounds:
  547.       All time settings in this section are entered in milliseconds.
  548.       They should be multiples of 60. So you should use values like
  549.       0, 60, 120, 180, 240 and so on.
  550.       ( By the way:
  551.          The "global" Section from Version 0.9 has been removed, cause
  552.          I figured out, that the problem really was a bug in the
  553.          Soundcard-driver. Now I have new drivers and all works perfect,
  554.          so I decided to remove the global-Section to make the configuration
  555.          less difficult. )
  556.       Wave:
  557.          These values are the sound definitions:
  558.          The sound files and the major timings are set here. ( These values,
  559.          especially the timings are NOT used in connection with the MMPM-bug )
  560.          The Default-Button is the normal solution for these settings.
  561.       -  Sounds-list:
  562.             Here the game's events are listed for which sounds can be defined.
  563.             They are sorted in their priority-order. The most top sound has
  564.             the highest priority, the most bottom one has the lowest
  565.             priority. The priority of a sound ( so the position in the list )
  566.             can be changed by clicking on that sound event in the list and
  567.             moving in up or down with the UP- and DOWN-buttons.
  568.             For more information see the descriptions of "Minimum Play Time"
  569.             and "Sure Play Time" below.
  570.       -  Filename:
  571.             Here stands the sound file name (and path) for the chosen sound
  572.             in the "Sounds-list". It must be a file with the extension ".WAV".
  573.             If no file name is entered in here, the defined file does not
  574.             exist or the file is not a wave file, no sound will be played
  575.             for that event.
  576.       -  Browse-Button:
  577.             With this button you can search a sound file name on your drives.
  578.       -  Minimum Play Time:
  579.             This time takes effect, only if the "Sure Play Time" has elapsed.
  580.             If the "Sure Play Time" has elapsed but not the
  581.             "Minimum Play Time" while a sound is playing and another sound
  582.             should be started, then the playing sound will be stopped and
  583.             the other one started only if the new sound has a higher or
  584.             equal priority then the playing one.
  585.             A value of 0 means that sounds with higher priority can always be
  586.             stopped by sounds with lower priority ( but only if the
  587.             "Sure Play Time" has elapsed ).
  588.       -  Sure Play Time:
  589.             This is similar to the "Minimum Play Time", except that the
  590.             priority of the sounds make no difference. A playing sound will
  591.             never be stopped during the "Sure Play Time", no matter which
  592.             priority the new sound has.
  593.             This time setting has a higher priority than the
  594.             "Minimum Play Time". So if this value here is greater than the
  595.             "Minimum Play Time", the "Minimum Play Time" looses it's sense as
  596.             well as the priorities of the sounds.
  597.             A value of 0 for the "Sure Play Time" and the "Minimum Play Time"
  598.             means that a playing sound can always be stopped by another one.
  599.             This includes, that the priorities of the sounds make no more
  600.             sense.
  601.       -  UP-Button and DOWN-Button:
  602.             See "Sounds-list" description.
  603.  
  604.  
  605. WHAT'S IN THE UNREGISTERED VERSION:
  606.   *) registration-dialog at startup and end of the program
  607.   *) Only 5 levels can be experienced
  608.   *) Same of your settings won't be saved in the INI-file.
  609.  
  610.  
  611. BENEFITS OF REGISTERING
  612.   *) you'll keep the shareware-idea alive :-)
  613.  
  614.   *) no annoying registering-dialog at startup and end
  615.   *) no limitation of 5 levels any more
  616.   *) all options are accessible
  617.   *) all last settings will be saved in an INI-file
  618.   *) you'll be informed when there are updates which will work with
  619.      your old registration-Number
  620.      -> Updates are for FREE !!!
  621.  
  622.  
  623. HOW TO REGISTER   
  624.   You are allowed to use Masterroids for a period of 30 days, after
  625.   this trialperiod you are asked :-) to register.
  626.  
  627.   The registration fee is 20 US$ or 200 ATS or 30 DM.
  628.   You can send the money in cash (which is cheaper for you)
  629.   or you use a postal order (you have to pay the extra-money).
  630.   
  631.   If you choose a postal order, please send the money in ATS
  632.   (Austrian Shillings), and if you send cash don't send coins !
  633.   DO NOT use any other form of payment (e.g. credit cards) as
  634.   I won't be able to accept that !
  635.  
  636.   I am really honest, so you don't have to worry when sending
  637.   the money in cash !
  638.  
  639.   Of course all of the given information will be treated confidentially !
  640.  
  641.   Take care your first and last name are readable and correct, because I
  642.   will send you a code calculated based upon these informations.
  643.   After you enter this code together with your names in the registration-
  644.   menu in the game, your version of Masterroids is registered.
  645.   It will be much easier if you also send me your Internet e-mail address,
  646.   so I can send you update-infos & registration-Nr. faster and easier.
  647.  
  648. To register, send the filled in order-form & the payment to:
  649.  
  650.       Roman Komary
  651.  
  652.       Am Hundsturm 11/12
  653.       A-1050 Vienna
  654.       AUSTRIA
  655.  
  656.       e-mail : e8925453@stud1.tuwien.ac.at
  657.  
  658.   The registration is for personal use only !!!
  659.   Running this program on more than one machine requires a special
  660.   registration - contact the author for special prices.
  661.  
  662.   Students can ask me for special prices, too.
  663.   (just send me a letter or e-mail, I know how hard your life is :-)
  664.  
  665. REPORTING BUGS 
  666.   If you find any bugs, or have ideas of improving Masterroids I will
  667.   be very happy hearing your ideas.
  668.   Send me a letter or e-mail :
  669.  
  670.    Roman Komary
  671.       e-mail : e8925453@stud1.tuwien.ac.at
  672.  
  673.   When you send me a bug report, please include a description of the
  674.   procedure for reproducing the bug and a description of your system
  675.   configuration (hardware and software and Masterroids-configuration).
  676.  
  677. KNOWN BUGS:
  678.   *) Sound-Troubleshooting:
  679.       Sometimes, when playing with sound, the game hangs ( or even OS/2 itself
  680.       hangs ).
  681.       This happens cause the MMPM of OS/2 3.0 has a bug.
  682.       So I have added some configuration parameters to reduce the occurence of
  683.       this bug. But sometimes it will happen nevertheless.
  684.       See the "Configuration" description above.
  685.       If you tried out all the settings explained above, switch off
  686.       the sound in the settings-dialog, or switch off the MMPM in
  687.       the configurations-dialog.
  688.       By now, my computer didn't hang playing the game without sound.
  689.       By the way:
  690.       I've heard that the new version of OS/2 that should be appearing soon
  691.       ( I hope ) has solved many big bugs of the MMPM. ( I hope once more )
  692.      THESE FEATURES HAVE BEEN REMOVED FROM THE CONFIGURATION, cause
  693.       it's really a problem of the drivers. If you have the problem, get
  694.       new soundcard-drivers and the problem is solved (when the new drivers
  695.       work correctly).
  696.   *) If you were playing with sounds and have opened the sound device as
  697.       NON-shared ( see in the settings-dialog ) and you have a program running
  698.       in the background that wants to play a sound sometimes (maybe a clock
  699.       that wants to play a sound every hour etc.), then this could make
  700.       problems: When the program tried to play a sound ( but that didn't work
  701.       cause the game opened the sound device as non-shared ), there was no
  702.       sound any more to here while playing. Solution: Press the PAUSE-Key
  703.       twice. The sound will be playing again. If you don't, the game could
  704.       hang some seconds or minutes later. The best would be to turn off
  705.       all programs in background that tries to play sounds.
  706.       By the way:
  707.       I tried to open the sound device as shared. So the clock program could
  708.       play its sound. But after the sound has finished, the game did hang.
  709.      SEEMS TO ME THAT THIS BUG ALSO WAS JUST A SOUNDCARD-DRIVER-ERROR.
  710.       With my new drivers, I did not have this problem any more.
  711.   *) When enabling DART in the Configuration-Dialog, but you do not have installed
  712.       DART on your computer, the program will crash when you start it even before
  713.       the window appears. The only way to get the program to start again, is
  714.       to start MRRESET.EXE first, so that the critical options ( like DART )
  715.       will be set back to uncritical values.
  716.   *) If you play the game together with one or more players and you recognise,
  717.       that some pressed keys don't function, then it's NO(!) bug. This is a
  718.       problem of the keyboard's hardware. You cannot press as many keys as you
  719.       want at the same time.
  720.   *) If you are using DART: Changing the Sound-Device from shared to non-shared
  721.       or vice versa (in the Settings-Options) does not work yet. The changing
  722.       effects only when you end and restart the program.
  723.       But still it makes problems playing sounds, when using DART in shared
  724.       mode. Cause when another program plays a sound, the game won't play
  725.       any more sounds. Only stopping and restarting the program will make
  726.       the sounds play again. So if you are using DART, it is better to use
  727.       mode Non-Shared (in the Settings-Options).
  728.  
  729. CORRECTIONS IN VERSION 1.0
  730.   *) Sometimes it occured, that the game paused for some seconds or even
  731.       stopped the execution. This only happened, when sounds were on.
  732.       This, I found out, was a problem of the game's architecture. In the
  733.       version 1.0, there are two threads with larger message queues to
  734.       reduce the occurrence of this error. If it ever should happen again,
  735.       then release the keys as fast as you can and wait till the game
  736.       continues ( if it does, hopefully ). But I think, in this version, this
  737.       should not happen again. ( The best would be to set the threads'
  738.       priorities to their defaults by pressing the Default-Button in the
  739.       "more"-Section of the Settings-Dialog (see above) ).
  740.   *) In higher levels it could happen in V0.9, that the protector ( this
  741.       is the dark shield-ball ) disappeared and no more protector could
  742.       be picked up. This error has been corrected in V1.0.
  743.   *) Sometimes, when entering a name in the Hiscore, ending the program and
  744.       starting it again, it could happen, that some names in the Hiscore are
  745.       truncated. In version 1.0, this error is corrected.
  746.  
  747. SOME HELP
  748.   *) If you have installed MMPM and the WAVE.DLL is in the directory of the
  749.       game, but the game says, it can't load the WAVE.DLL, then look in
  750.       the LIBPATH in the CONFIG.SYS. The beginning should be:
  751.          LIBPATH=.;
  752.       With this setting, DLLs will be searched in the actual directory first.
  753.  
  754. TO COME
  755.   Currently I am working on :
  756.     *) some more extras and dangerous objects
  757.     *) more features for the Turret-Gun
  758.     *) the possibility to split a Turret-Gun from its Ship, so they
  759.          must not play any longer in a team
  760.     *) DIVE-support to make the graphics and animations faster
  761.     *) making the sound processing better for both MMPM and DART
  762.     *) MIDI-background-music support
  763.     *) Joystick-support
  764.     *) maybe playing together on different machines
  765.     *) implementing a help-function or if not, I will write an INF-file.
  766.     *) hopefully correcting bugs
  767.     *) And of course your suggestions :-)
  768.  
  769. DISTRIBUTION CONDITIONS
  770.   You are free to distribute this shareware version of Masterroids as long as
  771.   the following conditions are met:
  772.     1) The distributed archive must contain ONLY the files listed above.
  773.     2) The contents of this archive are NOT MODIFIED in any way.
  774.     3) This version is not to be sold.  However, a reasonable disk copying fee
  775.        is permitted.
  776.  
  777. DISCLAIMER  (as usual :-)
  778.   The author of this program accepts no responsibility for damages that
  779.   are caused by this program and make NO WARRANTY or representation,
  780.   either express or implied, with respect to this software.  This software
  781.   is provided "AS IS," and you, its user, assume the entire risk when you
  782.   use it.
  783.  
  784.  
  785. SOME EXTRA NOTES:
  786.  
  787. Where to get emx
  788. ----------------
  789.  
  790. emx (and the emx.dll) is available for anonymous ftp on
  791. (The emx.dll is not necessary any more since Masterroids Version 1.0).
  792.  
  793.   ftp.uni-stuttgart.de [129.69.18.15]: /pub/systems/os2/emx-0.9a
  794.   ftp-os2.cdrom.com:  [192.153.46.2]:  /os2/32bit/unix/emx09a
  795.   src.doc.ic.ac.uk     [146.169.2.1]:  /packages/os2/32bit/unix/emx09a
  796.   ftp.informatik.tu-muenchen.de [131.159.0.198]:
  797.                                        /pub/comp/os/os2/devtools/emx+gcc
  798.  
  799. By the way:
  800. -----------
  801.  
  802. Have you seen "SYSMON20.ZIP" on
  803. ftp-os2.cdrom.com:  /pub/os2/incoming (or another directory) ?
  804. It's a system monitor program and very helpful program which tells you what's
  805. happening in your computer and offers some advantages. It shows you time,
  806. date, the processor's execution time, virtual memory, swap file, info
  807. about your drives and more. There are features like different versions to
  808. shutdown your system and restart it automatically, a new tasklist,
  809. an option to start programs, ...
  810.  
  811.  
  812. Please excuse that I am not able to answer your mails very often or fast.
  813. I have an account from the university and no modem. So I will look for
  814. mails only about once a week. Sorry :-)
  815.  
  816. So, at last, I only can say:
  817. Have fun with the game !
  818.