XML-Format for DiMAS
====================


DTD for DiMAS:
<!-- This is a DTD for DiMAS Data -->
<!ELEMENT World (Comment?, Elements?)>
<!ATTLIST World creator CDATA #REQUIRED name CDATA #IMPLIED>
  <!ELEMENT Comment (#PCDATA)>
  <!ELEMENT Elements (Ambient_Light | Directional_Light | Point_Light | Cylinder | Box | Sphere | Group)*>
    <!ELEMENT Ambient_Light (Color_RGB)>
    <!ATTLIST Ambient_Light state (on|off) "on">
    <!ELEMENT Directional_Light (Color_RGB, Vector3D)>
    <!ATTLIST Directional_Light state (on|off) "on">
    <!ELEMENT Point_Light (Color_RGB, Point3D, Attenuation?)>
    <!ATTLIST Point_Light state (on|off) "on">
      <!ELEMENT Attenuation EMPTY>
      <!ATTLIST Attenuation constant CDATA #REQUIRED linear CDATA #REQUIRED quadratic CDATA #REQUIRED>
    <!ELEMENT Cylinder (Transformation3D?, Appearance?)>
    <!ATTLIST Cylinder name CDATA #IMPLIED radius CDATA #REQUIRED height CDATA #REQUIRED>
    <!ELEMENT Box (Transformation3D?, Appearance?)>
    <!ATTLIST Box name CDATA #IMPLIED width CDATA #REQUIRED depth CDATA #REQUIRED height CDATA #REQUIRED>
    <!ELEMENT Sphere (Transformation3D?, Appearance?)>
    <!ATTLIST Sphere name CDATA #IMPLIED radius CDATA #REQUIRED>
    <!ELEMENT Group (Transformation3D?, Elements)>

<!-- common definitions for Elements with geometric aspects (e.g. Cylinder, Box, Sphere, ...) -->
<!ELEMENT Transformation3D (Rotation3D?, Vector3D?, Scale3D?)>
  <!ELEMENT Rotation3D EMPTY>
  <!ATTLIST Rotation3D a11 CDATA #REQUIRED a12 CDATA #REQUIRED a13 CDATA #REQUIRED
                       a21 CDATA #REQUIRED a22 CDATA #REQUIRED a23 CDATA #REQUIRED
                       a31 CDATA #REQUIRED a32 CDATA #REQUIRED a33 CDATA #REQUIRED>
  <!ELEMENT Scale3D EMPTY>
  <!ATTLIST Scale3D CDATA #REQUIRED y CDATA #REQUIRED z CDATA #REQUIRED>
<!ELEMENT Appearance ((Color, Material) | Color)>
  <!ELEMENT Color (Color_RGB)>
  <!ELEMENT Material (Ambient_Color, Emissive_Color, Diffuse_Color, Specular_Color)>
    <!ELEMENT Ambient_Color (Color_RGB)>
    <!ELEMENT Emissive_Color (Color_RGB)>
    <!ELEMENT Diffuse_Color (Color_RGB)>
    <!ELEMENT Specular_Color (Color_RGB)>

<!-- common definitions (used in different elements) -->
<!ELEMENT Color_RGB EMPTY>
<!ATTLIST Color_RGN red CDATA #REQUIRED green CDATA #REQUIRED blue CDATA #REQUIRED>
<!ELEMENT Vector3D EMPTY>
<!ATTLIST Vector3D x CDATA #REQUIRED y CDATA #REQUIRED z CDATA #REQUIRED>
<!ELEMENT Point3D EMPTY>
<!ATTLIST Point3D x CDATA #REQUIRED y CDATA #REQUIRED z CDATA #REQUIRED>


Example XML-File:
<?xml version="1.0"?>
<World creator="DiMAS V1.0" name="The Huge Labyrinth">
	<Comment>
		This world is meant to simulate a robot searching his way through a labyrinth.
		...
	</Comment>
	<Elements>
		<Ambient_Light state="on">
			<Color_RGB r="0.6" g="0.4" b="0.5"/>
		</Ambient_Light>
		<Directional_Light state="on">
			<Color_RGB r="0.5" g="0.5" b="0.5"/>
			<Vector3D x="-1.0" y="1.0" z="-1.0"/>
		</Directional_Light>
		<Point_Light state="off">
			<Color_RGB r="0.5" g="0.5" b="0.5"/>
			<Point3D x="-1.0" y="1.0" z="-1.0"/>
			<Attenuation constant="-1.0" linear="1.0" quadratic="-1.0"/>
		</Point_Light>
		<Cylinder name="Flippy" radius="10.0" height="15.0">
			<Transformation3D>
				<Rotation3D
				  a11="1.0"  a12="-1.0" a13="0.0"
				  a21="-1.0" a22="1.0"  a23="0.0"
				  a31="0.0"  a32="0.0"  a33="1.0" 
				/>
				<Vector3D x="10.0" y="15.0" z="21.5"/>
			</Transformation3D>
			<Appearance>
				<Color> <Color_RGB r="1.0" g="0.0" b="0.0"/> </Color>
				<Material lighting="enabled" shininess="64">
					<Ambient_Color>  <Color_RGB r="1.0" g="0.0" b="0.0"/> </Ambient_Color>
					<Emissive_Color> <Color_RGB r="1.0" g="0.0" b="0.0"/> </Emissive_Color>
					<Diffuse_Color>  <Color_RGB r="1.0" g="0.0" b="0.0"/> </Diffuse_Color>
					<Specular_Color> <Color_RGB r="1.0" g="0.0" b="0.0"/> </Specular_Color>
				</Material>
			</Appearance>
		</Cylinder>
		<Box name="Wall" width="25.0" depth="0.02" height="7.0">
			<Transformation3D>
				<Vector3D x="10.0" y="15.0" z="21.5"/>
				<Scale3D x="1.0" y="1.0" z="1.0"/>
			</Transformation3D>
			<Appearance face="left">
				<Color> <Color_RGB r="0.1" g="0.1" b="0.1"/> </Color>
			</Appearance>
		</Box>
		<Sphere name="Football" radius="3.5">
		</Sphere>
		<Group name="Field">
			<Transformation3D>
				...
			</Transformation3D>
			<Elements>
				...
			</Elements>
		</Group>
	</Elements>
</World>