map.h

Structures

struct MapCell

One cell of a map layer: its metatile and flags, its collision code and an attribute indexing the collision table.

Field	Declared as
`metatileAndFlags`	`u16 metatileAndFlags`	bits: 15..12 flags (15..14 read by Map_GetCellHighFlags) \| 11..0 metatile
`collisionCode`	`u8 collisionCode`	The step code: 1 to 239 scene events, 240 and 241 encounter ground, 250 hazard, 252 to 254 for Field_RunPushTileEvent, 0xff a wall.
`attributeB`	`u8 attributeB`	Indexes the 4-byte collision entries (gMapCollision): terrain kind in the first byte's low four bits, then its height samples.

struct MapLayer

A map layer's scroll record, seen from its cells.

Field	Declared as
`cells`	`struct MapCell *cells`	the layer's first cell (MapLayerScroll's cells)
`unk04`	`u8 unk04[0x2c]`	the next layer's scroll values; not named by TBS code

struct BlendScriptState

The map's running blend script, which sets the blend registers over time.

struct MapAnimation

One of the 16 tile animation channels, which copy tiles into VRAM by script.

struct MapState

The map work in heap slot 8 (struct MapScrollWork), seen as its tile animation channels, blend script and layers' cells.

Field	Declared as
`unk000`	`u8 unk000[0x14]`	MapScrollWork's origin, shake and script
`flags`	`u16 flags`	REG_DISPCNT bits; Map_SetShownLayers sets BG1 to BG3
`wideTiles`	`u8 wideTiles`	nonzero: tile animations copy 64-byte tiles
`unk17`	`u8 unk17`	MapScrollWork's footprints; Bilibin Cave sets it
`anim`	`struct MapAnimation anim[16]`
`blend`	`struct BlendScriptState blend`
`unke4`	`u8 unke4[0x1f]`	MapScrollWork's view, bounds and shown layers
`blendControl`	`u8 blendControl`	The last BLDCNT the blend script wrote; with mode 1 in bits 7..6 its values go to BLDALPHA, else to BLDY.
`unk104`	`u8 unk104[0x2c]`	the first layer's scroll values; not named by TBS code
`layers`	`struct MapLayer layers[4]`	Each layer's cells, at MapScrollWork's layers[i].cells; readers mask the layer with 3, and the fourth entry lies past MapScrollWork's end.