frame-delta-time — правило для Claude Code
Правило frame-delta-time требует умножать движение на delta в useFrame, чтобы скорость анимации не зависела от частоты кадров.
MIT ★ 4 719 обновлён 2026-10-24
.claude/rules/frame-delta-time.mdЧто делает frame-delta-time
Правило требует одного: любое движение в кадре умножается на delta. В useFrame из react-three-fiber это второй аргумент, время с прошлого кадра. Прибавлять фиксированные 0.01 к повороту нельзя: на 144 Гц сцена закрутится быстрее, чем на 30 fps.
Примеры разбирают основные случаи. Вращение и перемещение через speed * delta, колебания по clock.elapsedTime, плавное следование за целью с коэффициентом 1 - Math.pow(0.001, delta), движение по направлению через addScaledVector. Отдельно показана деструктуризация состояния: clock, camera, pointer, viewport.
Файл правила — обычный markdown, его можно держать и в Claude, и в Codex. Все примеры опираются на useFrame, так что в другом рендерере шаблон придётся переносить вручную. Сам по себе файл код не переписывает — это инструкция для агента.
Какие задачи решает
- убрать разницу в скорости анимации между 144 Гц и 30 fps
- перевести вращение меша на радианы в секунду
- сделать плавное следование за целью без рывков на слабом устройстве
- задать колебание объекта по
clock.elapsedTime - двигать объект с постоянной скоростью в юнитах в секунду
Примеры запросов агенту
- Перепиши колбэк
useFrame, чтобы поворот умножался наdelta, а не на фиксированный шаг. - Проверь мою анимацию: она должна идти с одинаковой скоростью на 144 Гц и на 30 fps.
- Сделай плавное следование меша за целью с коэффициентом, который не ломается при смене частоты кадров.
Как установить frame-delta-time
Вручную: положить файлы
.claude/rules/frame-delta-time.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/frame-delta-time.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/frame-delta-time.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/frame-delta-time.mdВручную: положить файлы
.clinerules/frame-delta-time.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о frame-delta-time
Как установить frame-delta-time в Claude Code?
Положи файл правила по пути .claude/rules/frame-delta-time.md. Это весь шаг установки.
Что делает frame-delta-time?
Требует считать движение через delta внутри useFrame, чтобы вращение и перемещение шли с одной скоростью на любой герцовке.
Чем delta отличается от clock.elapsedTime?
delta — время с прошлого кадра, его берут для скорости. clock.elapsedTime считает от запуска и подходит для колебаний и повторяющихся паттернов.
Исходный текст
frame-delta-time.md · MIT
# frame-delta-time
**Always use delta for frame-rate independent animation.**
## Why It Matters
Without delta time, animations run faster on 144Hz displays and slower on 30fps mobile devices. Delta time ensures consistent animation speed regardless of frame rate.
## Bad Example
```jsx
// BAD - Speed varies with frame rate
function BadAnimation() {
const meshRef = useRef();
useFrame(() => {
meshRef.current.rotation.y += 0.01; // Fast on 144hz, slow on 30hz
});
return <mesh ref={meshRef} />;
}
```
## Good Example
```jsx
// GOOD - Consistent speed on all devices
function GoodAnimation() {
const meshRef = useRef();
useFrame((state, delta) => {
meshRef.current.rotation.y += 1 * delta; // 1 radian per second, always
});
return <mesh ref={meshRef} />;
}
```
## Using Clock for Time-based Effects
```jsx
function TimeBasedAnimation() {
const meshRef = useRef();
useFrame(({ clock }) => {
const t = clock.elapsedTime;
// Oscillate at consistent frequency
meshRef.current.position.y = Math.sin(t * 2) * 2; // 2 Hz oscillation
meshRef.current.position.x = Math.cos(t) * 3;
});
return <mesh ref={meshRef} />;
}
```
## Frame-rate Independent Lerp
```jsx
function SmoothFollow({ target }) {
const meshRef = useRef();
useFrame((state, delta) => {
// Frame-rate independent smooth interpolation
const lerpFactor = 1 - Math.pow(0.001, delta);
meshRef.current.position.lerp(target, lerpFactor);
});
return <mesh ref={meshRef} />;
}
```
## Movement with Speed
```jsx
function MovingObject() {
const meshRef = useRef();
const speed = 5; // units per second
const direction = useRef(new THREE.Vector3(1, 0, 0));
useFrame((state, delta) => {
meshRef.current.position.addScaledVector(direction.current, speed * delta);
});
return <mesh ref={meshRef} />;
}
```
## Combining Delta and Elapsed Time
```jsx
function ComplexAnimation() {
const meshRef = useRef();
useFrame(({ clock }, delta) => {
const t = clock.elapsedTime;
// Position based on elapsed time (consistent patterns)
meshRef.current.position.x = Math.sin(t) * 3;
meshRef.current.position.z = Math.cos(t) * 3;
// Rotation based on delta (consistent speed)
meshRef.current.rotation.y += 0.5 * delta;
});
return <mesh ref={meshRef} />;
}
```
## State Destructuring
```jsx
useFrame(({ clock, camera, pointer, viewport }, delta) => {
// clock.elapsedTime - total time since start
// clock.getDelta() - same as delta parameter
// camera - the default camera
// pointer - normalized mouse position (-1 to 1)
// viewport - { width, height, factor }
});
```
## References
- [R3F useFrame](https://docs.pmnd.rs/react-three-fiber/api/hooks#useframe)
© zebbern · MIT · zebbern/claude-code-guide