This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
private:exrtrader2017:output [2017/11/03 18:39] – [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: |
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. | 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. | ||
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|-> |