Glossary
Each term that the wiki uses without explaining it has one definition here, and the other pages link to it. The terms fall into three groups: disc and containers, game runtime, and PlayStation hardware and formats. Notation and conventions defines the notation for numbers, field types, offsets, citations and evidence tags.
Disc and containers
Section titled “Disc and containers”| Term | Meaning |
|---|---|
| EMI | the game’s archive format (.EMI files): a sector-aligned table of contents and typed entries (EMI container) |
| entry | one item in an EMI archive, written ARCHIVE#n or archive/n. Its type (0 to 10) says how the loader treats it |
| payload | the bytes of an entry after its table-of-contents record |
| load argument | a type-dependent 32-bit value in an entry’s table record: a RAM address for code and data, a VRAM position for textures |
| kind | a name this wiki gives to a class of disc content, such as area-map, texture or audio-bank (asset kinds) |
| record, row | one fixed-size element of a table, such as a character, an enemy or a drop; or one string in a message table |
| stride | the byte distance between two consecutive records of a table |
| slot | an index. An archive slot id is the archive’s index in the disc file list. A text slot is an index in a message table’s offset table. A battler slot is a position in a battle. Each page says which |
| message table | a payload that opens with a little-endian u16 offset table. Each slot of the table points at a record of text; several slots can share one record (text) |
| text table | a message table that holds game text |
| name table | an array of fixed-stride records that each hold a name field (text) |
| fixed tables | the eight tables in GAME.EMI entry 0: items, vital items, weapons, armor, accessories, shops, abilities and level growth (records) |
| bundle | the payload of one entry that packs several tables behind a header, such as an area’s map bundle (area) |
| LBA | logical block address: a sector number on the disc |
| Form 1, Form 2 | the two CD-ROM XA sector layouts. Form 1 has error correction and 2,048 data bytes. Form 2 has 2,324 data bytes and no correction |
| STR, XA | the game’s streamed video and interleaved audio sectors (STR and XA) |
| CDDA | CD audio tracks on the disc, outside the data track |
Game runtime
Section titled “Game runtime”| Term | Meaning |
|---|---|
| resident program | the main executable, which stays in RAM from boot to power-off; every overlay calls into it (runtime) |
| overlay | code or data streamed from the disc into a fixed RAM window, replacing the previous overlay at that address |
| window | a RAM range that overlays share, such as 0x801D0C00 for scene overlays (memory) |
| module | a small overlay that a window swaps, such as a boss battle or a battle effect. Its first u32 is its module id (runtime) |
| boss module | the module of one boss battle |
| area | one of the 200 WORLDnn/AREAnnn.EMI maps: a town, dungeon, world map, battlefield, fishing pond, fairy village or camp |
| area program | the code entry of an area, loaded at 0x801F2C00; it places the area’s objects and runs its scripts |
| map kind | what an area is: world map, battlefield, fishing pond, fairy village, camp or walked area. Byte +0x32 of the area’s load record selects it (runtime) |
| scenario | one of 20 story controller overlays, SCENA00 to SCENA19 (scenario) |
| scene | what the overlay in the scene window (0x801D0C00) runs: a menu, title, battle or area (memory) |
| entry state | the value of g_GameEntryState: an index into the table g_GameStates of 12 full-screen modes, such as the field or the menu (screens) |
| request code | a byte, g_GameStateIndex, with values 0 to 9. Field, actor and scenario code write it, and the field state reads it to choose the next entry state (phases) |
| mode machine | a state machine selected by a mode byte; each mode owns a table of step functions (battle) |
| dispatch table | an array of function pointers indexed by a state or type value |
| callback slot | one of the four cooperative tasks the main loop runs each frame (scheduler) |
| zone list | the executable’s per-area list of 8-byte rectangles in map cells. A rectangle holds an encounter step class, a zone kind and a music selector ([inferred]; area) |
| work row | a record that an overlay builds in RAM at run time, such as a player or enemy record of a battle (battle) |
| actor row | one of 30 records of 152 bytes at 0x80146888: a map object or an interaction slot (field) |
| field slot | one of 20 records of 116 bytes at 0x80143FC8 that the scene claims, fills and clears (field) |
| battler | a combatant in a battle: slots 0 to 2 are the party and slots 3 to 10 are enemies (battle) |
| cell | one field of a record, addressed by its byte offset (+0x92); or one square of a map grid. The page says which |
| reader | a function that reads a field or table; the evidence for a field names it |
| text id | a 16-bit id that a record stores to name a string. The top two bits pick a group, and the rest index that group’s offset table (Message_GetText, text) |
| cue | a sound request: an id that the sound code looks up in an area’s cue table to start a sample or sequence (audio) |
| scratchpad | the PlayStation’s 1 KiB fast memory at 0x1F800000 |
| staging buffer | RAM where data waits before it is copied to VRAM, the card or the SPU |
PlayStation hardware and formats
Section titled “PlayStation hardware and formats”| Term | Meaning |
|---|---|
| VRAM | the GPU’s 1 MiB video memory, 1,024 by 512 16-bit words |
| CLUT | color lookup table: a row of palette words in VRAM that an indexed (4 or 8 bit) texture uses |
| TPage | texture page: the VRAM region and color depth a primitive samples |
| palette pairing | a texture page plus a CLUT row: the palette and color depth that a draw call uses with a texture (graphics) |
| STP | the semi-transparency bit of a 16-bit color word |
| GPU | the graphics processor; it draws primitives into VRAM |
| ordering table | the GPU’s linked list of primitives drawn in depth order |
| primitive | one GPU draw command (sprite, textured quad, line) |
| GTE | the geometry transformation engine: the coprocessor that rotates and projects vertices |
| SPU | the sound processing unit; it plays ADPCM samples with an envelope |
| ADPCM | the 4-bit sample compression the SPU and XA audio use |
| VAB | a sound bank: a header of programs and tones plus a body of samples (.vh header, .vb body) |
| sound bank | a VAB as the audio code loads it, one per SPU bank slot; the kind audio-bank, the bank:ARCHIVE ids and the libsnd names (SND_SetBankLayout, SsSepPlay) keep the word. No other format here is a bank |
| CLUT block | a type-0 entry of raw color words, a whole number of 4bpp rows, that loads into the palette arena (graphics) |
| VAG | one sample inside a VAB body |
| SEP | a music sequence package; each sequence plays through a VAB |
| MDEC | the motion decoder that turns STR frames into pictures |
| PS-X header | the 2 KiB header of a PlayStation executable; it holds the load address (t_addr), size and start address |
| PsyQ | Sony’s PlayStation SDK, which the game links; its library names (ResetGraph, LoadImage, CdControl) appear in the pages |