init

original/assets/README.md

@@ -0,0 +1,26 @@
+# Extracted TDK Pinball assets
+
+This directory contains every resource in `TDKPIN.EXE`'s Windows 3.x NE resource table.
+
+## Layout
+
+- `raw/`: all 63 resource allocations copied byte-for-byte from the executable. These files
+  intentionally retain alignment padding and are the lossless source of truth.
+- `decoded/images/`: 34 custom 8-bit DIB graphics and three standard bitmap resources converted
+  to PNG. The standard bitmaps also have BMP wrappers.
+- `decoded/palettes/`: the shared 256-color RGB palette as a swatch PNG and GIMP palette.
+- `decoded/audio/`: all 16 RIFF/PCM resources trimmed to their declared RIFF lengths.
+- `decoded/icons/`: the application icon as ICO and PNG.
+- `decoded/dialogs/`: all six packed Win16 dialog templates decoded to JSON, including bounds,
+  control IDs, classes, captions, styles, and fonts.
+- `decoded/metadata/`: printable strings and fixed fields from the version resource.
+- `manifest.json`: resource ID, original file offset, flags, allocated and meaningful sizes,
+  hashes, format metadata, and decoded paths for every entry.
+
+The custom `DAT` graphics omit an inline color table. They are decoded with the executable's
+separate `PAL/999` resource; the raw DAT and PAL bytes remain separate so their original storage
+model is preserved.
+
+Run `python3 tools/extract_ne_resources.py` from the repository root to regenerate the directory,
+then `python3 tools/verify_extracted_assets.py` to verify exact raw-byte round trips and decoded
+file structure.