PKGMC - Revision history

Fre-Ber: /* Structure: Forgot the number of the new primType */

2005-12-06T23:13:23Z

‎Structure: Forgot the number of the new primType

Fre-Ber: /* Structure: Corrected the primType attribute, previously known as nVerticesPerFace */

2005-12-06T23:08:13Z

‎Structure: Corrected the primType attribute, previously known as nVerticesPerFace

Fre-Ber at 16:40, 30 August 2005

2005-08-30T16:40:14Z

New page

==Introduction==

The PKG format of Midnight Club (MC) differs slightly from the PKG format of MM2. This section proposes an explanation of the differences.

===Geometry files===
Some objects in MC use a new graphics primitive. Several separate strips can be described in the same geometry structure. This is controlled by bit eight in the flags of the PKGSection. This flag also controls the data type of several attributes of the strips, presenting a more compact way of representing the geometry.

As a part of this more compact representation, normals are not represented by vectors. Instead Euler angles are used to give the direction of the normal. The angles are given in three unsigned bytes as a value between 0 and 255, yielding a full revolution in 256 steps. (This range is not yet verified)

===Structure===
union PKGSection
{
STDPKGSection stdSection; // If flags indicate standard sections
CompactPKGSection compactSection; // If flags indicate compact sections
}

// Standard section - A single actual strip per strip, this is the only
// format used in MM2.
//
//
STDPKGSection
{
ushort nStrips; // Number of geometry strips in this section
ushort flags; // Unknown flags, bit 8 clear
long shaderOffset; // Offset into the shader list of the requested
// paintjob
PKGStrip[nStrips] strips;
}

// Compact section - Each strip can contain several separate strips and data
// types are smaller than in the standard section.
//
//
CompactPKGSection
{
ushort nStrips; // Number of geometry strips in this section
ushort flags; // Unknown flags, bit 8 set
ushort shaderOffset; // Offset into the shader list of the requested
// paintjob
PKGCompactStrip[nStrips] strips;
}

PKGCompactStrip
{
ushort verticesPerFace; // Indicates triangles or quads
ushort nVertices; // Number of vertices in this section
PKGCompactVertex[nVertices] vertices;
ushort nIndices; // Number of indices making up the geometry strip
PKGCompactIndex[nIndices] indices;
}

PKGCompactIndex
{
ushort index; // Index in vertex list, bit 14 and 15 are special:
// bit 14: Vertex order is reversed for this strip
// bit 15: Indicates the end of a strip
}

struct PKGOrientation
{
unsigned char xAngle; // Integer angle of unknown range, assumed 0-255
unsigned char yAngle; // Integer angle of unknown range, assumed 0-255
unsigned char zAngle; // Integer angle of unknown range, assumed 0-255
}

PKGCompactTex2D
{
ushort x; // Fixed point value s = (x / 128f)
ushort y; // Fixed point value t = (y / 128f)
}

PKGCompactVertex
{
Vertex3D coordinate; // If PKGFileData.flags indicate
// coordinates
PKGOrientation normal; // If PKGFileData.flags indicate normals
ulong unknown; // If PKGFileData.flags indicate unknown
PKGCompactTex2D textureCoordinate; // If PKGFileData.flags indicate texture
// coordinates
}

Midnight Club adds at least one new flag to the PKGFILEData.flags field,
the bits are defined as follows:

<ol start="0">
<li>Unknown</li>
<li>Texture coordinates or coordinates</li>
<li>Unknown</li>
<li>Unknown</li>
<li>Normal vectors</li>
<li>Unknown</li>
<li>Unknown value, 32 bits</li>
<li>Unknown</li>
<li>Coordinates or texture coordinates</li>
</ol>
All other bits are unknown at this time.

← Older revision		Revision as of 23:13, 6 December 2005
Line 96:		Line 96:
	All other bits are unknown at this time.		All other bits are unknown at this time.

−	MC also adds the new primitive type PRIMTYPE_TRIANGLESTRIP. This means that the point indices in the strips define series of connected triangles.	+	MC also adds the new primitive type PRIMTYPE_TRIANGLESTRIP (=4). This means that the point indices in the strips define series of connected triangles.

@@ Line 43: / Line 43: @@
   PKGCompactStrip
+  {
-      ushort verticesPerFace; // Indicates triangles or quads
+      ushort primType         // Indicates primitive type
       ushort nVertices;       // Number of vertices in this section
       PKGCompactVertex[nVertices] vertices;
@@ Line 53: / Line 53: @@
+  {
       ushort index;   // Index in vertex list, bit 14 and 15 are special:
-                      // bit 14: Vertex order is reversed for this strip
+                      // bit 14: Vertex order is clockwise for this strip
                       // bit 15: Indicates the end of a strip
+  }
@@ Line 95: / Line 95: @@
 </ol>
 All other bits are unknown at this time.