Flixy heißt ab hier Halo

Reine Umbenennung, kein Verhalten geändert — bewusst als eigener Commit, damit „umbenannt" und „umgebaut" im Nachhinein auseinanderzuhalten sind. 712 mal `Flixy`, 778 mal `flixy`, 7 mal `FLIXY` in 169 Dateien, dazu 25 Pfade. Ziele: `Halo`, `HaloTV`, `HaloTopShelf`, `HaloUITests`, `HaloKit` mit `HaloDesign`, `HaloDownloads`, `HaloPlayback` und `HaloProbe`. `MediaKit`, `JellyfinKit` und `DownloadWidget` tragen den Namen nicht und bleiben. `docs/superpowers/specs/` ist ausgenommen. Datierte Entwurfsdokumente sind ein Protokoll getroffener Entscheidungen; sie nachträglich umzuschreiben hiesse, die Vergangenheit zu glätten. **Die Bundle-ID wandert mit** — ausdrücklich so gewollt, mit bekanntem Preis: `com.scarriffleservices.halo` ist für iOS eine *andere* App. Die installierte Fassung bleibt daneben stehen, mit Downloads und Anmeldung in ihrem Container; Halo startet leer. Einmal neu anmelden, heruntergeladene Folgen einmal neu laden. Dasselbe gilt für die App-Gruppe, die sich TV-App und Top Shelf teilen. **Eine Folge davon, die beim Entscheiden noch nicht auf dem Tisch lag:** der Aufräumschritt aus dem vorigen Commit kommt an die alten Plex-Token nicht mehr heran. Der Schlüsselbund grenzt nach Team und Bundle-Kennung ab — was unter `…flixy` liegt, ist für `…halo` unerreichbar. Erledigt wird es trotzdem, nur anders: **die alte App löschen.** iOS räumt deren Schlüsselbund-Einträge beim Deinstallieren mit ab. Der Code bleibt stehen, weil er für jeden Stand vor dieser Umbenennung richtig ist und im Jahr einen Startvergleich kostet. Die Projektdatei ist aus `project.yml` neu erzeugt, der alte Ordner gelöscht statt umbenannt — sie steht ohnehin nicht im Repo. Das Verzeichnis des Repos selbst heißt weiter `Flixy`; das umzubenennen ist ein Handgriff ausserhalb des Projekts. 368 Tests grün. iOS und tvOS bauen. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-10-03 11:12:32 +02:00
parent 2fcf6821c8
commit 4b9a1e7b67
280 changed files with 1456 additions and 1456 deletions
@@ -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:))
+    }
+}