# 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)