# Configuració de la TitleScene.
# `bg_color` i `text_color` són índexs sobre la paleta "ui" (uzebox.pal):
# 1 = (36,0,0) gairebé negre amb un mínim de càlid; 31 = (255,109,0)
# taronja pur. `duration_ms` és el timeout abans de saltar a la
# següent escena (skipable amb tecla no reservada). Els dos
# `blink_*_ms` defineixen el cicle del prompt "press start": el text
# es veu durant `visible_ms` i s'amaga durant `hidden_ms` repetint-se.
title:
  duration_ms: 30000
  bg_color: 1
  text_color: 31
  # Color del text del © de copyright (peu de la TITLE). Off-white càlid:
  # índex 183 = (255,218,170), tipus crema/peach, ~90% blanc amb tint càlid.
  copyright_color: 183
  # Color de l'outline del prompt "PRESS START". Marró fosc càlid (índex
  # 19 = 109,72,0), coherent amb la paleta del logo. Es manté separat de
  # `copyright_color` perquè l'outline i el text del © tenen rols visuals
  # diferents (contrast vs. peu informatiu).
  press_start_outline_color: 19
  # Posicions Y dels tres elements verticals de la TITLE, en percentatge
  # sobre l'alçada del canvas (240 px). El logo s'ancora pel seu top
  # (la imatge cau cap avall des d'aquest Y); el prompt i el copyright
  # es centren verticalment sobre la línia.
  logo_y_percent: 15
  prompt_y_percent: 68
  copyright_y_percent: 92
  # Separació vertical en píxels entre el minilogo i el text del © al peu.
  mini_logo_gap_px: 2
  blink_visible_ms: 800
  blink_hidden_ms: 200
  # Fase STARTING (entre la primera pulsació de START i el salt a la
  # següent escena). `starting_ms` és la durada fixa; durant aquesta
  # fase el parpadeig accelera per `starting_blink_speedup` (2.0 = doble
  # de freqüència). Si l'altre jugador prem START dins d'aquesta
  # finestra, el comptador es reseteja i s'arrenca amb BOTH.
  starting_ms: 3000
  # Durant STARTING el prompt commuta a un cicle simètric 50/50
  # (visible/ocult) amb aquest període total. 200 ms = 5 Hz, prou
  # ràpid per llegir-se com a "pulsació confirmada".
  starting_blink_period_ms: 200
  # Fade-out estil "mosaic dissolve" durant l'última part de STARTING.
  # `fade_out_ms` ha de ser <= starting_ms (els últims X ms del STARTING
  # es fan amb el dissolve actiu fins a quedar negre). `fade_out_max_block`
  # és la mida màxima de bloc en píxels al final del fade.
  fade_out_ms: 800
  fade_out_max_block: 32
  # Fade-out de `title.ogg` en entrar a STARTING. Independent del visual:
  # la música pot acabar abans o després del mosaic dissolve.
  music_fade_out_ms: 3000
  # Fade-to-black per a la sortida d'attract (timeout cap a LOGO). NO és
  # mosaic — capa negra lineal damunt del canvas. La música no es toca:
  # `title.ogg` continua sonant cap a LOGO, que ja veurà què en fa.
  attract_fade_to_black_ms: 800
  # Seqüència d'aparició dels elements de la TITLE en fase IDLE. Tots
  # els temps són absoluts des de l'entrada a l'escena. `fade_in_ms` és
  # la capa negra inicial que s'esvaeix cap al fons; els altres marquen
  # quan apareix cada element. Si l'usuari prem START en qualsevol
  # moment, la seqüència es completa instantàniament.
  intro:
    fade_in_ms: 500            # fade-in negre inicial sobre el fons
    game_logo_at_ms: 1500      # visibilitat binària del game_logo
    mini_logo_at_ms: 2000      # inici del slide-in del mini-logo
    mini_logo_slide_ms: 500    # durada del slide
    copyright_at_ms: 2200      # inici del slide-in del copyright
    copyright_slide_ms: 500    # durada del slide
    slide_curve: outCubic      # corba compartida per mini_logo i copyright
    press_start_at_ms: 3000    # quan apareix PRESS START amb parpadeig
  # Distorsió sinusoidal del fons (efecte de calor del desert).
  # `amplitude_px`: desplaçament màxim de cada fila en píxels.
  # `wavelength_px`: distància vertical entre dos pics de l'ona.
  # `speed_hz`: velocitat amb què avança la fase (cicles per segon).
  # Si `enabled` és false, el fons es pinta sense distorsió.
  heat_haze:
    enabled: true
    amplitude_px: 1.5
    wavelength_px: 32.0
    speed_hz: 0.6