Please read this entire document before proceeding with an installation.
If you will be running a license server on your machine, follow these steps to license your new software:
The following 3rd party software must be on your machine to use ShadeTree for Windows NT:
ShadeTree launches a text editor under a variety of circumstances, e.g. when you choose to view generated shader source code.
The standard Windows text editor, Notepad, is invoked by default. You may want to use a more sophisticated editor with ShadeTree. You can override the default by specifying an alternate editor through an environment variable (EDITOR or STREE_EDITORCMD both work), or you can simply replace the NOTEPAD.EXE executable with another text editor.
A couple of popular shareware replacements for Notepad include NoteTab and EditPad and for the vi users, Vim. All report cursor positions as line numbers (unlike Notepad), which is practically essential when debugging.
At minimum, ShadeTree requires that the following environment variables be set:
STREE_DIR | The root directory for the installation (e.g. C:\ShadeTree) |
SI_LOCATION | The Softimage root directory (e.g. C:\Soft3D_3.7) |
The Microsoft C++ compiler (CL.EXE) and Perl interpreter (PERL.EXE) must be in the system path in order to use ShadeTree successfully.
In addition to the editor-related variables mentioned above, ShadeTree recognizes several optional environment variable settings:
Environment Variable | Description |
STREE_DEBUG | Increases the amount of diagnostic output sent to the log window when set to 1 |
STREE_ELMHOST | Can be used to specify host(s) running CinemaGraphics Elan License Manager service |
STREE_QUIET | Disables ShadeTree sounds effects when set to 1 |
STREE_TMPDIR | Specifies a temporary file directory (the default is the Windows temporary directory) |
STREE_MRAY_COMPILEFLAGS | Flags for the compiler (cl.exe) |
STREE_MRAY_LINKFLAGS | Flags for the linker (ld.exe) |
STREE_MRAY_RENDERFLAGS | Flags for the Mental Ray Renderer (ray.exe) |
ShadeTree creates temporary files in the standard Windows temporary file directory unless you specify an alternative location through the optional STREE_TMPDIR variable. Normally any directories created within the temp directory are cleaned up automatically when the program exits.
ShadeTree NT remembers the layout of its windows across sessions using the Windows registry. If you need to blow away these settings for any reason, use the Windows REGEDIT utility to remove the registry entries under "HKEY_CURRENT_USER/Software/Cinema Graphics". IMPORTANT: Do not edit the registry unless you are familiar with its purpose and role in the Windows O/S.
If you encounter errors in this document, please email [email protected] with the URL, and enclose an example of the erroneous text, and what you feel to be the corrections, if possible.
Copyright (c) 1996-1998 Cinema Graphics Inc. All Rights reserved.