draw-call-optimization — правило для Claude Code: что делает
Правило draw-call-optimization для Claude Code описывает оптимизацию сцены Three.js: снизить число вызовов отрисовки до 100 на кадр инстансингом, батчингом и слиянием геометрий.
MIT ★ 4 719 обновлён 2026-10-24
.claude/rules/draw-call-optimization.mdЧто делает 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
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/draw-call-optimization.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/draw-call-optimization.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/draw-call-optimization.mdВручную: положить файлы
.clinerules/draw-call-optimization.mdПо шагам, с командами для каждой платформы: 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