Animações de valor

Os três animadores interpolam um número ao longo do tempo. Eles não desenham nada: no onUpdate você lê getValue() e aplica onde quiser (alpha, posição, cor…). Como o render é sob demanda, chame Component.repaint() no callback.

Comparação

Exemplo completo (copiar, colar e rodar)

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

/** Tela principal executável. Aponte o launcher (classname) e rode: gradlew :lwjgl3:run */
public class MainWindow extends Window
{
   @Override
   public void onShow() throws Exception
   {
      super.onShow();
      setLayout(new VerticalLayout());

      // AlphaAnimation — fade-in de um rótulo (0→1 em 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 um painel entrando pela direita (em pixels, livre)
      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 contínuo de opacidade (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();
   }
}

Os trechos abaixo mostram só o miolo (o que vai dentro de onShow()). Para rodar, coloque-os no esqueleto MainWindow acima.

AlphaAnimation — fade-in

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

Construtores: AlphaAnimation(start, end, duration) (60 FPS) ou (start, end, duration, fps).

PositionAnimation — deslizar um painel (em pixels)

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

Não é limitado a [0,1] e é linear — ideal para coordenadas.

LoopAnimation — pulso contínuo

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();   // pare quando sair da tela

Construtores: LoopAnimation(duration) (linear, 60 FPS) ou (duration, fps, easeInOut). Não tem onComplete (roda para sempre até stop()).

Controle comum

start() · stop() (dispara onComplete no Alpha/Position) · cancel() (não dispara) · isRunning() · getValue().

Boas práticas

• Sempre Component.repaint() no onUpdate — o render é sob demanda.
• Pare loops (stop()) ao sair da tela (em onRemove()), senão o Timer segue rodando.
• Guarde a animação numa variável/campo para poder stop()/cancel() depois.

Erros comuns

• Usar PositionAnimation esperando faixa [0,1] — ela é livre; quem clampa é AlphaAnimation.
• Esquecer o repaint() e “a animação não aparece”.
• Chamar setAlpha(...) (do Javadoc antigo) — o método real é alpha(float).

Veja também

• Transições de tela · Toque e feedback