geometry-instanced-mesh — правило для Claude Code
Правило geometry-instanced-mesh задаёт использование THREE.InstancedMesh вместо отдельных мешей для рендеринга множества одинаковых 3D-объектов.
MIT ★ 4 719 обновлён 2026-10-24
.claude/rules/geometry-instanced-mesh.mdЧто делает geometry-instanced-mesh
Правило ориентирует модель на оптимизацию рендеринга в Three.js. Вместо создания тысяч отдельных экземпляров THREE.Mesh, каждый из которых требует отдельного вызова отрисовки (draw call), оно предписывает собирать одинаковые объекты в один THREE.InstancedMesh. В инструкции описаны паттерны инициализации через вспомогательный THREE.Object3D, обновление матриц трансформации, раскраска через setColorAt и обработка кликов через THREE.Raycaster с чтением instanceId.
В материале зафиксированы чёткие ограничения. Подход не подходит для сцен с разными геометриями или материалами, для сложной покадровой анимации отдельных сущностей, а также для массивов менее чем из 100 объектов из-за накладных расходов на инстансинг.
Какие задачи решает
- сократить количество вызовов отрисовки при рендере тысяч одинаковых мешей
- настроить индивидуальные трансформации и цвета через матрицу инстансов
- реализовать выбор отдельных копий кликом мыши с помощью raycaster
Примеры запросов агенту
- Оптимизируй генерацию леса из 5000 одинаковых деревьев на Three.js
- Покажи, как менять цвет конкретного инстанса по клику через raycaster
- Перепиши цикл создания кубов на использование THREE.InstancedMesh
Как установить geometry-instanced-mesh
Вручную: положить файлы
.claude/rules/geometry-instanced-mesh.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/geometry-instanced-mesh.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/geometry-instanced-mesh.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/geometry-instanced-mesh.mdВручную: положить файлы
.clinerules/geometry-instanced-mesh.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о geometry-instanced-mesh
Как установить geometry-instanced-mesh в Claude Code?
Сохраните файл правила по пути .claude/rules/geometry-instanced-mesh.md в корне вашего проекта.
Что делает правило geometry-instanced-mesh?
Оно обучает ассистента заменять создание множества отдельных THREE.Mesh на единый THREE.InstancedMesh, объединяя отрисовку копий в один draw call.
Когда это правило не стоит применять?
Инстансинг не нужен, если в сцене меньше 100 объектов, а также если элементам требуются разные материалы, разные геометрии или сложная индивидуальная анимация.
Исходный текст
geometry-instanced-mesh.md · MIT
# geometry-instanced-mesh
**Use InstancedMesh for many identical objects.**
## Why It Matters
Each mesh = 1 draw call. 10,000 meshes = 10,000 draw calls = terrible performance. InstancedMesh renders multiple copies in a single draw call while allowing individual transforms and colors.
## Bad Example
```javascript
// BAD - 10000 draw calls
for (let i = 0; i < 10000; i++) {
const mesh = new THREE.Mesh(geometry, material);
mesh.position.random().multiplyScalar(100);
scene.add(mesh);
}
```
This creates 10,000 separate objects, each requiring its own draw call.
## Good Example
```javascript
// GOOD - Single draw call for 10000 instances
const instancedMesh = new THREE.InstancedMesh(geometry, material, 10000);
const dummy = new THREE.Object3D();
const color = new THREE.Color();
for (let i = 0; i < 10000; i++) {
// Set position
dummy.position.random().multiplyScalar(100);
dummy.rotation.random();
dummy.scale.setScalar(0.5 + Math.random() * 0.5);
dummy.updateMatrix();
instancedMesh.setMatrixAt(i, dummy.matrix);
// Set color (optional)
color.setHSL(Math.random(), 0.8, 0.5);
instancedMesh.setColorAt(i, color);
}
instancedMesh.instanceMatrix.needsUpdate = true;
if (instancedMesh.instanceColor) {
instancedMesh.instanceColor.needsUpdate = true;
}
scene.add(instancedMesh);
```
## Updating Instances
```javascript
// Update a single instance
function updateInstance(index, position, rotation, scale) {
dummy.position.copy(position);
dummy.rotation.copy(rotation);
dummy.scale.copy(scale);
dummy.updateMatrix();
instancedMesh.setMatrixAt(index, dummy.matrix);
instancedMesh.instanceMatrix.needsUpdate = true;
}
// Update in animation loop
function animate() {
for (let i = 0; i < 100; i++) {
instancedMesh.getMatrixAt(i, dummy.matrix);
dummy.matrix.decompose(dummy.position, dummy.quaternion, dummy.scale);
dummy.rotation.y += 0.01;
dummy.updateMatrix();
instancedMesh.setMatrixAt(i, dummy.matrix);
}
instancedMesh.instanceMatrix.needsUpdate = true;
renderer.render(scene, camera);
}
```
## Raycasting
```javascript
const raycaster = new THREE.Raycaster();
function onMouseClick(event) {
raycaster.setFromCamera(mouse, camera);
const intersects = raycaster.intersectObject(instancedMesh);
if (intersects.length > 0) {
const instanceId = intersects[0].instanceId;
console.log('Clicked instance:', instanceId);
// Change color of clicked instance
instancedMesh.setColorAt(instanceId, new THREE.Color(0xff0000));
instancedMesh.instanceColor.needsUpdate = true;
}
}
```
## Performance Comparison
| Method | Objects | Draw Calls | Performance |
|--------|---------|------------|-------------|
| Individual Meshes | 10,000 | 10,000 | ~5 FPS |
| InstancedMesh | 10,000 | 1 | ~60 FPS |
## When NOT to Use
- Different geometries needed
- Different materials needed
- Complex per-object animations
- < 100 objects (overhead not worth it)
## References
- [Three.js InstancedMesh](https://threejs.org/docs/#api/en/objects/InstancedMesh)
- [Instancing Example](https://threejs.org/examples/#webgl_instancing_performance)
© zebbern · MIT · zebbern/claude-code-guide