<HTML>
	<HEAD>
		<TITLE>Reference manual for David Piuva's graphics engine</TITLE>
		<STYLE TYPE="text/css">
		<!--
		.indented
		   {
		   padding-left: 30pt;
		   padding-right: 30pt;
		   }
		-->
		</STYLE>
	</HEAD>
	<BODY>
		<link rel="stylesheet" type="text/css" href="PageStyle.css">
		<A href="../Manual.html">Back to main page</A>
<P>	<b>David's Model Format *.dmf</b>
<P>	ANSI encoding is used because it is simple, fast and compact enough to remove the need of a binary model format. ANSI is an encoding with only one byte per character and no byte order mark. Trying to load a model using another encoding is not allowed by the engine.
<P>	Open model files in notepad to see examples of the syntax. It is recomended to associate the file format with a text editor since it is a very stable way to edit low detailed models.
<P>	Properties that have default values are usually not stored to save memory and improve both forward and backward version compability. If you for example only have white vertex color, it will to take any space in the file.
<P>	Bones:
		<DIV CLASS="indented">
<P>		ParentIndex is the index of the parent bone.
<P>			Not defining a parent will make it defined directly in object space.
<P>		Object space position is the default position.
<P>		Parent space position is relative to the end node of the parent bone.
<P>		Z axis is pointing from the start node to the end node.
<P>		Y axis is used to rotate the bone and generate the X axis that is not saved.
<P>		The user data in the bones is used to store anything you need per bone.
<P>		The axis system combined should make a normalized orthogonal 3x3 matrix
<P>		Length is the distance between the start node and the end node.
		</DIV>
<P>	<IMG SRC="Images/Border.png">
<P>	<b>Syntax definition:</b>
		<DIV CLASS="indented">
<P>		<FONT COLOR="#00BB00">// Version independent</FONT>
			<DIV CLASS="indented">
<P>			Start → "DMF1" ¤ ModelPropertyList ¤ ContentList ¤
<P>			PartContent → PartPropertyList TriangleList
<P>			PartPropertyList → PartProperty*
<P>			TriangleList → (¤ "&lt;Triangle&gt;" ¤ TriangleContent)*
<P>			TriangleContent → VertexPropertyList
<P>			VertexPropertyList → VertexProperty*
<P>			VertexProperty → ¤ VertexPropertyName ¤ "[" TriangleIndex "]" ¤ "(" Float ")" ¤
<P>			TriangleIndex → "0" | "1" | "2"
<P>			PointProperty → ¤ PointPropertyName ¤ "(" Float ")" ¤
<P>			PointPropertyName → "X" | "Y" | "Z" | "DX" | "DY" | "DZ"
<P>			ModelPropertyList → ModelProperty*
<P>			</DIV>
<P>		<FONT COLOR="#00BB00">// Version depending</FONT>
			<DIV CLASS="indented">
<P>			ContentList → "" | ¤ "&lt;Part&gt;" ¤ PartContent ContentList | ¤ "&lt;Bone&gt;" ¤ BoneProperty* ContentList | ¤ "&lt;Shape&gt;" ¤ ShapeProperty* ContentList | ...
<P>			FilterTypeName → "None" | "Alpha" | ...
<P>			CullingTypeName → "None" | "AABB" | "Radius" | ...
<P>			ModelProperty → ¤ "FilterType" ¤ "(" FilterTypeName ")" ¤ | ¤ "CullingType" ¤ "(" CullingTypeName ")" ¤ | ¤ "BoundMultiplier" ¤ "(" Float ")" ¤ | ...
<P>			PartProperty → ¤ "Name" ¤ "(" SimpleString  ")" ¤ | ¤ "Texture" ¤ "["  TextureChannel "]" ¤ "(" FileName  ")" ¤ | ¤ "TextureOverride" ¤ "[" TextureChannel "]" ¤ "(" TextureOverrideChannel ")" ¤ | ¤ "Shader" ¤ "[" ShaderChannel "]" ¤ "(" FileName ")" ¤ | ¤ "MinDetailLevel" ¤ "(" DetailLevel ")" ¤ | ¤ "MaxDetailLevel" ¤ "(" DetailLevel ")" ¤ | ...
<P>			BoneProperty → ¤ "Name" ¤ "(" SimpleString  ")" ¤ | ¤ BoneFloatPropertyName ¤ "(" Float ")" ¤ | ...
<P>			ShapeProperty → ¤ "Name" ¤ "(" SimpleString  ")" ¤ | ¤ ShapeFloatPropertyName ¤ "(" Float ")" ¤ | ¤ ShapeIntPropertyName ¤ "(" Integer ")" ¤ | ¤ "&lt;Point&gt;" ¤ PointProperty* ¤ | ...
<P>			VertexPropertyName → "X" | "Y" | "Z" | "NX" | "NY" | "NZ" | "U1" | "V1" | "U2" | "V2" | "CR" | "CG" | "CB" | "CA" | "AX" | "AY" | "AZ" | "AW" | "BX" | "BY" | "BZ" | "BW" | "BDX" | "BDY" | "BDZ" | "BDW" | ...
<P>			BoneFloatPropertyName → "ObjectSpaceX" | "ObjectSpaceY" | "ObjectSpaceZ" | "ParentSpaceX" | "ParentSpaceY" | "ParentSpaceZ" | "YAxisX" | "YAxisY" | "YAxisZ" | "ZAxisX" | "ZAxisY" | "ZAxisZ" | "Length" | "UserDataX" | "UserDataY" | "UserDataZ" | ...
<P>			BoneIntPropertyName → "ParentIndex" | ...
<P>			ShapeFloatPropertyName → "Radius" | "HalfWidth" | "HalfHeight" | "HalfDepth" | "PosX" | "PosY" | "PosZ" | "XAxisX" | "XAxisY" | "XAxisZ" | "YAxisX" | "YAxisY" | "YAxisZ" | "ZAxisX" | "ZAxisY" | "ZAxisZ" | ...
<P>			ShapeIntPropertyName → "ShapeType" | "CollisionType" | ...
<P>			TextureChannel → 0..15
<P>			ShaderChannel → 0..15
<P>			TextureOverrideChannel → -1..15
<P>			DetailLevel → 0..2
<P>			</DIV>
<P>		<FONT COLOR="#00BB00">// Datatypes</FONT>
			<DIV CLASS="indented">
<P>			Float → UFloat | -UFloat
<P>			UFloat → Integer | Integer "." Integer | Integer "," Integer
<P>			Integer → UInteger | -UInteger
<P>			UInteger → digit | digit UInteger
<P>			digit → 0..9
<P>			SimpleCharacter → Not any of these forbidden characters that could cause ambiguity < > ( ) [ ] { } * ? " |
<P>			SimpleString → SimpleCharacter*
<P>			FileName → SimpleString
<P>			</DIV>
<P>		<FONT COLOR="#00BB00">// Indentation</FONT>
			<DIV CLASS="indented">
<P>			Redundancy → " " | indent | linebreak
<P>			¤ → Redundancy*
			</DIV>
<P>		</DIV>
<P>	<IMG SRC="Images/Border.png">
<P>	<b>Explanation of vertex property names:</b>
		<DIV CLASS="indented">
<P>		X means position.x
<P>		Y means position.y
<P>		Z means position.z
<P>		NX means normal.x
<P>		NY means normal.y
<P>		NZ means normal.z
<P>		CR means color.red
<P>		CG means color.green
<P>		CB means color.blue
<P>		CA means color.alpha
<P>		U1 means texture coordinate U1
<P>		V1 means texture coordinate V1
<P>		U2 means texture coordinate U2
<P>		V2 means texture coordinate V2
<P>		AX means userdefined vector A.x
<P>		AY means userdefined vector A.y
<P>		AZ means userdefined vector A.z
<P>		AW means userdefined vector A.w
<P>		BX means userdefined vector B.x
<P>		BY means userdefined vector B.y
<P>		BZ means userdefined vector B.z
<P>		BW means userdefined vector B.w
<P>		BDX means bone space X
<P>		BDY means bone space Y
<P>		BDZ means bone space Z
<P>		BDW means bone index
		</DIV>
<P>	<IMG SRC="Images/Border.png">
	</BODY>
</HTML>