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.  

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 (link to [https://release.augmensys.at/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.

The most important classification is the [[SYSCLS_ARMARKER]], containting the identi-fier identifier and the AR-Marker side length. Two additional classifications [[SYSCLS_ARMARKER_DIRECTAR ]] and [[SYSCLS_ARMARKER_GEO ]] inherit from the above classiciation and are used to distinguish between the two use-cases of [[AR-Marker#Direct_Augmentation|Direct Augmentation]] and [[AR-Marker#AR-Marker Device Pose Estimation|Device Pose calculation]].  An additional [[SYSCLS_ARCONTENTREFERENCE]] {{Version/WinXSince|3.4.0}} can be used to specify an UBIK Object that should be rendered instead of the detected AR-Marker. This enables Multi AR-Marker Rendering whereby one an the same UBIK object can be rendered in relation to multiple AR-Markers. {{Attention|In order for a referenced object to be rendered, the detected AR marker object has to be additionally classified with [[SYSCLS_ARMARKER_DIRECTAR]]. And information such as distance, rotation, etc. is extracted from the detected object, not the referenced one. (This is critical for {{UBIK}} to render the same objects from different angles and distances.)}}

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_ARCONTENROTATION[[SYSCLS_ARCONTENTROTATION]], [[SYSCLS_ARCONTENTSCALE]]) can be used to trans-latetranslate, rotate and scale the Billboard in relation to the detected AR-Marker (see AR-Marker Coordinate system). 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).  [[File:DirectAR.PNG|600 px|center|thumb|alt=Direct Augmentation|Direct Augmentation]] 

If marked with the [[SYSCLS_ARMARKER_GEO ]] classification, AR-Markers can be used for calculating the device pose once they are detected in the [[POI_View|POI-View ]] (see [[AR-Marker_Device_Pose_Estimation|AR-Marker Device Pose Estimation]]) == Grouped AR Marker {{Version/WinXSince|3.8}}{{Version/XamarinSince|1.1}}==For scenarios where more than 1024 markers are needed, {{UBIK}} provides the possibility to group AR markers just like with Geo POIs. This means:* Depending on the currently opened POI group, a scanned AR marker might not be displayed (if it's doesn't belong to that group);* Within the same POI group, the 1024 unique marker limit still applies.* All types of AR markers are subject to the grouping rules stated above, including:** Directed augmented markers;** AR content reference markers; {{Attention|Only the detected AR marker object has to the in the open group, not the referenced object.}}** Geo AR markers.{{Hint|POI groups can be switched manually, but also via e.g. QR marker scanning. In fact, one can scan a QR marker and an AR marker at the same time to switch to a certain group and then display the AR marker object within that group.}} [[Category:Android|AR-Marker]][[Category:Client|AR-Marker]][[Category:Version 1.1|AR-Marker]][[Category:Version 3.8|AR-Marker]][[Category:WinX|AR-Marker]][[Category:Xamarin|AR-Marker]]