3.2.2 Command Line Options
As every compiler, shaderdl
understends a set of command-line options that control the compilation process, those are specified before the input file name:
| % shaderdl [options] shader.sl
|
There is no need to specify an output file name to shaderdl
since it is automatically set to the name of the shader (the identifier following the keyword surface
, displacement
, light
, volume
or imager
in the SL code) followed by the suffix `.sdl'.
Valid command line options are:
- `-d <directory>'
- Specifies destination directory for compiled shaders. The default is the
current working directory.
- `--dso'
- Generate object-code shaders. To use this option, you must have a C++ compiler installed. The compilation script included with 3Delight is configured to work with
CC
on IRIX, with g++
on Linux and with Visual C++
on Windows. If you have a different compiler installed, you will have to modify the compilation script. For more information, see section 3.2.3 Customizing the Compilation Script.
- `--int'
- Generate byte-code shaders (default).
- `-O<n>'
- Specifies the optimisation level, from 0 to 3. `-O0' turns off all optimisations, `-O1' optimises a little bit, `-O3' optimises aggressively. The default is `-O3'.
- `-w<n>'
- Sepcifies warning level:
- Disable all warnings (not recommanded);
- Log important warnings only (default);
- Log all warnings.
- `-I<directory>'
- Specifies a directory to search for
#include
'd files.
- `-D<symbol>'
- Defines a preprocessor symbol.
- `-E'
- Stops after the preprocessing step. See section 3.2.1 Compilation Process.
- `-c'
- Stops after the shading language to C++ translation pass. See section 3.2.1 Compilation Process.
- `--keep-cpp-file'
- `--dont-keep-cpp-file'
- Specifies whether or not to keep the intermediate files generated by the
preprocessor. They are not kept by default. See section 3.2.1 Compilation Process.
- `--keep-c++-file'
- `--dont-keep-c++-file'
- Specifies whether or not to keep the C++ files generated by the shading language translation pass. They are kept by default. See section 3.2.1 Compilation Process.
- `--no-array-check'
- Turns off array run time bound checking. Enabled by defaut.
- `--use-shadeops'
- `--dont-use-shadeops'
- Enable [disable] use of shadeops. Disabled by default.
- `-v'
- `--version'
- Print the compiler version number and exit.
- `-h'
- `--help'
- Print a help message and exit.
This document was generated
by Aghiles Kheffache on July, 31 2003
using texi2html
3Delight 1.0.0. Copyright 2000-2003 The 3Delight Team.
All Rights Reserved.