fortunecookie/assets/ASSET_REQUIREMENTS.md

📁 FortuneCookie - Asset Anforderungen

Version: 1.0.1 Datum: 02.06.2026 Zweck: Spezifikationen für Grafik-Assets (Hintergründe, Logos, Icons)

---

🎨 Allgemeine Anforderungen

Dateiformate

Asset-Typ	Empfohlen	Alternative	Grund
Hintergründe	.png	.jpg	Transparenz möglich, gute Qualität
Logos	.png	.svg	Transparenz, scharfe Kanten
Icons	.png	-	Konsistenz mit bestehenden Assets

Dateinamen-Konventionen

• Nur Kleinbuchstaben (z. B. background_70s.png, nicht Background_70s.PNG)
• Bindestriche statt Leerzeichen (z. B. seventies-style.png, nicht seventies style.png)
• Keine Umlaute/Sonderzeichen (z. B. esoteric.png, nicht esoterisch.png)
• Keine Versionen in Dateinamen (z. B. logo.png, nicht logo_v2_final.png)

---

📏 Größen & Auflösungen

Hintergründe

• Abmessungen: 1080 × 1920 Pixel (Full HD, 16:9)
• QML-Einheit: 45 GU (Breite) × 75 GU (Höhe) = 1080×1920 px
• Dateigröße: Max. 500 KB pro Bild
• Farbraum: RGB
• Transparenz: Optional (PNG unterstützt Alpha-Kanal)

Benötigte Varianten:

assets/backgrounds/
├── 70s.png          # 70er-Jahre Stil (Disco, Retro)
├── esoteric.png     # Esoterisch (Mystik, Tarot, spirituell)
└── heavenly.png     # Himmelisch (Wolken, Engel, Licht)

Logos

• Haupt-Logo (Startseite): 240 × 240 Pixel (ca. 30 GU × 30 GU)
• Button-Icon (Musik): 80 × 80 Pixel (ca. 10 GU × 10 GU)
• Dateigröße: Max. 200 KB pro Logo
• Transparenz: Pflicht (PNG mit Alpha-Kanal)
• Farbraum: RGB

Benötigte Varianten:

assets/logos/
├── default.png      # Standard Logo (Glückskeks)
├── 70s.png          # 70er-Jahre Stil (passend zu Hintergrund)
├── esoteric.png     # Esoterisch (passend zu Hintergrund)
├── heavenly.png     # Himmelisch (passend zu Hintergrund)
└── unfortune.png    # Gothic/Dark (Totenköpfe, Lilafarben, Blitze)

Icons

• Musik-Button: Emoji (🎵/🔇) oder PNG (80×80 px)
• Dateigröße: Max. 50 KB
• Transparenz: Pflicht

---

📂 Verzeichnis-Struktur

fortunecookie-neu/
└── testing/
    └── assets/
        │
        ├── ASSET_REQUIREMENTS.md    # ← Diese Datei
        │
        ├── backgrounds/              # Hintergrundbilder (Full HD)
        │   ├── 70s.png
        │   ├── esoteric.png
        │   └── heavenly.png
        │
        ├── logos/                   # Logos (240×240 px, transparent)
        │   ├── default.png
        │   ├── 70s.png
        │   ├── esoteric.png
        │   ├── heavenly.png
        │   └── unfortune.png
        │
        └── sounds/                  # Bestehend
            ├── chinese_music.mp3
            └── cookie_crack.mp3

---

⚠️ WICHTIGE HINWEISE für Ubuntu Touch

1. QML-Kompatibilität

• SVG-Unterstützung: Begrenzt in Lomiri/QML - PNG bevorzugen
• Transparenz: Funktioniert mit PNG (Alpha-Kanal)
• Skalierung: Bilder werden automatisch skaliert, aber native Auflösung empfohlen

2. QML-Integration

Hintergründe einbinden:

Image {
    id: background
    anchors.fill: parent
    source: Qt.resolvedUrl("../assets/backgrounds/70s.png")
    fillMode: Image.PreserveAspectCrop
}

Logos einbinden:

Image {
    id: logo
    width: units.gu(30)
    height: units.gu(30)
    source: Qt.resolvedUrl("../assets/logos/70s.png")
    fillMode: Image.PreserveAspectFit
}

3. Performance

• Maximale Dateigröße: 1 MB pro Asset (Click-App Limit)
• Optimierung: Bilder vor dem Einbinden mit optipng oder pngquant komprimieren
• Anzahl: Max. 20-30 Assets pro App (für schnelles Laden)

---

🎯 Nächste Schritte (Phase 1)

1. Erstelle die Bilder according to den Spezifikationen
2. Speichere sie im richtigen Verzeichnis (assets/backgrounds/ und assets/logos/)
3. Benenne sie nach der Konvention
4. Informiere mich - ich baue die Auswahl-Funktionalität in die Einstellungen ein

---

📞 Support

Fragen zu den Anforderungen? → einfach fragen oder in den entsprechenden Kanälen nachfragen.