Integración con Framer Motion
Las animaciones de Framer Motion normalmente se basan en el tiempo. Para sincronizarlas con Helios (que se basa en fotogramas y se puede desplazar), debes mapear el estado de fotograma de Helios a MotionValues.
Inicio Rápido
1. Hook useVideoFrame
Asegúrate de tener el hook useVideoFrame (consulta examples/react/SKILL.md).
2. Mapear Fotogramas a MotionValues
Usa useTransform para mapear el fotograma actual (de useVideoFrame) a valores de animación.
import { useMotionValue, useTransform, motion } from 'framer-motion';
import { useVideoFrame } from './hooks/useVideoFrame';
export const MyComponent = ({ helios }) => {
// 1. Obtener el fotograma actual
const frame = useVideoFrame(helios);
// 2. Crear un MotionValue para el fotograma
const frameMv = useMotionValue(0);
// Sincronizar MotionValue cuando el fotograma cambie
useEffect(() => {
frameMv.set(frame);
}, [frame, frameMv]);
// 3. Transformar Fotograma -> Valor de Animación
// Ejemplo: Rotar 360 grados en 60 fotogramas (0 a 60)
const rotate = useTransform(frameMv, [0, 60], [0, 360]);
// Ejemplo: Aparecer gradualmente en los primeros 30 fotogramas
const opacity = useTransform(frameMv, [0, 30], [0, 1]);
return (
<motion.div
style={{
width: 100,
height: 100,
background: 'blue',
rotate, // Vincular valor transformado
opacity
}}
/>
);
};
Avanzado: Configuración Manual de MotionValue
Para un mejor rendimiento en árboles profundos, actualiza un MotionValue compartido directamente en la suscripción, evitando el estado de React.
const frameMv = useMotionValue(0);
useEffect(() => {
const unsubscribe = helios.subscribe((state) => {
// Actualizar MotionValue directamente - ¡sin re-renderizado de React!
frameMv.set(state.currentFrame);
});
return unsubscribe;
}, [helios, frameMv]);
const x = useTransform(frameMv, [0, 100], [0, 500]);
return <motion.div style={{ x }} />;
Archivos Fuente
- Ejemplo:
examples/framer-motion-animation/