Octane can be started from the command line, and supports command line options for loading scenes, meshes, and automated rendering.
Loading and rendering a scene.
To load an OCS scene file, give the filename as an argument: octane.exe "scene.ocs".
You can specify a mesh or a rendertarget to be rendered.
-t node : Render a rendertarget node.
-m node : Render a mesh node. You need to give the name of the mesh node, not the filename of the OBJ file (but they are often the same). If used in
combination with -t it will render this mesh instead of the mesh attached to the rendertarget.
There are two ways to load an additional OBJ mesh file:
-l file.obj : load file.obj into a new mesh node called file.obj . You can use this in combination with -m to start rendering this new node.
-r file.obj -m node : load file.obj into an existing mesh node, and render this node. This keeps the existing materials connected to this mesh node.
Some examples:
Load an OBJ file as a mesh node, and render the newly loaded mesh (using the settings in the preview render target). Since no scene file is given it will create a new scene.
octane.exe -l "mesh.obj" -m "mesh.obj"
Load a scene, and render a render target
octane.exe "scene.ocs" -t "myrendertarget"
Load a scene, load an OBJ file into an existing mesh node and render using settings from a render target
octane.exe "scene.ocs" -t "myrendertarget" -m "meshnode" -r "mesh.obj"
Changing render settings.
The rendering settings are normally taken from the selected rendertarget, or the default preview render target if only a mesh node is given. Many of
these settings can be overridden with additional options. For example -s 1000 will set the maximum amount of samples to render to 1000.
--film-width 1280 --film-height 720 changes the resolution. There are also options to change camera, daylight and exposure settings.
The output file is specified with -o for a standard PNG file. There are a few other output options, --output-exr for instance saves HDR output
to an EXR file.
Other options
Use -g 0 to render on the first GPU only. This option can be given multiple times to render on multiple GPU's.
Use -e to exit Octane after the rendering is done, and -q to suppress popup windows when loading a scene.
Run octane.exe --help for an overview of all options.
--
Roeland