Proceso de creación de animación de velas (Candlestick) en Remotion
Esta skill documenta el proceso completo de creación de un gráfico de velas del S&P 500 en el proyecto Remotion vibe-motion-app.
Requisitos previos
- Proyecto Remotion 4.0.438 con React 19 + TailwindCSS v4
- Arquitectura de plugins:
motion/define escenas,remotion/maneja la tubería de composición de Remotion pnpmcomo gestor de paquetes
Paso 1: Obtener datos financieros
Yahoo Finance proporciona datos OHLC históricos gratuitos (sin necesidad de clave API).
Crear scripts/fetch-sp500-data.mjs:
// Núcleo: llamar a la API de Yahoo Finance Chart
const url = `https://query1.finance.yahoo.com/v8/finance/chart/%5EGSPC?period1=${PERIOD1}&period2=${PERIOD2}&interval=1wk`;
const resp = await fetch(url);
const json = await resp.json();
const result = json.chart?.result?.[0];
const ts = result.timestamp;
const quote = result.indicators.quote[0];
// Extraer { t: timestamp, o: open, h: high, l: low, c: close }
Guardar en public/data/sp500-weekly.json, para que Remotion lo cargue mediante staticFile().
Parámetros:
%5EGSPC= Símbolo de Yahoo para el S&P 500 (^GSPCcodificado como URL)interval=1wk= Semanal; opciones:1d,1moperiod1/period2= Marcas de tiempo Unix, cubriendo aproximadamente 40 años (1984-2026)
Paso 2: Crear la estructura de archivos del plugin
Cada plugin de Remotion necesita 4 archivos principales + una preconfiguración de renderizado:
motion/nombre-del-plugin/
config.js → Parámetros por defecto
timeline.js → Contexto de escena + cálculo de animación fotograma a fotograma
Scene.jsx → Componente React (dibujo en Canvas)
plugin.js → Objeto de registro del plugin
render-presets/
default.json → Preconfiguración de renderizado
2a. config.js — Parámetros por defecto
export const DEFAULT_LAYOUT_PARAMS = Object.freeze({
videoWidth: 1920, // 16:9 horizontal
videoHeight: 1080,
});
export const DEFAULT_ANIMATION_PARAMS = Object.freeze({
durationSeconds: 28, // Duración total de la animación
title: "S&P 500",
subtitle: "Últimos 40 años · Velas semanales",
});
export const DEFAULT_MOTION_PROPS = Object.freeze({
...DEFAULT_LAYOUT_PARAMS,
...DEFAULT_ANIMATION_PARAMS,
});
2b. timeline.js — Lógica de animación
Debe implementar tres funciones principales:
// 1. Contexto de escena: validar + forzar conversión de tipos de todos los parámetros
export const resolveXxxSceneContext = (pluginParams) => { ... }
// 2. Cálculo de duración: durationSeconds * fps
export const getXxxDurationInFrames = ({ fps, sceneContext }) => { ... }
// 3. Props fotograma a fotograma: calcular progress y otros valores de animación a partir de frame/fps
export const buildXxxSceneProps = ({ frame, fps, loop, sceneContext }) => { ... }
Principio de diseño clave: todo el estado de la animación depende únicamente del parámetro frame, cumpliendo con el requisito de renderizado paralelo de Remotion.
2c. Scene.jsx — Componente de dibujo en Canvas
Usar <canvas> en lugar de muchos elementos DOM para un mejor rendimiento.
Modo de carga de datos:
const [dataHandle] = useState(() => delayRender("Cargando datos"));
useEffect(() => {
fetch(staticFile("data/xxx.json"))
.then(r => r.json())
.then(data => { setData(data); continueRender(dataHandle); })
.catch(err => cancelRender(err));
}, [dataHandle]);
Lógica principal de dibujo en Canvas:
const draw = useCallback(() => {
const ctx = canvas.getContext("2d");
const dpr = window.devicePixelRatio || 1;
// Adaptación a pantallas de alta resolución
canvas.width = W * dpr;
canvas.height = H * dpr;
ctx.setTransform(dpr, 0, 0, dpr, 0, 0);
// 1. Relleno de fondo
// 2. Líneas de cuadrícula + escala de precios en el eje Y
// 3. Dibujo de velas (mecha + cuerpo)
// 4. Etiquetas de año en el eje X
// 5. Título/subtítulo/información estadística
// 6. Barra de progreso
}, [data, progress, ...]);
useEffect(() => { draw(); }, [draw]);
Parámetros clave para el dibujo de velas:
const CANDLE_GAP_RATIO = 0.28; // Proporción de espacio entre velas
const CANDLE_FADE_FRAMES = 22; // Fotogramas de animación de entrada
const MAX_CANDLE_W = 8; // Ancho máximo de vela (después de escalar)
const MIN_CANDLE_W = 0.6; // Ancho mínimo de vela
// El ancho de la vela se adapta según el número visible
const slotW = plotWidth / visibleCount;
const bodyW = Math.max(MIN_CANDLE_W, Math.min(MAX_CANDLE_W * scale, slotW * (1 - GAP_RATIO)));
Animación de entrada (fade-in + crecimiento desde abajo):
const appearFrame = (i / (N - 1)) * revealEndFrame;
const candleAge = currentFrame - appearFrame;
const fadeAlpha = Math.min(1, Math.max(0, candleAge / CANDLE_FADE_FRAMES));
// Animación de crecimiento
if (candleAge < CANDLE_FADE_FRAMES && candleAge > 0) {
const growT = easeOutCubic(candleAge / CANDLE_FADE_FRAMES);
displayBodyBottom = lerp(lowY, bodyBottom, growT);
}
ctx.globalAlpha = fadeAlpha;
// ... dibujar mecha + cuerpo ...
ctx.globalAlpha = 1;
Colores del tema oscuro:
const COLORS = {
bg: "#1a1a19",
grid: "#2c2c2a",
upBorder: "#e66767", // Borde de vela alcista (rojo)
upFill: "rgba(230,103,103,0.15)", // Relleno de vela alcista (semitransparente)
downFill: "#199e70", // Relleno de vela bajista (verde)
textPrimary: "#ffffff",
textSecondary: "#c3c2b7",
textMuted: "#898781",
accent: "#3987e5",
};
2d. plugin.js — Registro del plugin
export const xxxPlugin = Object.freeze({
id: "ID-del-plugin",
defaultProps: DEFAULT_MOTION_PROPS,
SceneComponent: XxxScene,
waitForSceneLayoutReady: true, // Esperar a que los datos se carguen
resolveSceneContext: (params) => ...,
getDurationInFrames: ({ fps, sceneContext }) => ...,
buildSceneProps: ({ frame, fps, loop, sceneContext }) => ...,
getLayout: ({ sceneContext }) => sceneContext.layout,
});
waitForSceneLayoutReady: true asegura que el componente Scene llame a onAutoLayoutReady() antes de comenzar a renderizar fotogramas.
2e. render-presets/default.json
{
"title": "S&P 500",
"subtitle": "Últimos 40 años · Velas semanales",
"videoWidth": 1920,
"videoHeight": 1080,
"durationSeconds": 28
}
Paso 3: Registrar la composición
Modificar motion/project.js para cambiar ACTIVE_COMPOSITION al nuevo plugin:
import { xxxPlugin } from "./xxx/plugin.js";
export const ACTIVE_COMPOSITION = Object.freeze({
id: "SP500Kline",
fps: 30,
plugin: xxxPlugin,
});
Paso 4: Verificar y renderizar
# Verificar el registro de la composición
pnpm run remotion:compositions
# Iniciar vista previa en Studio (compatible con arrastre en la línea de tiempo, ajuste de parámetros)
pnpm run dev
# Renderizar una captura de un solo fotograma
npx remotion still SP500Kline out/frame.png --frame=420
# Renderizar el vídeo completo
npx remotion render SP500Kline out/output.mp4
# Renderizar usando preconfiguración
REMOTION_PROPS_FILE=motion/xxx/render-presets/default.json pnpm run remotion:render
Preguntas frecuentes
Problema de CORS con la API de Yahoo Finance
En el entorno de renderizado de Remotion (navegador sin cabeza Node.js) no existe problema de CORS.
Si la vista previa en el navegador encuentra CORS, usa staticFile() para cargar el JSON local preobtenido.
Canvas borroso en pantallas de alta DPI
Multiplica siempre por devicePixelRatio:
canvas.width = W * dpr;
canvas.height = H * dpr;
ctx.setTransform(dpr, 0, 0, dpr, 0, 0);
Demasiadas velas provocan un ancho muy pequeño
Establece un ancho mínimo de 0.6px; si slotW < 1, reduce la proporción de espacio o agrega los datos.
Control del progreso de la animación
Usa funciones de easing segmentadas:
- Primer 3%: establece rápidamente la línea base
- 90% intermedio: revelación constante
- Final: puede desacelerar ligeramente para aumentar el dramatismo