Changes
[[File:ArucoMarker.PNG|250 px|right|thumb|alt=AR-Marker|AR-Marker]]
AR-Markers are square fiducial markers composed by a wide black border and a inner binary matrix which determines its identifier (ID). These markers are detected in the camera stream of the [[POI_View|POI View]] and can be used for [[AR-Marker#Direct_Augmentation|Direct Augmentation]] or [[AR-Marker#AR-Marker Device Pose Estimation|Device Pose calculation]].
The AR-Marker ID is defined as an integer value between zero and the maximum dictionary size (see [[AR-Marker#Marker Creation|Marker Creation]]). Once a marker is detected, the ID is used to gather additional information from the associated UBIK® {{UBIK}} object (see [[AR-Marker#Classifications|Classifications]]).
The four corner points of an AR-Marker are extracted to calculate the relative pose (position and orientation) between the camera and the AR-Marker, which serves as a basement for the above stated use-cases. For that, the camera of the mobile device has to be calibrated (see [[Camera_Calibration|Camera Calibration]]) and the AR-Marker side length has to be known.
== Marker Creation ==
Currently UBIK® {{UBIK}} is using the standard dictionary, allowing the creation of 1024 unique AR-Marker IDs. Markers can be created using the provided Aruco Marker Creation tool from the release portal [[https://80.243.175.50/Release/download/modules/Plugins/tools/ArucoMarkerGenerator.rar Aruco Marker Creation Tool]]. Once the tool is extracted, the ArucoMarkerGenerator.htm can be opened to configure the ID and side length. After clicking Generate Marker, the AR-Marker can be printed.
{{Hint|Note when printing AR-Markers the physical side length has to correlate with the AR-Marker side length property (see [[AR-Marker#Classifications|Classifications]]).}}
== Direct Augmentation ==
If marked with the [[SYSCLS_ARMARKER_DIRECTAR]] classification, AR-Markers can be directly augmented once they are detected in the [[POI_View|POI View ]]. Per default a Billboard, representing the classified UBIK® {{UBIK}} object, will be shown directly on the AR-Marker. Additional classifications ([[SYSCLS_ARCONTENTTRANSLATION]], [[SYSCLS_ARCONTENTROTATION]], [[SYSCLS_ARCONTENTSCALE]]) can be used to translate, rotate and scale the Billboard in relation to the detected AR-Marker. Furthermore it is possible to render multiple UBIK® {{UBIK}} objects in relation to the same physical AR-Marker.
Depending on the computational capacities of a mobile device, AR-Markers can be directly augmented in realtime (25 Hz).
