This section contains general information about Ayam and this document.
Ayam is a free 3D modelling environment for the RenderMan Interface, distributed under the BSD licence.
Ayam was formerly known as "The Mops".
Here is a short summary of the Ayam feature set:
Since Ayam 1.12, dynamic loading of custom objects and certain plugins are also available on the Win32 platform (they were not available before)!
Ayam is primarily aimed at the Linux, IRIX, and Win32 platforms. On those platforms BMRT (Blue Moon Rendering Tools, a RenderMan compliant renderer by Larry Gritz) is available. Even though the distribution of BMRT is stopped it is still the recommended renderer for Ayam. Despite of this, Ayam may be used on many more platforms with any RenderMan compliant renderer.
For platforms where BMRT is not available (e.g. FreeBSD or NetBSD), Ayam may be compiled with code from the Affine Toolkit with limited functionality (see also the file INSTALL). In this case, no parsing of slc compiled shaders will be possible. Since Ayam 1.6 it is also possible to completely replace BMRT shader parsing and RIB writing by code from the Aqsis project, thus completely eliminating the need for BMRT. Furthermore, shader parsing plugins are available for all major RenderMan compliant renderers allowing a tight integration of Ayam with those renderers.
How should one read this manual?
Since this manual is intended to be a reference manual, it is probably pointless to read it from the beginning to the end (except maybe for the next section, explaining the basics). Instead, just look up the documentation of the things you are interested in via the table of contents or the index. Cross references will then guide you to other important parts of the documentation. Again: this manual has a rather large index, please use it (see section Index)!
This manual is organized in the following way:
After this first section, the user interface of Ayam is introduced and basic handling instructions for the application are given in the second section. In the third section all interactive modelling actions are documented. The fourth section details all object types and object properties, followed by documentation on all NURBS modelling tools in the fifth section. In the sixth section the Tcl scripting interface is explained and the following seventh section has all information about the import and export plugins. The eighth section is the dreaded miscellaneous section that contains documentation not fitting elsewhere.
In this manual, the following typographic conventions are used:
<Ctrl+c> (press control and
c key), for shortcuts like <Ctrl+Shift+t> an abbreviated
version: <Ctrl+T> will be used;"A Name";
set riopt(runtime) { a b }
+-Parent_Object(Type) | First_Child_Object(Type) | Second_Child_Object(Type) | [Third_Child_Object_may_be_present_or_not(Type)] | Empty_Level(Level) +-Sub_Level(Level) | | First_Child_Object_of_Sub_Level(Type) | \ Last_Child_Object_of_Sub_Level(Type) \ Last_Child_Object(Type)