Readme
------
by Jeffrey Ladino

This file describes the basics of my Computer Graphics project for
COM1370, Summer 1999.

*************************

The source and documentation files in my project are listed below:
-rw-r--r--   1 jnl      users        1537 Aug 25 12:57 Desc
-rw-r--r--   1 jnl      users        1731 Aug 25 12:57 Desc2
-rw-r--r--   1 jnl      users        1625 Aug 25 12:54 Makefile
-rw-r--r--   1 jnl      users        7741 Aug 25 12:45 bb.cpp
-rw-r--r--   1 jnl      users        1437 Aug 25 00:31 bb.h
-rw-r--r--   1 jnl      users        5096 Aug 22 19:53 character2d.cpp
-rw-r--r--   1 jnl      users        1046 Aug 22 16:50 character2d.h
-rw-r--r--   1 jnl      users        1885 Aug 22 15:00 circle2d.cpp
-rw-r--r--   1 jnl      users         587 Aug 22 15:00 circle2d.h
-rw-r--r--   1 jnl      users        6927 Aug 25 13:30 main.cpp
-rw-r--r--   1 jnl      users        3073 Aug 22 15:00 matrix3d.cpp
-rw-r--r--   1 jnl      users         745 Aug 22 15:00 matrix3d.h
-rw-r--r--   1 jnl      users         939 Aug 22 15:00 point2d.cpp
-rw-r--r--   1 jnl      users         535 Aug 22 15:00 point2d.h
-rw-r--r--   1 jnl      users        1782 Aug 22 16:01 shape2d.cpp
-rw-r--r--   1 jnl      users         540 Aug 22 16:02 shape2d.h
-rw-r--r--   1 jnl      users        8949 Aug 22 15:00 simpledraw.cpp
-rw-r--r--   1 jnl      users        2347 Aug 22 15:00 simpledraw.h
-rw-r--r--   1 jnl      users        2827 Aug 22 16:27 transforms.cpp
-rw-r--r--   1 jnl      users        1038 Aug 22 15:00 transforms.h
-rw-r--r--   1 jnl      users        1452 Aug 24 19:40 vector3d.cpp
-rw-r--r--   1 jnl      users         862 Aug 24 19:35 vector3d.h

Desc   - original proposal for this project.
Desc2  - second revision to this project's proposal.
Writeup - my detailed final writeup of this project.
main.cpp - the main() function for this project and other high level
functions.
simpledraw.* - simple window drawing class based on X11 provided by
Professor York.

All other files of the form <name>.h and <name>.cpp define a class of
<name>.  I created these in the course of this project and p3.

*************************

To make this project...

Just type 'make' at the command prompt from this directory.  This will
create an executable named "bounce" in this directory.

To clean out the object files type 'make clean'.
To clobber the executable and all object files type 'make clobber'.

*************************

To run this project...

Just type './bounce -h' to see Usage.  You will see this...

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

bounce -n <number_balls> [-r <radius>] [-w <windowSize>] [-h]

Options:
        -n sets the number of balls to appear on the screen from 1 to 99
        -r sets an integer radius from 1 to 100 (default=30)
        -w sets the windowSize from 200 to 1200 (default=600)
        -h prints this help message

radius * number_balls MUST be less than windowSize!
bounce will run forever... it must be terminated with a Control-C

Each ball gets assigned the following characteristics by pseudorandom numbers
        position
        velocity
        rotation
        colors

bounce is created by Jeffrey Ladino jnl22@ccs.neu.edu

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

Some nice options to run bounce with are:
./bounce -n 5
./bounce -n 3 -r 60 -w 700
./bounce -n 40 -r 12

Try these running configurations and others specified by Usage.  Don't
forget that bounce will run forever.  It must be terminated with
Control-C.


*************************

OS & Architecture

This code was built on an Intel x86 architecture running Linux kernel
2.0.36 with gcc and X11R6.  It also runs on Solaris 2.6 on a Sun Ultra
SPARC.

It should run with minimal changes on most UNIX systems that run X-Windows.

*************************

Please read Desc Desc2 and Writeup for more information on this project.