PZZ (Gotcha Force) - Revision history

Algoflash: /* Software */

2023-10-07T12:48:57Z

Software

← Older revision		Revision as of 14:48, 7 October 2023
Line 99:		Line 99:
	== Software ==		== Software ==

	Virtual World RE ~~provide~~ the python script [https://github.com/Virtual-World-RE/NeoGF/tree/main/pzztool pzztool.py] handling PZZ files unpack / uncompress / compress / pack inspired from [https://github.com/infval/pzzcompressor_jojo a PS2 pzz file handling algorithm].		Virtual World RE provides the python script [https://github.com/Virtual-World-RE/NeoGF/tree/main/pzztool pzztool.py] handling PZZ files unpack / uncompress / compress / pack inspired from [https://github.com/infval/pzzcompressor_jojo a PS2 pzz file handling algorithm].

	[[Category:File format]]		[[Category:File format]]
	[[Category:Gotcha Force]]		[[Category:Gotcha Force]]

2023-10-07T12:47:22Z

Files padding

← Older revision		Revision as of 14:47, 7 October 2023
Line 46:		Line 46:
	==== Files padding ====		==== Files padding ====

	<span style="color: rgb(241, 196, 15);">When a pzz packed file is stored uncompressed then we find a padding added to ~~it's~~ end because of the 0x800 align. In this case it's impossible to know the padding length and how to remove it exactly since the file could ~~contains~~ ending Null bytes.</span>		<span style="color: rgb(241, 196, 15);">When a pzz packed file is stored uncompressed then we find a padding added to its end because of the 0x800 align. In this case it's impossible to know the padding length and how to remove it exactly since the file could contain ending Null bytes.</span>

	=== Compression algorithm ===		=== Compression algorithm ===

2023-10-07T12:46:41Z

File descriptors format

← Older revision		Revision as of 14:46, 7 October 2023
Line 42:		Line 42:
	The first file to be packed has a length of 12kb (12 000 bytes) and is packed compressed. So it's file descriptor is equal to:		The first file to be packed has a length of 12kb (12 000 bytes) and is packed compressed. So it's file descriptor is equal to:
	* upper_round(12000/0x800)+0x40000000 = 0x40000006		* upper_round(12000/0x800)+0x40000000 = 0x40000006
	So the '''40 00 00 06''' is stored just after the header file count field. A file descriptor ~~describe~~ sometimes an empty file, in this case the file_descriptor is equal to "00 00 00 00" and will be counted in the header file count field.		So the '''40 00 00 06''' is stored just after the header file count field. A file descriptor describes sometimes an empty file, in this case the file_descriptor is equal to "00 00 00 00" and will be counted in the header file count field.

	==== Files padding ====		==== Files padding ====

2023-10-07T12:45:35Z

File descriptors format

← Older revision		Revision as of 14:45, 7 October 2023
Line 29:		Line 29:
	* Bit 0 to 29 (30 bits) - File length divided by 0x800 bytes (2048).		* Bit 0 to 29 (30 bits) - File length divided by 0x800 bytes (2048).

	So max length of a pzz packed file is (2^30) * 2048: more than 2 Tb (2 199 023 255 552 octets). In others words there is no file length restriction.		So the max length of a pzz packed file is (2^30) * 2048: more than 2 Tb (2 199 023 255 552 octets). In others words there is no file length restriction.

	File length (in bytes) is computed as following:		File length (in bytes) is computed as following:

2023-10-07T12:45:03Z

Header

← Older revision		Revision as of 14:45, 7 October 2023
Line 20:		Line 20:
	* 4 bytes[file_count] - uint - [[#File descriptors\|file_descriptors]] describing files length and compression.		* 4 bytes[file_count] - uint - [[#File descriptors\|file_descriptors]] describing files length and compression.

	Note: Header length is 0x800 bytes (2048) and each file_descriptor takes 4 bytes, this allows max 2048/4-1 max total file_discriptors so the PZZ cannot contain more than 511 files. All pzz from Gotcha Force ~~contains~~ less than 20 files.		Note: Header length is 0x800 bytes (2048) and each file_descriptor takes 4 bytes, this allows max 2048/4-1 max total file_discriptors so the PZZ cannot contain more than 511 files. All pzz from Gotcha Force contain less than 20 files.

	==== File descriptors format ====		==== File descriptors format ====

2023-10-07T12:44:08Z

Header

← Older revision		Revision as of 14:44, 7 October 2023
Line 20:		Line 20:
	* 4 bytes[file_count] - uint - [[#File descriptors\|file_descriptors]] describing files length and compression.		* 4 bytes[file_count] - uint - [[#File descriptors\|file_descriptors]] describing files length and compression.

	Note: Header length is 0x800 bytes (2048) and each file_descriptor takes 4 bytes, this ~~allow~~ max 2048/4-1 max total file_discriptors so the PZZ cannot ~~contains~~ more than 511 files. All pzz from Gotcha Force contains less than 20 files.		Note: Header length is 0x800 bytes (2048) and each file_descriptor takes 4 bytes, this allows max 2048/4-1 max total file_discriptors so the PZZ cannot contain more than 511 files. All pzz from Gotcha Force contains less than 20 files.

	==== File descriptors format ====		==== File descriptors format ====

2023-10-07T10:17:23Z

← Older revision		Revision as of 12:17, 7 October 2023
Line 1:		Line 1:
	[[Gotcha Force \| ← Gotcha Force]]		[[Gotcha Force \| ← Gotcha Force]]

	''This article is about Gotcha Force PZZ file format and ongoing ~~researchs~~ on it.''		''This article is about Gotcha Force PZZ file format and ongoing researches on it.''

	{{Research \| 1\| The structure of this file is well known. }}		{{Research \| 1\| The structure of this file is well known. }}

2023-10-07T10:12:04Z

← Older revision		Revision as of 12:12, 7 October 2023
Line 2:		Line 2:

	''This article is about Gotcha Force PZZ file format and ongoing researchs on it.''		''This article is about Gotcha Force PZZ file format and ongoing researchs on it.''

			{{Research \| 1\| The structure of this file is well known. }}

	'''PZZ''' files are archive packing files with a compression algorithm available.		'''PZZ''' files are archive packing files with a compression algorithm available.

2022-09-07T10:12:24Z

Fichiers et compression

← Older revision		Revision as of 12:12, 7 September 2022
Line 50:		Line 50:

	=== Observations ===		=== Observations ===
	==== ~~Fichiers et~~ compression ====		==== Files and compression ====
	All stxx.pzz -> 000 packed files are stored uncompressed same as firstld.pzz -> 000, 001, 002 and 005 files. Others pzz files are all stored compressed. (NTSC/USA version)		All stxx.pzz -> 000 packed files are stored uncompressed same as firstld.pzz -> 000, 001, 002 and 005 files. Others pzz files are all stored compressed. (NTSC/USA version)


	==== stxx.pzz files (40) ====		==== stxx.pzz files (40) ====

2022-09-07T10:11:38Z

File descriptors format

← Older revision		Revision as of 12:11, 7 September 2022
Line 40:		Line 40:
	The first file to be packed has a length of 12kb (12 000 bytes) and is packed compressed. So it's file descriptor is equal to:		The first file to be packed has a length of 12kb (12 000 bytes) and is packed compressed. So it's file descriptor is equal to:
	* upper_round(12000/0x800)+0x40000000 = 0x40000006		* upper_round(12000/0x800)+0x40000000 = 0x40000006
	So the ``40 00 00 06`` is stored just after the header file count field. A file descriptor describe sometimes an empty file, in this case the file_descriptor is equal to "00 00 00 00" and will be counted in the header file count field.		So the '''40 00 00 06''' is stored just after the header file count field. A file descriptor describe sometimes an empty file, in this case the file_descriptor is equal to "00 00 00 00" and will be counted in the header file count field.

	==== Files padding ====		==== Files padding ====