Alignment Panel

as part of creating a tracking config, an initial world alignment is defined however, the user can easily modify this initial world alignment at any point in time by using the “alignment” panel available in the dashboard defining a sensible zero point using the world alignment tools is an important step to make sure that any cg elements that are intended to be rendered, are correctly positioned the zero point is initially set to the camera position when the tracking is started following this the zero point can be adjusted using 6 different methods set zero point to feature point set zero point to feature point – allows the zero point to be snapped to a tracking point floor orientation floor orientation – align the floor plane horizontally, manual adjustment is available for finetuning adjust floor height adjust floor height – offset the height of the camera vertically move zero point on floor move zero point on floor – move the zero point to anywhere on the current floor plane fine tune position fine tune position – for small adjustments to the position of the zero point fine tune rotation fine tune rotation – for small adjustments to the rotation of the zero point to make any changes to the world alignment, press “ e e dit world alignment dit world alignment ” to unlock the controls while in edit mode, changes to the world alignment will not be applied to the tracking data sent from the system to ue connect or other 3rd party renderers when in edit mode, the following options become available undo last step– undo the previous change cancel – revert all changes and exit edit mode save – commit all changes and save the alignment and pointcloud to the tracking config the stage when in edit mode, the “stage” overlay is displayed on the dashboard views this is a representation of the floor and position and orientation of the zero point when adjusting the world alignment, the stage should be used to visually confirm how the changes are applying to the zero point the size of the stage can be adjusted in the “settings” panel alignment panel features set zero point to feature point this option allows the user to snap the zero point to any detected tracking feature this is a very fast and simple way to quickly position the zero point when this mode is enabled simply hover over a tracking point in any of the dashboard views a yellow cone will be rendered to indicate the position of the zero point the cone is 1m high, this will give some indication as to the estimated distance of the selected tracking feature left click to confirm the zero point position note – when using this method, try and use the other views available in the dashboard to confirm that the zero point has been correctly set particularly when operating in natural tracking mode, some tracking features may be falsely detected and will appear much further or closer away than in reality using these falsely detected features with this tool can cause issues with tracking quality floor orientation the “floor orientation” allows for adjusting the rotation of the “x” and “z” axis, which make up the floor or “ground plane” two different methods for aligning the orientation of the floor are available gravity sensor gravity sensor uses internal sensors in the cambar to estimate the floor, very quick but can be inaccurate height sample height sample more accurate method that lets the user sample the floor at 3 different locations, slower but produces better results when done correctly gravity sensor the “ use gravity sensor use gravity sensor ” button will try and automatically determine the ground plane using the internal sensors of the cambar for optimal results, the cambar should not be moving when the gravity sensor button is pressed the ground plane can be further manually adjusting using either the “ + + ” or “ ” buttons or using the keyboard cursor hotkeys it is typically recommended to try and align the floor with the real world physical floor height sample this method works by moving the camera to 3 different positions in the area that have the same identical identical height from the floor it works well as when done correctly it gives an accurate representation of the real world floor orientation the process requires the tracking to be stable and consistent over the area that is being sampled and is a particularly good method to use in conjunction with marker based tracking the process measures from the cambar, this means it can be done without the cambar being rigged to the camera position the camera in the first area that you wish to sample and press " sample first position sample first position " move the camera to a second area, ideally at least 1m away, avoid panning or tilting the camera too much as this might impact the height of the cambar press " sample second position sample second position " when located move to a third location, ideally at least 1m from the previous two press " sample third position sample third position " a red overlay will be shown in the perspective view that highlights the new floor orientation press " align floor align floor " to apply the new orientation " reset reset " will discard the samples and allow the process to be repeated, if desired adjust the floor height in most applications, it is generally helpful to have the zero point set on the ground, to aid with this, particularly when the physical floor is not observable in the any of the dashboard views, the “adjust floor height” tool is available from this section the user can adjust the vertical “y” axis of the world alignment either the “+” or “ ” or keyboard cursor keys can be used to make changes to the distance of the camera from the ground plane the values displayed for the cambar and main cam should relate to the real world physical distance between the respective devices and the chosen ground plane positive values indicate the camera is above the ground plane, and negative values indicate that it is below main camera distances should be measured to the sensor position of the camera move zero point on the floor this tool allows for the quick and easy movement of the zero point by snapping it to any position on the ground plane this is suited to making large adjustments very quickly and is particularly useful after the camera height has been correctly defined using the “adjust floor height” tool with this tool active, simply hover anywhere on the “stage” floor in the dashboard views a yellow cone will be displayed to show where the zero point will be set to after clicking, the zero point will be set to the clicked position be aware that it is important that the area on the image that you are selecting, is at the same height relative to the floor/ground plane that has been set this tool makes no adjustment to the height of the zero point fine tune zero point position zero point position allows for the translation of the zero point on the “x” and “z” axis, in effect, sliding the zero point along the ground plane it is similar to the “move zero point on floor plane” tool but allows for much more granular control and is therefore suited to making small adjustments to adjust, simply use the “+” or “ ” buttons available in the panel alternatively, the keyboard cursor keys can be used when using the keyboard shortcuts, holding shift will increase the magnitude of the adjustment fine tune zero point rotation the rotation tool allows for adjusting the rotation of the zero point around the “y” or vertical axis this can be done either by using the “+” or “ ” buttons or the keyboard cursor shortcuts when using the keyboard shortcuts, the shift key will increase the magnitude of the adjustment using the gizmo when entering edit mode, a gizmo will be displayed on all the dashboard views the gizmo allows for the adjustment of the zero point directly from the dashboard views the 4 icons along the lower edge of the gizmo toggle between the 4 modes; horizon, height, position and rotation depending on the mode selected, the corresponding axis on the gizmo will be highlighted, by clicking and dragging on a chosen axis, adjustments can be made the gizmo allows for the quick adjustment of all axis of the zero point without needing to use the tools offered in the world alignment panel