Phase 0: Repository-Initialisierung nach Bauplan v1.2

- Struktur gemäß §8 (Eigentumsgrenzen), PLAN.md als normative Basis
- Pflichtdokumente: STATUS.md, ERRORS.md, TEST_REPORT.md, CHANGELOG.md, ADRs
- ADR-0001 Python 3.13-Pin, ADR-0002 GStreamer 1.28.6-Pin (Windows),
  ADR-0003 IPC TCP+MessagePack v1
- Kernpakete: hms_protocol, hms_domain, hms_parameter, hms_artnet,
  hms_adaptive, hms_capabilities, hms_plugin_sdk
- Renderer-Spike: D3D11-Primärpfad + Dev-GL-Pfad (§36 Nr. 4-5)
- Control Core: FastAPI REST + WebSocket (§36 Nr. 9)
- Beispielplugins: Passthrough + Gaussian Blur (3 Adaptive-Quality-
  Varianten, HLSL/GLSL/GLES)
- Tools: Art-Net-Emulator, Fixture-Generator (Master32/Layer64-CSV),
  Capability-Probe
- JSON-Schemas: IPC, Plugin, Projekt, Cluster
- 121 Unit-/Integrationstests grün, Ruff grün

Gate 0 bleibt offen: Hardwaremessungen nur auf echter Windows-Referenz-
hardware gültig (§29.7, §33).
This commit is contained in:
HMS MediaEngine Agent
2026-09-11 00:36:59 +02:00
commit 0922cc1d68
133 changed files with 7939 additions and 0 deletions
View File
+46
View File
@@ -0,0 +1,46 @@
# GStreamer-Bündelung Windows (Pin)
ADR-0002. Ziel: portables `runtime/gstreamer` ohne Systeminstallation (PLAN.md §3.1, §30.2).
## Pin
- **Version:** 1.28.6 (aktuelle stabile 1.28-Serie, Stand 2026-09-10, Quelle: <https://gstreamer.freedesktop.org/download/>)
- **Distribution:** offizielle MSVC-Binaries, x86_64 (`gstreamer-1.0-msvc-x86_64-1.28.6.msi`)
- **SHA-256:** nach dem ersten Bündelungs-Build manifestieren (§30.1)
## Minimal gebündelte Plugin-Untermenge (Phase 0)
Ziel: H.264-MP4-Testclip → D3D11-Decode → Compositing → Vollbildausgabe.
| Komponente | Paket | Enthält | Zweck |
| --- | --- | --- | --- |
| libgstreamer-1.0-0.dll | gstreamer core | | Kern |
| coreelements | gst-plugins-core | `filesrc`, `queue`, `decodebin3`-Basen | Container/Datei |
| typefindfunctions | gst-plugins-core | Typenerkennung | MP4-Erkennung |
| isomp4 | gst-plugins-good | `qtdemux` | MP4-Demux |
| videoparsersbad | gst-plugins-bad | `h264parse` | H.264-Parsing vor Decoder |
| playback | gst-plugins-base | `uridecodebin` | bequeme Quelle (Spike) |
| d3d11 | gst-plugins-bad | `d3d11h264dec`, `d3d11h265dec`, `d3d11convert`, `d3d11compositor`, `d3d11videosink` | GPU-Pfad (§12.6) |
| video/x-raw Basen | gst-plugins-base | `videoconvert` (nur Fallback, nicht Normalpfad) | nur Diagnose |
Nicht gebündelt (V1-Spike): Netzwerk-Quellen, NDI, Capture, Software-Codecs außer für expliziten Fallback.
## Umgebungsvariablen beim Start (Launcher, §9.2)
```text
GST_PLUGIN_PATH_1_0=<app>/runtime/gstreamer/lib/gstreamer-1.0
PATH=<app>/runtime/gstreamer/bin;%PATH%
GST_PLUGIN_SYSTEM_PATH_1_0= (leer setzen, um System-Plugins zu unterdrücken)
```
## Validierung
1. Saubere Windows-VM ohne GStreamer (§29.6)
2. `gst-inspect-1.0 d3d11h264dec` muss die Elemente aus dem Bündel listen
3. Testpipeline läuft; GPU-Treiber ist die einzige Systemabhängigkeit
4. MSI-Binärdateien und DLL-Set als SHA-256-Manifest festhalten
## Offene Punkte
- [ ] Bündelungsskript (MSI still entpacken, Untermenge kopieren) Phase-0-Aufgabe mit Packaging-ADR-0005
- [ ] VC-Runtime-Redistributable-Handling → `runtime/vc-runtime` (§9)