3delight-helpers

3Delight command line utilities/helpers.

For now just a renderdl replacement.

Installation

1. Install Rust.

2. Run:

   cargo install delight-helpers
   

Helpers

rdl

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

USAGE:
    rdl
    rdl <SUBCOMMAND>

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] <FILE>...
    rdl render <SUBCOMMAND>

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:
    <FILE>...
            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 as an NSI stream to stdout/a file.

USAGE:
    rdl cat [OPTIONS] <FILE>
    rdl cat <SUBCOMMAND>

OPTIONS:
    -b, --binary
            Encode NSI stream in binary format.

    -g, --gzip
            Compress NSI stream using GNU zip format.

    -e, --expand
            Expand archives and procedurals.

        --expand-archives
            Expand archives only.

        --expand-procedurals
            Expand procedurals only.

    -o, --output <OUTPUT>
            Dump NSI stream to OUTPUT instead of stdout.

    -h, --help
            Print this help message.


ARGS:
    <FILE>
            The NSI FILE(s) to dump.