Processus de création d'animation de chandeliers (Candlestick) avec Remotion
Ce skill documente le processus complet de création d'un graphique en chandeliers (K-line) pour le S&P 500 dans le projet Remotion vibe-motion-app.
Prérequis
- Projet Remotion 4.0.438, configuré avec React 19 + TailwindCSS v4
- Architecture de plugins :
motion/définit les scènes,remotion/gère le pipeline de composition Remotion - pnpm comme gestionnaire de paquets
Étape 1 : Récupération des données financières
Yahoo Finance fournit des données OHLC historiques gratuites (sans clé API).
Créez scripts/fetch-sp500-data.mjs :
// Cœur : Appel à l'API 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];
// Extraction de { t: timestamp, o: open, h: high, l: low, c: close }
Enregistrez dans public/data/sp500-weekly.json, pour que Remotion le charge via staticFile().
Paramètres :
%5EGSPC= symbole Yahoo du S&P 500 (codage URL de^GSPC)interval=1wk= hebdomadaire ; options possibles :1d,1moperiod1/period2= timestamps Unix, couvrant environ 40 ans (1984-2026)
Étape 2 : Création de la structure des fichiers du plugin
Chaque plugin Remotion nécessite 4 fichiers principaux + un preset de rendu :
motion/nom_plugin/
config.js → Paramètres par défaut
timeline.js → Contexte de scène + calcul d'animation image par image
Scene.jsx → Composant React (dessin Canvas)
plugin.js → Objet d'enregistrement du plugin
render-presets/
default.json → Preset de rendu
2a. config.js — Paramètres par défaut
export const DEFAULT_LAYOUT_PARAMS = Object.freeze({
videoWidth: 1920, // 16:9 paysage
videoHeight: 1080,
});
export const DEFAULT_ANIMATION_PARAMS = Object.freeze({
durationSeconds: 28, // Durée totale de l'animation
title: "S&P 500",
subtitle: "40 dernières années · Graphique hebdomadaire en chandeliers",
});
export const DEFAULT_MOTION_PROPS = Object.freeze({
...DEFAULT_LAYOUT_PARAMS,
...DEFAULT_ANIMATION_PARAMS,
});
2b. timeline.js — Logique d'animation
Trois fonctions centrales doivent être implémentées :
// 1. Contexte de scène : validation + conversion de type forcée de tous les paramètres
export const resolveXxxSceneContext = (pluginParams) => { ... }
// 2. Calcul de la durée : durationSeconds * fps
export const getXxxDurationInFrames = ({ fps, sceneContext }) => { ... }
// 3. Props image par image : calcul de progress et autres valeurs d'animation à partir de frame/fps
export const buildXxxSceneProps = ({ frame, fps, loop, sceneContext }) => { ... }
Principe de conception clé : tous les états d'animation ne dépendent que du paramètre frame, satisfaisant aux exigences de rendu parallèle de Remotion.
2c. Scene.jsx — Composant de dessin Canvas
Utilisez <canvas> plutôt qu'une multitude d'éléments DOM pour de meilleures performances.
Mode de chargement des données :
const [dataHandle] = useState(() => delayRender("Chargement des données"));
useEffect(() => {
fetch(staticFile("data/xxx.json"))
.then(r => r.json())
.then(data => { setData(data); continueRender(dataHandle); })
.catch(err => cancelRender(err));
}, [dataHandle]);
Logique centrale de dessin Canvas :
const draw = useCallback(() => {
const ctx = canvas.getContext("2d");
const dpr = window.devicePixelRatio || 1;
// Adaptation haute définition
canvas.width = W * dpr;
canvas.height = H * dpr;
ctx.setTransform(dpr, 0, 0, dpr, 0, 0);
// 1. Remplissage de fond
// 2. Grille + échelle des prix axe Y
// 3. Dessin des chandeliers (mèche + corps)
// 4. Étiquettes d'années axe X
// 5. Titre/sous-titre/informations statistiques
// 6. Barre de progression
}, [data, progress, ...]);
useEffect(() => { draw(); }, [draw]);
Paramètres clés pour le dessin des chandeliers :
const CANDLE_GAP_RATIO = 0.28; // Ratio d'espacement entre chandeliers
const CANDLE_FADE_FRAMES = 22; // Nombre d'images pour l'animation d'entrée
const MAX_CANDLE_W = 8; // Largeur maximale du chandelier (après mise à l'échelle)
const MIN_CANDLE_W = 0.6; // Largeur minimale du chandelier
// Largeur du chandelier adaptée en fonction du nombre visible
const slotW = plotWidth / visibleCount;
const bodyW = Math.max(MIN_CANDLE_W, Math.min(MAX_CANDLE_W * scale, slotW * (1 - GAP_RATIO)));
Animation d'entrée (fondu + croissance depuis le bas) :
const appearFrame = (i / (N - 1)) * revealEndFrame;
const candleAge = currentFrame - appearFrame;
const fadeAlpha = Math.min(1, Math.max(0, candleAge / CANDLE_FADE_FRAMES));
// Animation de croissance
if (candleAge < CANDLE_FADE_FRAMES && candleAge > 0) {
const growT = easeOutCubic(candleAge / CANDLE_FADE_FRAMES);
displayBodyBottom = lerp(lowY, bodyBottom, growT);
}
ctx.globalAlpha = fadeAlpha;
// ... dessin de la mèche + corps ...
ctx.globalAlpha = 1;
Couleurs du thème sombre :
const COLORS = {
bg: "#1a1a19",
grid: "#2c2c2a",
upBorder: "#e66767", // Bordure bougie haussière (rouge)
upFill: "rgba(230,103,103,0.15)", // Remplissage bougie haussière (semi-transparent)
downFill: "#199e70", // Remplissage bougie baissière (vert)
textPrimary: "#ffffff",
textSecondary: "#c3c2b7",
textMuted: "#898781",
accent: "#3987e5",
};
2d. plugin.js — Enregistrement du plugin
export const xxxPlugin = Object.freeze({
id: "ID_plugin",
defaultProps: DEFAULT_MOTION_PROPS,
SceneComponent: XxxScene,
waitForSceneLayoutReady: true, // Attendre le chargement complet des données
resolveSceneContext: (params) => ...,
getDurationInFrames: ({ fps, sceneContext }) => ...,
buildSceneProps: ({ frame, fps, loop, sceneContext }) => ...,
getLayout: ({ sceneContext }) => sceneContext.layout,
});
waitForSceneLayoutReady: true garantit que le composant Scene appelle onAutoLayoutReady() avant de commencer à rendre les images.
2e. render-presets/default.json
{
"title": "S&P 500",
"subtitle": "40 dernières années · Graphique hebdomadaire en chandeliers",
"videoWidth": 1920,
"videoHeight": 1080,
"durationSeconds": 28
}
Étape 3 : Enregistrement de la composition
Modifiez motion/project.js pour basculer ACTIVE_COMPOSITION vers le nouveau plugin :
import { xxxPlugin } from "./xxx/plugin.js";
export const ACTIVE_COMPOSITION = Object.freeze({
id: "SP500Kline",
fps: 30,
plugin: xxxPlugin,
});
Étape 4 : Validation et rendu
# Vérifier l'enregistrement de la composition
pnpm run remotion:compositions
# Lancer l'aperçu Studio (avec glissement de la timeline, réglage des paramètres)
pnpm run dev
# Rendu d'une image fixe
npx remotion still SP500Kline out/frame.png --frame=420
# Rendu de la vidéo complète
npx remotion render SP500Kline out/output.mp4
# Rendu avec un preset
REMOTION_PROPS_FILE=motion/xxx/render-presets/default.json pnpm run remotion:render
Problèmes courants
Problème CORS avec l'API Yahoo Finance
Dans l'environnement de rendu Remotion (navigateur sans tête Node.js), il n'y a pas de problème CORS.
Si l'aperçu navigateur rencontre des problèmes CORS, utilisez staticFile() pour charger le JSON pré-récupéré local.
Flou du Canvas sur écrans haute densité (DPI élevé)
Multipliez toujours par devicePixelRatio :
canvas.width = W * dpr;
canvas.height = H * dpr;
ctx.setTransform(dpr, 0, 0, dpr, 0, 0);
Trop de chandeliers rend la largeur trop petite
Définissez une largeur minimale de 0,6 px. Lorsque slotW < 1, réduisez le ratio d'espacement ou agrégez les données.
Contrôle de la progression de l'animation
Utilisez des fonctions d'easing segmentées :
- Les 3% initiaux établissent rapidement une base
- Les 90% intermédiaires révèlent à vitesse constante
- La fin peut légèrement ralentir pour renforcer l'effet dramatique