sm:technical_information:data_structures
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
sm:technical_information:data_structures [2024/11/15 22:42] – [Enemy population] felixwright | sm:technical_information:data_structures [2024/11/16 08:12] (current) – felixwright | ||
---|---|---|---|
Line 521: | Line 521: | ||
Scroll values are as follows: | Scroll values are as follows: | ||
- | 0 Red. Cannot scroll into this area | + | |0|Red. Cannot scroll into this area | |
- | 1 Blue. Hides the bottom 2 rows of the area | + | |1|Blue. Hides the bottom 2 rows of the area | |
- | 2 Green. Unrestricted | + | |2|Green. Unrestricted |
==== Special X-Ray Blocks ==== | ==== Special X-Ray Blocks ==== | ||
Line 542: | Line 542: | ||
The X/Y position is specified in (16px x 16px) block units. The block uses the level data block format, except that the block type is ignored. | The X/Y position is specified in (16px x 16px) block units. The block uses the level data block format, except that the block type is ignored. | ||
- | Note that flexglow uses this pointer for the flexglow table instead. | + | Note that [[https:// |
==== PLM population ==== | ==== PLM population ==== | ||
Line 571: | Line 571: | ||
The list of commands used in Super Metroid is as follows: | The list of commands used in Super Metroid is as follows: | ||
- | Type Parameters | + | ^Type^Parameters^Description |
- | 2 ssssss dddd nnnn Transfer n bytes from s to d in VRAM | + | |2|ssssss dddd nnnn|Transfer n bytes from s to d in VRAM | |
- | 4 ssssss dddd Decompress s to d in bank $7E | + | |4|ssssss dddd|Decompress s to d in bank $7E | |
- | 6 | + | |6| |Clear layer 3 | |
- | 8 ssssss dddd nnnn Transfer n bytes from s to d in VRAM and set BG3 tiles base address = $2000 | + | |8|ssssss dddd nnnn|Transfer n bytes from s to d in VRAM and set BG3 tiles base address = $2000 | |
- | Ah | + | |Ah| |Clear layer 2 | |
- | Ch | + | |Ch| |Clear Kraid' |
- | Eh DDDD ssssss dddd nnnn Transfer n bytes from s to d in VRAM if the current door pointer = D | + | |Eh|DDDD ssssss dddd nnnn|Transfer n bytes from s to d in VRAM if the current door pointer = D | |
===== Object formats ===== | ===== Object formats ===== | ||
Line 620: | Line 620: | ||
The draw instruction format is a list of: | The draw instruction format is a list of: | ||
- | nnnn ; Number of blocks | + | |
- | bbbb [...] ; Blocks | + | bbbb [...] ; Blocks |
- | xx yy ; X and Y offsets from origin to start drawing from | + | xx yy ; X and Y offsets from origin to start drawing from |
where the list is terminated by xx yy = 00 00. | where the list is terminated by xx yy = 00 00. | ||
Line 725: | Line 725: | ||
Palette instructions are a mix of colours (which are positive values) and ASM instructions (negative values). Colours are written to successive positions in CGRAM starting from initial colour index. ASM instructions can modify the colour index between listed colour values, and the instruction $C595 is used to terminate the palette instruction list. | Palette instructions are a mix of colours (which are positive values) and ASM instructions (negative values). Colours are written to successive positions in CGRAM starting from initial colour index. ASM instructions can modify the colour index between listed colour values, and the instruction $C595 is used to terminate the palette instruction list. | ||
- | |||
- | Enemy projectile header: | ||
- | |||
- | | ||
- | | | ||
- | | | | ||
- | | | | | ||
- | | | | | | ||
- | | | | | | | ||
- | | | | | | | | ||
- | | | | | | | | ___ Shot AI | ||
- | | | | | | | | | | ||
- | iiii pppp IIII xx yy Pddd tttt ssss | ||
- | |||
- | The properties are as follows: | ||
- | 8000h Detect collisions with projectiles | ||
- | 4000h Don't die on contact | ||
- | 2000h Disable collisions with Samus | ||
- | 1000h Low priority (drawn under enemies/ | ||
- | |||
- | The special instructions for enemy projectiles have the format: | ||
- | |||
- | | ||
- | | _ Pointer to spritemap | ||
- | | | | ||
- | tttt ssss | ||
- | |||
- | The spritemap timer is how many frames to wait until the next instruction in the instruction list is proceeded to. Within the spritemap, the tile numbers added to the base tile number set when the enemy projectile was spawned (so the projectile can access enemy graphics). | ||
- | |||
- | ==== Animated Tiles Objects ==== | ||
- | |||
- | Animated tiles objects are objects that modify tile graphics in real-time. They exist in bank $87 and are loaded with a room from an FX header. | ||
- | |||
- | Animated tiles object header format: | ||
- | |||
- | | ||
- | | | ||
- | | | _ VRAM address | ||
- | | | | | ||
- | iiii ssss vvvv | ||
- | |||
- | The special instructions for animated tiles objects have the format: | ||
- | |||
- | | ||
- | | _ Pointer to tile graphics | ||
- | | | | ||
- | tttt ssss | ||
- | |||
- | The animation timer is how many frames to wait until the next instruction in the instruction list is proceeded to. | ||
- | |||
- | ==== HDMA Objects ==== | ||
- | |||
- | HDMA objects exist in bank $88 and are typically loaded with a room as part of FX or spawned by power bombs / x-ray. | ||
- | |||
- | HDMA object header format: | ||
- | |||
- | | ||
- | | ____ PPU register index | ||
- | | | _ Instruction list pointer | ||
- | | | | | ||
- | dd pp iiii | ||
- | |||
- | The special instructions for HDMA objects have the format: | ||
- | |||
- | | ||
- | | _ Pointer to HDMA table | ||
- | | | | ||
- | tttt ssss | ||
- | |||
- | The table timer is how many frames to wait until the next instruction in the instruction list is proceeded to. | ||
- | |||
- | ==== Palette FX Objects ==== | ||
- | |||
- | Palette FX objects are objects that modify palette data in real-time. They exist in bank $8D and are loaded with a room from an FX header. | ||
- | |||
- | Palette FX object header format: | ||
- | |||
- | | ||
- | | _ Instruction list pointer | ||
- | | | | ||
- | aaaa iiii | ||
- | |||
- | The special instructions for palette FX objects have the format: | ||
- | |||
- | | ||
- | | _ Palette instruction list | ||
- | | | | ||
- | tttt [...] | ||
- | |||
- | The palette timer is how many frames to wait until the next instruction in the instruction list is proceeded to. | ||
- | |||
- | The ASM instructions are usually used for setting the initial colour index, which is an index into CGRAM equal to (p * 10h + c) * 2 where p is the palette number and c is the colour index within the palette. | ||
- | |||
- | Palette instructions are a mix of colours (which are positive values) and ASM instructions (negative values). Colours are written to successive positions in CGRAM starting from initial colour index. ASM instructions can modify the colour index between listed colour values, and the instruction $C595 is used to terminate the palette instruction list. | ||
- |
sm/technical_information/data_structures.1731710530.txt.gz · Last modified: 2024/11/15 22:42 by felixwright