import Foundation
import FlixyDesign
import MediaKit

/// Woher der Aufmacher seine Bilder nimmt.
///
/// An **einer** Stelle, weil zwei Stellen es schon zweimal falsch gemacht
/// haben:
///
/// Erstens wurde das Hintergrundbild in 900×1200 angefordert — hochkant — und
/// dann in einem 16:9-Rahmen gezeigt. Zu sehen war davon ein schmaler Streifen
/// aus der Mitte; vom Bild fehlte oben und unten je ein Drittel. Die Maße
/// richten sich jetzt nach dem Rahmen, in dem das Bild landet.
///
/// Zweitens holt das Karussell das nächste Bild vor, solange das aktuelle noch
/// steht. Weicht dessen Adresse auch nur in einer Zahl ab, ist es eine andere
/// Adresse, der Zwischenspeicher trifft daneben und der Aufmacher blendet auf
/// eine graue Fläche über.
enum HeroArtwork {
    /// Die Maße, in denen das Bild angefordert wird.
    ///
    /// Im Seitenverhältnis des Rahmens, in dem es landet — sonst schneidet der
    /// Server zu, und man sieht einen Streifen aus der Mitte.
    static func size(compact: Bool) -> (width: Int, height: Int) {
        compact ? (600, 900) : (1920, 1080)
    }

    static func aspectRatio(compact: Bool) -> CGFloat {
        compact ? FlixyAspectRatio.poster : FlixyAspectRatio.hero
    }

    /// Auf einem schmalen Bildschirm das **Plakat**, sonst das Hintergrundbild.
    ///
    /// Ein Hintergrundbild ist 16:9. Hochkant gezeigt fehlen ihm links und
    /// rechts je ein Viertel, und zu sehen ist ein Ausschnitt aus der Mitte —
    /// vom Bild bleibt wenig übrig. Ein Plakat ist von vornherein hochkant;
    /// es passt in den Rahmen, ohne dass etwas weggeschnitten werden muss.
    static func backdropURL(for item: MediaItem, backend: any MediaBackend, compact: Bool) -> URL? {
        let size = size(compact: compact)
        let path = compact
            ? (item.posterArtworkPath ?? item.art)
            : (item.art ?? item.seriesArt ?? item.thumb)
        return backend.artworkURL(path: path, width: size.width, height: size.height)
    }

    /// Der freigestellte Schriftzug — ohne Bild-Transcoder.
    ///
    /// Er ist ein PNG mit durchsichtigem Grund, und der Transcoder liefert
    /// JPEG. Aus dem Schriftzug würde sonst ein schwarzer Kasten.
    static func logoURL(for item: MediaItem, backend: any MediaBackend) -> URL? {
        backend.rawImageURL(path: item.clearLogoPath)
    }
}