ApplicationConfiguration

You can customize the published ShockwaveARFrame / FlashARFrame application without the need of programming. This includes the modification of 3D models, sound and video textures. The customization is done via a configuration file which is called ApplicationConfiguration.scef. The file is a human readable XML file and is placed in the same folder as the ShockwaveARFrame movie for Shockwave and in the "bin-debug" subfolder for Flash. The skeleton and usage of the Application Configuration file is explained below.

Basic tag:

<?xml version="1.0" encoding="UTF-16"?>
<Scene>
   <SceneParams> … </SceneParams >
   <ApplicationConfiguration> … </ApplicationConfiguration>
   <VideoTextures> … </VideoTextures>
   <Geometry> … </ Geometry >
   <Geometry> … </ Geometry >
   <Geometry> … </ Geometry >
   …
</Scene>

Additional note:

• The tags “SceneParams”, “ApplicationConfiguration” and “VideoTextures” only appear once in the file. The tag “Geometry” is defined for each geometry.

“SceneParams” tag:

<SceneParams>
<markerDataPath>tracking/TrackingData.xml</markerDataPath>
   <Filesize>1200000</Filesize>
   <mirrorMode>0</mirrorMode>
   <renderAntialiasing>0</renderAntialiasing>
</SceneParams >

Additional note:

• All those tags appear only once in the configuration file.

“ApplicationConfiguration” & “geometry” tag:

An exemplary geometry to COS binding is shown below. A geometry named “UnifeyeViewerLogo” is bound to the coordinate system with the cosID 1.

<ApplicationConfiguration>
   <!-- Binding a geometry to a Cos -->
   <Cos>
      <cosID>1</cosID>
      <contentLength type="ms">1000</contentLength>
      <useHeadlight>0</useHeadlight>
      <trackingTolerance>1500</trackingTolerance>
      <geometry>
         <name>UnifeyeViewerLogo</name>   
         <contentLength type="frames" fps="30">50</contentLength> 
         <animationType>InOut</animationType>
      </geometry>
      <!-- another geometry definition
         <geometry>...</geometry>
      -->
   </Cos>
</ApplicationConfiguration>

<!-- Definition of a geometry -->
<Geometry>
   <title>UnifeyeViewerLogo</title>
   <type>normal</type>
   <vrmlPath>http://sw.ar-live.de/models/UnifeyeViewerLogo.W3D</vrmlPath> 
   <cosID>1</cosID>
   <Rotation>
      <x>0</x>
      <y>0</y>
      <z>1</z>
      <angle>0</angle>
   </Rotation>
   <Translation>
      <x>0</x>
      <y>0</y>
      <z>0</z>
   </Translation>
   <Scale>
      <x>1.3</x>
      <y>1.3</y>
      <z>1.3</z>
   </Scale>
</Geometry>

ApplicationConfiguration tags:

Geometry tags:

Additional notes:

• You can define multiple “Geometry” tags.
• You can bind multiple geometries to each coordinate system.

“ApplicationConfiguration” & “audio” tag:

The example below shows how to assign an audio file to a coordinate system. The audio file is played back when the coordinate system is being tracked.

<ApplicationConfiguration>
   <Cos>
      ... cosID, geometry etc. here ...
      <audio>
         <name>myAudio</name>
         <looping>0</looping>
      </audio>   
   </Cos>
   <Audio>
      <name>myAudio</name>
      <path>http://sw.ar-live.de/sounds/summer.mp3</path>
   </Audio>
</ApplicationConfiguration>

ApplicationConfiguration tag descriptions:

Additional notes:

• You can define multiple “Audio” files
• You can reference only one audio file per coordinate system.

“ApplicationConfiguration” & “VideoTextures” tag:

The example below shows how to bind a video texture to a model. A video texture or movie texture is a video that is placed on a part of a geometry.

<ApplicationConfiguration>
      <Cos>
         ... Cos properties …
         <geometry>
            … geometry properties …

            <videoTexture>
               <name>MyMovieTexture</name>
               <animationType>Normal</animationType>
            </videoTexture>
         </geometry>      
      </Cos>
<ApplicationConfiguration>   
      
<VideoTextures>
   <videoTexture>
      <name>MyMovieTexture</name>
      <path>http://www.myserver.de/myMovie.flv</path>
   </videoTexture>
   … another video texture definition here …
</VideoTextures>

Application Configuration Tags:

VideoTextures Tags:

Additional notes:

• You can define multiple “Video Textures”
• You can assign only one video texture per geometry

-- SupportMetaio - 2010-08-13