Cet article est pour les format de fichiers PZZ de Gotcha Force. Voir PZZ (Format de fichier) pour les autres versions de ce fichier.
Les fichiers PZZ sont des dossiers d'archive.
Cette section est en cours de rédaction.
Des recherches sont encore nécessaires et certains paragraphes peuvent être faux.
Format
Les PZZ se composent d'un header de 2048 octets, soit 0x800 octets. A la suite de ce header se trouvent les fichiers inscrit les uns à la suite des autres. Ces fichiers peuvent être compressés ou non.
Header
Le premier champ du header est un uint32 big endian contenant le nombre de fichiers total de l'archive. On retrouve après une suite de taille variable de descripteurs de fichiers au format uint32 big endian. Chaque fichier est paddé avec des "\x00" pour avoir une taille multiple de 0x800.
Format descripteur de fichier
Si on numérote les bits d'un descripteur de fichier de 0 (poids faible) à 31 (poids fort) :
- bit 31 - inutilisé,
- bit 30 - Flag de compression : est à 1 si le fichier est compressé, 0 sinon,
- bit 0 à 29 (30 bits) - taille du fichier divisée par 2048 (0x800),
taille_fichier (octets) = (descripteur_fichier & 0x3FFFFFFF) * 0x800
bCompression = descripteur_fichier & 0x40000000
Pour mieux comprendre le format du descripteur de fichier, voici un exemple :
Le premier fichier de l'archive fait 12288 octets et il est compressé, son descripteur est alors (12288/0x800)+0x40000000 = 0x40000006. On le stockera dans l'entête en big endian (40 00 00 06) juste à la suite du nombre de fichiers.
Le descripteur de fichier peut décrire un fichier vide. Il correspondra alors à "00 00 00 00" mais sera compté dans le nombre de fichier au début du header.
Padding des fichiers
Lors ce que le fichier à extraire du pzz n'est pas compressé, on a alors un padding présent à sa fin. Il devient alors impossible de déterminer quel padding enlever précisément. En effet, le fichier peut se terminer par des "00".
Algorithme de compression
L'algorithme de compression reste à déterminer.
Observations
Fichiers plxxxx.pzz
On sait désormais que les PZZ avec le nom plxxxx.pzz correspondent chacun à un borg. Ils contiennent des fichiers spécialisés à chacune des positions dans le pzz. Il arrive que le fichier à une position donnée soit présent dans certains pzz et absent dans d'autres. Ils contiennent 4 fichiers TPL en position 10, 11, 12, et 13 (numérotation commençant à 0) affichant le nom des borgs dans différentes langues (version PAL), ou encore le nom des borgs en japonais (version JAP) ou en anglais et japonais (version NTSC). Dans les fichiers contenus dans les PZZ allant généralement de la position 4 à 8, on retrouve des fichiers avec des valeurs correspondantes à de la 3D. On peut notamment citer "pl0300.pzz" qui possède des fichiers avec un header, des flags ainsi qu'un padding ajustable si besoin est d'avoir plus d’éléments Par exemple pour pl0629.pzz la quantité de flags dans le headers est plus conséquente. L'origine des flags et des valeurs dans le header est pour l'instant inconnu mais ces champs du header pourraient constituer une liste de mesh disponibles dans le fichier.
Dans le header des PZZ, on retrouve parfois des file_descriptor=NULL. On peut notamment citer "pl0f07.pzz" qui a un header se terminant par plusieurs descripteurs de fichiers NULL. Ce fichier correspond en fait à un borg non implémenté (absence des 4 TPLs finaux).
Logiciel
Virtual World RE a développé le script python pzztool.py permettant de manipuler les archives PZZ et leurs fichiers internes, en s'inspirant d'un script de manipulation pzz de PS2.