OmniCal RigCheck
RigCheck is the tool for quickly re-calibrating without advanced knowledge of the rest of the OmniCal system. It is primarily used by operators at fixed installations to re-calibrate shows after minor external changes (e.g. projector pose or lens change).
Accessing RigCheck
Section titled “Accessing RigCheck”- Open the stage editor by right-clicking Stage in the dashboard, or by right-clicking the floor in the visualiser.
- Left-click OmniCal Calibration to open the OmniCal Calibration editor.
- Ensure that you have a plan already calibrated by a trained operator.
- Left-click Check cameras.
Workflow
Section titled “Workflow”The RigCheck workflow is used after a full OmniCal calibration & alignment has been completed. The plan is used as a template to repeat the calibration with the same settings. The plan itself is not modified in this workflow. Each RigCheck stores its own set of settings and data.
Using RigCheck
Section titled “Using RigCheck”- Ensure that you have a plan already calibrated by a trained OmniCal operator. It should be selected in the OmniCal Calibration editor.
- Left-click Check Cameras in the OmniCal Calibration editor.
- Verify there are no errors when the Check Cameras window opens. Errors can include the following:
- a. Cameras are unavailable.
- b. Camera names have been modified in the plan. The plan capture is used as a reference for RigCheck. Any changes to cameras names after a completed plan capture will invalidate it.
- The Check Cameras window will open which shows camera pairs consisting of the original plan capture and a snapshot capture of the current stage. You can take a new snapshot using the Refresh Camera Views button.
- Ensure that the camera views match:
- a. They don’t need to be identical, but the coverage of projection surfaces should match and they should be in approximately the same positions.
- b. The brightness of the images should also match. The exact camera settings specified in the plan (like exposure time) will be used here, so any differences would be either due to the physical aperture or focus of the camera lens, or the lighting environment. It is therefore recommended that the focus and aperture of machine vision cameras be locked in place for repeatability.
- Once you are happy with the camera views, close the Check Cameras window.
- Left-click Execute Plan. This will perform a capture, calibration, alignment and optionally a mesh deform (if it was configured to run automatically in the plan’s deform settings). A new Result object is created which contains the capture, calibration etc data.
- Ensure that the correct Plan and Result are selected in the OmniCal Calibration editor.
- Left-click Check Result in the OmniCal Calibration editor. Note that this will apply the result’s alignment to the stage (if it hasn’t been applied already). This will update both projectors and projection surfaces if they have alignment points. If Check Result is greyed out a tool tip should tell you the reason, which can include the following:
- a. The Plan has no capture or calibration.
- b. The Result has no capture or calibration.
- Verify there are no errors when the Check Result window opens. Errors can include the following:
- a. The camera names in the Plan and Result don’t match. The Plan may have been modified since the Result was created.
- The Check Result window will open which shows camera pairs consisting of the original Plan capture and the Result capture that was taken.
- Left-click on a camera image to open the Result Aligner window. If any Mesh Deforms have been applied these will be undone in order for alignment points to be editable.
- On the left hand side is the camera view from the original Plan (read only) and on the right the Result. You can then update the alignment points on the right to match the left. This will update the alignment on the stage as you do it. The controls are identical to QuickAlign, except that it’s not possible to add/remove any alignment points.
- Select the next screen by pressing the button at the bottom of the camera views or selecting it from the surfaces drop down and repeat the process of checking and adjusting alignment points.
- Repeat this for all cameras. You could in theory only check cameras or projection surfaces which you know to have moved.
- Close the Check Result window. You will be asked if you’d like to re-apply the MeshDeform.
Managing RigCheck data on disk
Section titled “Managing RigCheck data on disk”Just like in the Plan workflow, OmniCal RigCheck also stores a mix of data on the hard disk, rather than in the .d3 project itself.
The RigCheck data includes:
- OmniCal settings
- Captured images
- Calculated blob detection results
- Calibration results
- Alignment data
- Report data
This RigCheck data is stored in subfolders of the d3 project’s internal/opticalresult/
folder.
Every RigCheck has its own set of data, and its subfolder has the same name as the associated “Result” object in Designer.
The data in the internal subfolders is managed together with the corresponding Result object in Designer. When the RigCheck object is deleted, and the trash in Designer is cleared, any associated folder is also deleted from the hard disk.