3`delight-helpers`

3Delight command line utilities/helpers.

For now just a renderdl replacement.

Installation

Install Rust.
Run: cargo install delight-helpers

Helpers

`rdl`

``` rdl 0.1.0 Renders or filters NSI streams or Lua NSI files.

USAGE: rdl rdl

OPTIONS: -h, --help Print this help message. -V, --version Print version information.

SUBCOMMANDS: render Render an image of result with 3Delight. cat Dump the input as an NSI stream to stdout/a file.

‘rdl -h’ prints a brief overview while ‘rdl --help’ gives all details. ```

`render` Subcommand

``` rdl-render Render an image of result with 3Delight.

USAGE: rdl render [OPTIONS] ... rdl render

OPTIONS: --cloud Use 3Delight Cloud to render the specified file(s).

-d, --display
        Send 3Delight Display (a copy of) the image(s) being rendered.

-t, --threads <THREADS>
        Launch the render using number of THREADS.

-v, --verbose
        Print the names of the file(s) being rendered.

-p, --progress
        Print rendering progress at each bucket.

    --dry-run
        Do not render, just print the name of the file(s) to be rendered.

-f, --frames <FRAMES>
        FRAME(S) to render.
        They can be specified individually:
        1,2,3,5,8,13
        Or as a squence:
        10-15   ⟶   10, 11, 12, 13, 14, 15
        With an optional step size:
        10-20@2 ⟶   10, 12, 14, 16, 18, 20
        Step size is always positive.
        To render a sequence backwards specify the range in reverse:
        42-33@3 ⟶   42, 39, 36, 33
        With binary splitting. Useful to quickly check if a sequence has
        ‘issues’ in some frames:
        10-50@b ⟶   10, 50, 30, 20, 40, …
        The last frame of a sequence will be omitted if
        the specified step size does not touch it:
        80-70@4 ⟶   80, 76, 72

-h, --help
        Print this/a long help message.

ARGS: ... The NSI FILE(s) to render. Frame number placeholders are specified using @[padding]: foo.@.nsi ⟶ foo.1.nsi, foo.2.nsi, … foo.@4.nsi ⟶ foo.0001.nsi, foo.0002.nsi, … ```

`cat` Subcommand

``` rdl-cat Dump the input to stdout as an NSI stream.

USAGE: rdl cat [OPTIONS] rdl cat

OPTIONS: -b, --binary Encode NSI stream in binary format. -g, --gzip Compress NSI stream using Gzip format. -e, --expand Expand archives and procedurals. --expand-archives Expand archives only. --expand-procedurals Expand procedurals only. -o, --output Dump NSI stream to OUTPUT instead of stdout. -h, --help Print this help message.

ARGS: The NSI FILE(s) to dump. ```

3delight-helpers