3 releases
0.1.2 | Sep 22, 2023 |
---|---|
0.1.1 | Sep 22, 2023 |
0.1.0 | Sep 21, 2023 |
#89 in Rendering
69 downloads per month
93KB
2K
SLoC
Skylights
Skylights is a command line tool to bake radiance and irradiance maps for image based lighting.
It converts an input environment map in equirectangular format into 3 cubemaps:
- Radiance
- Irradiance
- Environment map to use optionally as a skybox
Usage: skylights [OPTIONS] [input-image]
Arguments:
[input-image] Environment map to process
Options:
-x <cubemap-side> Side of the output cubemaps in pixels [default: 1024]
-f <pixel-format> Output cubemaps pixel format [default: rgba16f] [possible values: rgba32f, rgba16f]
-e <encoding> Output cubemaps image encoding [default: ktx2] [possible values: ktx1, ktx2, dds, png]
-n <num-samples> Number of samples per pixel when calculating radiance and irradiance maps [default: 128]
-m <strength> Scales the final baked value in the radiance and irradiance maps [default: 1]
-c <contrast> Corrects the contrast of the final color [default: 1]
-b <brightness> Corrects the brightness of the final color [default: 1]
-s <saturation> Corrects the saturation of the final color 0: grayscale and 1: original color [default: 1]
-u <hue> Corrects the hue of the final color in degrees. [possible values: 0..360] [default: 0]
-l, --lut Computes GGX LUT
-h, --help Print help
To use from Releases (Windows only)
- Download the latest release .exe from https://github.com/arturoc/skylights/releases
skylights --help
shows a help screen.- If the application shows an error about a missing dll you need the Visual Studio 2015, 2017, 2019, and 2022 redistributable from this page: https://learn.microsoft.com/en-US/cpp/windows/latest-supported-vc-redist?view=msvc-170#visual-studio-2015-2017-2019-and-2022 Or directly download the file from: https://aka.ms/vs/17/release/vc_redist.x64.exe Once installed skylights will work without problem.
To install:
- Install rust following the official Rust install guide: https://www.rust-lang.org/tools/install
- Restart the terminal so the search paths are updated.
- Install the latest cmake adding it to the path and a c++ compiler, in windows Visual Studio 2017 or later, or Build Tools for Visual Studio with the Visual C++ option. In linux gcc or clang.
- Use cargo to install the tool:
cargo install skylights
- Now skylights should be in the path and can be called from anywhere.
skylights --help
shows a help screen.
To build from source:
- Install rust following the official Rust install guide: https://www.rust-lang.org/tools/install
- Restart the terminal so the search paths are updated.
- Install the latest cmake adding it to the path and a c++ compiler, in windows Visual Studio 2017 or later, or Build Tools for Visual Studio with the Visual C++ option. In linux gcc or clang.
- Download the source from git:
git clone https://github.com/arturoc/skylights
- Build and run using cargo (add the corresponding parameters after the
--
):
cd skylights
cargo run --profile=debug-optimized -- --help
Skylights is sponsored by novorender
Dependencies
~33–69MB
~1M SLoC