CamBar Offset

the cambar offset calculates the position and orientation of the cambar relative to the main camera accurate offset values are essential for reliable tracking performance the offset can be calculated using either cambar offset assistant ( \<font color="#2166ae">recommended\</font> ) manual cambar offset both methods are described below before you begin before starting the offset procedure, ensure that the correct camera and lens calibration has been created the cambar is securely mounted the environment contains stable tracking features the instant recovery chart is available cambar offset assistant the cambar offset assistant automatically calculates the offset by matching the optical relationship between the cambar and the main camera the process is designed to be quick and straightforward for best results, use the included instant recovery chart during the procedure when the lens calibration is accurate and the environment contains stable tracking features, the assistant typically produces highly accurate results with minimal manual adjustment the assistant can be accessed from the cambar offset panel a red exclamation mark will be displayed if the offset has not yet been completed for the current tracking configuration select start cambar offset assistant to begin the assistant guides the user through each stage of the process calibration selection select the correct calibration profile for the current camera and lens setup if the required calibration is not listed exit the assistant add the calibration from the equipment page restart the procedure using the wrong calibration can result in inaccurate offset values lens encoder verification the lens encoder stage verifies that the current fiz (focus, iris, zoom) encoder values are valid incorrect encoder data may cause the wrong region of the lens calibration to be used, reducing alignment accuracy chart placement place a single instant recovery chart within view of the main camera recommendations ensure the chart is clearly visible and well lit do not move the chart during the procedure avoid showing multiple charts simultaneously the assistant also relies on stable natural tracking features within the environment avoid areas with reflective surfaces excessive movement low feature detail learn stage during the learn stage, the system builds a shared point cloud between the cambar and the main camera slowly move the camera system so the cambar can observe the area visible to the main camera the environment the cambar will face during operation the instant recovery chart (this will be indicated when it has been detected in the point cloud) tips move slowly and smoothly avoid rapid motion or motion blur ensure the instant recovery chart remains stationary if the chart is not detected immediately, slightly move the camera to trigger detection for larger physical offsets, it may be easier to temporarily remove the cambar and move it independently during learning estimation stage during the estimation stage, the system calculates the final alignment using the shared point cloud the instant recovery chart the values will refine over several seconds during this stage keep the camera stationary avoid lighting changes prevent people or objects moving through the scene once the values stabilise — typically within 5–10 seconds — the procedure can be completed if the values fail to stabilise, this usually indicates poor point cloud quality unstable tracking features incorrect lens or camera calibration troubleshooting do not move the chart moving the instant recovery chart during the procedure can cause the offset calculation to fail or produce inaccurate results keep the chart completely stationary until the process has finished wide vs long lenses the assistant performs best with wider focal lengths longer focal lengths provide less environmental information for the system to match, which can reduce robustness and alignment quality where possible, use a wider lens during the offset process the assistant will display a warning if the detected field of view is too narrow for reliable operation chart not detected this may be caused by the chart being too far away poor lighting motion blur or focus issues temporary tracking loss insufficient camera movement during learning adding the chart after that part of the environment has already been learnd repositioning the chart and restarting the "learn" phase is often the quickest method to ensure the chart is properly detected poor results poor alignment results are commonly caused by inaccurate lens calibration incorrect camera sensor settings unstable tracking features in the environment environmental elements such as reflective surfaces, moving objects, or visible marker patterns may interfere with tracking quality during the procedure if problems persist verify the lens calibration quality confirm the correct sensor dimensions are configured repeat the procedure in a more stable environment manual cambar offset if the cambar offset assistant cannot be used, the cambar offset can also be adjusted manually select the padlock icon to unlock the offset controls for editing keyboard shortcuts are available for fine adjustment of the transform values a useful alignment method is to compare the position of tracking features between the main camera view the cambar view and iteratively align them visually