ScarriffleandClaude Opus 5
0815432efd
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>
46 lines
1.9 KiB
Swift
46 lines
1.9 KiB
Swift
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:))
|
|
}
|
|
}
|