OmniCal Rig-check

Overview

Rig check is the tool for quickly re-calibrating without advanced knowledge of the rest of the OmniCal system. It is primarily used by touring operators to re-calibrate shows moving into new venues.

Workflow

The Rig Check 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 is not modified in this workflow.

  1. Ensure that you have a plan already calibrated by a Trained user. It should be selected in the OmniCal Calibrator editor.

  2. Left-click Check Cameras in the OmniCal Calibrator editor.

  3. Verify there are no errors when the Check Cameras window opens.Errors can include the following:

    1. Cameras are unavailable

    2. Camera names have been modified in the plan. The plan capture is used as a reference for Rig Check. Any changes to cameras names after the plan capture was done will invalidate it.

  4. 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.

  5. Ensure that the camera views match:

    1. They don't need to be identical, but the coverage of projection surfaces should match and they should be in approximately the same positions.

    2. 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 (for machine vision cameras) or the lighting environment. It is therefore recommended that the focus and aperture of machine vision cameras be locked in place for repeatability

  6. Once you are happy with the camera views, close the Check Cameras window.

  7. Left-clickExecute 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 and calibration.

  8. Ensure that the correct Plan and Result are selected in the OmniCal Calibrator editor.

  9. Left-click Check Result in the OmniCal Calibrator 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:

    1. The Plan has no capture or calibration

    2. The Result has no capture or calibration

  10. Verify there are no errors when the Check Result window opens. Errors can include the following:

    1. The camera names in the Plan and Result don't match. The Plan may have been modified since the Result was created.

  11. The Check Result window will open which shows camera pairs consisting of the original Plan capture and the Result capture that was taken.

  12. Left-click on a camera image to open the Result Aligner window. If an Mesh Deforms have been applied these will be undone in order for alignment points to be editable.

  13. 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 Quick Align.

  14. 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.

  15. Repeat this for all cameras. You could in theory only check cameras or projection surfaces which you know to have moved.

  16. Close the Check Result window. You will be asked if you'd like to re-apply the mesh deform

  17. Warning: The stage should be clear

    Warning: No changing light levels

    Warning: No people walking across stage

Example

Accessing rig-check

  1. Open the stage editor by right-clicking Stage in the dashboard, or by right-clicking the floor in the visualiser.

  2. Left-click OmniCal Calibration to open the OmniCal editor.

  3. Ensure that you have a plan already calibrated by a Trained user.

  4. Left-click Check cameras.

Using rig-check

  1. Ensure that you have a plan already calibrated by a Trained user. It should be selected in the OmniCal Calibrator editor.

  2. Left-click Check Cameras in the OmniCal Calibrator editor.

  3. Verify there are no errors when the rig-check editor opens.

    Errors can include the following:

    • Cameras are unavailable

    • Camera names have been modified in the plan. The plan capture is used as a reference for Rig Check. Any changes to cameras names after the plan capture was done will invalidate it.

  4. 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.

  5. Ensure that the camera views match:

    1. They don't need to be identical, but the coverage of projection surfaces should match and they should be in approximately the same positions.

    2. 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 (for machine vision cameras) or the lighting environment. It is therefore recommended that the focus and aperture of machine vision cameras be locked in place for repeatability

  6. Once you are happy with the camera views, close the Check Cameras window.

  7. 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 and calibration.

  8. Ensure that the correct Plan and Result are selected in the OmniCal Calibrator editor.

  9. Left-click Check Result in the OmniCal Calibrator 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:

    1. The Plan has no capture or calibration

    2. The Result has no capture or calibration

  10. Verify there are no errors when the Check Result window opens. Errors can include the following:

    1. The camera names in the Plan and Result don't match. The Plan may have been modified since the Result was created.

  11. The Check Result window will open which shows camera pairs consisting of the original Plan capture and the Result capture that was taken.

  12. Left-click on a camera image to open the Result Aligner window. If an Mesh Deforms have been applied these will be undone in order for alignment points to be editable.

  13. 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 Quick Align.

  14. 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.

  15. Repeat this for all cameras. You could in theory only check cameras or projection surfaces which you know to have moved.

  16. Close the Check Result window. You will be asked if you'd like to re-apply the mesh deform.

  17. Warning:

    The stage should be clear.

    With no changing light levels.

    And no people walking across stage.