Intégration de Framer Motion
Les animations de Framer Motion sont généralement basées sur le temps. Pour les synchroniser avec Helios (qui est basé sur les images et scrutable), vous devez mapper l'état d'image d'Helios à des MotionValues.
Démarrage rapide
1. Hook useVideoFrame
Assurez-vous de disposer du hook useVideoFrame (voir examples/react/SKILL.md).
2. Mapper les images aux MotionValues
Utilisez useTransform pour mapper l'image courante (depuis useVideoFrame) aux valeurs d'animation.
import { useMotionValue, useTransform, motion } from 'framer-motion';
import { useVideoFrame } from './hooks/useVideoFrame';
export const MyComponent = ({ helios }) => {
// 1. Obtenir l'image courante
const frame = useVideoFrame(helios);
// 2. Créer une MotionValue pour l'image
const frameMv = useMotionValue(0);
// Synchroniser la MotionValue à chaque changement d'image
useEffect(() => {
frameMv.set(frame);
}, [frame, frameMv]);
// 3. Transformer Image -> Valeur d'animation
// Exemple : Rotation de 360 degrés sur 60 images (0 à 60)
const rotate = useTransform(frameMv, [0, 60], [0, 360]);
// Exemple : Fondu d'opacité sur les 30 premières images
const opacity = useTransform(frameMv, [0, 30], [0, 1]);
return (
<motion.div
style={{
width: 100,
height: 100,
background: 'blue',
rotate, // Lier la valeur transformée
opacity
}}
/>
);
};
Avancé : Définition manuelle de la MotionValue
Pour de meilleures performances dans des arbres de composants profonds, mettez à jour une MotionValue partagée directement dans l'abonnement, en contournant l'état React.
const frameMv = useMotionValue(0);
useEffect(() => {
const unsubscribe = helios.subscribe((state) => {
// Mettre à jour la MotionValue directement - pas de re-rendu React !
frameMv.set(state.currentFrame);
});
return unsubscribe;
}, [helios, frameMv]);
const x = useTransform(frameMv, [0, 100], [0, 500]);
return <motion.div style={{ x }} />;
Fichiers source
- Exemple :
examples/framer-motion-animation/