Untertitel lassen sich jetzt einstellen

Groesse in vier Stufen, Schrift und Hintergrund als fuenf feste Paare —
Weiss, Weiss auf Schwarz, Schwarz auf Weiss, Gelb, Gelb auf Schwarz. Feste
Paare statt zweier Regler, weil unabhaengige Achsen unlesbare Mischungen
zulassen: Schwarz auf durchsichtig ueber einer Nachtszene ist eine
gueltige Einstellung und eine wertlose.

Die Uebersetzung nach AVFoundation ist eine Tabelle aus Schluesseln, bei
der jeder Fehler lautlos ist — ein falscher Schluessel laesst den
Initialisierer `nil` zurueckgeben, und dann gibt es gar keine Regel. Auf
dem Bildschirm sieht „keine Regel\" genauso aus wie „Regel ohne Wirkung\".
Zehn Tests decken das ab, darunter die drei Fallen: Alpha zuerst in der
Farbe, Prozentwert statt Punktgroesse, und der Hintergrund auch fuer
„durchsichtig\" ausdruecklich gesetzt statt weggelassen — weggelassen gilt
sonst, was Jellyfins WebVTT selbst mitbringt, und das ist oft ein
schwarzer Kasten.

Als Protokollmethode, nicht als Feld an `PlaybackSource`: die wird einmal
beim Oeffnen gelesen, und eine Einstellung, die erst beim naechsten Film
wirkt, haelt jeder fuer kaputt. Angewandt wird an zwei Stellen — am
laufenden Gegenstand und am frisch angelegten. Nur das erste zu tun hiesse,
dass die naechste Folge wieder in der Vorgabe erscheint.

VLC erbt die leere Vorgabe. Die Einstellungsseite sagt beides: dass es fuer
den Standardplayer gilt, und dass eingebrannte Bilduntertitel von Blu-rays
sich nicht gestalten lassen, weil es dort keinen Text gibt.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Packages/FlixyKit/Sources/FlixyPlayback/Engine/SubtitleStyle+AVFoundation.swift

@@ -0,0 +1,45 @@
+import AVFoundation
+import CoreMedia
+import Foundation
+
+public extension SubtitleStyle {
+    /// Die Regeln, wie AVFoundation sie erwartet.
+    ///
+    /// **Vier Fallen stecken hier drin, und jede ist lautlos:**
+    ///
+    /// 1. **Die Farbe ist ein Feld aus vier Zahlen von 0 bis 1, Alpha
+    ///    zuerst** — A, R, G, B. Kein `CGColor`, kein `UIColor`; ein solcher
+    ///    wird ohne Fehlermeldung ignoriert.
+    /// 2. **Die Grösse ist ein Prozentwert**, hundert heisst unverändert.
+    ///    `BaseFontSizePercentageRelativeToVideoHeight` **nicht** zusätzlich
+    ///    setzen — die beiden beziehen sich auf Verschiedenes und streiten
+    ///    sich.
+    /// 3. **Den Hintergrund immer setzen, auch für „durchsichtig".** Ihn
+    ///    wegzulassen ist nicht dasselbe wie Alpha null: dann gilt, was der
+    ///    Untertitel selbst mitbringt, und Jellyfins WebVTT bringt oft einen
+    ///    schwarzen Kasten mit.
+    /// 4. **`AVTextStyleRule(textMarkupAttributes:)` kann fehlschlagen.** Ein
+    ///    falscher Schlüssel ergibt `nil` — und damit gar keine Regel, ohne
+    ///    dass irgendwo etwas auffiele. Genau dafür gibt es den Test.
+    var textStyleRules: [AVTextStyleRule] {
+        var attribute: [String: Any] = [
+            kCMTextMarkupAttribute_ForegroundColorARGB as String: foreground.argb,
+            kCMTextMarkupAttribute_BackgroundColorARGB as String: background.argb,
+            kCMTextMarkupAttribute_RelativeFontSize as String: Double(size.rawValue),
+        ]
+
+        if wantsEdgeShadow {
+            attribute[kCMTextMarkupAttribute_CharacterEdgeStyle as String] =
+                kCMTextMarkupCharacterEdgeStyle_DropShadow as String
+        }
+
+        return [AVTextStyleRule(textMarkupAttributes: attribute)].compactMap(\.self)
+    }
+}
+
+extension SubtitleStyle.RGBA {
+    /// Alpha zuerst — die Reihenfolge, die CoreMedia verlangt.
+    var argb: [NSNumber] {
+        [alpha, red, green, blue].map(NSNumber.init(value:))
+    }
+}