Dummy Tracking configuration

→Return to Tracking Configuration

Introduction

The Dummy tracking allows the definition of a pseudo tracking system/sensor source that delivers constant tracking values at a given interval. It can be useful for e.g. placing 3D models always at the same location in the augmented image, regardless of any other tracking system. Another common use are 2D overlays or screensavers. Also, the tracking values delivered by a Dummy tracking can be changed on the fly.

Configuration

The code below specifies the content of an according tracking configuration file.

In the Sensor section a Sensor of type DummySensorSource has to be defined with a unique SensorID. The Parameters section defines parameters which are related to the Dummy Tracking. The parameter updateInterval defines the update interval in milliseconds at which the Dummy sensor shall deliver tracking values.

The configuration for a specific dummy sensor coordinate system contains:

• the unique SensorCosID
• and a translation (in mm) and rotation value (in Quaternion notation), that this sensor coordinate system should deliver, within the <Parameters><Pose> section.

Note that you can use use the function setTrackingValues() (please refer to the according API documentation section) to manipulate the pose of the Dummy coordinate system at runtime.

<?xml version="1.0"?>
<TrackingData>
<Sensors>
 <Sensor type="DummySensorSource">  
  <SensorID>DummySensor1</SensorID>
   <Parameters>
    <updateInterval>40</updateInterval><!-- in ms-->
   </Parameters>
  <SensorCOS>
   <SensorCosID>DummyCos1</SensorCosID>
   <Parameters> 
    <!-- The pose the dummy sensor source delivers-->
    <Pose>
     <Translation>
      <x>0.0</x>
      <y>0.0</y>
      <z>-1000.0</z>
     </Translation>
     <Rotation>
      <x>0.0</x>
      <y>0.0</y>
      <z>0.0</z>
      <w>1.0</w>
     </Rotation>
    </Pose>
   </Parameters>
  </SensorCOS>
  <SensorCOS>
   <SensorCosID>DummyCos2</SensorCosID>
   <Parameters>    
    <Pose>
     <Translation>
      <x>500.0</x>
      <y>0.0</y>
      <z>-1000.0</z>
     </Translation>
     <Rotation>
      <x>0.0</x>
      <y>0.0</y>
      <z>0.0</z>
      <w>1.0</w>
     </Rotation>
    </Pose>
   </Parameters>
  </SensorCOS>
 </Sensor>
</Sensors> 
<Connections>
 <COS>
  <Name>Cos1</Name>
  <Fuser type="BestQualityFuser">
   <Parameters></Parameters>
  </Fuser>
  <SensorSource trigger="1">
   <SensorID>DummySensor1</SensorID>
   <SensorCosID>DummyCos1</SensorCosID>
   <HandEyeCalibration>
    <TranslationOffset>
     <x>0.0</x>
     <y>0.0</y>
     <z>0.0</z>
    </TranslationOffset>
    <RotationOffset>
     <x>0.0</x>
     <y>0.0</y>
     <z>0.0</z>
     <w>1.0</w>
    </RotationOffset>
   </HandEyeCalibration>
   <COSOffset>
    <TranslationOffset>
     <x>0.0</x>
     <y>0.0</y>
     <z>0.0</z>
    </TranslationOffset>
    <RotationOffset>
     <x>0.0</x>
     <y>0.0</y>
     <z>0.0</z>
     <w>1.0</w>
    </RotationOffset>
   </COSOffset>
  </SensorSource>
 </COS>
 <COS>
  <Name>Cos2</Name>
  <Fuser type="BestQualityFuser">
   <Parameters></Parameters>
  </Fuser>
  <SensorSource trigger="1">
   <SensorID>DummySensor1</SensorID>
   <SensorCosID>DummyCos2</SensorCosID>
   <HandEyeCalibration>
    <TranslationOffset>
     <x>0.0</x>
     <y>0.0</y>
     <z>0.0</z>
    </TranslationOffset>
    <RotationOffset>
     <x>0.0</x>
     <y>0.0</y>
     <z>0.0</z>
     <w>1.0</w>
    </RotationOffset>
   </HandEyeCalibration>
   <COSOffset>
    <TranslationOffset>
     <x>0.0</x>
     <y>0.0</y>
     <z>0.0</z>
    </TranslationOffset>
    <RotationOffset>
     <x>0.0</x>
     <y>0.0</y>
     <z>0.0</z>
     <w>1.0</w>
    </RotationOffset>
   </COSOffset>
  </SensorSource>
 </COS>
</Connections>
</TrackingData>
 

Using Dummy tracking configuration files

To activate Dummy tracking within the Unifeye SDK you simply have to load an according tracking configuration file and use the API function setTrackingData() (see http://doxygen.metaio.com/UnifeyeSDK/UnifeyeSDK_doxygen/group__Configuration.html). You can also load the according tracking configuration file within the Unifeye GUI using the Tracking Configuration Tool.

→Return to Tracking Configuration

-- SupportMetaio - 2011-01-21