fase 2: fades de jd8 a màquina d'estats i helper wait_frame_or_skip a les cinemàtiques

source/core/jail/jdraw8.hpp

@@ -50,10 +50,21 @@ void JD8_PutPixel(JD8_Surface surface, int x, int y, Uint8 pixel);
 
 void JD8_SetPaletteColor(Uint8 index, Uint8 r, Uint8 g, Uint8 b);
 
+// Fades legacy bloquejants (shim damunt la màquina d'estats de sota).
 void JD8_FadeOut();
-
 void JD8_FadeToPal(JD8_Palette pal);
 
+// API de fade no bloquejant (màquina d'estats). `FadeStart*` inicia el
+// fade; `FadeTickStep` aplica un pas i retorna `true` quan el fade ha
+// acabat. Un pas correspon visualment a una iteració del fade original
+// (32 passos en total). El caller és responsable de fer el Flip entre
+// passos si el vol veure animat. `FadeIsActive` permet saber si hi ha
+// un fade en curs per a enllaçar-lo amb un altre subsistema.
+void JD8_FadeStartOut();
+void JD8_FadeStartToPal(JD8_Palette pal);
+bool JD8_FadeTickStep();
+bool JD8_FadeIsActive();
+
 // JD_Font JD_LoadFont( char *file, int width, int height);
 
 // void JD_DrawText( int x, int y, JD_Font *source, char *text);