     O R Z U N O I D     7    -  The utlimate (?) arkanoid for Usgard!

             Programmed by Patrick Davidson (eeulplek@hotmail.com)

---------------------------------------) Table of Contents

                  1. Introduction ..................... 17
                  2. System Requirements .............. 33
                  3. Installation Instructions ........ 39
                  4. Copyright Conditions ............. 51
                  5. Playing the Game ................. 70
                  6. External Universes .............. 108
                  7. Bonus Blocks .................... 143
                  8. Contacting the Programmer ....... 195
                  9. Versions History ................ 221
               
1--------------------------------------) Introduction

   Orzunoid is an Arkanoid-style game for TI-85 calculators running the
Usgard operating system.  Development of this game (formerly called Lunoid)
began in April 1997 and after two years and many radical changes has finally
resulted in this product, Orzunoid 7.  Some of its amazing features include:


   - Multiple types of bricks
   - Falling bonuses
   - Ability to save the game and resume later
   - High score table holding 7 names
   - Multiple balls on-screen at once
   - External "universe" system allowing not only new maps, but also the
     addition of many more features to the game, including grayscale!

2--------------------------------------) System requirements

   - A TI-85 running Usgard 1.5 (or a TI-86 running YAS)
   - 4K of memory to store the game
   - Additional memory if you want to have add-on "universes" 

3--------------------------------------) Installation Instructions

    Since Orzunoid is an Usgard program, it is stored in the calculator as
an executable file rather than text.  Because of this, you cannot type in
the program.  You must send it to the calculator to load it.  If you have a
graph-link to connect the calculator to your computer, you can load it by
sending the string file "ORZUNOID.85S" into your calculator.  TI-85 users
must have the Usgard operating system installed first.  TI-86 users need a
shell supporting Usgard emulation installed when they run it.  If you
cannot connect your calculator to your computer, you must send it into your
calculator from another calculator that already has it.

4--------------------------------------) Copyright conditions

Since you did not pay me anything for the right to use this software, there
is no warranty of any kind.  This software has been tested, and at the time
of release the author was not aware of any serious problems with it.
However, there is still a possibility of unforeseen problems.  If you do
encounter any problems with this program, please inform me as soon as
possible (of course, I cannot guarantee that I will fix such problems).

All portions of the program made by me are copyrighted by me, but may be
freely used, copied, and/or modified with no restrictions.

However, I would appreciate if you at least do the following if you are
making a modified version:

 - Don't add any restrictions to its distribution or modification
 - Supply complete source code
 - Give me a reasonable amount of credit

5--------------------------------------) Playing the game

   To start the game, run the Usgard program called "Orzunoid" if you want
to use the built-in universe, or run a universe file (see section 6 for more
information on this) to use an external universe.  When the game starts, you
should first see the start-up screen.  If a saved game is present, you will
be asked whether to resume it or start a new game.

   If you restore a saved game, you go to the gameplay immediately.  If you
start a new game, you will probably see a title screen.  What exactly you
get depends on the universe you play.  The built-in universe will display
some instructions and ask you to select speed with function keys.  In this
case, F1 is the slowest speed and F5 is the fastest.  The F4 and F5 speeds
are currently very fast, so you probably shouldn't use them if you aren't
familiar with the game.  If you have played earlier versions of Orzunoid,
you should beware that the F4 and F5 speeds are much faster now.

   The gameplay itself is much like Arkanoid.  You move a paddle across the
bottom of the screen.  One or more balls move across the screen.  Your goal
is to destroy bricks by hitting them with the balls.  You lose a ball if it
falls off the bottom of the screen, and you die when you lose all of the
balls.  Different blocks will have different appearances, and may take
multiple hits to be destroyed.  Some can't be destroyed.  You win a level
when all of the destructible blocks are destroyed.  Sometimes bonuses will
drop when blocks are destroyed.  You can collect them to get things such
as extra points, extra lives, multiple balls, or extra capabilities such as
an expanded paddle.  The brick types and bonuses can vary a lot with some
external universe.  The controls (which also can vary) are:

Left Arrow     Move paddle left
Right Arrow    Move paddle right
Up Arrow       Slow down movement
Down Arrow     Save the game and exit
EXIT           Exit the game without saving
CLEAR          Give up the current life
2nd            Release ball
ENTER          Pause or unpause

6--------------------------------------) External levels

   Orzunoid 6.0 supports a complex external level system.  This system
allows "universe files" to provide not only extra levels but also to add
extra features to the game, such as lasers or new types of blocks.

   Unfortunately, the new system used in Orzunoid 6.0 is incompatible with
universe files for older versions of Orzunoid.  As a result, the old level
files can't be used under Orzunoid 6.0.  This includes the many files made
on the calculator by the original "OOCE" utility.  The new version of OOCE
(Orzunoid On-calc Editor), which is available from my web page, can create
levels in the new format as well as convert older levels.

   To start a new game from an external level, just run the level file.
You can save games in external levels the same as with the built-in
universe.  To restore a game saved in an external universe, it doesn't
matter whether you run from the level file or Orzunoid itself; the game can
locate it automatically.  It is required that the level file still be
present to continue the game.  It is very important *not* to rename the
level files, since this could confuse the game.

   If you are emulating Usgard on a TI-86, only the "YAS" shell seems able
to run the external level files correctly.  To run an external level, you
must mark the main "Orzunoid" string as an external variable, and then run
the level file to start the game.  The same procedure is also used when you
want to restore a saved game.

   One simple external universe (called SandBox) is supplied with Orzunoid.
You can visit the Orzunoid web page to get more level files.  A recently
released universe ("Tartarus") now adds grayscale to the game!

   If you ware an assembly programmer who would like to know how to program
extra features in level files, just send me E-Mail and I'll give you full
documentation on the universe system.

7--------------------------------------) Bonus blocks

   Some blocks will drop bonuses when you destroy them.  These give you
various things such as extra points, extra lives, or multiple balls.  All
bonuses are beneficial, so you don't need to worry about collecting
something harmful.  Here is a list of the basic types that are built-in to
Orzunoid (of course, they can vary with external universed):

   100 points
      - This piece looks like the number 100.  Whenever you collect it,
        you get 100 points.  (never would have guessed, would you?)

   Multi-ball
      - This piece looks like three balls next to each other.  When you
        collect it, it splits your main ball into three balls and gives
        you 5 points.

   Expander
      - This piece looks somewhat like <-->.  When you collect it, it
        will increase your paddle's length to twice what it noramlly is.
        In addition, you get 5 points.  If you collect this while you
        are already expanded, the paddle will stay the same.  You should
        still collect it because you will get 5 points.

   Extra life
      - This piece is shaped like a miniature paddle.  Can you guess
        what it does?  It gives you an extra life!

   Guard
      - This piece is a this solid line.  Collecting this puts a barrier
        across the bottom of the screen which prevents you from losing
        balls.  It can only reflect balls twice, and will go away after
        that.  If you collect another guard while one is already active,
        the effect is NOT cumulative.  However, you always gain 5 points
        whenever you collect this.

   Catch
      - This piece (which looks like a stretched H) allows you to
        hold the ball after catching it.  When you are ready to release
        it, press the 2nd key.  You can catch the ball 2 times for each
        of thes you collect.  You can accumulate more than two catches
        and always get 5 points for collecting this.

   Brick-thru
      - This piece looks like an arrow through a ball.  It is probably
        the most powerful piece in the game.  It causes all of your
        balls to fly straight through all bricks on the screen!  This
        runs out depending on the number of times the ball hits your
        paddle.  You get two hits each time you collect this.  If the
        ball hits your paddle too many times, the brick-thru goes away.
        You also get 5 points whenver you collect one of these.

8--------------------------------------) Contacting me:

If you find any bugs in this game or have suggestions or comments about it,
please tell me in E-Mail!  If you are writing to report a bug, please be
sure to tell me exactly what the problem is and describe exactly what you
did before the problem occured.  If you don't do so, it will be very hard
for me to tell what is going wrong!  You should also tell me which version
of Phoenix you have in any mail you send me.  My main E-Mail address is:

        eeulplek@hotmail.com

I will usually answer my E-Mail within a week.  If I don't, you can try to
write to one of my other addresses below.  I will not be replying from that
address, so if your E-Mail is set up to block all messages except those from
certain addressses, you'll have to send it to one of the other addresses and
un-block that address.  This sort of blocking has caused trouble for me
before since some people didn't even un-block the address they sent to.
The other addresses at which you can E-Mail me are:

        pad@ocf.berkeley.edu

You can always get the latest version of this game, as well as other
programs of mine, from my web page.  The addresses are:

        http://www.ocf.berkeley.edu/~pad/

9--------------------------------------) Orzunoid Version history

 [Since this section was getting extremely long, all of the information on
  versions prior to 6.0 was moved into the file ORZUNOID.HST]

Orzunoid 6.0 (27-December-1998) - 4094 bytes
   - Redesigned external level system (for the last time, I hope)
   - Optimized lots of stuff
   - Changed the title screen
   - Added 3 more built-in levels
   - Added contrast changer during pause

Orzunoid 6.1 (1-January-1999) - 4083 bytes
   - Fixed contrast changer
   - Data display optimized (F4 and F5 speeds are *much* faster)
   - Bonus block bug fixed
   - Bonus block positioning improved
   - Some other small optimizations

Orzunoid 6.2 (4-January-1999) - 4086 bytes
   - Fixed end-game bug that sometimes locked up the calculator
   - Fixed high score bug that could corrupt external levels

Orzunoid 6.3 - This version skipped due to a numbering error

Orzunoid 6.4 (2-February-1999) - 4093 bytes
   - Now saves only "permanent" section of DELc memory
   - Now displays Web page address on title screen
   - Incremented internal version number
   - Fixed spelling in highscore table
   - Optimized some code

Orzunoid 7.0 (6-April-1999) - 4083 bytes
   - Optimized name entry 
   - Updated title screen 

Orzunoid v7.1 (12-April-2010) - 4047 bytes
   - Updated addresses
   - Some small optimizations
