"bin"
.
To start Ayam more easily, you can add an icon to your desktop by double
clicking on the "make_shortcut.vbs"
script.
Since Ayam 1.8 there are also two more scripts named
"make_ftassoc.vbs"
and "remove_ftassoc.vbs"
that add and remove a file type association with Ayam scene files
(extension .ay) to/from your desktop.
If you get error messages about input or output file handles
when trying to render directly from Ayam, please use the
accompanying batch file "ayam.bat"
to start Ayam
instead of directly using "ayam.exe"
.
"Edit/Preferences"
) are
automatically saved when you leave Ayam."$(HOME)/ayamrc"
if the environment variable
"HOME"
exists"$(TEMP)/ayamrc"
else.
The following steps need to be done if you (for some reason)
do not like it that way, or the preferences end up in silly
places (e.g. Win95 is setting your $(HOME) to "C:/"
, so that
the preferences are saved to "C:/ayamrc"
...).
However, if everything is fine with you, just skip to Step 2 now.
You can change the path and filename of the preference settings
using the environment variable "AYAMRC"
.
How do you set an environment variable?
An easy way to do this is to edit the batch file "ayam.bat"
,
and use it to start Ayam (this route does not work on Windows-NT4!):
"ayam.bat"
"rem"
from the line
"rem SET AYAMRC=D:/Ayam/ayamrc"
"D:/Ayam/ayamrc"
to a more
appropriate setting; notice that the drive and the path you use already
have to exist, and that you should have write permissions to the path
that you choose
"ayam.bat"
"ayam.bat"
to start Ayam
"ayam.bat"
to start
Ayam in the future
"Start/Control Panel/System/Advanced/Environment Variables"
"AYAMRC"
and set it e.g. to
"D:/ayam/ayamrc"
;
notice that the drive and the path you use already have to exist,
and that you should have write permissions to the path that you choose
"Start/Settings/Control Panel/System/Environment"
"AYAMRC"
(On Win2000 you need to be administrator to be able to do this.)
and set it e.g. to "D:/ayam/ayamrc"
;
notice that the drive and the path you use already have to exist,
and that you should have write permissions to the path that you choose
"Run"
and enter "sysedit"
, then click "Ok"
.
Select the window that is displaying "AUTOEXEC.BAT"
.
Add the line"Start/Programs/Accessories/System Tools/System Information"
.
This brings up a window titled "Microsoft Help and Support"
.
From here, choose the "Tools"
menu, then select the
"System-Configuration"
utility. Click the
"Environment"
tab.
Add a new variable named "AYAMRC"
and set it e.g. to
"D:/ayam/ayamrc"
;
notice that the drive and the path you use already have to exist,
and that you should have write permissions to the path that you choose.
"Main/AutoSavePrefs"
.
If you switched off "AutoSavePrefs"
, you can enforce saving
of the preferences using the menu entry "File/Save Prefs"
.Remember: NEVER use backslashes (\) in any path or filename you enter to Ayam.
"Main/Shaders"
.
Just open the preferences using the main menu entry
"Edit/Preferences"
and
enter the appropriate paths (separated by semicolons ";"
)
into the string entry labeled "Shaders"
."Scan Shaders"
button below and watch the
console for error messages.
Remember: NEVER use backslashes (\) in any path or filename you enter to Ayam.
In the directory "ayam/bin/plugins"
there are the following
shader parsing plugins:
aysdr.dll for Pixie, ayslb.dll for Air, ayslo3d.dll for 3Delight,
ayslo.dll for PRMan, and ayso.dll for RenderDotC.
The plugins may be loaded manually (using the main menu entry: "File/Load Custom") or automatically on startup of Ayam. In order to load a plugin automatically on startup of Ayam, just add the complete path and filename of the corresponding Tcl script (e.g. loadaysdr.tcl) to the "Scripts" preference setting and restart Ayam. The plugins have to be present in a directory called "plugins", which in turn has to be present in the directory where "ayam.exe" is located, in order to make this work. Your directory structure should look like this:
ayam/bin/
ayam/bin/ayam.exe
ayam/bin/plugins/ayslb.dll
ayam/bin/plugins/loadayslb.tcl
ayam/bin/plugins/...
Note that some plugins require additional DLL files to be present in the DLL search path. Depending on the flavour of your Win32 you may need to adapt the PATH environment variable to include the directories with those DLL files. You can also just copy them to the directory where "ayam.exe" is located. If a plugin does not find the corresponding DLL files it needs, you will get "invalid argument" Tcl error messages upon loading, or the plugin will fail to scan shaders later on.
Furthermore, all plugins have been compiled and tested against a specific version of the corresponding renderer (as outlined below); parsing shaders of other versions of those renderers possibly will not work.
ayslx.dll: Aqsis 1.0.1, does not depend on other DLL files
aysdr.dll: Pixie 1.7.4, depends on "sdr.dll"
ayslb.dll: Air 2.6, does not depend on other DLL files
ayslo3d.dll: 3Delight 5.0.2, depends on "3delight.dll"
ayso.dll: RenderDotC 3.4, depends on "soargs.dll"
Since RenderDotC compiles all shaders as shared native code (into DLL files),
all paths of the "Shaders" preference setting should also be present in the
DLL search path.
ayslo.dll: Photorealistic RenderMan 11.5, does not depend on other DLL files
aygso.dll: Gelato 2.0, depends on "libgelato.dll"
Remember: NEVER use backslashes (\) in any path or filename you enter to Ayam.
"Create/View"
."Special/Save Environment"
. This will save the environment
to the file given in the preference setting "Main/EnvFile"
.
The default setting is "~/2view.ay"
.
The tilde "~"
always expands to the home directory of the
current user. If you have a single or no user on your system you might want
to put an absolute path into the preference setting
"Main/EnvFile"
first (e.g. set it to
"D:/ayam/2view.ay"
).
Notice that the drive and the path you use already have to exist,
and that you should have write permissions.
"Main/LoadEnv"
,
as this would inhibit automatic loading of the working
environment on startup.
"File/New"
(provided that the
preference setting "Main/NewLoadsEnv"
is not switched off).
We are set.
Quit Ayam and start it again, check the console for errors; then
download "Tutorial #1"
from
http://www.ayam3d.org/
and read it.
For further information, see also the documentation of Ayam and the list of frequently asked questions (FAQ).