***********************************************************
*                                                         *
*   Cal3d 0.10 PSP RC1                                    *
*                                       by                *
*                                           ginka         *
*                                                         *
***********************************************************

Introduction:
  
   Since I'm working on a 3D WorldForge client for the PSP, I need to
make and/or port various libraries to the PSP.  One of those libraries
is for character animation.   I will be releasing all the sources and 
required changes to the cal3D lib shortly - I just need to clean things
up a little.  

   The PSP demo I made up is based on the miniviewer_gl code with some
features brought in from the cally demo and some custom stuff from me.
Libraries used are pspgl and freetype2.


What is Cal3D?

  [ from http://http://cal3d.sourceforge.net/ ]
  Cal3d is a skeletal based 3d character animation library written in C++ in
a platform-/graphic API-independent way. Originally designed to be used in
a 3d client for Worldforge, it evolved into a stand-alone product which
can be used in many different kinds of projects.


Install:

  v1.5
    Just copy the cal3d and cal3d% directories to psp/psp/game.

  v1.0
    ?? 

  v2.x
    does it work?? Please let me know!  If it doesn't, I will try and
	get it working.
	
	
Controls:

   ANALOGUE NUB:
           UP :  zoom in
         DOWN :  zoom out
         LEFT :  rotate left
        RIGHT :  rotate right
	  
   LTRIGGER:  kick
   RTRIGGER:  wave
   LEFT:      go slower
   RIGHT:     go faster
   UP:        increase 'strut walk'
   DOWN:      decrease 'strut walk'
   
   TRIANGLE:  show skeleton
   SQUARE;    show grid
   CROSS:     decrease LOD
   CIRCLE;    increase LOD
   
   SELECT:  hide info display
   START:   exit demo
   
TODO:

   - increase performace.  
        - I want to switch to using PSP's native skinning feature
		- put vertex/texcoords/colours into native format
   - allow switching between characters
   - figure out why textured characters are slow ( I think I know why... )
   - collisions
   - many more items...

Future Plans:

   Continue work on full 3D WorldForge client.  Current status of 
   other projects I'm working on for the PSP;
     - cal3d
        - port working.  Needs more tweaking
     - Atlas-C++ 
        - ported and works
     - 3D widget toolkit
        - in progress.  basic window, fonts and (cool new)text input working
     - 3D renderer
       - in progress...

	   
THANKS:

   Much thanks to TyRaNiD for his work on pspsdk and 
     especially for psplink/pcterm/usbhostfs/usbgdb!!!!
   
   Jeremy Fitzhardinge for the awesome pspgl!!!

   
