Precompiled Mesh File

by JeGX

Pourquoi le PMF

Le Precompiled Mesh File (PMF) permet de stocker la description complete d'un mesh polygonal. A la différence, par exemple, du format ASC de 3DS, le PMF contient la liste de toutes les normales à chaque face et à chaque vertex. Les nombres de faces et de vertices sont stockés sur 32 bits non signés ce qui signifie que l'on peut stocker des meshes bien chargés en polygones (le format 3ds, le nombre de faces et de vertices est codé sur 16 bits (why????)). Autre intérêt : le loading d'un mesh volumineux (par exemple 100000 faces) et son affichage en smooth est très rapide puisqu'il n'y a plus toute la phase de précalcul des normales. La toute dernière version (v3) du format PMF contient les bounding box et sphere pour le mesh 3D.

Structure d'un PMF

Structure globale du fichier - PMF toutes versions

Header

Vertices List

Faces List

Le header

Structure du header - PMF Version 1 et 2
Champ	Taille	Description
magicCode	1*unsigned long	Identification du pmf. Contient la chaîne "_PMF"
version	1*unsigned long	Version du PMF : 1, 2 ou 3
numVertices	1*unsigned long	Nombres de sommets 3D.
numFaces	1*unsigned long	Nombres de faces triangulaires.

Structure du header - PMF Version 3
Champ	Taille	Description
magicCode	1*unsigned long	Identification du pmf. Contient la chaîne "_PMF"
version	1*unsigned long	Version du PMF : 1, 2 ou 3
numVertices	1*unsigned long	Nombres de sommets 3D.
numFaces	1*unsigned long	Nombres de faces triangulaires.
AABB	9*float	Axis Aligned Bounding Box.
BS	4*float	Bounding Sphere.

Structure Axis Aligned Bounding Box - PMF version 3
Champ	Taille	Description
min_x	float	Composante x du coin inférieur.
min_y	float	Composante y du coin inférieur.
min_z	float	Composante z du coin inférieur.
max_x	float	Composante x du coin supérieur.
max_y	float	Composante y du coin supérieur.
max_z	float	Composante z du coin supérieur.
center_x	float	Composante x du centre de la BB.
center_y	float	Composante y du centre de la BB.
center_z	float	Composante z du centre de la BB.

Structure Bounding Sphere - PMF version 3
Champ	Taille	Description
radius	float	Rayon de la BS.
center_x	float	Composante x du centre de la BS.
center_y	float	Composante y du centre de la BS.
center_z	float	Composante z du centre de la BS.

Structure d'un vertex

La liste des vertices est stockée à la suite du header. Les vertices se suivent de façon contigüe.

Structure d'un vertex - PMF version 1
Champ	Taille	Description
x	float	Composante x
y	float	Composante y
z	float	Composante z
nx	float	Composante x de la normale
ny	float	Composante y de la normale
nz	float	Composante z de la normale
u	float	Coordonnée de texture u
v	float	Coordonnée de texture v

Structure d'un vertex - PMF version 2 et 3
Champ	Taille	Description
x	float	Composante x
y	float	Composante y
z	float	Composante z
nx	float	Composante x de la normale
ny	float	Composante y de la normale
nz	float	Composante z de la normale
r	float	Composante rouge de la couleur
g	float	Composante verte de la couleur
b	float	Composante bleue de la couleur
u	float	Coordonnée de texture u
v	float	Coordonnée de texture v

Structure d'une face

La liste des faces est stockée à la suite de celle des vertices. Les faces se suivent de façon contigüe.

Structure d'une face - PMF toutes versions
Champ	Taille	Description
a	unsigned long	Index sommet 0 de la face dans la liste des vertices.
b	unsigned long	Index sommet 1 de la face dans la liste des vertices.
c	unsigned long	Index sommet 2 de la face dans la liste des vertices.
nx	float	Composante x de la normale
ny	float	Composante y de la normale
nz	float	Composante z de la normale