AAMP - Revision history

Leoetlino: /* Structure */ fix struct definitions (offsets and counts are packed as a single u32; they are not separate fields)

2020-09-01T21:34:27Z

Structure: fix struct definitions (offsets and counts are packed as a single u32; they are not separate fields)

← Older revision		Revision as of 21:34, 1 September 2020
Line 63:		Line 63:
	\| 0x0 \|\| u32 \|\| Name CRC32		\| 0x0 \|\| u32 \|\| Name CRC32
	\|-		\|-
	\| 0x4 \|\| ~~u16~~ \|\| Offset to child lists, divided by 4 and relative to parameter list start		\| 0x4 \|\| u32 \|\|
			* Bits 0-15: Offset to child lists, divided by 4 and relative to parameter list start
			* Bits 16-31: Number of child lists
	\|-		\|-
	\| ~~0x6~~ \|\| ~~u16~~ \|\| ~~Number of child lists~~		\| 0x8 \|\| u32 \|\|
	\|-		* Bits 0-15: Offset to child objects, divided by 4 and relative to parameter list start
	~~\| 0x8 \|\| u16 \|\|~~ Offset to child objects, divided by 4 and relative to parameter list start		* Bits 16-31: Number of child objects
	\|-
	~~\| 0xa \|\| u16 \|\|~~ Number of child objects
	\|}		\|}

Line 78:		Line 78:
	\| 0x0 \|\| u32 \|\| Name CRC32		\| 0x0 \|\| u32 \|\| Name CRC32
	\|-		\|-
	\| 0x4 \|\| ~~u16~~ \|\| Offset to child parameters, divided by 4 and relative to parameter object start		\| 0x4 \|\| u32 \|\|
	\|-		* Bits 0-15: Offset to child parameters, divided by 4 and relative to parameter object start
	~~\| 0x6 \|\| u16 \|\|~~ Number of child parameters		* Bits 16-31: Number of child parameters
	\|}		\|}

Line 89:		Line 89:
	\| 0x0 \|\| u32 \|\| Name CRC32		\| 0x0 \|\| u32 \|\| Name CRC32
	\|-		\|-
	\| 0x4 \|\| ~~u24~~ \|\| Offset to data, divided by 4 and relative to parameter start.<br>For strings, this points to a string in the string section. For other parameter types, this points to the data section.		\| 0x4 \|\| u32 \|\|
	\|-		* Bits 0-23: Offset to data, divided by 4 and relative to parameter start.<br>For strings, this points to a string in the string section. For other parameter types, this points to the data section.
	~~\| 0x7 \|\| ParameterType (u8) \|\| Type~~		* Bits 24-31: Parameter type
	\|}		\|}

imported>Leoetlino: bactorpack, beventpack -> actor pack, event pack

2020-03-11T22:31:47Z

bactorpack, beventpack -> actor pack, event pack

← Older revision		Revision as of 22:31, 11 March 2020
Line 192:		Line 192:

	== Usage in ''Breath of the Wild'' ==		== Usage in ''Breath of the Wild'' ==
	AAMP files are used in ''Breath of the Wild'' to store parameters that define the game's behaviour. They are very frequently used inside [[~~bactorpack~~]] archives, where they define most of an Actor's characteristics.		AAMP files are used in ''Breath of the Wild'' to store parameters that define the game's behaviour. They are very frequently used inside [[actor pack]] archives, where they define most of an Actor's characteristics.

	=== Naming conventions for arrays ===		=== Naming conventions for arrays ===

imported>Leoetlino at 21:34, 12 February 2020

2020-02-12T21:34:56Z

← Older revision		Revision as of 21:34, 12 February 2020
Line 17:		Line 17:
	=== Section order ===		=== Section order ===
	* Header		* Header
	* Parameter lists, objects~~, parameters (the official ordering algorithm is unknown)~~		* Parameter lists
	** It appears that Nintendo's official parameter archive generator writes all parameter lists before objects.		* Parameter objects
			* Parameters
	* Data section (to store parameter data)		* Data section (to store parameter data)
	* String section (to store strings)		* String section (to store strings)
	* Unknown uint32 section (unused?)		* Unknown uint32 section (unused?)

			For more information on the ordering, refer to the [https://github.com/zeldamods/oead/blob/v0.9.0-2/src/aamp.cpp#L262 oead source code].

	=== Header ===		=== Header ===

imported>Leoetlino at 17:54, 2 February 2020

2020-02-02T17:54:16Z

← Older revision		Revision as of 17:54, 2 February 2020
Line 37:		Line 37:
	\| 0x10 \|\| u32 \|\| Parameter IO version		\| 0x10 \|\| u32 \|\| Parameter IO version
	\|-		\|-
	\| 0x14 \|\| u32 \|\| Offset to parameter IO ~~(multiple of 4)~~		\| 0x14 \|\| u32 \|\| Offset to parameter IO relative to 0x30
	\|-		\|-
	\| 0x18 \|\| u32 \|\| Number of lists (including parameter IO)		\| 0x18 \|\| u32 \|\| Number of lists (including parameter IO)

imported>Leoetlino: /* Structure / Clarify that AAMP files are the same on both platforms in BotW*, not in general

2019-10-25T10:28:44Z

Structure: Clarify that AAMP files are the same on both platforms *in BotW*, not in general

← Older revision		Revision as of 10:28, 25 October 2019
Line 7:		Line 7:
	AAMP is a (typically) little endian format.		AAMP is a (typically) little endian format.

	Unlike some other file formats, AAMP files have the exact same structure and endianness on Wii U and Switch, so these files are interchangeable between the consoles.		Unlike some other file formats, AAMP files in ''Breath of the Wild'' have the exact same structure and endianness on Wii U and Switch, so these files are interchangeable between the consoles.

	=== Introduction ===		=== Introduction ===

imported>Leoetlino: /* Tools */

2018-10-14T09:44:54Z

Tools

← Older revision		Revision as of 09:44, 14 October 2018
Line 244:		Line 244:
	== Tools ==		== Tools ==
	The following tools can be used to convert AAMP files to an editable format, and back again:		The following tools can be used to convert AAMP files to an editable format, and back again:
	{{~~#dpl:~~		{{Tool table\|category=Tools (AAMP)}}
	\|category = Tools (AAMP)
	}}
	[[Category:File formats]]		[[Category:File formats]]

imported>Leoetlino at 09:11, 14 October 2018

2018-10-14T09:11:06Z

← Older revision		Revision as of 09:11, 14 October 2018
Line 244:		Line 244:
	== Tools ==		== Tools ==
	The following tools can be used to convert AAMP files to an editable format, and back again:		The following tools can be used to convert AAMP files to an editable format, and back again:
			{{#dpl:
	* [https:~~//github.com/leoetlino/aamp <code>aamp</code>]~~		\|category = Tools (AAMP)
	* [https://github.com/Zer0XoL/BotW-aampTool/releases aampTool] (~~doesn't display root nodes correctly~~)		}}
	[[Category:File formats]]		[[Category:File formats]]

imported>Leoetlino: mention the fact that parameter lists come before objects

2018-10-13T21:48:07Z

mention the fact that parameter lists come before objects

← Older revision		Revision as of 21:48, 13 October 2018
Line 18:		Line 18:
	* Header		* Header
	* Parameter lists, objects, parameters (the official ordering algorithm is unknown)		* Parameter lists, objects, parameters (the official ordering algorithm is unknown)
			** It appears that Nintendo's official parameter archive generator writes all parameter lists before objects.
	* Data section (to store parameter data)		* Data section (to store parameter data)
	* String section (to store strings)		* String section (to store strings)

imported>Leoetlino at 21:47, 13 October 2018

2018-10-13T21:47:11Z

← Older revision		Revision as of 21:47, 13 October 2018
Line 9:		Line 9:
	Unlike some other file formats, AAMP files have the exact same structure and endianness on Wii U and Switch, so these files are interchangeable between the consoles.		Unlike some other file formats, AAMP files have the exact same structure and endianness on Wii U and Switch, so these files are interchangeable between the consoles.

	=== Introduction ~~to structures~~ ===		=== Introduction ===
	* Parameters are a key-value pair. In the binary form, the key is a CRC32 hash.		* Parameters are a key-value pair. In the binary form, the key is a CRC32 hash.
	* Parameter Objects are dicts that contain Parameters.		* Parameter Objects are dicts that contain Parameters.

imported>Leoetlino: /* Extensions */

2018-09-29T15:23:15Z

Extensions

← Older revision		Revision as of 15:23, 29 September 2018
Line 208:		Line 208:
	{{#dpl:		{{#dpl:
	\|category = File extensions (AAMP)		\|category = File extensions (AAMP)
			\|columns=5
			\|rowcolformat=width=100%
	}}		}}