time-based: migrada escena Intro (dual-API a MovingSprite/SmartSprite/Writer, constants a 60Hz)

source/core/rendering/writer.h

@@ -8,19 +8,23 @@ class Writer {
    public:
     explicit Writer(Text *text);  // Constructor
 
-    void update();  // Actualiza el objeto
-    void render();  // Dibuja el objeto en pantalla
+    void update();            // Actualiza el objeto (frame-based)
+    void update(float dt_s);  // Actualiza el objeto (time-based)
+    void render();            // Dibuja el objeto en pantalla
 
     void setPosX(int value);                       // Establece el valor de la variable
     void setPosY(int value);                       // Establece el valor de la variable
     void setKerning(int value);                    // Establece el valor de la variable
     void setCaption(const std::string &text);      // Establece el valor de la variable
-    void setSpeed(int value);                      // Establece el valor de la variable
+    void setSpeed(int value);                      // Establece el valor de la variable (frame-based: frames per caracter)
+    void setSecondsPerChar(float seconds);         // Time-based: segons per caracter
     void setEnabled(bool value);                   // Establece el valor de la variable
     [[nodiscard]] auto isEnabled() const -> bool;  // Obtiene el valor de la variable
 
-    void setEnabledCounter(int time);                     // Establece el valor de la variable
-    [[nodiscard]] auto getEnabledCounter() const -> int;  // Obtiene el valor de la variable
+    void setEnabledCounter(int time);                      // Establece el valor de la variable (frame-based)
+    [[nodiscard]] auto getEnabledCounter() const -> int;   // Obtiene el valor de la variable
+    void setRemainingTime(float seconds);                  // Time-based: temps despres de completar
+    [[nodiscard]] auto getRemainingTime() const -> float;  // Time-based: temps restant
 
     void center(int x);                              // Centra la cadena de texto a un punto X
     [[nodiscard]] auto hasFinished() const -> bool;  // Obtiene el valor de la variable
@@ -30,16 +34,19 @@ class Writer {
     Text *text_;  // Objeto encargado de escribir el texto
 
     // Variables
-    int pos_x_{0};            // Posicion en el eje X donde empezar a escribir el texto
-    int pos_y_{0};            // Posicion en el eje Y donde empezar a escribir el texto
-    int kerning_{0};          // Kerning del texto, es decir, espaciado entre caracteres
-    std::string caption_;     // El texto para escribir
-    int speed_{0};            // Velocidad de escritura
-    int writing_counter_{0};  // Temporizador de escritura para cada caracter
-    int index_{0};            // Posición del texto que se está escribiendo
-    int length_{0};           // Longitud de la cadena a escribir
-    bool completed_{false};   // Indica si se ha escrito todo el texto
-    bool enabled_{false};     // Indica si el objeto está habilitado
-    int enabled_counter_{0};  // Temporizador para deshabilitar el objeto
-    bool finished_{false};    // Indica si ya ha terminado
+    int pos_x_{0};                  // Posicion en el eje X donde empezar a escribir el texto
+    int pos_y_{0};                  // Posicion en el eje Y donde empezar a escribir el texto
+    int kerning_{0};                // Kerning del texto, es decir, espaciado entre caracteres
+    std::string caption_;           // El texto para escribir
+    int speed_{0};                  // Velocidad d'escriptura (frame-based: frames per caracter)
+    int writing_counter_{0};        // Temporizador d'escriptura per cada caracter (frame-based)
+    float seconds_per_char_{0.0F};  // Time-based: segons per caracter
+    float char_timer_s_{0.0F};      // Time-based: acumulador d'avanç de caracter
+    int index_{0};                  // Posición del texto que se está escribiendo
+    int length_{0};                 // Longitud de la cadena a escribir
+    bool completed_{false};         // Indica si se ha escrito todo el texto
+    bool enabled_{false};           // Indica si el objeto está habilitado
+    int enabled_counter_{0};        // Temporizador per a deshabilitar el objecte (frame-based)
+    float remaining_time_s_{0.0F};  // Temps restant per a deshabilitar (time-based)
+    bool finished_{false};          // Indica si ya ha terminado
 };