Changes

Camera calibration needs to be done once per device model, for features requiring depth estimation (e.g. [[AR-Marker|AR-Markers]]).  <tabs><tab name="Prior to UBIK 4">Currently the following device models are pre-calibrated:

[[File:CameraCalibrationScreenshot.png|thumb|Camera Calibration Application (WinX)]][[File:CameraCalibrationResultScreenshot.png|thumb|Camera Calibration Result (WinX)]] * Download and the camera calibration application from the release portal.* Print Download and print the [[:File:AsymetricCalibrationPattern.pdf|asymmetrical circle calibration pattern from the release portal]].

* Tap on the display to mark a frame for calibration.(Press the Capture Button on the WinX client)** The calibration pattern should take up aus as much of the camera view as possible.

** Take as much many calibration frames as possible (at least 30).* After having enough calibration frames, open the menu and press calibra-tioncalibration (Press Calibrate on the WinX client).* A On Android a toast indicates that calibration was done and shows the reprojection er-rorerror. This error should be as low as possible (lower than 3). On the WinX client the result section can be expanded.* The camera matrix and distortion coefficients are now saved on the device in the Downloads folder(in the LocalState folder on the WinX client). The device name is used as the filename of the textfile, on WinX the filename is ''CalibrationResult. txt''

<tab name=" UBIK 4"> [[File:CameraCalibrationScreenshotCamCal Settings.pngjpg|thumb|220px|Camera Calibration Application in AR Settings]]      From UBIK 4 onwards, the camera calibration can be done directly on the device. Navigate to Settings -> AR and locate the section ''Camera Calibration''. Right of it there are 3 buttons: == Start calibration (WinXCamera symbol {{key press|Android}} {{key press|iOS}})==  [[File:CamCal Checkerboard.jpg|thumb|220px|Calibration in progress]][[File:CameraCalibrationResultScreenshotCamCal Result.pngjpg|thumb|Camera 220px|Calibration Result result]]* Download and print the [[:File:AsymetricCalibrationPattern.pdf|asymmetrical circle calibration pattern]].* Verify the correct size by measuring the reference length on the upper right corner.* Mount the calibration pattern on a planar surface.* Target the calibration pattern with the camera (WinXthe pattern gets augmented --> check if the augmentation is placed at the center of the circles before taking a calibration screenshot).* Tap on ''Add Frame'' to mark a frame for calibration.** The calibration pattern should take up as much of the camera view as possible.** Keep the camera and calibration pattern stable to not introduce blur.** Take calibration frames from different viewpoints.** Circles of the calibration pattern should also be in the corners of the camera view.** Take as many calibration frames as possible (at least 10).* After having enough calibration frames, the ''Calibrate'' button will be enabled.** Once pressed, the result of the calibration is shown on screen.** Press "Save" to store the camera matrix and distortion coefficients on the device ** Press "Restart" to start a fresh calibration. Return to the settings screen. You will now see text stating ''Device calibrated as [model]]'' underneath the ''Camera Calibration'' label. Your device was successfully calibrated. == Export calibration (Download symbol {{key press|Android}} {{key press|iOS}}) ==Exports the currently stored calibration of this device into a text file, that can be used for import on other devices of the same model. The resulting file will be presented in a share dialog. == Import calibration (Upload symbol {{key press|UWP}}) ==The native UWP client does not have the built in camera calibration feature, but it can import calibration files that were previously generated and exported from other clients. == Delete calibration (Trash bin symbol) ==Deletes the currently stored calibration from this device. If no calibration values are stored, the system will use fallback values that are device-agnostic. </tab></tabs>