---------------------------------------------------------------------- 
			 	S.M.A. V 0.38
---------------------------------------------------------------------- 


I. License
	I.1	Distribution license
	I.2	Disclaimer of warranty

II. Requirements
	II.1	Hardware & software
	II.2	Libraries
	II.3	Memory

III. First contacts
	III.1	Run it !
	III.2	Menu
	III.3	Game
	III.4	Features

IV. Documentations
	IV.1	To do
	IV.2	History
	IV.3	Thanks
	IV.4	Staff
	IV.5	Bugs

----------------------------------------------------------------------
	               S.M.A. DISTRIBUTION LICENSE
----------------------------------------------------------------------

	      (c) 1999-2001 by Pelissier Patrick. 


All the files of the archive sma.zip are copyrighted 
(c) by Pelissier Patrick except for the files in the directory
'Distrib' which have their own distribution license. Read their docs.

This License applies to all the files of the archive except
for the files in the directory 'Distrib'.

Permission to make and distribute verbatim copies of S.M.A.
is granted provided that the copies are not made or distributed 
for resale (excepting nominal copying fees) and provided that you
conspicuously and appropriately include on each copy the Copyright
Notice and Disclaimer of Warranty as well as this License.

Using any file of S.M.A. or portion thereof in any commercial program 
is prohibited.
Reverse-engineering, debugging, disassembling, is prohibited
without the permission of Pelissier Patrick.

By copying, modifying or distributing S.M.A. (or any program based on)
you indicate your acceptance of this license. All these actions
are prohibited by law if you do not accept this license agreement.  



----------------------------------------------------------------------
			Disclaimer of Warranty
----------------------------------------------------------------------

THE COPYRIGHT HOLDERS PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF
ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE. IN NO EVENT WILL THE COPYRIGHT HOLDERS BE LIABLE TO YOU FOR
DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL
DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM.



----------------------------------------------------------------------
				Requirements
----------------------------------------------------------------------

 Well you need a calc (amazing not ?)
	+ a TI-92 II with Fargo II (0.2.7.1).
	+ a TI-92 +  with DoorsOs II / UniOs / TeOs
		and ROM v1.0x, v2.0x
	+ a TI-89    with DoorsOs II / UniOs / TeOs
		and ROM v1.0x, v2.0x

Sorry, but you can't use a normal TI-92 (memory !!).

To get these OS-extender, you can go to:

English	http://www.tinews.net
	http://www.ticalc.org
	http://www.calc.org

French	http://www.ti-fr.org
	http://www.ti89clairnet.fr.st

To get the latest version of sma, check at 
	http://www.ti-fr.org/t3



----------------------------------------------------------------------
				LIBRARIES:
----------------------------------------------------------------------
Just need libraries for TI-92+ or TI-89 :
	_ filelib v??
	_ genlib v0.99.19
	_ shrnklib v1.00.P2
	_ pk92lib v1.20.P1 recompiled for ROM 2.0x

For TI-92, you need :
	_ filelib v??
	_ genlib v0.99.19
	_ shrnklib v1.00.P2
	_ pk92lib v1.20.P1
	- flib v??


/**********************************************************************\
|                                                                      |
| YOU MUST HAVE THE RIGHT AND THE MOST RECENT VERSIONS OF THE LIBRARIES|
| IN ORDER FOR THE GAME TO RUN CORRECTLY.                              |
|                                                                      |
\**********************************************************************/




  All levels, graphics, external-sprites will work on either a TI-89,
  TI-92, or TI-92 Plus. Also, the header of TI-89/92(Plus) level sets
  must be changed slightly in order for TI-Graph Link(TM) for TI-92 to
  accept them.

/**********************************************************************\
|                                                                      |
| SO YOU JUST HAVE TO RENAME THE 9XS FILES IN 92S OR 89S !!!!!!!       |
|                                                                      |
\**********************************************************************/
 


----------------------------------------------------------------------
				MEMORY:	
----------------------------------------------------------------------

 You need about 80Kb in average to run its program.
 You need about 60 KB more if you have archived 'sma'.
 If you want to archive sma, the best way is to use a compressor program 
such as 'runc' (Get it at http://www.ti-fr.org/t3)
 You can and SHOULD archive all the files.

 If you don't have enought memory free, :
	+ Run it directly under Home Screen without using an explorer
	+ Delete all useless variables.
	+ Archive as variables as possible.
	+ Select only one plane.
	+ Erase 'Monster' (You won't have any monster)

NOTE FOR FARGO II USERS :
 Although sma doesn't always crash your calc, I recommend to use 'FPL' for
executing it. If nothing works, try FPL's [On]+[Esc] shortcut. 
 If you're using FPL, don't hesitate to use it's compression feature.




----------------------------------------------------------------------
				RUN:
----------------------------------------------------------------------
	
	First, install the OS-Extender (Fargo, PlusShell, DoorsOS, ...).
	Read the doc of the OS to install them !

	Send :
		+ Main program	: sma
		+ Graph files	: gfx, gfxruins, baqua, ...
		+ Level files	: chaos, wlds, plant, ...
		+ Sprites files	: monster
	
	And the libraries (See below).

	Finally, press 'sma()' in the home screen to run it.



----------------------------------------------------------------------
				Levels:
----------------------------------------------------------------------

A world is composed of :
	+ Graphics files : Example : Gfx, gfxruins, baqua, ...
	+ Main Level files : Chaos1
	+ Sub level files : Chaos2, chaos3, Chaos4
	+ Sprites/Plug-in files: Monster
	
In the archive, you have 3 worlds :
	+ Wlds : basic world that I use only for beta testing... (Not very fun).
	+ Chaos : 4 huges zones of 2 acts with no boss.
	+ S2 : Some famous levels :)

----------------------------------------------------------------------
				MENU:
----------------------------------------------------------------------

 The current item is the middle one !
	* Press ESC to escape (Return to TI-OS or a shell).
	* Press Up / Down to select something.
	* Press F1 or 2nd to select something.

	New Game
		-> Enter a valid file-name for the save-file or hit enter 
		if you don't want to save.
		-> Select world
	Load game -> Select save-file.

Options:
	Speed : Sonic speed (* Sloooww, ** Normal or *** Crazy)
	Turbo : On (30 Hz) or Off (15 Hz)
	Plane : 1 Display only first plane / 2 Display both planes.

In the game, you can use the standart virtual pad of GenLib.
	+ Up /Down /Left/ Right ..
	+ '+' or '-' : Adjust the contrast
	+ F1 or 2nd to jump.
	+ Esc to quit.
	+ 'Apps' : pause the game and turn off the calc.


----------------------------------------------------------------------
				GAME
----------------------------------------------------------------------
	
	'S.M.A.' is a 'Sonic the hedgehod like'.
 The source code for this game is completely original and was written 
 without knowledge of the source code for any Sega game.
(It is really hard to create such a engine ;-)
	It will be available as soon as the program is finished.



----------------------------------------------------------------------
				FEATURES
----------------------------------------------------------------------

 _GrayScale.
 _Parallax scrolling !
 _Huge levels !
 _Hight compression ratio.
 _World Developement Kit (WDK)


----------------------------------------------------------------------
				To do:
----------------------------------------------------------------------

 _Levels : Ice cap / Wood / Death Egg / Sky Sanctuary
 _Boss



 ---------------------------------------------------------------------------- 
			  	History
 ---------------------------------------------------------------------------- 
v0.20 ? : First public release

v0.25 : * Add sprites / Fixed 'sprite bugs'
	* Fix many bugs.

v0.27 :	* Add world
	* Add save
	* Add Menu
	* Change 'sprite' format for compatibillity with external
	* Add multi-speed / multi-skill
	* Add 'Saving point'
	* Improve 'Animation engine'
	* Add other things ?
	* Fix many bugs.

v0.28 : * Rewrite the engine of the main character.
	* Fix many bugs
	* Add many bugs.
	* Add World Developement Kit.
	* Fix a crash bug of 'filelib::writefile' function.

v0.29 : * Add 'Special effects'
	* Fix some bugs
	* Add many sprites
	* Add monster check routine
	* Add many other features

v0.30 : * Fix bugs, bugs and bugs.
	* Add features but I forget what !
	* Hardware v2.00 : ok !
	* Add bugs, bugs and bugs...

v0.31 : * Finish 1st act of Chaos !
	* Add one act in chaos
	* Fix many bugs in editor
	* Fix / add bugs.
	* Fix & Improve (?) the tubes.
	* Add some objects.
	* Optimize the fargo version (less memory needed).

v0.32 : * Add Aquatic ruins act 1
	* Add Aquatic ruins act 2
	* Fix some level errors	
	* Fix / add bugs.
	* Improve Sonic engine
	* Add one special effect.
	* Fix a crash bug (Odd adress :()
	* Fix a minor bug in scrr

v0.33 : * Improve the breakable blocks. It should work fine now.
	* Improve the physics of the main character.
	* Increase explosion time.
	* Sprite files can be archived now.
	* Conversion the doc from Unix text format to Dos text format :)

v0.34:	* Change the menu
	* Another version of the physic engine
	* UpDate Sonic engine : now Sonic takes off more easily.
	* Fix / add bugs.
	* Add Toxic Plant act 1
	* UpDate Sonic engine
	* Add Turbo mode
	* Add plane option
	* Improve the levels
	* WARNING : CHANGE LEVELS FORMAT (BUT NOT SIGNATURE).
	 BE SURE TO HAVE THE CORRECT LEVELS

v0.34+: * Correct some minor things in the package.
		-> Add the libraries since it seems that nobody got the right libraries
		-> Fix the Ti-graph-link / gfx files problem (I hope)
		-> Fix a key problem (use new genlib !)

v0.34++:* Fix the crash bug with the file 'monster'.
	  Sorry I was very stupid...
	* Other minor changes.

v0.35 : * Add 3 badnicks !
	* Improve the logic of the badnicks
	* Add 4 new actions for Sonic !
	* Add Plant act 2 !
	* Improve the back ground of Aquatic Ruins a lot !
	* Optimize the code.
	* Fix / Add some bugs :) / :(
	* Add Big blocks (64x64 !)
	* Improve water effects
	* Improve the allocation of the memory in case of only one plane.
	* Add Water !!

v0.36 : * Make Metropolis graphs
	* Improve a lot the way of working of the plat-forms !
	So, if you have made some levels (?) with plat-forms, you will 
	need to adapt them. Don't cry ! It is really better !
	* Remove a crash bug ! - Cool !-
	* Add crash handler by Patrick Davidson
	* Fix a bug with save
	* Fix a bug with plat_form
	* Add two new ennemies Buzz / Monster
	* Finish Plant act 2
	* Start Metropolis Act 1
	* Don't need anymore 'Graphlib', 'userlib' and 'ziplib' !
	* Add Horizontal Flipping animation tile
	* Add Multi-texturing animation tile
	* Fix a bug with an action.
	* Add a new sprite-object : (Delete Test if speed is not enought)
	* Fix a stupid bug in monster (as usual)
	* Modify the scroll center routine
	* Add the ability of erasing monsters without graphs
	* Port to Fargo II (in fact, update smalib)
	* Improve the display routines (In fact, improve the double-buffer !)
	

v0.37 :	* Fix a bug in the calcul of the dot product.
	* If you hit ENTER at the save-file screen, you will start with no save.
	* The spikes doesn't hurt you if you jump when you just tuch them.
	* More stars for invincibility
	* The flying debris move a little slower.
	* When you hits a low ceiling, you will come right back down instantly.
	* Separate the Data & the code (smadata)
	* Add an End screen & an introduction
	* Start working on Bonus Levels.
	* Fix some bugs when not enought memory.
	* Fix some bugs in the engine.
	* Now you could link the worlds between them (i.e., when you finish Chaos, you will have plantwld...)

v0.38 : * Fix many minors things.
	* Increase game play : the control is more precise.
	* Add 'Moon Gravity' Option.
	* Add 'Circle Light' Option.
	* Add the ability of running on the rock face ! (2 new actions) - Very fun -
	* Change the surfaces properties, to get more speed.
	* Fix a bug in the TURBO mode (Animation & timer was too fast).
	* Fix the jump bug with the plat-form

 ---------------------------------------------------------------------------- 
			  	Thanks
 ---------------------------------------------------------------------------- 
 
 Special thanks:	David Ellsworth 
			Thomas Corvazier 
			David Khling 
			Patrick Davidson 
			Rusty Wagner 
			Xavier VASSOR 
			Scott Noveck
 
 Thanks:		Ian D. Mead & Laurent Feltz for UltraEdit 


-------------------------------------------------------------------
				Staff
-------------------------------------------------------------------

Code & graphics by Patrick Pelissier
Level design & map by Cedric Pelissier
Beta test & other things by
 Lars Harrison, Nathan Karren,
 Etan21, PpHd, Technic,
 AtomX, Segaman, Iceman, Rage2000, BillBob


----------------------------------------------------------------------
				KNOW BUGS :
----------------------------------------------------------------------

 + Sometimes the sprites don't apears if you run too fast.


----------------------------------------------------------------------
				NEW BUGS :
----------------------------------------------------------------------

If you find any bugs in this game or have suggestions or comments about it,
please tell me. 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. You should also tell me which version of Sma, calc, ROM
and OS you have in any mail you send me.
If you can, please send me a screen-shot of the bug, or an animated
screenshot of what you are doing before having the bug.
 
 ppelissi@caramail.com
 www.ti-fr.org/t3