Datasheet - Revision history

imported>Leoetlino: /* Header */

2020-04-13T18:53:14Z

Header

← Older revision		Revision as of 18:53, 13 April 2020
Line 39:		Line 39:
	\|0xE		\|0xE
	\|u8		\|u8
	\|~~?{{Check}}~~		\|Alignment (usually 4 or 8)
	\|-		\|-
	\|0x10		\|0x10

imported>Leoetlino: /* Field */ fix Field::Type storage type

2020-04-13T08:57:09Z

Field: fix Field::Type storage type

← Older revision		Revision as of 08:57, 13 April 2020
Line 70:		Line 70:
	=== Field ===		=== Field ===
	<syntaxhighlight lang="c++">		<syntaxhighlight lang="c++">
	enum class Type : ~~u16~~ {		enum class Type : u8 {
	Struct = 0,		Struct = 0,
	Bool = 1,		Bool = 1,

imported>Leoetlino: /* Header */

2020-04-12T10:54:48Z

Header

← Older revision		Revision as of 10:54, 12 April 2020
Line 43:		Line 43:
	\|0x10		\|0x10
	\|const char*		\|const char*
	\|Name		\|Name (must be non-null)
	\|-		\|-
	\|0x18		\|0x18

imported>Leoetlino: /* Field */

2020-04-12T10:54:28Z

Field

← Older revision		Revision as of 10:54, 12 April 2020
Line 98:		Line 98:
	\|0x8		\|0x8
	\|const char*		\|const char*
	\|Type name		\|Type name (must be non-null)
	\|-		\|-
	\|0x10		\|0x10

imported>Leoetlino: /* Header */

2020-04-12T10:19:57Z

Header

← Older revision		Revision as of 10:19, 12 April 2020
Line 17:		Line 17:
	\|0x0		\|0x0
	\|char[4]		\|char[4]
	\|Magic (<code>~~GSHT~~</code> or <code>~~gsht~~</code>)		\|Magic (<code>gsht</code>)

			After pointer relocation, the magic is set to <code>GSHT</code>.
	\|-		\|-
	\|0x4		\|0x4

imported>Leoetlino: /* Header */

2020-04-11T23:11:10Z

Header

← Older revision		Revision as of 23:11, 11 April 2020
Line 22:		Line 22:
	\|int		\|int
	\|Version (must be 1)		\|Version (must be 1)
			\|-
			\|0x8
			\|u32
			\|? Some kind of hash? (unused {{check}})
	\|-		\|-
	\|0xC		\|0xC

imported>Leoetlino: clarifications

2020-04-11T20:37:31Z

clarifications

← Older revision		Revision as of 20:37, 11 April 2020
Line 2:		Line 2:
	'''GSHT''' (G?sheet) is a custom Grezzo binary serialization file format that is used to store structured, strongly typed data. GSHT documents are called '''datasheets'''.		'''GSHT''' (G?sheet) is a custom Grezzo binary serialization file format that is used to store structured, strongly typed data. GSHT documents are called '''datasheets'''.

	A datasheet contains structure type information followed by arrays of structures. Optionally, one of the structure fields may be declared as a key field, in which case the contents are a dictionary rather than a array.		A datasheet contains structure type information followed by arrays of structures. Optionally, one of the structure fields may be declared as a key field, in which case the contents are treated as a dictionary/mapping rather than a array.

	== Format ==		== Format ==
	Documents are little endian and their sizes are always 0x10~~-byte aligned~~.		Documents are little endian and their sizes are always rounded up to be a multiple of 0x10.

	Pointers are encoded as absolute offsets and relocated when the document is loaded by the game.		Pointers are encoded as absolute offsets and relocated when the document is loaded by the game.
Line 57:		Line 57:
	\|0x2C		\|0x2C
	\|u32		\|u32
	\|~~Value size~~		\|Size of each value
	\|}		\|}

Line 76:		Line 76:
	IsArray = 1 << 1,		IsArray = 1 << 1,
	IsKey = 1 << 2,		IsKey = 1 << 2,
	b3 = 1 << 3,		b3 = 1 << 3, // unknown
	IsEnum = 1 << 4,		IsEnum = 1 << 4,
	b5 = 1 << 5,		b5 = 1 << 5, // unknown
	};		};
	</syntaxhighlight>		</syntaxhighlight>
Line 108:		Line 108:
	\|0x14		\|0x14
	\|u16		\|u16
	\|~~Value offset~~		\|Offset of this field in the value structure
	\|-		\|-
	\|0x16		\|0x16
	\|u16		\|u16
	\|~~Value blob size~~		\|Size of this field in the value structure

			For strings and arrays, this is always 0x10.
	\|-		\|-
	\|0x18		\|0x18
	\|u16		\|u16
	\|~~Value~~ size		\|Size of the data

			For strings and inline types (inline structs, ints, floats, bools), this is the same as the size in the value structure.
	\|-		\|-
	\|0x1A		\|0x1A
	\|u16		\|u16
	\|~~Structure field count~~		\|[For structs] Number of fields
	\|-		\|-
	\|0x20		\|0x20
	\|Field*		\|Field*
	\|~~Structure fields~~		\|[For structs] Fields
	\|-		\|-
	\|0x28		\|0x28
Line 137:		Line 141:

	=== Value ===		=== Value ===
	~~A value is simply serialized data for~~ the structure ~~formed~~ of ~~root fields~~.		Combining all the root fields gives a structure (in the sense of a C or C++ structure). That structure is called a Value in this documentation.

	{\| class="wikitable"		{\| class="wikitable"

imported>Leoetlino: /* Value */ Nullable strings

2020-04-11T19:12:57Z

Value: Nullable strings

← Older revision		Revision as of 19:12, 11 April 2020
Line 164:		Line 164:
	\|String		\|String
	\|<code>struct { const char* data; u32 length; }</code> (aligned to 0x10 bytes)		\|<code>struct { const char* data; u32 length; }</code> (aligned to 0x10 bytes)

			For empty strings ''that are Nullable'', data is nullptr and length is 0. Empty strings that are ''not'' Nullable have a 0 length but still point to a null byte.
	\|}		\|}

imported>Leoetlino: /* Format */

2020-04-07T19:43:57Z

Format

← Older revision		Revision as of 19:43, 7 April 2020
Line 59:		Line 59:
	\|Value size		\|Value size
	\|}		\|}

			The header is immediately followed by the root fields (a <code>Field[num_root_fields]</code> array).

	=== Field ===		=== Field ===

imported>Leoetlino: /* Value */

2020-04-07T18:58:22Z

Value

← Older revision		Revision as of 18:58, 7 April 2020
Line 135:		Line 135:

	=== Value ===		=== Value ===
			A value is simply serialized data for the structure formed of root fields.

	{\| class="wikitable"		{\| class="wikitable"
	\|+Field data serialization		\|+Field data serialization
Line 161:		Line 163:
	\|<code>struct { const char* data; u32 length; }</code> (aligned to 0x10 bytes)		\|<code>struct { const char* data; u32 length; }</code> (aligned to 0x10 bytes)
	\|}		\|}
	~~A value is simply serialized data for the structure formed of main fields.~~

	== Usage in ''Link's Awakening'' ==		== Usage in ''Link's Awakening'' ==