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).
2026-09-11 00:36:59 +02:00
commit 0922cc1d68
133 changed files with 7939 additions and 0 deletions
@@ -0,0 +1,22 @@
+"""hms_renderer – Render-Worker-Spike (PLAN.md §6.1C, §12, §36 Nr. 4–6).
+
+Python orchestriert native GStreamer-Komponenten; keine Pixelverarbeitung
+in Python (§2.1, §33). Pipelines werden als gst-launch-Strings definiert
+und auf dem Zielsystem ausgeführt/messbar.
+"""
+
+from hms_renderer.pipelines import (
+    D3D11Pipeline,
+    DevGLPipeline,
+    build_compositor_pipeline,
+    build_single_video_pipeline,
+    gst_available,
+)
+
+__all__ = [
+    "D3D11Pipeline",
+    "DevGLPipeline",
+    "build_single_video_pipeline",
+    "build_compositor_pipeline",
+    "gst_available",
+]
@@ -0,0 +1,52 @@
+"""Renderer-CLI (Phase-0-Spike).
+
+Aufruf:
+    python -m hms_renderer --pipeline d3d11 --video-a A --video-b B
+
+Ohne GStreamer-Installation: kontrollierter Abbruch mit Exit-Code 2 und
+klarer Meldung – niemals Erfolgssimulation (§1.1 Nr. 5, §33).
+"""
+
+from __future__ import annotations
+
+import argparse
+import shutil
+import subprocess
+import sys
+
+from hms_renderer.pipelines import build_compositor_pipeline, build_single_video_pipeline
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = argparse.ArgumentParser(prog="hms-renderer")
+    parser.add_argument("--pipeline", choices=["d3d11", "devgl"], default="d3d11")
+    parser.add_argument("--video-a", required=True)
+    parser.add_argument("--video-b", default=None, help="zweite Quelle für Compositing")
+    parser.add_argument("--dry-run", action="store_true", help="nur Pipeline-String ausgeben")
+    args = parser.parse_args(argv)
+
+    use_d3d11 = args.pipeline == "d3d11"
+    if args.video_b:
+        pipeline = build_compositor_pipeline(args.video_a, args.video_b, d3d11=use_d3d11)
+    else:
+        pipeline = build_single_video_pipeline(args.video_a, d3d11=use_d3d11)
+
+    if args.dry_run:
+        print(pipeline)
+        return 0
+
+    gst_launch = shutil.which("gst-launch-1.0")
+    if gst_launch is None:
+        print(
+            "ERROR: gst-launch-1.0 nicht gefunden. GStreamer 1.28.6 muss gebündelt "
+            "oder installiert sein (build/windows/GSTREAMER.md).",
+            file=sys.stderr,
+        )
+        return 2
+
+    result = subprocess.run([gst_launch, "-v", pipeline], check=False)
+    return result.returncode
+
+
+if __name__ == "__main__":
+    sys.exit(main())
@@ -0,0 +1,79 @@
+"""Renderer-Pipeline-Definitionen (PLAN.md §12, §13, §36 Nr. 4–5).
+
+Windows-Primärpfad (§12.6): d3d11h264dec → D3D11Memory → d3d11compositor
+→ d3d11videosink. Kein CPU-Rundweg (Decoder → RAM → Upload verboten).
+
+DevGL-Pfad: Nur für Entwicklung/CI-Umgebungen ohne D3D11; ausdrücklich
+gekennzeichnet, kein stiller Ersatz im Normalbetrieb (§5.2, §33).
+"""
+
+from __future__ import annotations
+
+import shutil
+from dataclasses import dataclass
+
+
+@dataclass(frozen=True)
+class D3D11Pipeline:
+    """Primärpipeline Windows: durchgängig D3D11Memory."""
+
+    video_a: str
+    video_b: str
+    width: int = 1920
+    height: int = 1080
+    fullscreen: bool = True
+
+    def launch_string(self) -> str:
+        sink = "d3d11videosink fullscreen=true" if self.fullscreen else "d3d11videosink"
+        # Zwei Quellen → Compositor → Ausgabe (§36 Nr. 5: zwei Videos GPU-mischen)
+        return (
+            f"d3d11compositor name=mix sink_0::xpos=0 sink_0::ypos=0 "
+            f"sink_0::width={self.width // 2} sink_0::height={self.height} "
+            f"sink_1::xpos={self.width // 2} sink_1::ypos=0 "
+            f"sink_1::width={self.width // 2} sink_1::height={self.height} ! "
+            f"d3d11convert ! video/x-raw(memory:D3D11Memory),format=RGBA,"
+            f"width={self.width},height={self.height} ! {sink} "
+            f"uridecodebin uri=file:///{self.video_a} ! queue ! "
+            f"d3d11convert ! mix. "
+            f"uridecodebin uri=file:///{self.video_b} ! queue ! "
+            f"d3d11convert ! mix."
+        )
+
+
+@dataclass(frozen=True)
+class DevGLPipeline:
+    """Entwicklungspfad ohne D3D11 (explizit gekennzeichnet, kein Normalpfad).
+
+    Nur für CI/Dev ohne Windows-GPU; die Backend-Schnittstelle bleibt
+    identisch (§12.6)."""
+
+    video_a: str
+    video_b: str
+    width: int = 960
+    height: int = 540
+
+    def launch_string(self) -> str:
+        return (
+            f"glvideomixer name=mix ! glimagesink "
+            f"uridecodebin uri=file:///{self.video_a} ! queue ! glupload ! mix. "
+            f"uridecodebin uri=file:///{self.video_b} ! queue ! glupload ! mix."
+        )
+
+
+def build_single_video_pipeline(video: str, d3d11: bool = True) -> str:
+    """Minimale Einzelquellen-Pipeline (§36 Nr. 4: Testvideo → Vollbild)."""
+    if d3d11:
+        return f"uridecodebin uri=file:///{video} ! d3d11convert ! d3d11videosink fullscreen=true"
+    return f"uridecodebin uri=file:///{video} ! glupload ! glimagesink"
+
+
+def build_compositor_pipeline(video_a: str, video_b: str, d3d11: bool = True) -> str:
+    """Zwei-Quellen-Compositing (§36 Nr. 5: GPU-Mischen ohne CPU-Readback)."""
+    if d3d11:
+        return D3D11Pipeline(video_a=video_a, video_b=video_b).launch_string()
+    return DevGLPipeline(video_a=video_a, video_b=video_b).launch_string()
+
+
+def gst_available() -> bool:
+    """True, wenn ein GStreamer-CLI auf dem System liegt (Diagnose, kein Fake)."""
+    return shutil.which("gst-launch-1.0") is not None