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.

08_graphics/views.md

@@ -0,0 +1,109 @@
+[← Home](../README.md) · [Graphics](README.md)
+
+# Views and ViewPorts — Display Construction
+
+## Overview
+
+The AmigaOS display system builds the actual screen image through a hierarchy: `View` → `ViewPort` → `RasInfo` → `BitMap`. The `MakeVPort`/`MrgCop`/`LoadView` pipeline compiles this into a Copper list that programs the custom chips.
+
+---
+
+## Key Structures
+
+```c
+/* graphics/view.h — NDK39 */
+struct View {
+    struct ViewPort *ViewPort;  /* first viewport in chain */
+    struct cprlist  *LOFCprList; /* long-frame copper list */
+    struct cprlist  *SHFCprList; /* short-frame copper list */
+    WORD            DyOffset;   /* vertical scroll offset */
+    WORD            DxOffset;   /* horizontal scroll offset */
+    UWORD           Modes;      /* display mode flags */
+};
+
+struct ViewPort {
+    struct ViewPort *Next;       /* next viewport in chain */
+    struct ColorMap *ColorMap;   /* palette for this viewport */
+    struct CopList  *DspIns;     /* display copper instructions */
+    struct CopList  *SprIns;     /* sprite copper instructions */
+    struct CopList  *ClrIns;     /* colour copper instructions */
+    struct CopList  *UCopIns;    /* user copper instructions */
+    WORD            DWidth;      /* display width */
+    WORD            DHeight;     /* display height */
+    WORD            DxOffset;
+    WORD            DyOffset;
+    UWORD           Modes;       /* HIRES, LACE, HAM, EHB, etc. */
+    UBYTE           SpritePriorities;
+    UBYTE           ExtendedModes;
+    struct RasInfo  *RasInfo;    /* linked bitmap info */
+};
+
+struct RasInfo {
+    struct RasInfo *Next;        /* for dual-playfield */
+    struct BitMap  *BitMap;      /* the actual bitmap */
+    WORD           RxOffset;     /* horizontal scroll within bitmap */
+    WORD           RyOffset;     /* vertical scroll within bitmap */
+};
+```
+
+---
+
+## Display Mode Flags
+
+```c
+/* graphics/view.h */
+#define HIRES       0x8000   /* 640 pixel mode */
+#define LACE        0x0004   /* interlaced */
+#define HAM         0x0800   /* Hold-And-Modify (4096 colours) */
+#define EXTRA_HALFBRITE 0x0080 /* Extra Half-Brite (64 colours) */
+#define DUALPF      0x0400   /* dual playfield */
+#define PFBA        0x0040   /* playfield B has priority */
+#define SUPERHIRES  0x0020   /* 1280 pixel mode (ECS+) */
+#define VP_HIDE     0x2000   /* viewport is hidden */
+```
+
+---
+
+## Building a Display
+
+```c
+struct View view;
+struct ViewPort vp;
+struct RasInfo ri;
+struct BitMap *bm = AllocBitMap(320, 256, 5, BMF_DISPLAYABLE|BMF_CLEAR, NULL);
+
+InitView(&view);
+InitVPort(&vp);
+view.ViewPort = &vp;
+vp.RasInfo = &ri;
+ri.BitMap = bm;
+vp.DWidth = 320;
+vp.DHeight = 256;
+vp.Modes = 0;   /* lores */
+
+/* Build colour map: */
+vp.ColorMap = GetColorMap(32);
+
+/* Compile to copper: */
+MakeVPort(&view, &vp);
+MrgCop(&view);
+
+/* Activate: */
+LoadView(&view);
+WaitTOF();
+
+/* Cleanup: */
+LoadView(GfxBase->ActiView);  /* restore system view */
+FreeVPortCopLists(&vp);
+FreeCprList(view.LOFCprList);
+FreeColorMap(vp.ColorMap);
+FreeBitMap(bm);
+```
+
+---
+
+## References
+
+- NDK39: `graphics/view.h`
+- ADCD 2.1: `InitView`, `InitVPort`, `MakeVPort`, `MrgCop`, `LoadView`
+- HRM: display construction chapter