Creatures 3 Scriptorium V1.4
============================

This program allows you to browse the Creatures 3
Scriptorium. This is the portion of Creatures that holds all the CAOS
code for the objects and internal goings on of the world.

It is probably most useful for people who are interested in how things
inside Creatures 3 works or those who want to see a large
body of working CAOS code. It can also be useful for finding out what
effects a COB has on the environment.

It provides a 'Smalltalk' style browser allowing you to work through
the Family, Genus, Species and Events for all the scripts in the
world.

Selecting a 'family' with the mouse will cause all the genus for that
family to be displayed. Selecting a genus causes all the species in
that genus to appear. Selecting a species will cause all the events
available for that species to display. Selecting an event will
display the CAOS code for that event.

Only some of the entries have helpful descriptions. Creatures 3 
is an expandable game and scripts can be added by
Cobs. It's impossible to have descriptions available for every single
cob out there.

Usage
=====

1. Extract all the files into a directory of your choice.

2. Make sure Creatures 3 is running.

3. Run C3Scriptorium.exe to display the browser.

Troubleshooting
===============
1. I run the program but it displays a blank browser.

A. Creatures 3 is probably not running or it cannot make a
connection to it due to it being busy.

2. I double click on C3Scriptorium.exe but nothing happens.

A. Email me with details of your PC configuration and I'll try and
help.

3. I don't understand what all this CAOS stuff is. 

A. Try getting BobCob (http://www.frimlin.co.nz/bobware) - this is a
cob editing tool that may help. You should also arm yourself with the
CAOS documentation available for download at
http://www.creatures3.com.

Legal Stuff 
=========== 

The scriptorium browser is Copyright (c) 1999, Chris Double. All
Rights Reserved.

This application and the associated dynamic link libraries may not be
redistributed without my (me being Chris Double) permission.

Portions of this application are Copyright (c) 1998 Roger Corman, All
Rights Reserved. The development product used to produce it was the
Corman Lisp compiler. Details of this excellent product can be
obtained from http://www.corman.net/CormanLisp.html.

History
=======
V1.4 = Added checking of the mutex and process handle of the C3
       application. This allows the Scriptorium Browser to work
       correctly when run with other applications that use the
       C3 interface.
V1.3 = Removed the artificial delay while waiting for results and 
       wait on the C3 result event instead. This is much faster.
V1.0 = Initial Release.

Notes
=====
To see all of the scripts in the game you should make sure you've
entered a world first. If you run this program at the world selection
screen you will only see a subset of the scripts.

Creatures 3 runs in full screen mode by default. You should place the
game in windowed mode to make the most use of the program. To switch
to and from windowed mode, press 'Ctrl+Alt+Enter' when inside
Creatures 3.

And Finally...
==============
Any questions, comments or suggestions can be addressed to the Author:

Chris Double
http://www.double.co.nz/creatures
chris@double.co.nz
--
23 December 1999
Chris Double