This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
private:exrtrader2017:output [2017/07/24 14:15] – [Compression] lightwolf | exrtrader2018:output [2019/01/25 12:21] (current) – lightwolf | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Output ====== | + | ====== |
- | {{ : | + | {{ exrtrader2018: |
These options define how the output file(s) is named and where it is saved. | These options define how the output file(s) is named and where it is saved. | ||
Directories will be created by exrTrader if required. | Directories will be created by exrTrader if required. | ||
- | ===== Output File ===== | ||
- | This control allows you to select an output | + | The file names can either be absolute, or relative |
- | exrTrader | + | ==== Output Path ==== |
+ | This defines the base path for all written images. You can either use the path defined by LightWave 3D or select your own. | ||
+ | |||
+ | You can only select an output path if **Use Prefs Render Path** is not activated. | ||
+ | ==== Use Prefs Render Path ==== | ||
+ | |||
+ | If you select this option, exrTrader will use the output file defined in the Lightwave3D render globals. | ||
+ | |||
+ | This option is quite important if used across a render farm in conjunction with the OpenEXR Dummy Saver, described later in this manual. | ||
+ | |||
+ | ===== Layered File ===== | ||
+ | |||
+ | This control allows you to select an output file for the buffer saver to write to. The file name extension will be automatically removed, but is then added when saving. | ||
The currently supported variables are: | The currently supported variables are: | ||
+ | ^%#% - %########%| The frame number using 1 to 8 digits, zero padded.| | ||
^%scene%| Is replaced with the scene name (without the .lws extension)| | ^%scene%| Is replaced with the scene name (without the .lws extension)| | ||
+ | ^%sceneversion%| Version number of the scene (the last number in the scene name)| | ||
+ | ^%rendertime%| The time taken for the current render in minutes and seconds| | ||
^%camera%| The name of the camera used to render the current image| | ^%camera%| The name of the camera used to render the current image| | ||
- | ^%layer%| The name of the current layer| | + | ^%layer% / %buffer%| The name of the current layer, only valid for **Single Layer Files**| |
+ | ^%frameheight% / %framewidth%| Height/ | ||
+ | ^%fps%| The current frames per second| | ||
+ | ^%time%| The time of the current frame within LightWave in seconds.| | ||
^%eye%| If the current camera is rendering in stereo mode, this will be either L or R depending on which eye the currently saved frame represents.| | ^%eye%| If the current camera is rendering in stereo mode, this will be either L or R depending on which eye the currently saved frame represents.| | ||
^%dot%| This is just replaced with a single " | ^%dot%| This is just replaced with a single " | ||
+ | ^%cryptoname%| The name of the current Cryptomatte, | ||
You can use the Review Settings... option to verify if the file names are created as you'd expect them to be. | You can use the Review Settings... option to verify if the file names are created as you'd expect them to be. | ||
- | ===== Use Render Path ===== | + | ===== Single Layer Files ===== |
- | If you select this option, exrTrader will use the output file defined in the Lightwave3D render globals. | + | This control allows |
- | This option is quite important if used across a render farm in conjunction with the OpenEXR Dummy Saver, described later in this manual. | + | |
- | ===== Format ===== | + | |
- | This setting defines how exrTrader will append the frame number and file extension to the Output File. These settings are identical to the settings in the Lightwave3D render globals. | + | ===== Single |
- | + | ||
- | ===== Single | + | |
exrTrader by default saves all buffers into a single OpenEXR image file. You may optionally save single buffers into a separate image file. | exrTrader by default saves all buffers into a single OpenEXR image file. You may optionally save single buffers into a separate image file. | ||
- | This option defines how these separate image files will be named. | + | This option defines how these separate image files will be named. |
- | + | ||
- | Output is the file name, as defined by the Output File control, or the render global in Lightwave3D if “Use Render Path” is active. | + | |
- | + | ||
- | ^ Layer| is the layer name of the selected buffer, as described below in the documentation. | | + | |
- | ^ ### | is the frame number, the amount of digits is defined by the Format option. | | + | |
- | ^ _ | The underscores are only added if the Format option contains underscores as well. | | + | |
- | ^ .exr | The file extension is added only if the Format option contains the file extension. | | + | |
- | + | ||
- | * **Output_Layer_### | + | |
- | * **Layer/ | + | |
- | * **Layer/ | + | |
- | * **Layer_Output_### | + | |
- | * **Custom_### | + | |
- | ===== Custom Single Image Name ===== | + | |
- | + | ||
- | If the Single File Naming option is set to Custom_### | + | |
- | + | ||
- | You may also add slashes or colons (depending on the OS platform) to designate sub-directories. These will be automatically created by exrTrader if needed. | + | |
- | + | ||
- | The currently supported variables are: | + | |
- | + | ||
- | ^%scene% | Is replaced with the scene name (without the .lws extension)| | + | |
- | ^%camera% | The name of the camera used to render the current image| | + | |
- | ^%layer% | The name of the current layer (as defined in the per buffer Layer Name option)| | + | |
- | ^%eye% | If the current camera is rendering in stereo mode, this will be either L or R depending on which eye the currently saved frame represents.| | + | |
- | ==== Examples ==== | + | |
- | To hopefully make this a bit easier to understand, here is an example of how these options work. | ||
- | Let's assume we're rendering out to “images/ | ||
- | We want to save the Reflection buffer as a separate image file, the “Layer” name of it is “Specular”. | ||
- | These will be the buffer image file written at frame 60, depending on the Single File Naming option: | ||
- | |Output_Base_### | ||
- | |Layer/ | ||
- | |Layer/ | ||
- | |Layer_Output_### | ||
- | In all cases, the main file saved will be the same: images/ | ||
===== Compression ===== | ===== Compression ===== | ||
- | {{ : | + | {{ exrtrader2018: |
- | All compression options are lossless, | + | Most compression options are lossless, |
- | exrTrader is compiled to support OpenEXR Version 1.6, which includes the following compression modes: | + | exrTrader is compiled to support OpenEXR Version 1.2, which includes the following compression modes: |
* **Uncompressed** \\ Doesn' | * **Uncompressed** \\ Doesn' | ||
* **RLE (lossless)** \\ Compresses the difference between adjacent pixels. Fast to compress and decompress, but in general only works well for images with large areas of solid colour. | * **RLE (lossless)** \\ Compresses the difference between adjacent pixels. Fast to compress and decompress, but in general only works well for images with large areas of solid colour. | ||
- | * **ZIPS (lossless)** - default \\ This uses a ZIP type compression scheme to compress one scanline | + | * **ZIPS (1 line, lossless)** - default \\ This uses a ZIP type compression scheme to compress one scan line at a time. Slow to compress, fast to decompress and also offers a fairly high compression ratio. \\ This is the recommended compression mode for compositing tools like **Nuke** and **Fusion**, both of which may read single scan lines. |
- | * **ZIP (lossless)** \\ Just like ZIPS, except that it compresses 16 scanlines in one go. This results in a slightly better compression compared to ZIPS, but also slows down reading single scanlines from an image (as some compositing packages might do in proxy or ROI/DOD mode). | + | * **ZIP (16 line, lossless)** \\ Just like ZIPS, except that it compresses 16 scanlines in one go. This results in a slightly better compression compared to ZIPS, but also slows down reading single scanlines from an image (as some compositing packages |
* **PIZ (lossless)** \\ This is a wavelet based compression scheme that has a compression ratio that is comparable to ZIP(S), but is faster to compress ... on the other hand it is slower to decompress. | * **PIZ (lossless)** \\ This is a wavelet based compression scheme that has a compression ratio that is comparable to ZIP(S), but is faster to compress ... on the other hand it is slower to decompress. | ||
- | * **PXR24 (lossy)** \\ A wavelet based compression scheme similar to PIZ, 32bit float numbers are cut off to 24bit, | + | * **PXR24 (lossy)** \\ A wavelet based compression scheme similar to PIZ, 32bit float numbers are cut off to 24bit, |
* **B44 (lossy)** \\ A compression scheme designed for the real-time playback of OpenEXR images with a constant compression ratio. | * **B44 (lossy)** \\ A compression scheme designed for the real-time playback of OpenEXR images with a constant compression ratio. | ||
* **B44A (lossy)** \\ Just like B44, but solid areas (such as alpha channels) have a better compression ratio. | * **B44A (lossy)** \\ Just like B44, but solid areas (such as alpha channels) have a better compression ratio. | ||
- | * ** DWA A/B (lossy) ** | + | * **DWA A (32 line, lossy)** \\ **DWA B (256 line, lossy)** |
These are explained in more detail in the Technical Introduction to OpenEXR, available as a PDF at www.openexr.com (( I admit it, I didn't want to copy and paste the section over from the OpenEXR website. \\ The document is highly recommended to understand the capabilities of OpenEXR. )). | These are explained in more detail in the Technical Introduction to OpenEXR, available as a PDF at www.openexr.com (( I admit it, I didn't want to copy and paste the section over from the OpenEXR website. \\ The document is highly recommended to understand the capabilities of OpenEXR. )). | ||
- | <- viewer| ^| ^ metadata|-> | + | ===== DWA Compression Level ===== |
+ | |||
+ | This is a floating point value to set the strength of the (lossy) DWA compression. The control is only available if either DWAA or DWAB are selected as a compression. | ||
+ | |||
+ | The higher the value, the higher the compression. A good range is between 0.0 and 100.0, 45.0 is the default. | ||
+ | |||
+ | <- viewer| ^| ^ cryptomatte|-> |