docs(amiga): complete AmigaOS 3.1/3.2 developer reference — 172 files across 17 sections

Comprehensive technical documentation covering:
- Hardware: OCS/ECS/AGA custom chip registers, Copper & Blitter deep dives
- Boot sequence: cold boot through startup-sequence
- Binary format: HUNK executable spec, relocation, debug info
- Linking & ABI: .fd files, LVO tables, register calling conventions
- Exec kernel: tasks, interrupts, memory, signals, semaphores
- AmigaDOS: file I/O, FFS/OFS layout, CLI/Shell scripting
- Graphics: planar bitmaps, Copper programming, HAM/EHB modes
- Intuition: screens, windows, IDCMP, BOOPSI
- Devices: trackdisk, SCSI, serial, timer, audio, keyboard
- Libraries: utility, expansion, IFFParse, locale, ARexx
- Networking: bsdsocket API, SANA-II, TCP/IP stack comparison
- Toolchain: GCC, vasm/vlink, SAS/C, NDK, debugging
- Reverse engineering: IDA/Ghidra setup, compiler fingerprints, case studies
- CPU & MMU: 68040/060 emulation libs, PMMU, cache management
- Driver development: SANA-II, Picasso96/RTG, AHI audio

All files include breadcrumb navigation. No local paths or proprietary content.
This commit is contained in:
Ilia Sharin 2026-04-23 12:16:52 -04:00
parent f07a368bf1
commit 21751c0025
172 changed files with 19701 additions and 0 deletions

81
11_libraries/iffparse.md Normal file
View file

@ -0,0 +1,81 @@
[← Home](../README.md) · [Libraries](README.md)
# iffparse.library — IFF File Parsing
## Overview
IFF (Interchange File Format) is EA/Commodore's universal container format. `iffparse.library` provides stream-oriented parsing/writing of IFF files. Common IFF types: ILBM (images), 8SVX (audio), ANIM (animation), FTXT (formatted text).
---
## IFF Structure
```
FORM <size> <type>
<chunk_id> <size> <data...>
<chunk_id> <size> <data...>
...
```
All values are big-endian. Chunks are padded to even byte boundaries.
---
## Key Functions
```c
struct Library *IFFParseBase = OpenLibrary("iffparse.library", 0);
struct IFFHandle *iff = AllocIFF();
/* Open from file: */
iff->iff_Stream = (ULONG)Open("image.iff", MODE_OLDFILE);
InitIFFasDOS(iff);
OpenIFF(iff, IFFF_READ);
/* Register chunks we want to stop at: */
StopChunk(iff, ID_ILBM, ID_BMHD);
StopChunk(iff, ID_ILBM, ID_BODY);
StopChunk(iff, ID_ILBM, ID_CMAP);
/* Parse: */
LONG error;
while ((error = ParseIFF(iff, IFFPARSE_SCAN)) == 0) {
struct ContextNode *cn = CurrentChunk(iff);
switch (cn->cn_ID) {
case ID_BMHD:
ReadChunkBytes(iff, &bmhd, sizeof(bmhd));
break;
case ID_CMAP:
ReadChunkBytes(iff, palette, cn->cn_Size);
break;
case ID_BODY:
ReadChunkBytes(iff, bodydata, cn->cn_Size);
break;
}
}
CloseIFF(iff);
Close((BPTR)iff->iff_Stream);
FreeIFF(iff);
```
---
## Common Chunk IDs
| FORM Type | Chunk | Description |
|---|---|---|
| `ILBM` | `BMHD` | Bitmap header (width, height, depth) |
| `ILBM` | `CMAP` | Colour map (R,G,B triples) |
| `ILBM` | `BODY` | Image body data |
| `ILBM` | `CAMG` | Amiga display mode |
| `8SVX` | `VHDR` | Voice header |
| `8SVX` | `BODY` | Audio sample data |
| `ANIM` | `ANHD` | Animation header |
| `ANIM` | `DLTA` | Delta frame data |
---
## References
- NDK39: `libraries/iffparse.h`, `datatypes/pictureclass.h`