Animaciones de valor

Los tres animadores interpolan un número a lo largo del tiempo. No dibujan nada: en el onUpdate lees getValue() y lo aplicas donde quieras (alpha, posición, color…). Como el render es bajo demanda, llama Component.repaint() en el callback.

Comparación

Ejemplo completo (copiar, pegar y ejecutar)

package com.exemplo;

import dev.crossfly.ui.*;
import dev.crossfly.ui.layout.*;
import dev.crossfly.ui.animation.*;   // AlphaAnimation, PositionAnimation, LoopAnimation
import dev.crossfly.util.*;           // Debug

/** Pantalla principal ejecutable. Apunta el launcher (classname) y corre: gradlew :lwjgl3:run */
public class MainWindow extends Window
{
   @Override
   public void onShow() throws Exception
   {
      super.onShow();
      setLayout(new VerticalLayout());

      // AlphaAnimation — fade-in de una etiqueta (0→1 en 0,3s)
      Label card = new Label("Olá");
      add(LAY_AUTO, card);
      AlphaAnimation fade = new AlphaAnimation(0f, 1f, 0.3f);
      fade.onUpdate(() -> { card.alpha(fade.getValue()); Component.repaint(); })
          .onComplete(() -> Debug.log("fade concluído"))
          .start();

      // PositionAnimation — desliza un panel entrando por la derecha (en píxeles, libre)
      Label painel = new Label("Painel");
      add(LAY_AUTO, painel);
      int y0 = painel.y, w = painel.width, h = painel.height;
      PositionAnimation slide = new PositionAnimation(Screen.width, 0, 0.4f);
      slide.onUpdate(() -> { painel.setBounds((int) slide.getValue(), y0, w, h); Component.repaint(); })
           .start();

      // LoopAnimation — pulso continuo de opacidad (ciclo de 1s, suavizado, infinito)
      Label ponto = new Label("●");
      add(LAY_AUTO, ponto);
      LoopAnimation pulse = new LoopAnimation(1.0f, 60f, true);
      pulse.onUpdate(() -> { ponto.alpha(0.4f + 0.6f * pulse.getValue()); Component.repaint(); })
           .start();
   }
}

Los fragmentos siguientes muestran solo el núcleo (lo que va dentro de onShow()). Para ejecutar, colócalos en el esqueleto MainWindow de arriba.

AlphaAnimation — fade-in

Label card = new Label("Olá");
AlphaAnimation fade = new AlphaAnimation(0f, 1f, 0.3f);   // 0→1 en 0,3s
fade.onUpdate(() -> { card.alpha(fade.getValue()); Component.repaint(); })
    .onComplete(() -> Debug.log("fade concluído"))
    .start();

Constructores: AlphaAnimation(start, end, duration) (60 FPS) o (start, end, duration, fps).

PositionAnimation — deslizar un panel (en píxeles)

int y0 = painel.y, w = painel.width, h = painel.height;
PositionAnimation slide = new PositionAnimation(Screen.width, 0, 0.4f);  // entra desde la derecha
slide.onUpdate(() -> { painel.setBounds((int) slide.getValue(), y0, w, h); Component.repaint(); })
     .start();

No está limitado a [0,1] y es lineal — ideal para coordenadas.

LoopAnimation — pulso continuo

LoopAnimation pulse = new LoopAnimation(1.0f, 60f, true);   // ciclo de 1s, 60 FPS, suavizado
pulse.onUpdate(() -> { float v = 0.4f + 0.6f * pulse.getValue(); ponto.alpha(v); Component.repaint(); })
     .start();
// pulse.stop();   // detén al salir de la pantalla

Constructores: LoopAnimation(duration) (lineal, 60 FPS) o (duration, fps, easeInOut). No tiene onComplete (corre para siempre hasta stop()).

Control común

start() · stop() (dispara onComplete en Alpha/Position) · cancel() (no dispara) · isRunning() · getValue().

Buenas prácticas

• Siempre Component.repaint() en el onUpdate — el render es bajo demanda.
• Detén los loops (stop()) al salir de la pantalla (en onRemove()), si no el Timer sigue corriendo.
• Guarda la animación en una variable/campo para poder stop()/cancel() después.

Errores comunes

• Usar PositionAnimation esperando el rango [0,1] — es libre; quien hace clamp es AlphaAnimation.
• Olvidar el repaint() y “la animación no aparece”.
• Llamar setAlpha(...) (del Javadoc antiguo) — el método real es alpha(float).

Véase también

• Transiciones de pantalla · Toque y feedback