The controlVR XML File

The .XML file is the most important element of the VR object.

The .XML file stores all the paths of the images which need to be loaded by the controlVR component. It also determines how all the attributes are set for a specific object like direction, tempo, controlabilty, etc that is why it will be important for you to correctly create you .XML file.

The controlVR .XML file has two types of tags, namely: VR Tag and IMG Tag.

The VR Tag

Syntax : <vr>...</vr>

Description:

The VR Tag determines how the object and component behaves before and after loading.

Attribute Specifications

Attribute Value Default Description
activelayer [Number] 1 The layer that must be displayed first when object has loaded.
controlable [0|1] 1 Sets if the object is controlable(If contralability is set to 0 then you will be unable to control the object with the mouse and keyboard, but you will still be able to control the object with Action Script).
keyboard [0|1] 1 Sets if the object is controlable by the keyboard (If keyboard is set to 0 then the object is not keyboard controlable).
zoom [0|1] 1 Sets if the object is able to zoom (If zoom is set to 0 then the object is not able to zoom - it will remove the zoomability on the keyboard and mouse).
direction [CW|CCW] CW Sets if the object is spinning clockwise or counter clockwise when the object is first displayed and rotating is set to 1.
layers [Number] 1 The amount of layers in the VR object . This attribute can be left out if you only make use of one layer.
progress [0|1] 1 Sets if the loading process is displayed.
rotating [0|1] 0 Indicates whether or not the object is rotating on startup.
tempo [num] 50 Determines the milliseconds between each image interval on auto rotation. For instance if you need the image interval to be 0.5 second you would set the tempo to 500.
title [Text] Null The title of the VR object (displayed with the progress when loading and will not be displayed if left blank or when progress attribute is set to 0).

 

The IMG Tag

Syntax : <img src="url" />

Description:

The src attribute of the IMG tag determines the URL of a specific image. The URL can be a relative or absolute path. All the image tags must be defined in sequence because they are loaded from top to bottom(Sequentially meaning: From your first image to your last image for a single layer object and from your first image in the first layer to your last image in your last layer for a multiple layer object).

Attribute Specifications

Attribute Value Default Description
src Path undefined The relative or absolute path to the image from the file displaying the component

Note: If using relative paths
If the .swf file is loaded by an .html file the path of the images should be relative to the .html. If you only make use of a .swf file the path should be relative to the .swf; the path should never be relative to the .xml file.

Example 1:

The following example will load a single layered object into a VR component with 18 images making up the image sequence- 

<?xml version="1.0" encoding="iso-8859-1"?>

<vr>

  <img src="image01.jpg" />

  <img src="image02.jpg" />

  <img src="image03.jpg" />

  <img src="image04.jpg" />

  <img src="image05.jpg" />

  <img src="image06.jpg" />

  <img src="image07.jpg" />

  <img src="image08.jpg" />

  <img src="image09.jpg" />

  <img src="image10.jpg" />

  <img src="image11.jpg" />

  <img src="image12.jpg" />

  <img src="image13.jpg" />

  <img src="image14.jpg" />

  <img src="image15.jpg" />

  <img src="image16.jpg" />

  <img src="image17.jpg" />

  <img src="image18.jpg" />

</vr>

Example 2:

The following example will load a multiple layered object into a VR component consisting of 3 layers with 18 images per layer making up the image sequence-

<?xml version="1.0" encoding="iso-8859-1"?>

<vr layers="3">

  <img src="image01.jpg" />

  <img src="image02.jpg" />

  <img src="image03.jpg" />

  <img src="image04.jpg" />

  <img src="image05.jpg" />

  <img src="image06.jpg" />

  <img src="image07.jpg" />

  <img src="image08.jpg" />

  <img src="image09.jpg" />

  <img src="image10.jpg" />

  <img src="image11.jpg" />

  <img src="image12.jpg" />

  <img src="image13.jpg" />

  <img src="image14.jpg" />

  <img src="image15.jpg" />

  <img src="image16.jpg" />

  <img src="image17.jpg" />

  <img src="image18.jpg" />

  <img src="image19.jpg" />

  <img src="image20.jpg" />

  <img src="image21.jpg" />

  <img src="image22.jpg" />

  <img src="image23.jpg" />

  <img src="image24.jpg" />

  <img src="image25.jpg" />

  <img src="image26.jpg" />

  <img src="image27.jpg" />

  <img src="image28.jpg" />

  <img src="image29.jpg" />

  <img src="image30.jpg" />

  <img src="image31.jpg" />

  <img src="image32.jpg" />

  <img src="image33.jpg" />

  <img src="image34.jpg" />

  <img src="image35.jpg" />

  <img src="image36.jpg" />

  <img src="image37.jpg" />

  <img src="image38.jpg" />

  <img src="image39.jpg" />

  <img src="image40.jpg" />

  <img src="image41.jpg" />

  <img src="image42.jpg" />

  <img src="image43.jpg" />

  <img src="image44.jpg" />

  <img src="image45.jpg" />

  <img src="image46.jpg" />

  <img src="image47.jpg" />

  <img src="image48.jpg" />

  <img src="image4
9.jpg" />

  <img src="image50.jpg" />

  <img src="image51.jpg" />

  <img src="image52.jpg" />

  <img src="image53.jpg" />

  <img src="image54.jpg" />

</vr>