Integração com Framer Motion
As animações do Framer Motion são normalmente baseadas no tempo. Para sincronizá-las com o Helios (que é baseado em frames e pode ser arrastado), você deve mapear o estado do frame Helios para MotionValues.
Início Rápido
1. Hook useVideoFrame
Certifique-se de ter o hook useVideoFrame (veja examples/react/SKILL.md).
2. Mapear Frames para MotionValues
Use useTransform para mapear o frame atual (de useVideoFrame) para valores de animação.
import { useMotionValue, useTransform, motion } from 'framer-motion';
import { useVideoFrame } from './hooks/useVideoFrame';
export const MyComponent = ({ helios }) => {
// 1. Obter o frame atual
const frame = useVideoFrame(helios);
// 2. Criar um MotionValue para o frame
const frameMv = useMotionValue(0);
// Sincronizar MotionValue sempre que o frame mudar
useEffect(() => {
frameMv.set(frame);
}, [frame, frameMv]);
// 3. Transformar Frame -> Valor de Animação
// Exemplo: Rotacionar 360 graus em 60 frames (0 a 60)
const rotate = useTransform(frameMv, [0, 60], [0, 360]);
// Exemplo: Fade de opacidade nos primeiros 30 frames
const opacity = useTransform(frameMv, [0, 30], [0, 1]);
return (
<motion.div
style={{
width: 100,
height: 100,
background: 'blue',
rotate, // Vincula o valor transformado
opacity
}}
/>
);
};
Avançado: Definição Manual de MotionValue
Para melhor desempenho em árvores profundas, atualize um MotionValue compartilhado diretamente na assinatura, ignorando o estado do React.
const frameMv = useMotionValue(0);
useEffect(() => {
const unsubscribe = helios.subscribe((state) => {
// Atualizar MotionValue diretamente - sem re-renderização do React!
frameMv.set(state.currentFrame);
});
return unsubscribe;
}, [helios, frameMv]);
const x = useTransform(frameMv, [0, 100], [0, 500]);
return <motion.div style={{ x }} />;
Arquivos de Origem
- Exemplo:
examples/framer-motion-animation/