OpenVPCal Plugin - Reference
このコンテンツはまだ日本語訳がありません。
This page provides comprehensive reference documentation for the OpenVPCal Plugin interface. It contains every control, setting, and feature available in each tab of the plugin: Main tab, Analyse tab, and Settings tab.
Use this reference to understand what each control does, how to interpret calibration analysis graphs, and how to configure OpenVPCal settings for your specific workflow. For step-by-step calibration instructions, see the Quick Start guide. For optimal setup recommendations, see the Best Practice guide.
System Tray
Section titled “System Tray”
OpenVPCal Plugin System Tray
When you launch OpenVPCalPlugin.exe, an icon appears in the system tray. The icon colour indicates server status:
- Coloured icon: Server is running correctly (left side of OpenVPCal Plugin System Tray)
- Greyed-out icon: Server has failed or is not running (right side of OpenVPCal Plugin System Tray)
If the server fails to launch, a port conflict is the most likely cause. To resolve this, use Change Port to assign a different port number.
- Open WebUI:
- Opens the OpenVPCal Plugin WebUI in your default browser. The typical workflow involves interacting with the OpenVPCal Plugin UI within Designer via the Plugin widget. However, if Designer is running on a different machine, you can open the WebUI to interact with Designer over the network.
- Change Port:
- If the server is not running (greyed-out icon), a port conflict between the OpenVPCal Plugin and another application is likely. Use Change Port to assign a different port number. The OpenVPCal Plugin server will automatically restart with the new port.
- Restart Server:
- If the server has failed for a reason other than a port conflict, use this option to restart the server with the same port number.
- Open Plugin Folder:
- Opens the folder containing all calibration-related settings and assets.
- View Logs:
- Opens the log file in your default text editor.
- About:
- Displays the plugin version.
- Close:
- Terminates
OpenVPCalPlugin.exe.
- Terminates
Landing Page
Section titled “Landing Page”
OpenVPCal Plugin Landing
1. Settings
Section titled “1. Settings”When you click the settings icon, the plugin settings widget will be displayed.
Designer IP Address
Section titled “Designer IP Address”If the OpenVPCal plugin is running on a server or laptop that is connected to the Designer session network, an IP address does not have to be assigned. The plugin will be able to discover the Director in the session and establish the connection. However, when the OpenVPCal Plugin is running on a different network, you must set the IP address to the Director’s IP address, so the plugin can discover the session and establish the connection.
Designer Port
Section titled “Designer Port”This is the HTTP port of Designer. You can find the port in d3 Manager.
Machine Settings > Advanced Network Configuration > HTTP Port (default: 80)
Rsync Port
Section titled “Rsync Port”When the OpenVPCal Plugin is running on Windows, the Windows file system will be used to transfer files for the calibration process and rsync will not be used. However, if the OpenVPCal Plugin is running on Linux or Mac, this must be correctly configured. The rsync port must be identical to the rsync daemon port of Designer. You can find the port in d3 Manager.
Machine Settings > Advanced Network Configuration > rsync daemon port (default: 9993)
Enable All OpenVPCal Settings
Section titled “Enable All OpenVPCal Settings”Designer expects a few OpenVPCal settings to have certain values for the calibration process. Therefore, a few OpenVPCal settings in the Settings tab are disabled to prevent changing settings that can cause issues during the calibration process. If you would like to take full control over all OpenVPCal settings, you can check Enable All OpenVPCal Settings.
2. Status Footer
Section titled “2. Status Footer”The status footer shows the state of the connected Designer. From the left, it will display:
- Connected/Disconnected: The connection state between the plugin and the target Designer.
- Designer: The IP address of the connected Director in the Designer session.
- Project: The Designer project name of the connected Designer session.
Main Tab
Section titled “Main Tab”
OpenVPCal Plugin Main Tab
Main Tab Elements
Section titled “Main Tab Elements”1. Main Canvas
Section titled “1. Main Canvas”The main canvas area is where you can inspect captured images and draw a region of interest (ROI) to run the calibration on. The canvas consists of three parts: control, canvas and navigation.
Canvas Control Panel
Section titled “Canvas Control Panel”The header has basic canvas control buttons on left and status text on right. The status text will show the loading state once calibration capture is finished.
+Button: Zoom in-Button: Zoom out- Clear: Clear the ROI from the Canvas
- Reset: Clear the ROI and reset the zoom level
Canvas Panel
Section titled “Canvas Panel”The canvas will display the captured image. Both Camera Capture under the Designer area and Capture under the Calibration area will update the displayed image in the canvas. Several mouse actions are supported for easy image inspection.
Mouse Control
Section titled “Mouse Control”- Left-click+drag: Pan/move the view.
- Right-click+drag: Draw ROI.
- Wheel-up: Zoom in.
- Wheel-down: Zoom out.
- Wheel-click (MMB): Reset zoom level and position to default.
Navigation Panel
Section titled “Navigation Panel”You can control the frame to display on the main canvas using the navigation area. The navigation area will be enabled once the calibration capture process is finished and captured images are loaded.
- Playhead: You can scrub through to change the displayed frame quickly
- Arrow button: You can inspect images one by one with the arrow buttons
- Double arrow button: Move the playhead to either the beginning or end of the sequence
- Start: Start of sequence
- End: End of sequence
- Current: Current frame. You can move to a specific frame by updating this field
2. State Area
Section titled “2. State Area”Status
Section titled “Status”The status will show the high-level state of the plugin:
- Disconnected: Designer is disconnected.
- Running: A calibration process is running.
- Idle: The calibration process is ready to be run.
MRSet contains the list of MRSets in Designer. Changing the current MRSet using the dropdown menu will update the current MRSet in Designer.
Camera
Section titled “Camera”Camera has a list of cameras in Designer. Changing the camera using the dropdown will update the camera of the selected MR Set.
Display
Section titled “Display”Display has a list of selected displays for the selected MR Set. You can control which displays to run capture, analyse and calibration by using the checkboxes. The selected and highlighted display will be used to display the capture sequence on the main canvas area.
Calibration Result
Section titled “Calibration Result”This field will become visible once either analysis or calibration is finished. It provides feedback about the analysis/calibration result and will guide you to get the best calibration output.
Common OpenVPCal Analysis and Calibration Feedback
Section titled “Common OpenVPCal Analysis and Calibration Feedback”-
Measured Exposure Validation
- Issue: The camera exposure is incorrect (e.g., measuring 5.0% instead of the required 18%).
- Solution: Re-expose the camera using these steps:
- Display the first calibration patch (with the grey center square).
- Use your camera’s false colour display or a light meter.
- Adjust camera settings until the entire center grey square reads exactly 18%.
- Use the 17% and 19% reference patches at the bottom of the frame to fine-tune exposure.
- Re-shoot all calibration patches with the corrected exposure.
-
Measured EOTF Peak vs Target Peak Failed
- Issue: Significant mismatch between measured peak luminance and target luminance.
- Solution: Check your complete imaging pipeline:
- Use SPG Linear Steps patterns to validate brightness mapping throughout your pipeline.
- Verify the Target Max Lum setting in the plugin matches your LED wall’s actual peak capability.
- Confirm Designer is applying the correct EOTF transform (e.g., ST2084 for HDR content).
- Check LED processor settings - ensure peak luminance is set correctly and not clamped.
- Verify no unexpected gain or brightness adjustments are applied in the imaging chain.
- Re-shoot patches after correcting the imaging chain configuration.
-
EOTF Validation
- Issue: The display’s brightness response curve deviates from the expected target EOTF.
- Solution: Troubleshoot your imaging pipeline:
- Verify EOTF settings match between plugin Target EOTF and LED processor configuration.
- Check Designer colour management - ensure only the required EOTF transform is applied to patches.
- Disable any tone mapping or creative colour grading in the imaging chain.
- Confirm video data range is consistent (Full/Extended vs Legal range) throughout the pipeline.
- Use SPG Bit Depth patterns to verify 10-bit processing is maintained.
- Test with SPG Exposure Stops patterns to confirm linear lighting response.
- Re-shoot calibration patches after resolving imaging chain issues.
3. Designer Area
Section titled “3. Designer Area”Refresh Data
Section titled “Refresh Data”The OpenVPCal plugin does not fetch the Designer state in real-time. If you made a change in Designer, you must update the Designer state using the Refresh Data button.
Camera Capture
Section titled “Camera Capture”When a capture sequence has not been done, Camera Capture can be used to get the camera preview from Designer.
4. Calibration Control Area
Section titled “4. Calibration Control Area”Generate Colour Patches
Section titled “Generate Colour Patches”Generate Colour Patches will:
- Generate the colour patches to use for the calibration of checked displays in the State area.
- Upload the colour patches to Designer.
- Download the current OCIO config in Designer.
- Create
pre_calibration_openvpcal_<config>.ociobased on the downloaded config. - Upload the created OCIO config.
- Update the Designer OCIO config to the pre-calibration OCIO config.
- Update the LED display colour space to the pre-calibration colour space.
Make sure to populate and configure the OpenVPCal settings for all LED displays in the Settings tab.
Generate the colour patches to use for the calibration, then upload the colour patches to Designer. Make sure to update the OpenVPCal settings in the Settings tab before generating the colour patches. The generated colour patches will be stored in:
objects/videofile/<camera_display>/colour_patches
The OCIO config generated by the OpenVPCal Plugin should not be used for Generate Colour Patches. Otherwise, it may fail to create an OCIO config with the desired colour space.
If you would like to change the colour space of displays or the camera, you can update them after the Generate Colour Patches process is finished. Neither Analyse nor Calibrate will overwrite OCIO-related settings. However, it is advised to use the prepared OCIO settings as they are.
Generate SPG Patterns
Section titled “Generate SPG Patterns”Generating SPG (Synthetic Pattern Generator) Patterns creates a comprehensive set of synthetic test patterns designed to validate your LED wall setup before running colour calibration. These diagnostic patterns help identify potential issues in your imaging pipeline that could affect calibration accuracy. They are essential for ensuring your LED wall and imaging pipeline are properly configured before investing time in the calibration process.
When to Use SPG Patterns:
- Before shooting calibration patches to verify your setup.
- To diagnose sync, mapping, or colour pipeline issues.
- When troubleshooting LED wall display problems.
- To validate your imaging chain after making configuration changes.
How to Use SPG Patterns:
- Go to the plugin’s Main Tab and click Generate SPG Patterns. Once generation has completed, the patterns will be stored in
objects/videofile/<camera_display>/spg_patterns. - In Designer, create a video layer.
- Ensure the video layer is direct mapped to the display you wish to debug.
- Under
Video Layer > Media, select the SPG pattern you wish to display. - Certain SPG patterns like the Frame Sync Count are available as
.seqframe sequences, that can be directly mapped to the display and played back like normal video.
The SPG generator creates test patterns in the same colour space and EOTF as your LED wall target settings. Each pattern tests specific aspects of your LED wall and imaging pipeline:
Frame Sync Count
Section titled “Frame Sync Count”Displays sequential frame numbers to verify proper synchronisation between your camera recording frame rate and LED wall playback. Any ghosting, blending, or missing numbers indicates sync issues that must be resolved before calibration. To permit correct playback and capture of the patterns, ensure the following:
- Go to
Video Layer > Media > Video > Edit- Set playback frame rate (
FPS) to 1/10 of camera recording FPS for single-frame patterns.
- Set playback frame rate (
- Go to
Video Layer > Media > Video > Filtering- Disable frame blending (
Frame Blending > Off) and ensure the sequence stops at the last frame.
- Disable frame blending (
Note that since the capture of the colour patches is automatically handled by Designer when the capture process is launched from the plugin, verifying frame synchronisation is redundant.

Checkerboard Patterns
Section titled “Checkerboard Patterns”Multiple checkerboard sizes test for scaling, aspect ratio, and mapping issues. When displayed 1:1 with your LED wall resolution, squares should appear undistorted and properly aligned.

Linear Steps
Section titled “Linear Steps”Absolute brightness steps (in nits) for PQ (ST2084) workflows. You should see clearly distinguishable bands up to your wall’s peak luminance, with no visible bands beyond that limit. These patterns help verify correct brightness mapping throughout your pipeline. The exact values can be further verified using a light metre. Ensure the peak luminance value is reflected in the Target Max Lum field within the plugin’s OpenVPCal Settings.

Exposure Stops
Section titled “Exposure Stops”Test patterns that, when viewed through your camera’s false colour display, allow you to verify linear lighting response by adjusting camera exposure settings in one-stop increments.

Data Range Verification
Section titled “Data Range Verification”Ensures your imaging chain operates in extended (full) range rather than legal range. Inner squares within test patches should be clearly distinguishable when configured correctly.

Bit Depth Testing
Section titled “Bit Depth Testing”Grey ramp patterns reveal whether your imaging chain maintains 10-bit processing. Any visible vertical banding indicates 8-bit limitations that could affect calibration quality.

Colour Steps
Section titled “Colour Steps”Graduated colour patterns test for colour clipping and verifying proper colour space handling throughout your pipeline. Smooth gradations without black bands or indistinguishable steps indicate correct configuration.

Real Black Level
Section titled “Real Black Level”Determines your LED panels’ true black capabilities before multiplexing artifacts become visible in camera. This helps establishing the practical black level limits for your calibration.

Alignment Grids
Section titled “Alignment Grids”Cross patterns and grids verify physical construction alignment and content mapping accuracy. Misaligned patterns indicate hardware or mapping configuration issues.

Best Practices for SPG Pattern Testing
Section titled “Best Practices for SPG Pattern Testing”- View patterns through your production camera setup.
- Check all sections of multi-processor LED walls for consistency.
- Resolve any identified issues before proceeding to calibration patch generation.
Capture
Section titled “Capture”The Capture button will trigger the Designer image sequence capture process for selected displays in the State area. Note that the capture process will be done sequentially (i.e. capture for display 1 will be done first, then move on to display 2).
- Start the image sequence capture for each display.
- Download all captured images from Designer. The downloaded images will be saved in:
Documents/d3plugins/openvpcal/assets/<project>/<camera__display>/capture
- Convert all downloaded EXR (ACES2065-1) images into PNG (sRGB) for preview. They will be saved in:
Documents/d3plugins/colourcal/assets/<project>/<camera__display>/preview
- Load all preview images on the frontend.
Analyse
Section titled “Analyse”The Analyse button will start the analysis process using the captured images and produce analysis result data. This process will not interact with Designer. Instead, the plugin will run the analysis using the downloaded captured images. The analysis results can be monitored from the Analyse tab.
You can set an ROI to run calibration on in the Main Canvas to make the analysis process faster. When an ROI is not set, the detection algorithm will try to find the ROI to run the calibration on, then begin the analysis process.
When the analysis is finished, feedback will be provided in Calibration Result. All analytical data will also be provided in the Analyse tab.
Calibrate
Section titled “Calibrate”When you are happy with the analysis results, you can run the calibration. The calibration process will:
- Create a new OCIO config,
post_calibration_openvpcal_<hash>.ociowith the Output Transform from the calibration result. - Upload the newly created OCIO config to Designer.
- Set the OCIO config of Designer to
post_calibration_openvpcal_<hash>.ocio. - Set the Output transform of the LED Display to the calibrated Output transform.
Cancel
Section titled “Cancel”You can cancel Generate Colour Patches, Generate SPG Patterns, Capture, Analyse and Calibrate. Note that when the process is running a file I/O task with a potential race condition, the cancel button will be disabled.
Updated Fields
Section titled “Updated Fields”This table summarises the fields and settings that are modified when executing each button operation in the Main tab.
| Action | Updated Data in Plugin | Updated Data in Designer |
|---|---|---|
| Generate SPG Patterns |
|
|
| Generate Colour Patches |
|
|
| Capture |
|
|
| Analyse |
| |
| Calibrate |
|
|
Field Definitions:
- Base OCIO config: The baseline OCIO configuration file from which pre-calibration and post-calibration configs are derived.
- OCIO config: The active OCIO configuration selected in Designer under
Project Settings > Colour Management. - pre_calibration: Generated config file with naming pattern
pre_calibration_openvpcal_<hash>.ocio. Applied during pattern generation and capture to prepare the display for calibration. - post_calibration: Generated config file with naming pattern
post_calibration_openvpcal_<hash>.ocio. Contains the calibrated output transform applied after successful calibration. - Generated SPG Patterns: SPG pattern VideoClip resource uploaded to Designer in
.seqformat. - Camera input transform (colour patches): Input transform for the calibration colour patch VideoClip, located at
objects/videofile/<camera_display>/colour_patches. - LED screen output transform (calibrated): The calibrated display transform applied to the LED screen after successful calibration.
Analyse Tab
Section titled “Analyse Tab”The Analyse tab provides comprehensive visual feedback on calibration quality, displaying analysis results from the calibration. This tab shows how well your LED display matches the target colour specifications before and after calibration. To see the analysis results, you must complete either the Analyse or Calibrate process from the Main tab.

Analyse Tab Elements
Section titled “Analyse Tab Elements”- Analyse Main Cavas
- Max Distance Graph
- EOTF Analysis Graph
- White Point Analysis Graph
- CIE 19331 Chromacity Diagram
- Macbeth Chart
- Designer Control
- Analysis Graph Control
Mouse Control
Section titled “Mouse Control”All graphs support interactive exploration with the following controls:
- Left-click+drag: Pan/move the view.
- Wheel up: Zoom in.
- Wheel down: Zoom out.
- Wheel-click (MMB): Reset zoom level and position to default.
1. Analyse Main Canvas
Section titled “1. Analyse Main Canvas”The main canvas displays the currently selected graph for detailed inspection.
- Shows the graph that is selected by clicking thumbnails from the grid (items 2-6).
- Provides zoom and pan capabilities for close examination.
2. Max Distance Graph
Section titled “2. Max Distance Graph”This bar chart displays the maximum colour error in each RGB channel, providing a quick assessment of overall colour accuracy.
What it shows:
- Red, Green, Blue bars: Maximum distance of each colour channel between the target and captured image.
- Pre-calibration bars: Wider bars showing errors before calibration.
- Post-calibration bars: Narrower bars showing errors after calibration.
- Numeric values: Error of each colour channel between the target and captured image.
Interpreting results:
- Shorter bars = better accuracy: Values close to zero indicate excellent calibration.
- Compare heights: Post-calibration bars should be shorter than pre-calibration bars.
- Large remaining errors: May indicate LED hardware limitations or calibration issues that need investigation.
- Negative distance: Captured image is darker than intended.
- Positive distance: Captured image is brighter than intended.
3. EOTF Analysis Graph
Section titled “3. EOTF Analysis Graph”This graph displays the Electro-Optical Transfer Function (EOTF), showing how input signal levels translate to output luminance. This reveals whether the display reproduces brightness correctly across the full brightness range.
What it shows:
- White diagonal reference line: Represents a perfect linear response (input = output).
- Pre-calibration lines: Dashed lines showing the luminance response for each RGB channel before calibration.
- Post-calibration lines: Solid lines showing the corrected luminance response after calibration.
Interpreting results:
- Lines close to the diagonal = accurate: Minimal deviation means proper luminance reproduction
- Curved lines: Indicate gamma or tone curve issues
- Post-calibration improvement: Solid lines should track closer to the reference diagonal than the dashed lines
- Smooth curves: Indicate a good tonal response without banding or clipping
- Curves above the diagonal: Display is brighter than intended
- Curves below the diagonal: Display is darker than intended
- Non-smooth curves: May indicate bit depth or processing issues
4. White Point Analysis Graph
Section titled “4. White Point Analysis Graph”This graph shows white point accuracy on the CIE 1931 chromaticity diagram, showing colour temperature and tint characteristics.
What it shows:
- Planckian locus: Black curved line showing blackbody radiation at different colour temperatures.
- Target white point: Reference target marker.
- Pre-calibration white point: Marker showing initial measured white point.
- Post-calibration white point: Marker showing corrected white point.
Interpreting results:
- Markers closer together = better white balance: Distance indicates a colour temperature shift.
- Post-calibration near target: Indicates successful white point correction.
- Distance from target: Shows the magnitude of colour cast (green/magenta or blue/yellow shift).
- Common target: D65 (6500K) for LED walls in ICVFX workflows.
- Large separation after calibration may indicate camera white balance issues.
5. CIE 1931 Chromaticity Diagram
Section titled “5. CIE 1931 Chromaticity Diagram”This graph displays the colour gamut on the standard CIE 1931 colour space, showing the range of colours the display can reproduce.
What it shows:
- Colour triangles: RGB primaries connected to form the achievable colour gamut.
- Target gamut: Dashed line showing the desired target gamut.
- Pre-calibration gamut: Initial display capabilities.
- Post-calibration gamut: Corrected display capabilities.
- White point: Circle inside the triangle showing the neutral colour location.
- Macbeth samples (optional): Coloured dots showing measured ColourChecker patch locations.
Interpreting results:
- Larger triangle = wider gamut: More colours the display can reproduce.
- Triangle shape matters: The post-calibration triangle should closely match the target shape.
- Perfect match often impossible: Hardware may not physically reach the target primaries.
- Small mismatches acceptable: Calibration optimises within hardware constraints.
- Coverage check: The triangle should enclose colours important for your content.
- Triangle vertices show RGB primary chromaticities.
- Triangle interior contains all reproducible colours.
- Area outside the triangle represents out-of-gamut colours (cannot be displayed accurately).
6. Macbeth Chart
Section titled “6. Macbeth Chart”The Macbeth button switches the main canvas to display the captured Macbeth ColourChecker reference image.
What it shows:
- The actual calibration target image captured during the analysis process.
- 24 colour patches arranged in the standard Macbeth ColourChecker layout.
- Reference patches used for colour accuracy measurements.
Interpreting results:
- Click to toggle between the Macbeth chart view and graph views.
- Verify that the colour patch detection worked correctly during analysis.
- Visual confirmation that the calibration patches were captured properly.
- If the Macbeth chart is not visible, the detection algorithm may have failed, but this does not prevent calibration from succeeding. The primary calibration patches are still analysed correctly.
7. Designer Control
Section titled “7. Designer Control”This section allows you to select which calibration data to display from your Designer project.
Controls:
- MRSet: Select the Mixed Reality Set containing the calibration data you want to analyse.
- Camera: Choose which camera’s calibration results to view.
- Display: Select which LED display’s calibration to analyse.
Behaviour:
- Changing any dropdown automatically refreshes all graphs with the selected calibration data.
- Data must exist from a completed Analyse or Calibrate process.
- Allows the comparison of calibration results across different camera/display combinations.
8. Analysis Graph Control
Section titled “8. Analysis Graph Control”This section controls the visibility of data series and channels across all graphs, allowing you to focus on specific aspects of the calibration.
- Show Pre-Calibration
- Displays measurements taken before calibration.
- Shown as dashed lines and wider bars (semi-transparent).
- Use this to understand the initial display state and calibration starting point.
- Show Post-Calibration
- Displays measurements taken after calibration.
- Shown as solid lines and narrower bars (more opaque).
- Use this to verify calibration improvements and final accuracy.
- Show Target
- Displays the target colour space specification.
- Shows ideal reference goals (e.g., Rec.2020, P3, custom gamut).
- Use this to compare actual performance against calibration objectives.
- Show Macbeth
- Displays Macbeth ColourChecker sample points.
- Only visible on the CIE 1931 Chromaticity diagram (item 5).
- Shows the measured locations of colour reference patches.
- Show Red
- Toggle the red channel data visibility of the EOTF Analysis Graph (item 3).
- Show Green
- Toggle the green channel data visibility of the EOTF Analysis Graph (item 3).
- Show Blue
- Toggle the blue channel data visibility of the EOTF Analysis Graph (item 3).
Workflow Guide
Section titled “Workflow Guide”Follow this workflow to effectively analyse calibration results:
- Select your data source: Use the Designer Control (7) to choose MRSet, Camera, and Display.
- Review overview: Examine all four graph thumbnails (2-5) for a quick assessment.
- Deep dive: Click any thumbnail to enlarge the view in the main canvas (1) for detailed inspection.
- Compare results: Use the visibility toggles (8) to compare pre-calibration, post-calibration, and target data.
- Zoom for details: Scroll to zoom and drag to pan for close examination of specific regions.
- Verify patch detection: Click the Macbeth button (6) to confirm the colour patch detection worked correctly.
- Interpret findings: Use the guidelines below to determine calibration quality.
Interpreting Calibration Results
Section titled “Interpreting Calibration Results”Indicators of Good Calibration:
- Max Distance: Bars near zero across all RGB channels.
- EOTF: Lines closely follow the diagonal reference line.
- White Point: Post-calibration marker very close to target marker.
- Gamut: Post-calibration triangle overlaps closely with target triangle.
Common Issues and What They Mean:
- Uneven Max Distance bars: One or more channels have calibration errors.
- Check if a specific channel needs attention.
- May indicate LED ageing or hardware issues in that channel.
- Curved EOTF lines away from the diagonal: Gamma or tone response problems.
- Display is not reproducing brightness linearly.
- May need EOTF correction settings adjusted.
- Separated white points: Colour temperature mismatch.
- White balance needs correction.
- Check camera white balance settings.
- Small gamut triangle: LED hardware cannot reach the target primaries.
- Physical limitation of LED panels.
- Consider whether the target gamut is achievable with your hardware.
When to Re-calibrate:
- Post-calibration errors remain large relative to pre-calibration.
- Significant visual differences remain between pre and post measurements.
- White point is far from the target after calibration.
- Calibration feedback messages suggest issues or warnings.
- LED wall hardware has been changed or serviced.
Acceptable Tolerances:
- Small deviations from perfect are normal due to hardware constraints.
- Post-calibration should show significant improvement over pre-calibration.
- Target match depends on LED hardware capabilities.
- Consult the calibration feedback messages in the Main tab for specific recommendations.
Settings Tab
Section titled “Settings Tab”The Settings tab contains all the configuration options for the colour calibration process. These settings control how calibration patches are generated, how the analysis is performed, and how the final calibration is computed and applied.

Settings Tab Elements
Section titled “Settings Tab Elements”1. Designer Settings
Section titled “1. Designer Settings”The Designer Settings section integrates OpenVPCal with Designer’s colour management system, allowing you to apply calibrations within your mixed reality set.
Colour Management Settings
Section titled “Colour Management Settings”Configure the OCIO colour management pipeline that will be used as the foundation for calibration.
| Colour Management | Description |
|---|---|
| Mode | Selects the colour management mode for the Designer project. |
| OCIO Config | The OCIO config currently selected as the base to create a new config with the calibration results. |
Mixed Reality Set Configuration
Section titled “Mixed Reality Set Configuration”Select and configure the MR Set and camera that will be used for calibration.
| MR Set | Description |
|---|---|
| MR Set | The currently selected MR Set. |
| Camera | The target Camera selected for the current MR Set. |
LED Display Management
Section titled “LED Display Management”Manage the LED displays assigned to your MR Set and their associated OpenVPCal settings.
| Displays (LED Walls) | Description |
|---|---|
| Displays | A list of the displays assigned to the current MR Set. |
| OpenVPCal Settings | The OpenVPCal settings associated with the selected camera/display pair (calibration asset). |
| Populate Display | Populates the OpenVPCal settings for the selected display. |
| Populate All | Populates the OpenVPCal settings for all listed displays. |
2. OpenVPCal Settings
Section titled “2. OpenVPCal Settings”The OpenVPCal Settings gather calibration data for specific camera and display combinations. Each set of settings is used to generate a unique calibration that can be applied to content in the Designer timeline.
LED Wall Configuration and Management
Section titled “LED Wall Configuration and Management”Create, organize, and manage different LED wall configurations for your calibration workflow.
| LED Walls | Description |
|---|---|
| New LED Name | Text field to enter a name for a new LED wall configuration. |
| Add | Creates a new set of OpenVPCal settings with the name specified in the “New LED Name” field. |
| Copy | Duplicates the currently selected LED wall configuration, creating a copy with all the same settings. |
| Remove | Deletes the currently selected LED wall configuration and all associated OpenVPCal settings. |
| Up | Moves the currently selected LED wall configuration up one position in the list order. |
| Down | Moves the currently selected LED wall configuration down one position in the list order. |
| Rename | Allows you to change the name of the currently selected LED wall configuration. |
Project Settings
Section titled “Project Settings”Global project settings that affect how calibration data is processed and exported.
| Project | Description |
|---|---|
| Export LUT for ACEScct | Modifies the calibration LUT export so that the LUT expects ACEScct input and produces a calibrated ACEScct output. The user will have to apply the colour space conversion and EOTF transform from ACEScct to the target independently. |
| Export LUT for ACEScct In/Target Out | Modifies the calibration LUT export so that the LUT expects ACEScct input and produces a calibrated target output (with both the colour space and EOTF transform to the target applied). |
| Reference Gamut | Colour space used as the common computational foundation for all colour transformations and calibration calculations between different input and target colour spaces. Typically ACES-2065-1. |
Calibration Patch Generation
Section titled “Calibration Patch Generation”Configure the technical specifications for generating colour calibration patches and test patterns.
| Patch Generation | Description |
|---|---|
| File Format | The file format for export. If EXR is chosen, the patches will export in linear (e.g. Linear Rec 2020), scaled such that 1=100 nits. Otherwise, patches will export in the target space and EOTF (e.g. ST 2084 - Rec 2020). |
| Resolution Width | Width resolution of the exported patches. |
| Resolution Height | Height resolution of the exported patches. |
| Frames Per Patch | How many frames per patch the tool will export. |
| Frame Rate | The frame rate for the shooting camera, used in certain SPG pattern sequences. |
| Content Max Lum | The maximum luminance of the content, which is used to produce three variations of creative roll-off, which gently rolls off the maximum value specified to the peak luminance of the LED wall. Defaults to 10,000 nits, which is the maximum for PQ. |
LED Display Target Specifications
Section titled “LED Display Target Specifications”Define the target colour space, brightness, and gamma characteristics that your LED wall should reproduce.
| LED Target Specs | Description |
|---|---|
| Target Gamut | The target gamut for the calibration. Choose between predefined standard gamuts (sRGB, P3, Rec.2020), or select a custom one that matches the LED wall primaries. |
| Add Custom Gamut | A pop-up widget allows you to add a new custom gamut for the calibration by inserting a custom gamut name and its CIE 1931 x,y primaries and white point coordinates. |
| Target EOTF | Select the target EOTF of the LED panel. Note that when switching between ST2084 and power gamma (sRGB/BT1886), the MaxLum will automatically reset. |
| Target Max Lum (nits) | Select the content peak luminance (only available if the EOTF is ST2084). |
Colour Patch Configuration
Section titled “Colour Patch Configuration”Fine-tune the characteristics of the colour patches used in the calibration process.
| LED Tool | Description |
|---|---|
| Primaries Saturation | The saturation intensity for the colour primaries (default to 0.7). |
| Number of Grey Patches | The number of grey steps to be generated/analysed (default to 30). |
Calibration Settings
Section titled “Calibration Settings”Control how the calibration transforms are calculated and applied.
| Calibration | Description |
|---|---|
| Reference To Target CAT | Choose from a standard list of Chromatic Adaptation Transforms or select NONE for the Reference to Target 3x3 matrix (defaults to Bradford). |
| Calculation Order | Edit the order of operations for the calibration transforms. |
| Enable EOTF Correction | If checked, enables the EOTF correction. |
| Target To Screen CAT | Choose from a standard list of Chromatic Adaptation Transforms or select NONE for the Calibration matrix. None is set as the default. |
| Enable Gamut Compression | If checked, enables gamut compression. |
| Avoid Clipping | If checked, scales the entire calibration transforms to avoid highlight clipping (on by default). |
Camera Plate Configuration
Section titled “Camera Plate Configuration”Specify the colour space characteristics of your camera’s captured footage for accurate calibration processing.
| Plate | Description |
|---|---|
| Input Plate Gamut | The input colour space of the pre-processed camera plate sequence (defaults to ACES-2065-1). |
| Shooting Camera Gamut | The native colour space of the camera used for the calibration. |
Reference Calibration Settings
Section titled “Reference Calibration Settings”Configure automatic white balancing and cross-referencing between multiple LED wall setups.
| Plate Reference | Description |
|---|---|
| Auto WB Source | If enabled, the input plate will be white-balanced prior to performing the analysis and calibration. |
| Match Reference Wall | If checked, the selected LED wall will be matched to the selected reference wall. |
White Point Correction
Section titled “White Point Correction”Adjust the white point of captured plates using a reference image to improve calibration accuracy.
| Plate White Point Offset | Description |
|---|---|
| Use White Point Offset | If checked, the plate’s original white point will be shifted towards the measured white point of the indicated file, prior to performing the analysis and calibration. |
| White Point Offset Source | The path to an image file with the white point offset source. |