next up previous contents index
Next: The gmake Command Up: Setting up a Mirage Previous: Environment Setup

The newmirage Command

The newmirage command  creates a new Mirage project. It creates a subdirectory under the current directory and places a sample Mirage client program in it.

To create a new Mirage project type

newmirage <projectname>.

This creates a new directory called <projectname> containing three items: Makefile, <projectname>.c and <projectname>.key.

The file <projectname>.c contains the code to construct an example scene. The scene contains just one primitive object, a sphere stretched into an ellipsoid but the code demonstrates many mirage features. It shows how to create and position a camera and lighting for the scene. The object shows how to create a new primitive, perform a transformation on the object, define the material the object is made from and LINK the object into the scene.

The keyfile <projectname>.key  is a textfile containing a list of parameters that are input to the Mirage system. The default keyfile contains two keys: output-file-name-template and picture-size. The default template for naming output files is anim%d.tif where %d is the frame number. The default picture size is set to width = 400 and height = 300. There are several other keys that can be added to the keyfile these are discussed in section 18.



Sophie Day
Fri Feb 20 15:47:19 NZDT 1998