Merger¶
Description¶
The PresenZ Merger Utility is a tool that combines the .przRender files created by PresenZ into a single .PRZ file compatible with the PresenZ VR Viewer. This .PRZ file can then be dragged and dropped into the PresenZ Dashboard for viewing.
The Merger Utility comes installed with the authoring tools and can be found in the following standard locations based on your plugin version:
For 3dsMax:
C:\Program Files\PresenZ\PresenZ For ...\presenz_merger.exe
For maya/Arnold:
C:\Users\<username>\PresenZ\Maya20xx\MtoAx-x-x\utilities
For maya/Vray:
C:\Users\<username>\PresenZ\Maya20xx\Vrayx.x\utilities
Besides merging .przRender files, the Merger Utility can also apply a color profile to your final image.
Launching the Merger Utility¶
There are four ways to merge your files. The first two methods will execute the merger utility within your 3D Authoring Software. The following two allow you to execute the merger through the command line with custom parameters.
3. PresenZ Merger Toolbar¶
In your 3D authoring software, in the PresenZ Toolbar there is a merger command button.
This button will open a commmand prompt window at the location where PresenZ is installed, making it easy to set your own command line merging parameters.
4. Open a Command Prompt¶
The last method to merge your files is to execute the presenz_merger.exe file in a command prompt outside of your 3D authoring software. This file is installed in the desired location you specified when you installed the PresenZ authoring tools. The default location being C:\Program Files\PresenZ\PresenZ For ...\presenz_merger.exe
.
PresenZ Command Line Merging¶
The PresenZ Merger allows you to specify which .przRender files to merge and some additional parameters such as a color corrections before the merge. Manually merging .przRender files through the presenZ_merger.exe
allows for more flexibility. For instance, if you just made a glass render and would like to re-merge without also relaunching all the other render passes.
Press the merger command icon in the floating toolbar or run the
presenz_merger.exe
file in a command prompt.Give the path for the file you want to merge, containing the przDetect and przRender folder
Optionally, specify additional parameters
Press Enter for the merge.
Example command line:
presenz_merger C:\Sten\Testing\Testing_Box3
You will be left with a .PRZ image as output. This is the file you use for viewing your scene.
The following two sections give commonly used command flags for the merger.
V-Ray 4.X Frame buffer color correction¶
If you are using the VFB’s color correction tools, PresenZ will automatically export the settings into a vfbColorSettings.vccglb
file. This is useful in the case that you want to convert your image to sRGB, or for a simple exposure correction.
If you are manually merging through the presenz_merger.exe you will have to add this file with the --VFBPreset
flag.
When pressing merge it will add your VFB color corrections to your file.
Warning
Since V-Ray 5.0, PresenZ is unfortunately not compatible with the new vrayFrameBuffer Color Corrections yet. We are trying to solve this issue.
VFBCC manual export¶
In case you are happy with your rendered result, but you wish to only adjust the color settings for your render. You can do so by doing the following.
Inside the V-Ray frame buffer there is a large button above the settings Globals… , with this button you can save your file as a .vccglb
.
Now that you have this vccglb file you can use it with the --VFBPreset
flag, without having to render all over again.
Command-line Flags¶
Here you can find a complete list of all the possible flags that can be used with the merger.
-h --help --usage
:Display a help message with all the supported flags.
input
( Arg ):Root directory path to the input przRender files, or przRender file list sperated with , .
--output
( Arg ):Path to the file ending with .prz. For example C:/users/presenz_test_v01.prz
-r
Arg0,Arg1:Merge from frame range, for example: r 0,20 will merge frame 0 to frame 20.
--lift
Arg0,Arg1,Arg2:Will lift the image by these values. Applied before OCIO conversion. ( Default : 0.0,0.0,0.0 )
--gain
Arg0,Arg1,Arg2:Will multiply the image by these values. Applied before OCIO conversion ( Default : 1.0,1.0,1.0 )
--pow
Arg0,Arg1,Arg2:Will apply a power of these values to the image. Applied before OCIO conversion ( Default : 1.0,1.0,1.0 )
--VFBPreset
Arg:Path to VFBPreset file. To apply color Color Correction from V-Ray Frame Buffer 1
--OCIOconfig
Arg:Path to an OCIO config file.
--applyColorSpaceFrom
Arg:Define the original colorspace of an image (default: linear)
--applyColorSpaceTo
Arg:Apply this colorspace transform to an image (default: linear)
--displayGamut
Arg:Define the original colorspace of an image (default: linear)
--convertBackToLinear
Arg:If your final space is not linear, convert the final value back to linear (assuming sRGB as input)
--mindist
Arg:If present, Overwrite the mimimal Z distance in the file (default 0)
--maxDist
Arg:If present, Overwrite the maximum Z distance in the file(default 1e30)
--colorTolerance
Arg:If present, Overwrite tolerance when merging. Higher = Merge more
--normalTolerance
Arg:If present, Overwrite tolerance when merging. Lower = Merge more
--planeTolerance
Arg:Specifies the verbose level of information printed to the standard output. (default : 3)
--mergeHypertangent
:If present, Does not take the tangency factor for merging. (Merge more)
-l
Arg:Specifies the verbose level of information printed to the standard output. (default : 3)
--logFile
Arg:[string] Specifies a file to record merger events
-x
:If present, overwrite existing prz
--zovOffset
Arg0,Arg1,Arg2:If there is multiple przRender with different zovOffset in input, tell the merger to only process the input files with this zov offset.
--stills
Arg0,[ArgN]:[string] Add specified przRender file(s) to each zov(s). ( Useful to combine a PresenZ background to a PresenZ animation )
--motionVectorFillHoles
:If Present, the merger will use the next frame to fill holes induced by the motion interpolation at current frame. Only the hole filling data is written to the disk in a the PRZ format, which must be combine later with the standard merging