db&w documentation wiki

finest software | finest docs

Site Tools


exrtrader2018:output

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
private:exrtrader2017:output [2017/08/16 14:43] – [Compression] lightwolfexrtrader2018:output [2019/01/25 12:21] (current) lightwolf
Line 1: Line 1:
-====== Output ====== +====== Layered Output ====== 
-{{ :private:exrtrader2017:output.png?nolink|}}+{{ exrtrader2018:output.png?nolink|}}
 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 file for the buffer saver to write to. Any extension and frame numbers of the selected file will be automatically removed. You can only select an output file if “Use Render Path” is not activated.+The file names can either be absolute, or relative to the Output Path
  
-exrTrader also supports special variables in the path name that will be replaced as the image is being saved.+==== 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. exrTrader supports special variables in the path name that will be replaced as the image is being saved.
  
 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/width of the rendered image in pixels| 
 +^%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 "." \\ It allows you to add a . at the end of the file name in the Output File Control (where it would normally be stripped with any file name extension).| ^%dot%| This is just replaced with a single "." \\ It allows you to add a . at the end of the file name in the Output File Control (where it would normally be stripped with any file name extension).|
 +^%cryptoname%| The name of the current Cryptomatte, only valid in the Cryptomatte tab.|
 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 you to define the output file names for layers saved as separate filesThe options are identical to the **Layered Output File**the %buffer% / %layer% variables contain the name of the current layer.
-This option is quite important if used across a render farm in conjunction with the OpenEXR Dummy Saverdescribed 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 Layer Files Naming =====
- +
-===== Single File Naming =====+
  
 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. You can use the same variables as you can for the Layered File.
- +
-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_###.exr** \\ This will save the buffer image files into the same directory as the Output File, and append the “Layer” name to the file name. +
-  * **Layer/Output_###.exr** \\ This will create a subdirectory named after the “Layer” name where the Output File is written, and write the buffer image into that subdirectory. +
-  * **Layer/Output_Layer_###.exr** \\ This will create a subdirectory named after the “Layer” name where the Output File is written, and write the buffer image into that subdirectory appending the “Layer” name to the file name. +
-  * **Layer_Output_###.exr** \\ This will save the buffer image files into the same directory as the Output File, and prepend the “Layer” name to the file name. +
-  * **Custom_###.exr** \\ This will save the buffer image files into the same directory as the Output File, and use the  “Custom Single Image Name” as the file name. +
-===== Custom Single Image Name ===== +
- +
-If the Single File Naming option is set to Custom_###.exr, the file name for single image files will be constructed from the text entered into this control. +
- +
-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/Ninja.exr” as the Output File. The Format we're using is “Name_0001.exr”. 
-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_###.exr |images/Ninja_Specular_0060.exr| 
-|Layer/Output_###.exr |images/Specular/Ninja_0060.exr| 
-|Layer/Output_Base_###.exr |images/Specular/Ninja_Specular_0060.exr| 
-|Layer_Output_###.exr |images/Specular_Ninja_0060.exr| 
-In all cases, the main file saved will be the same: images/Ninja_0060.exr  
 ===== Compression ===== ===== Compression =====
-{{ :private:exrtrader2017:exr_compression.png?nolink|}} +{{ exrtrader2018:exr_compression.png?nolink|}} 
-All compression options are lossless, except for PXR24which is lossy when saving 32bit float image data (it cuts off the lower 8bit, effectively cutting the precision to 24bits).+Most compression options are lossless, with the exception of PXR24(( which is lossy when saving 32bit float image data (it cuts off the lower 8bit, effectively cutting the precision to 24bits) )), B44/A and DWA A/B.
  
 exrTrader is compiled to support OpenEXR Version 1.2, which includes the following compression modes: exrTrader is compiled to support OpenEXR Version 1.2, which includes the following compression modes:
Line 74: Line 53:
   * **Uncompressed** \\ Doesn't compress the data at all, recommended for highest speeds (if the hard drive is fast) - but also uses the most storage space.   * **Uncompressed** \\ Doesn't compress the data at all, recommended for highest speeds (if the hard drive is fast) - but also uses the most storage space.
   * **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 at a time. Slow to compress, fast to decompress and also offers a fairly high compression ratio. +  * **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 like Nuke or Fusion might do in proxy or ROI/DOD mode).
   * **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, loosing 8 bits of precision.+  * **PXR24 (lossy)** \\ A wavelet based compression scheme similar to PIZ, 32bit float numbers are cut off to 24bit, losing 8 bits of precision.
   * **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 has been created by Karl Rasche and is patented by DreamWorks Animation, but available to use within the OpenEXR standard )) \\ This is a lossy compression scheme that allows you to change the compression quality (similar to JPEG). \\ DWA is very fast to decompress and can be used for realtime playback of 2K on most computers. \\ DWA only compresses the RGB channels using the lossy scheme and falls back to ZIP for other channels. To be more precise, channels named R, G, B, Y, RY, BY (( The channel names need to be capitalised )) will be compressed using DWA, channels named A will be RLE (lossless) compressed, all others will be ZIP (lossless) compressed. \\ DWA A and B differ in that A uses blocks of 32 scanlines and B uses 256 scanlines. A allows for faster reading by applications that don't read the whole image, B allows for higher compression. \\ **Please Note:** DWA was only added in OpenEXR 2.2. Applications based on older version of OpenEXR will not be able to read files compressed with it.+  * **DWA A (32 line, lossy)** \\ **DWA B (256 line, lossy)** (( DWA has been created by Karl Rasche and is patented by DreamWorks Animation, but available to use within the OpenEXR standard )) \\ This is a lossy compression scheme that allows you to change the compression quality (similar to JPEG). \\ DWA is very fast to decompress and can be used for realtime playback of 2K on most computers. \\ DWA only compresses the RGB channels using the lossy scheme and falls back to ZIP for other channels. To be more precise, channels named R, G, B, Y, RY, BY (( The channel names need to be capitalised )) will be compressed using DWA, channels named A will be RLE (lossless) compressed, all others will be ZIP (lossless) compressed. \\ DWA A and B differ in that A uses blocks of 32 scanlines and B uses 256 scanlines. A allows for faster reading by applications that don't read the whole image, B allows for higher compression. \\ **Please Note:** DWA was only added in OpenEXR 2.2. Applications based on older version of OpenEXR will not be able to read files compressed with it.
  
 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. )).
Line 90: Line 69:
 The higher the value, the higher the compression. A good range is between 0.0 and 100.0, 45.0 is the default. The higher the value, the higher the compression. A good range is between 0.0 and 100.0, 45.0 is the default.
  
-<- viewer| ^| ^ metadata|->+<- viewer| ^| ^ cryptomatte|->
exrtrader2018/output.1502887380.txt.gz · Last modified: 2017/08/16 14:43 by lightwolf