Tamagotchi! 0.13
----------------
The virtual pet for hp48, after several months of waiting, while
I was working and studying, I finished this version, which is more
similar to the real one.

Any comments, suggestions, bugs or whatever send to bnll4@usa.net




CONTENTS
--------

        1. Introduction
                1.1 Copyright and Disclaimer
                1.2 The Tamagotchi! Library

        2. Installing and Removing the Tamagotchi! Library
                2.1 Installing the Library
                2.2 Universal Font Library (UFL)
                2.3 Bytes and Checksum
                2.5 Removing the Library

        3. Usage
                3.1 Commands
                3.2 Explanation of Keys

        4. Resources and References



1. Introduction
---------------

1.1  Copyright and Disclaimer
-----------------------------
All files in the Tamagotchi package are copyrighted(c) by bnll4
unless otherwise noted.

The software contained in this package is provided as free of charge
and therefore contains no warranty of any kind.  Should the Software
prove defective, you and not the author assume the entire cost of any
service and repair.  This disclaimer of warranty constitutes an
essential part of the agreement.


1.2 The Tamagotchi! Library
---------------------------
Tamagotchi! is a simulator of the real tamagotchi from Bandai
take care of your pet feeding, playing, etc.




2. Installing and Removing the Tamagotchi! Library
--------------------------------------------------
The Tamagotchi library requires at least ~11kb to install and an
auxiliary library called the Universal Font Library (UFL) must be present.


2.1 Installing
--------------
a) send the library to the HP48
b) put a copy of the library on the stack
c) enter the port number to store the library (0-33 GX, 0-2 SX)
d) here is an example of the stack setup so far:

   --------------------------
   4:
   3:
   2:   Library 1236:  TAM...
   1:                      0
   |   |   |   |   |   |   |

e) at this point, press [STO]
f) perform a warmstart with [ON][C] or turn on and off the HP48
g) erase the variable containing the library.  eg. 'TAMA013.LIB' PURGE
h) read the next section for the Universal Font Library (UFL)
   requirements


2.2 Universal Font Library (UFL)
--------------------------------
The Tamagotchi! library requires the UFL to be present.  Read the UFL
documentation from the UFL package (included) for more information
From the UFL package, one of two libraries must be present.  Either
ufl1.lib or ufl3.lib and not ufl2.lib because the Tamagotchi! library
requires FNT1.

If you have not installed one of the UFL libraries, install it now:

a) send the library(ufl1.lib or ufl3.lib) to the HP48
b) put a copy of the library on the stack
c) enter the port number to store the library (0-33 GX, 0-2 SX)
d) here is an example of the stack setup so far:

   --------------------------
   4:
   3:
   2:    Library 257: UFL...
   1:                      0
   |   |   |   |   |   |   |

e) at this point, press [STO]
f) perform a warmstart with [ON][C] or turn on and off the HP48
g) erase the variable containing the library.
h) The Tamagotchi! library is ready for use.


2.3 Bytes and Checksum
----------------------
Bytes: 11068.5
Checksum: # 68F9h



2.4  Removing the Library
-------------------------
a) :0: 1236 DETACH
b) :0: 1236 PURGE

Depending on which port number the library was stored, :0: in the
above can be replaced by the appropriate port number.




3. Usage
--------

3.1 Commands
------------

  TAMA - This is the only command pushing it will start a new
         pet or you can put a 'tama' string which contains all
         the characteristics of your old pet.


3.2 Explanation of keys
-----------------------


     [A]   eat
     [B]   play
     [C]   enject (ouch!)
     [D]   toile
     [E]   teach
     [F]   info

     [1]   select
     [2]   submit
     [3]   cancel

     [MTH] exchange between gr/oz weight measure
     [VAR] turn menu on/off

     [ON]  quit & push tama string game to stack


          NOTE: when you quit, you have to start a new hatched tama or
                put in stack a tama-string game to continue your game.






4. Resources and References
---------------------------
HPTools - PC based System RPL and Assembly Language compiler
          ftp://hpcvbbs.external.hp.com/dist/

Jazz - HP48 based System RPL and Assembly Language development tools
       http://www.hut.fi/~mheiskan/

UFL - Universal Font Library
      http://www.engr.uvic.ca/~aschoorl/ufl/

Arnold Moy - email: amoy@geog.ubc.ca
             WWW: http://www.geog.ubc.ca/~amoy/

             I used his matrix12.doc file to do this help, actually
             I asked him about it, but I didn't receive any answer.

Bnll4 - email: bnll4@usa.net
        www: http://members.xoom.com/bnll4/hp48.htm




---------------------------------------------------------------------------

       Next it's the help from Tamagotchi has hatched
       http://members.hknet.com/~ada/tama/tama3.html

By clicking on the 8 icons and the 3 pink buttons around Tamagotchi.
The three pink buttons, from the left to right, are A,B,C.

[A] button is select button: you can choose meal or cake (which means candies).

[B] button is submit button: make a decision.

[C] button is cancel button: abort your selection.

When Tamagotchi lives on earth for one day, it can gain one year older.
If you offer more meals or candies, it'll gain weight.
The score of manner shows Tamagotchi's personality.
"O" is a postive score and "X" is a negative score.

Offer Tamagotchi meals or candies by clicking [A] button and select
a meal or a candy and click [B] button.

The light bulb is inactive on the WWW.

Play game with Tamagotchi. This game is called "Atchi muite hoi" which is
popular in Japan.

Just predicate which side, right or left by clicking [A] button for left
and [B] for right.

If you can guess correctly which direction Tamagotchi would face, it'll have
a better mood.

When Tamagotchi is ill, there'll be a crainium appear. What you should do is
to offer it an injection.


When you find Tamagotchi's stools on the screen, you should flush it.

There is no function for the status icon since all the informaton of
Tamagotchi is displayed on the screen.

You should scold Tamagotchi when its manner becomes poor. Otherwise, the
virtual pet will grow into different shapes based on its personality.

The help icon is inactive on the WWW.
----------------------------------------------------------------------------
