Wexos: Escaped \t

2024-05-01T21:32:33Z

Escaped \t

← Older revision		Revision as of 21:32, 1 May 2024
Line 59:		Line 59:
	{		{
	uint result = 0;		uint result = 0;
	\t
	for (int i = 0; i < name.Length; i++)		for (int i = 0; i < name.Length; i++)
	{		{
	result = name[i] + result * key;		result = name[i] + result * key;
	}		}
	\t
	return result;		return result;
	}		}

Wexos: Imported from avsys wiki

2024-05-01T18:00:35Z

Imported from avsys wiki

New page

'''SARC Files''' are archive files used on [[Nintendo Switch]], [[Wii U]] and [[Nintendo 3DS]]. Common extensions are '''.arc''' and '''.sarc''' (general), '''.pack''' (when the archive contains mostly other archive files), '''.bars''' (when it contains audio data), and '''.bgenv/.genvb''' (when it contains shader and post-effect files). SARC files are sometimes [[Yaz0]] compressed into '''.szs''' files.

= File Format =
== Header ==
Every SARC file begins with a 0x14 byte SARC header structure.

{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || Char[4] || '''File magic'''. Always ''SARC'' in ASCII.
|-
| 0x04 || UInt16 || '''Size of this header''' in bytes.
|-
| 0x06 || UInt16 || {{BOM}}
|-
| 0x08 || UInt32 || '''File size''' of the entire archive in bytes.
|-
| 0x0C || UInt32 || '''Data start offset'''.
|-
| 0x10 || UInt16 || '''Version number''' of the file format. Only version 0x0100 has been seen.
|-
| 0x12 || UInt16 || Reserved.
|}

== SFAT ==
The Header is immediately followed by the SFAT section. It has the following structure:

{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || Char[4] || '''Section magic'''. Always ''SFAT'' in ASCII.
|-
| 0x04 || UInt16 || '''Size of this section''' in bytes.
|-
| 0x06 || UInt16 || '''Number of [[#Node|nodes]]'''.
|-
| 0x08 || UInt32 || '''Hash key'''. Always 0x65.
|}

=== Node ===
After the SFAT section comes all node entries. Each entry has the following structure:

{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || UInt32 || '''File Name Hash'''. Look below for the calculation.
|-
| 0x04 || UInt32 || '''File attribute'''. If flag 0x01000000 is set, bottom half (0xFFFF) is the name offset divided by 4 (relative to end of [[#SFNT|SFNT]]).
|-
| 0x08 || UInt32 || '''Start of file data''', relative to the data start offset specified in the [[#Header|Header]].
|-
| 0x0C || UInt32 || '''End of file data''', relative to the data start offset specified in the [[#Header|Header]].
|}

==== File Name Hash ====
The hash is calculated like this:
<pre>
uint GetHash(string name, uint key)
{
uint result = 0;
\t
for (int i = 0; i < name.Length; i++)
{
result = name[i] + result * key;
}
\t
return result;
}
</pre>

== SFNT ==
The [[#SFAT|SFAT]] [[#Node|node array]] is immediately followed by the SFNT structure. It has the following layout:

{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || Char[4] || '''File magic'''. Always ''SFNT'' in ASCII.
|-
| 0x04 || UInt16 || '''Size of this section''' in bytes.
|-
| 0x06 || UInt16 || Reserved.
|}

After follows 4-byte aligned null-terminated strings that represent the filenames of the packed files.

== File Data ==
The data begins at the data start offset specified in the [[#Header|SARC header]]. The alignment of the internal files vary between different files, but default is 4.

= Tools =
The following tools can handle SARC files:
* [http://florian.nouwt.com/wiki/index.php/Every_File_Explorer Every File Explorer], by [[Gericom]]
* [https://github.com/aboood40091/SARC-Tool/releases/tag/v0.3 SARC Tool], by [[User:Aboood40091|AboodXD]]
* [https://github.com/NWPlayer123/WiiUTools/tree/master/SARCTools SARCTools], by [[User:NWPlayer123|NwPlayer123]]
* [https://drive.google.com/file/d/0B9ETxoIujjPFLTJOY2pIZ3RfRms/view Uwizard], by [[User:Mr. Mysterio|Mr. Mysterio]]
* [https://github.com/smb123w64gb/Uwizard/releases/tag/1.2.0 Uwizard.Woomy], by [[User:smb123w64gb|smb123w64gb]]
* [[Wexos's Toolbox]], by [[Wexos]]
* [https://www.dropbox.com/sh/tfg2nd6q809oqn3/AADWk3SgQEsqnvlbplcWOfv5a WiiUExplorer], by [[User:Celcodioc|Celcodioc]]

[[Category:3DS File Formats]]
[[Category:Switch File Formats]]
[[Category:Wii U File Formats]]

SARC (File Format) - Revision history

Wexos: Escaped \t

Wexos: Imported from avsys wiki