3D:ZAR format - Revision history

FireFly at 02:10, 4 October 2015

2015-10-04T02:10:41Z

FireFly: Categorise

2015-10-03T15:39:52Z

Categorise

FireFly: The only remaining mystery is the unknown field in the filetypes section, which is seemingly always -1 anyway.

2015-10-03T15:37:33Z

The only remaining mystery is the unknown field in the filetypes section, which is seemingly always -1 anyway.

FireFly: Whee, new stuff. Moving over from the tcrf Notes: page I edited yesterday.

2015-10-03T11:39:22Z

Whee, new stuff. Moving over from the tcrf Notes: page I edited yesterday.

New page

{{stub|reason=Document the data section}}

The '''ZAR file format''' is an archive format used in OoT 3D.

All offsets below are global (i.e. relative to start of archive).

== Structure ==
This section documents the structure of the file format.

=== Header ===
{| class="wikitable" border="1"
! Offset !! Type !! Description
|-
| 0000 || char[4] || Magic ("ZAR\x01")
|-
| 0004 || u32 || Size of archive
|-
| 0008 || u16 || #types
|-
| 000A || u16 || #files
|-
| 000C || u32 || Offset to filetypes section
|-
| 0010 || u32 || Offset to filenames section
|-
| 0014 || u32 || Offset to data section
|-
| 0018 || char[8] || "queen"
|}

=== Filetypes section ===
Consists of a number of filetype entries. Each filetype is associated with a number of compressed files. Contains a table of 16-byte entries as detailed below, one entry for each of the [#types] filetypes (see main header).

{| class="wikitable" border="1"
! Offset !! Type !! Description
|-
| 0000 || u32 || #files
|-
| 0004 || u32 || Offset to files list
|-
| 0008 || u32 || Offset to type name
|-
| 000C || u32 || Unknown (always -1?)
|}

At [offset to files list] is a list of [#files] u32's, each corresponding to a file index (0 refers to the first file, etc). These lists and the type names are stored immediately afterwards within the section.

The number of filetypes vary between 2 and 8 in known files, and "unknown" is always the first type (even if it contains no files). Known filetype names are "anb", "ccb", "cmab", "cmb", "csab", "ctxb", "faceb", "qdb", "tbd", "unknown", "zsi".

=== Filenames section ===
Consists of one entry for each compressed file ([#files] in the main header).

{| class="wikitable" border="1"
! Offset !! Type !! Description
|-
| 0000 || u32 || Unknown
|-
| 0004 || u32 || Offset to filename
|}

The filenames are stored immediately afterwards within the section.

=== Data section ===
Contains the actual compressed data.

← Older revision		Revision as of 15:39, 3 October 2015
Line 63:		Line 63:

	The offsets are immediately followed by the actual data, within the section.		The offsets are immediately followed by the actual data, within the section.
		+
		+	[[Category:File Formats]]

@@ Line 1: / Line 1: @@
-The '''ZAR file format''' is an archive format used in OoT 3D.
+The '''ZAR format''' ('''Zelda Archive''') is an archive format used in OoT 3D.
 == Structure ==
@@ Line 10: / Line 8: @@
 ! Offset !! Type !! Description
 |-
-| 0000 || char[4] || Magic ("ZAR\x01")
+| 0000 || char[4] || Magic ("ZAR\1")
 |-
 | 0004 || u32 || Size of archive

@@ Line 1: / Line 1: @@
 The '''ZAR file format''' is an archive format used in OoT 3D.
@@ Line 22: / Line 20: @@
 | 000C || u32 || Offset to filetypes section
 |-
-| 0010 || u32 || Offset to filenames section
+| 0010 || u32 || Offset to file-metadata section
 |-
 | 0014 || u32 || Offset to data section
@@ Line 46: / Line 44: @@
 At [offset to files list] is a list of [#files] u32's, each corresponding to a file index (0 refers to the first file, etc).  These lists and the type names are stored immediately afterwards within the section.
-The number of filetypes vary between 2 and 8 in known files, and "unknown" is always the first type (even if it contains no files).  Known filetype names are "anb", "ccb", "cmab", "cmb", "csab", "ctxb", "faceb", "qdb", "tbd", "unknown", "zsi".
+The number of filetypes vary between 2 and 8 in known files, and "unknown" is always the first type (even if it contains no files).  Known filetype names are "anb", "ccb", "cmab", "cmb", "csab", "ctxb", "faceb", "qdb", "tbd", "unknown", "zsi".  The only archive containing an "unknown" file is ''actor/zelda_magic_wind.zar'', which contains ''Anim/new_magic_wind.cskla''.
-=== Filenames section ===
+=== File metadata section ===
-Consists of one entry for each compressed file ([#files] in the main header).
+Consists of one entry for each file in the archive ([#files] in the main header).
 {| class="wikitable" border="1"
 ! Offset !! Type !! Description
 |-
-| 0000 || u32 || Unknown
+| 0000 || u32 || File size
 |-
 | 0004 || u32 || Offset to filename
@@ Line 62: / Line 60: @@
 === Data section ===
-Contains the actual compressed data.
+Consists of one u32 for each file in the archive, representing the offset to the file's data.  The length of the file's data is taken from the metadata section above.