Nebulae

A multi-threaded Nebulabrot renderer.

Building

• Install Rust, using the recommended "rustup" tool
• On the command line in the root folder, run cargo build --release
• Your executable, named nebulae will be placed in target/release

Usage

• On the command line, with nebulae available in your $PATH:

  • To render with default settings, just run nebulae

  • Change the output file name with the -c, --config <CONFIG> option:

    nebulae -o my_render.png
    

  • To get help, run nebulae help
    It should print the following:

    USAGE:
        nebulae [OPTIONS] [SUBCOMMAND]
    
    OPTIONS:
    -c, --config <CONFIG>     Configuration file
    -h, --help                Print help information
    -n, --no-intermediates    Do not write intermediate files
    -o, --output <OUTPUT>     File to write to [default: image.png]
    -V, --version             Print version information
    
    SUBCOMMANDS:
    help             Print this message or the help of the given subcommand(s)
    wizard           Display configuration wizard
    write-default    Write the default configuration to TOML
    

Configuration

Configuration files can be provided as .toml files, using the following as a template:

# Iteration multiplier for each of the red, green, and blue channels
# Must be an array of three integers
limits = [
  7740,
  2580,
  860,
]
# Number of random samples to take, per channel, per pass
samples = 1000000
# Number of passes to run
passes = 100
# Resolution of the rendered image (size × size pixels)
size = 2048
# Colour correction curve to apply (value between 0 and 1, raised to this power)
curve = 0.5

To pass use a configuration file, use the -c, --config <CONFIG> option:

nebulae -c my_config.toml

To output a configuration file (with wizard and write-default subcommands), use the -c, --config <CONFIG>" option:

nebulae wizard -s new_config.toml

To speed up total rendering time, you can choose not to output an image after each pass with the -n, --no-intermediates flag.

Subcommands

write-default

Simply prints the default configuration in TOML format.

wizard

Guides you through a simple configuration with some nice defaults.