Changes between Version 4 and Version 5 of XmlModelConfiguration

Timestamp:

Feb 18, 2011, 8:25:29 PM (14 years ago)

Author:

Torben Dannhauer

Comment:

--

XmlModelConfiguration

@@ -13 +13 @@
    - label: text to label the model with.
    - dynamic: "yes" to add an standard updater to the model. 
-   - position: Position to place the model
-   - attitude: Orientation in degree to place the model
-   - updater [optional]: Channels to use for position, attitude and label update
-   - cameraoffset [optional]: Rotational (in degree) and translational offset for the object mounted camera manipulator to the visual_object   
-   - Geometry [optional]: 3D model to display. Leave empty to use model without 3D model.
-   - Geometryoffset [optional]: Rotational offset (in degree) for the loaded 3D model to the visual_object (if the 3D model has a wrong coordinate frame)
-   - Geometryscale [optional]: Scale factors for the loaded 3D model in all three dimensions.
 -->
 <model objectname="TestObject" trackingid="1" label="TestText!" dynamic="no">
@@ -42 +35 @@
 
 == Position & Attitute ==
+To position the visual_object, you have to setup a location in latitude (in degree), logitude (in degree) and altitude. Additionally you have to specify it's attitude in degree.
 {{{
 #!xml
@@ -49 +43 @@
 
 == Updater ==
+To update certain properties of the visual_object, you can define an updater and configure the slot names which should be used for the updates.
+The attributes in the XML entries are not values but names of the slots which content should be used for updating the visual_object every frame.
+To skip updating of a certain value, leave the updatername emtpy. 
+
+The updater can be defined in the XML configuration file as followed:
 {{{
 #!xml
 <updater>
- <position lat="" lon="" alt=""></position>
- <attitude rot_x="" rot_y="" rot_z=""></attitude>
+ <position lat="your_lat_slot" lon="your_lon_slot" alt=""></position>
+ <attitude rot_x="your_rot_x_slot" rot_y="" rot_z="your_rot_z_slot"></attitude>
  <label text=""></label>
 </updater>
@@ -59 +58 @@
 
 == Camera Offset ==
+To use the "Object mounted" camera manipulator, you have to define for your what the camera coordinates relative to your visual_object are. You can define a rotational (in degree) und translational offset.
+
+The defition of the camera offset in the XML configuration file is:
 {{{
 #!xml
@@ -68 +70 @@
 
 == Geometry ==
-Using a geometry as well as modifying it with offset or scalefactors is optional.
+You can load and display a 3D geometry to visualize the 3D object. You have to specify the filename with an relative or absolute path.
+If the 3D model has the wrong orientation or wrong size, you can specify an offset rotation (in degree) or scale factors. Using a geometry as well as modifying it with offset or scalefactors is optional.
 
-You can load and display a 3D geometry to visualize the 3D object. You have to specify the filename with an relative or absolute path.
-If the 3D model has the wrong orientation or wrong size, you can specify an offset rotation or scale factors.
-
-The XML configuration of an gemoetry entry in a visual object is:
+The XML configuration of an geometry entry in a visual object is:
 {{{
 #!xml
@@ -82 +82 @@
 }}}
 
-
-
+If you do not use a geometry, a visual_object is still usefull, e.g. for dynamic positioning and upating a text label or to attach the camera.