Changes
== Setup ==
In order for one to be able to use the feature properly , a setup folder is required and can be found at the following link [http://wiki.augmensys.com/images/6/66/Dynamic_AR_Content_Folder_Structure.rar Folder Structure]. The setup folder contains:# A root folder, named ''UBIK''.# The ''UBIK'' root folder contains a child folder, named ''ARConfig''.# The ''ARConfig'' contains two child folders named ''IDMarker'' and ''Markerless''. <br>## ''IDMarker'' folder contains the resources and configuration files needed for scanning an id marker. <br>## ''Markerless'' folder contains the resources and configuration files needed for scanning a picture.# ''IDMarker'' and ''Markerless'' folder contain a ''res'' and a ''conf'' folder. In the ## The ''res'' folder contains all the resources needed for metaio and ubik <br>to show 3d be shown, like 3D objects, video videos and ubik links to {{UBIK}} objects are located. In the ## The ''conf'' folder contains all the configuration files are stored.* ''Example''. In the following picture one can see a sketch of the folder structure.<br>:[[File:folder_structure.png]] <br>{{Attention|If a texture is used for a geometry, in order for it to be displayed properly, the 3d object, the material (*.mtl file) and the texture (picture) must all exist in the same place. Only the geometry itself has to be specified as a resource in the Action Mapping though.}}
== Action Mapping XML Setup ==
After the folder is configured, the next step is to validate the schema against an online validator. A solution can be found at [http://www.utilities-online.info/xsdvalidation/ Online XML Schema Validator]. The schema used to validate against can be found inside the ''UBIK'' Folder and is named ''xsd_schema_validation''.
The action mapping xml contains different actions such as GeometryAction, MovieAction and UBIKObjectAction.
* In the The following xml below shows an example can be seen.<br>configuration:
<source lang="xml">
<TrackingActionMapping>
</TrackingActionMapping>
</source>
All the actions Action tags must have specify a Tracking id, as an attribute a tracking id. The Tracking id must exist <br>in the tracking xml, the one that metaio needs in order to recognize id markers or pictures scanned.
{{Attention|If a texture is used for a geometry, the material (*.mtl file) and the texture (picture) must all exist in the same place in order for to have the 3D object displayed properly, Only the geometry has to be specified as a resource in the Action Mapping, though.}}
=== GeometryAction Tag ===
==== GeometryResource Tag ====
The GeometryResource contains:
# '''Resource path'''. It is : the resource path of the 3d 3D object or video to be displayed.# '''Scale'''. If it exists: if specified, it is the scale of the current 3D objectwill be scaled to this size.# '''OffsetMillimeters'''. If it exists: if specified, it is this value will be added to the translation vector position of the current detected marker when displaying the 3D object. It has a The offset can be defined along the X, Y and Z value, but not all them are mandatoryaxis. # '''RotationDegrees'''. If it existsif specified, it is the rotation of the current 3D objectwill be rotated by this value against the detected marker. * ''Resource path example''. pump/pump.obj. <br>
* ''OffsetMillimeters example''.
<source lang="xml">
</OffsetMillimeter>
</source>
=== MovieAction Tag ===
==== MovieResource ====
The ''MovieResource '' Tag contains the same values as the ''GeometryResource '' except the rotation vector.
==== PlayButton Tag ====
The ''PlayButton '' Tag, if it is defined, contains the same values as the ''GeometryResource '' tag. It's Its purpose, if it exists, is to start a video, if the geometry is touched.
=== UBIKObjectAction Tag ===
The ''UBIKObjectAction '' tag should enable handling of the ubik {{UBIK}} objects when scanning either a picture or an id marker. <br>The tag must contain the tracking id attribute and, optional, the ubik-uid tag.
== Tracking Data XML ==