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

draw-call-optimization — правило для Claude Code: что делает

Правило draw-call-optimization для Claude Code описывает оптимизацию сцены Three.js: снизить число вызовов отрисовки до 100 на кадр инстансингом, батчингом и слиянием геометрий.

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

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

Что делает draw-call-optimization

Правило направляет ИИ-ассистента при оптимизации 3D-сцен в Three.js, удерживая планку менее 100 draw calls на кадр для стабильных 60 кадров в секунду. Внутри описано дерево решений: одинаковые объекты переводятся на InstancedMesh, разные модели с общим материалом — на BatchedMesh, а статичные элементы объединяются через BufferGeometryUtils.mergeGeometries.

Здесь также собраны паттерны переиспользования материалов, применение DataArrayTexture для текстурных слоёв и мониторинг через renderer.info.render.calls. Без общей настройки материалов батчинг работать не будет, поэтому правило запрещает создавать дублирующие экземпляры MeshStandardMaterial в циклах.

Какие задачи решает

  • сократить число вызовов отрисовки в Three.js ниже 100 на кадр
  • перевести одинаковые объекты на InstancedMesh
  • объединить разные геометрии через BatchedMesh
  • настроить переиспользование материалов между мешами

Примеры запросов агенту

  • Проверь сцену Three.js и оптимизируй отрисовку одинаковых объектов
  • Объедини статичные меши через BufferGeometryUtils для снижения draw calls
  • Переведи разные модели с общим материалом на BatchedMesh

Как установить draw-call-optimization

Вручную: положить файлы

.claude/rules/draw-call-optimization.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать

Вопросы о draw-call-optimization

Как установить draw-call-optimization в Claude Code?

Сохраните файл правила по пути .claude/rules/draw-call-optimization.md.

Что делает правило draw-call-optimization?

Задаёт ориентир до 100 draw calls на кадр в Three.js и подсказывает ассистенту техники с InstancedMesh, BatchedMesh и mergeGeometries.

Какой целевой показатель производительности задаёт правило?

Менее 100 вызовов отрисовки на кадр, чтобы сцена держала 60 кадров в секунду на большинстве устройств.

Исходный текст

draw-call-optimization.md · MIT
# Draw Call Optimization

> Source: [100 Three.js Tips - Utsubo](https://www.utsubo.com/blog/threejs-best-practices-100-tips)

Draw calls are the primary performance bottleneck in most Three.js applications.

## Target: Under 100 Draw Calls Per Frame

Most devices maintain 60fps below 100 draw calls. Check progress via:

```javascript
console.log('Draw calls:', renderer.info.render.calls);
console.log('Triangles:', renderer.info.render.triangles);
```

## Optimization Techniques

### 1. InstancedMesh (Identical Objects)

Reduces N draw calls to 1 for identical geometry.

```javascript
const mesh = new THREE.InstancedMesh(geometry, material, 1000);
const matrix = new THREE.Matrix4();

for (let i = 0; i < 1000; i++) {
  matrix.setPosition(positions[i]);
  mesh.setMatrixAt(i, matrix);
}
mesh.instanceMatrix.needsUpdate = true;
```

### 2. BatchedMesh (Varied Geometries)

Combines multiple geometries sharing materials into single draw call. Allows per-instance geometry variation.

```javascript
const batchedMesh = new THREE.BatchedMesh(
  maxGeometryCount,
  maxVertexCount,
  maxIndexCount,
  material
);

const geoId1 = batchedMesh.addGeometry(geometry1);
const geoId2 = batchedMesh.addGeometry(geometry2);

batchedMesh.addInstance(geoId1);
batchedMesh.addInstance(geoId2);
```

### 3. Merge Static Geometry

```javascript
import { mergeGeometries } from 'three/addons/utils/BufferGeometryUtils.js';

const merged = mergeGeometries([geo1, geo2, geo3]);
const mesh = new THREE.Mesh(merged, sharedMaterial);
```

### 4. Share Materials

```javascript
// BAD: Separate materials per mesh
meshes.forEach(m => {
  m.material = new MeshStandardMaterial({ color: 'red' });
});

// GOOD: Shared material
const sharedMaterial = new MeshStandardMaterial({ color: 'red' });
meshes.forEach(m => {
  m.material = sharedMaterial;
});
```

### 5. Array Textures (Modern Browsers)

Combine multiple textures into layers, accessed by index in shaders:

```javascript
const textureArray = new THREE.DataArrayTexture(data, width, height, depth);
```

### 6. Frustum Culling

Enabled by default. Understand how it works:

```javascript
const frustum = new THREE.Frustum();
const matrix = new THREE.Matrix4().multiplyMatrices(
  camera.projectionMatrix,
  camera.matrixWorldInverse
);
frustum.setFromProjectionMatrix(matrix);

if (frustum.intersectsObject(mesh)) {
  // Object is visible
}
```

## Decision Tree

```
Need to render many objects?
├── All identical geometry?
│   └── Use InstancedMesh
├── Different geometries, same material?
│   └── Use BatchedMesh
├── Static objects?
│   └── Merge with BufferGeometryUtils
└── Dynamic objects?
    └── Consider object pooling + visibility toggling
```

## Monitoring

```javascript
setInterval(() => {
  const info = renderer.info.render;
  console.log(`Calls: ${info.calls}, Tris: ${info.triangles}`);
}, 1000);
```

© zebbern · MIT · zebbern/claude-code-guide

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

Все правила IDE по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
threejs-performance CloudAI-X Скилл threejs-performance для Claude Code, Codex, Cursor и других платформ измеряет быстродействие three.js и оптимизирует рендеринг. Запускается, когда сцена тормозит или превышает лимит памяти. CX Codex +1 7 100установок three-best-practices three-agent-skills Скилл three-best-practices для Claude Code с правилами оптимизации Three.js. Срабатывает при написании, ревью и отладке кода с 3D-сценами, WebGL/WebGPU, шейдерами и TSL. CX Codex +1 1 700установок react-three-fiber-architect Claude Design Skillstack Субагент react-three-fiber-architect для проектирования 3D-сцен на React Three Fiber: разбирает архитектуру, ищет узкие места рендера и предлагает план оптимизации. CX Codex ★ 1 428звёзд репо threejs-materials CloudAI-X Скилл threejs-materials для Claude Code, Codex, Cursor и других платформ: подбор и настройка материалов three.js — от базовых до PBR, тун-шейдинга и точечных облаков. CX Codex +1 21 100установок threejs-webgl freshtechbro Скилл threejs-webgl для Claude Code учит агента настраивать сцены Three.js, рендереры WebGL и WebGPU, свет, материалы и загрузку glTF-моделей. Описывает настройку Three.js для 3D-визуализаций и конфигураторов. CX Codex +1 5 300установок threejs-aaa-graphics-builder majidmanzarpour Скилл threejs-aaa-graphics-builder переводит браузерную 3D-графику Three.js из прототипа в качественный продакшен: настраивает материалы, свет, шейдеры и проверяет сцену по шкале качества. CX Codex +1 4 300установок

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

Весь набор →
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звёзд репо frame-delta-time Правило frame-delta-time требует умножать движение на delta в useFrame, чтобы скорость анимации не зависела от частоты кадров. 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звёзд репо perf-zustand-selectors Правило perf-zustand-selectors для ИИ-агента: подписка в компоненте идёт на отдельный срез Zustand-стора, поэтому перерисовка случается только при изменении нужных данных. CX Codex +1 ★ 4 719звёзд репо

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

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