For the most up-to-date version of the FAQ's, please refer to the Cinema Graphics website. Often we will update the website with common questions about a new release after it has gone out.If your problem isn't in list below, contact us via email [email protected].
|1.0.0 - BEGINNER GOTCHYAS||
|1.0.1 Where do I start? Are there some examples?||
|1.0.2 How do I load (the desk, a .cpp file)?||
Loading Shader Source
You don't load shader source. The only way ShadeTree can use shader source code is when you create your own boxes; you put the source code in the box definition. To make your own boxes, please refer to the section CUSTOM BOXES in the Operation Box Description page.
|1.0.3 How do I save (the desk, the .cpp file, the .dll file)?||
Saving Shader Source
'File->Export->Shader Source' from the main menu bar will save shader source files (mray: .cpp files).
Saving Compiled Shaders
To save compiled shader files (mray: .dll files), use 'File->Export->Compiled Shader' File from the main menu bar.
|1.0.4 Is there a way to easily save out everything, then invoke a render?||
This lets you save out all the different file types; shader source, compiled shader, render interface, etc., even run a custom script after all the files have saved out.
The 'File->Export Options' menu lets you set the individual filenames for where each file is saved.
|1.0.5 Do the example ShadeTree files have any documentation?||
This opens a window that contains help documentation for the shader you currently have loaded. Most of the example shaders have help documentation. At some point they all will, time permitting.
You can enter text in this window when writing your own shaders..
|1.0.6 Can I make my own help docs for shaders I create?||
Try to follow the format shown in the template (when you hit 'File->New') or follow the format of the docs that comes with the examples.
|2.0.0 - NORMAL USE GOTCHYAS||
|2.0.1 I get an error in the text window when I hit render. What do I do?||
If you have a dotted line, right mouse on the button at either end of the dotted connection, and enter the 'Casts' sub menu, to see if you can change the cast to something that matches the other end of the connection.
If the error message in the text window is telling you what line number the error is in, then hit 'View Shader Source' in the RENDER menu (or hit the F9 key) and go to that line in the file; a few lines up there will be a comment that indicates which 'box' is generating the error, which may help you track the problem down.
|2.0.2 Won't render examples (can't find renderer, permission denied)||
|2.0.3 The image is not what I expected.. what do I do?||
|2.0.4 How can I render my scene, not just spheres and cylinders?||
Please refer to Custom Render Scripts for in depth information.
There are also several examples of custom render scripts in:
|2.0.5 I hit render, the machine slows down to a crawl.. what's up?||
Any of the following may help your situation:
|2.0.6 The sliders (along the left) take a long time to appear/disappear?||
However, you can make use of the FREEZE button (above the slider area). When FREEZE is enabled, you can select boxes without having sliders appear and disappear.
|2.0.7 When boxes get close together, the inter-connection lines do weird stuff.||
Boxes have a region next to their buttons where it needs space to create routes. Even if no lines exist their (yet), it reserves the space for them, so that when the lines are added, there is space for them to connect. It sort of forces the user to plan ahead of time, rather than have all the lines reroute, and do weirder stuff.
These examples graphically show these avoid regions; the more buttons on the box, the larger the region. These are areas where you don't want other boxes to be in, so that there's room for the lines to route up and down:
________________ ________________ |________________| |________________| :::::| | | | :::::| | | | :::::|___| | | :::::|___| | | :::::::::| | | | :::::::::| | | | :::::::::|___| | | :::::::::|___| | | :::::::::::::| | | | :::::::::| | | | :::::::::::::|___| | | :::::::::|___| | | :::::::::::::::::| | | | :::::| | | | :::::::::::::::::|___| | | :::::|___|________|___| :::::::::::::::::| | | | :::::::::::::::::|___| | | :::::::::::::| | | | :::::::::::::|___| | | :::::::::| | | | :::::::::|___| | | :::::| | | | :::::|___|________|___|
|3.0.0 - ADVANCED USER GOTCHYAS||
|3.0.1 What happens when you hit the 'Render' button?||
See Custom Render Scripts for more information.
|3.0.2 How do I render my own scenes?||
Also, see Custom Render Scripts for more in depth information.
|3.0.3 How do I render a frame range?||
These frame ranges are passed to all render scripts as environment variables:
STREE_SFRM - start frame STREE_EFRM - end frame STREE_IFRM - frame incrementAn example of a custom render script that uses these variables is shown in:
$STREE_DIR\mray\bin\cusom-render-animate See Custom Render Scripts for more information.
|3.0.4 Where's the source for some of these STREE_
However, if you really feel strongly about it, leave us a message, and we may be able to accomodate you, under certain circumstances.
|3.0.5 What libraries should I include when rendering over a network?||
|3.0.6 How do I set up ShadeTree to 'see' custom boxes I've created?||
|3.0.7 How do I setup ShadeTree to work with netrender?||
|3.0.8 How do I setup ShadeTree to work with a render queue?||
|4.0.0 - SYSADMIN/SETUP GOTCHYAS||
|4.0.1 My EDITOR variable is set, but (emacs, gemacs) doesn't load||
This variable is called STREE_EDITORCMD, and is usually unset unless you have particular needs. See the next question for serious hacking to make your favorite editor work.
|4.0.2 Won't render examples (can't find renderer, permission denied)||
|5.0.0 - INSTALLATION PROBLEMS||
|5.0.1 Can't start the software ... license error||
|Log File Name||$STREE_DIR\etc\elm\log.txt|
If not, you may not have properly keyed the software. See the install documentation for keying instructions.
If either is using Dialup Networking, your server code should have been generated when it was not in use. You may need to quit Dialup Networking to start ShadeTree. See the install documentation for instructions.
|5.0.2 We use subnets, and our redundant license servers can't see each other?||
You can use the STREE_ELMHOST environment variable to tell ShadeTree which hosts are running the license manager daemon:
To get the redundant license managers to see each other, either try to locate them all on your backbone, or enable broadcast routing.
|5.0.3 On startup, I get an error 'Cannot create "C:\temp\stree.273"'.||
When ShadeTree is invoked, it creates a temporary work directory called C:\temp\stree.###, where ### is the PID of the executable.
You can tell ShadeTree to use a directory other than C:\temp by changing the STREE_TMPDIR environment variable.
|5.0.4 I can bring up the interface, but can't find the examples to test it?||
Enter 'File->Open' from the main menu, and point the file browser at that directory.
If the directory isn't there, the software was probably installed somewhere other than C:\ShadeTree. To find it, try:
to see where your sysadmin might have put the distribution, then look for a directory called 'mray\examples'.
|5.0.5 I can load the examples, but it won't render an image?||
It probably isn't able to invoke the renderer. ShadeTree assumes your environment is already setup correctly to access the RenderMan (or mental ray) renderer.
|5.0.6 The elm license daemon won't start! The log says 'System date error'||
Please contact [email protected] for help with such problems.
Copyright (c) 1996-1998 Cinema Graphics Inc. All Rights reserved.