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.

1. Activate the option in the PresenZ authoring tool

When using the PresenZ Render Dialog in your 3D authoring software (for instance 3Ds Max) you will see that there is an option “ Merge files after rendering “, simply check the box to automatically merge the files at the end of the render phases.

../_images/RenderDialog_01.PNG

2. Merge button in the PresenZ authoring tool

Alternatively, there also is a Merge button in the PresenZ Render Dialog. This button will merge the files located in the output directory you defined, without having to re-render first.

../_images/RenderDialog_02.PNG

3. PresenZ Merger Toolbar

In your 3D authoring software, in the PresenZ Toolbar there is a merger command button.

../_images/ToolbarMerger.PNG

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.

../_images/CmdMerger.PNG

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 .

../_images/MergerFolder.PNG

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.

../_images/vfbglobals.PNG

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