К основному содержанию
правило CX Codex

frame-delta-time — правило для Claude Code

Правило frame-delta-time требует умножать движение на delta в useFrame, чтобы скорость анимации не зависела от частоты кадров.

MIT ★ 4 719 обновлён 2026-10-24

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/frame-delta-time.md
Открыть на GitHub

Что делает 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 и 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

Похожие правила IDE

Все правила IDE по теме «Фронтенд и UI» →
threejs-animation iart-ai Скилл threejs-animation для ИИ-кодинга, который помогает писать анимацию Three.js и React Three Fiber: сцены, GLTF-клипы, камера по скроллу, инстансинг. CX Codex +1 2 300установок core-3d-animation-integration Claude Design Skillstack Субагент core-3d-animation-integration для Claude, который разбирает проекты, где three.js, GSAP, React Three Fiber, Motion и Babylon.js встречаются в одном коде. CX Codex ★ 1 428звёзд репо threejs-react-three-fiber CloudAI-X Скилл threejs-react-three-fiber для Claude Code помогает собирать сцены three.js в React-компонентах. Он охватывает React Three Fiber, drei, цикл кадров и обработку событий указателя. CX Codex +1 6 800установок react-three-fiber freshtechbro Скилл react-three-fiber обучает агента строить декларативные 3D-сцены в React через Three.js, настраивать хуки рендера и загружать модели через Suspense. CX Codex +1 4 300установок r3f-interaction EnzeD Скилл r3f-interaction настраивает события указателя, выбор объектов, перетаскивание и управление камерой в React Three Fiber. Помогает связать ввод мыши и клавиатуры без конфликтов между контроллерами сцены. CX Codex +1 3 600установок r3f-postprocessing EnzeD Скилл r3f-postprocessing для Claude Code разбирает постобработку в React Three Fiber: блум по выбранным объектам, глубину резкости, SSAO и управление цветом после рендера. CX Codex +1 2 300установок

Из того же набора86

Весь набор →
change-implementer Субагент change-implementer проводит одно заранее утверждённое изменение до конца: правит код, проверяет его в реальном запуске и докладывает, что увидел. CX Codex ★ 4 719звёзд репо tsl-why-use Правило tsl-why-use для Claude Code и Codex: кастомные материалы в Three.js собираются из нод TSL, а не через патч onBeforeCompile. Применяется в проектах со своими шейдерами. CX Codex +1 ★ 4 719звёзд репо asset-compression Правило asset-compression с инструкциями по сжатию 3D-ассетов для Three.js. Помогает настроить Draco, Meshopt, KTX2-текстуры и LOD для ускорения 3D-сцен в вебе. CX Codex +1 ★ 4 719звёзд репо perf-never-set-state-in-useframe Правило perf-never-set-state-in-useframe для react-three-fiber: не вызывать setState внутри useFrame, потому что это даёт перерисовку на каждом кадре. Вместо состояния React — мутация ref. CX Codex +1 ★ 4 719звёзд репо draw-call-optimization Правило draw-call-optimization для Claude Code описывает оптимизацию сцены Three.js: снизить число вызовов отрисовки до 100 на кадр инстансингом, батчингом и слиянием геометрий. CX Codex +1 ★ 4 719звёзд репо object-pooling Правило object-pooling учит агента переиспользовать снаряды, частицы и NPC из пула, вместо того чтобы создавать и удалять меши каждый кадр. CX Codex +1 ★ 4 719звёзд репо shader-mobile Правило shader-mobile для Claude Code содержит приёмы оптимизации GLSL и Three.js шейдеров под мобильные GPU, помогающие избежать просадок FPS на смартфонах. CX Codex +1 ★ 4 719звёзд репо drei-use-gltf Правило drei-use-gltf для Claude Code задаёт загрузку GLTF-моделей через useGLTF с кэшированием и предварительной загрузкой. Используется в сценах на React Three Fiber. CX Codex +1 ★ 4 719звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой