NAME

shader - compile shading language source into run-time shaders

SYNOPSIS

/usr/prman/shader [ −Iincdir ] [ −o outputfile ] [ −s srcfilename ] [ −v ] [ −q ] [ −Uname ] [ −Dname ] [ −Dname=def ] files ...

DESCRIPTION

shader translates shading language source statements into modules suitable for execution in the RenderMan run-time environment.  If the files specification is missing, shader looks for input on stdin.  Unless overridden with the −q option, the compiler prints the name of each shader module as it is compiled. 

OPTIONS

The following options are supported by shader. 

−Iincdir
This option is actually passed to and interpreted by cpp, the C pre-processor.  It specifies the directory in which to search for #include files.  Several such options may be given to shader and directories are searched in the order specified.  The default directory, /usr/prman/lib/shaders will be searched last. 

−U name
This option is passed to and interpreted by cpp.  It removes any initial definition of name, where name is a reserved symbol that is predefined by the particular version of cpp(1). See cpp(1) for the implementation-dependent list of these possibly reserved symbols.

−D name
This option is passed to and interpreted by cpp.  It defines name as 1 (one). This is the same as if a −Dname=1 option appeared on the shader command line, or as if a #define   name  1 line appeared in the source file that shader is processing. 

−D name=def
This option is passed to and interpreted by cpp.  It defines name as if by a #define directive. This is the same as if a #define   name  def line appeared in the source file that shader is processing.  The −D option has lower precedence than the −U option.  That is, if the same name is used in both a −U option and a −D option, the name will be undefined regardless of the order of the options. 

−o outputfile
By default, shader places its output in a file named "shader_name.slo" where shader_name is the name of the shader as specified in the shader definition statement in the source file.  Note that this is not necessarily the same as the source file name.  The -o option allows the user to override this default naming convention.  It should be used with care since the run-time system looks for shader executables according to the default naming convention.  The outputfile specification may be either a file name, in which case output is written to the specified file, or one of the following special names:

− Write the output to stdout

−src Derive an output filename from the source filename by removing any directory prefix and a .sl suffix and appending a .slo suffix. 

−shader Derive the output filename from the name of the shader and the .slo suffix.  This is the default. 

−s srcfilename
This allows specification of the original source file name in those cases where it may be difficult or impossible to infer it otherwise (e.g., when the source file is being cated to stdin).}

−v The verbose option produces more output from the compiler. 

−q The quiet option suppresses the normal printing of the shader module names as they are compiled. 

FILES

/lib/cpppre-processor
/NextLibrary/Shadersdefault include directory
/usr/prman/shadershell front end
/usr/prman/lib/shadecomcompiler executable
\RMAN\LIB\SHADECOMcompiler executable {PRMAN}Tools:shadecom compiler executable

FILES

FILES

Release 3.0  —  August 14, 1991