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

postprocessing-optimization — правило для Claude Code

Правило postprocessing-optimization для Three.js и React Three Fiber. Помогает оптимизировать постобработку и объединять шейдерные проходы без просадок FPS.

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

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

Что делает postprocessing-optimization

Сборник рекомендаций по ускорению графики в WebGL и WebGPU. Правило предписывает использовать библиотеку pmndrs/postprocessing вместо стандартного EffectComposer из Three.js, отключать встроенное сглаживание и лишние буферы в WebGLRenderer. Для React Three Fiber отключается мультисэмплинг.

Внутри описан строгий порядок этапов: совместимые эффекты объединяются в один EffectPass. Тональная компрессия и сглаживание (SMAA или FXAA) ставятся строго в финал пайплайна. Вместо полноэкранного свечения применяется SelectiveBloomEffect. Для WebGPU предложен конвейер на TSL-узлах.

Встроенное сглаживание рендерера (antialias: true) впустую тратит ресурсы, если сглаживание уже выполняется отдельным пассом в конце цепочки.

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

  • объединить разрозненные эффекты в один EffectPass
  • отключить избыточные буферы в параметрах WebGLRenderer
  • настроить выборочное свечение через SelectiveBloomEffect
  • перевести постобработку WebGPU на TSL-узлы

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

  • Проверь конвейер постобработки Three.js и объедини совместимые проходы в один
  • Оптимизируй параметры рендерера и добавь сглаживание SMAAEffect в конец цепочки
  • Покажи, как настроить выборочное свечение объекта без обработки всей сцены

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

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

.claude/rules/postprocessing-optimization.md

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

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

Вопросы о postprocessing-optimization

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

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

Что делает postprocessing-optimization?

Задаёт правила оптимизации постобработки в Three.js: объединение эффектов, отключение лишних буферов и правильный порядок проходов.

В чём разница между WebGL и WebGPU в этих рекомендациях?

Для WebGL правило рекомендует связку с pmndrs/postprocessing, а для WebGPU — нативный конвейер THREE.PostProcessing на базе TSL-модулей.

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

postprocessing-optimization.md · MIT
# Post-Processing Optimization

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

Post-processing can significantly impact performance. Optimize carefully.

## Use pmndrs/postprocessing (WebGL)

The pmndrs library is more performant than Three.js default EffectComposer:

```javascript
import { EffectComposer, Bloom, Vignette, EffectPass, RenderPass } from 'postprocessing';

const composer = new EffectComposer(renderer);
composer.addPass(new RenderPass(scene, camera));
composer.addPass(new EffectPass(camera, new Bloom(), new Vignette()));

// In render loop
composer.render();
```

## Configure Renderer for Post-Processing

```javascript
const renderer = new THREE.WebGLRenderer({
  powerPreference: 'high-performance',
  antialias: false,      // AA handled by post-processing
  stencil: false,        // Disable if not needed
  depth: false           // Disable if not needed
});
```

## Disable Multisampling When Not Needed

```jsx
// React Three Fiber
<EffectComposer multisampling={0}>
  <Bloom />
</EffectComposer>
```

## Apply Tone Mapping at Pipeline End

```javascript
renderer.toneMapping = THREE.NoToneMapping;

// Add ToneMappingEffect as the LAST effect
composer.addPass(new EffectPass(camera, new ToneMappingEffect()));
```

## Add Antialiasing at the End

```javascript
import { SMAAEffect } from 'postprocessing';

// SMAA as the final pass
composer.addPass(new EffectPass(camera, new SMAAEffect()));
```

## Merge Compatible Effects

Reduce passes by combining effects:

```javascript
// BAD: Multiple passes
composer.addPass(new EffectPass(camera, new Bloom()));
composer.addPass(new EffectPass(camera, new Vignette()));
composer.addPass(new EffectPass(camera, new ChromaticAberration()));

// GOOD: Single pass with multiple effects
composer.addPass(new EffectPass(
  camera,
  new Bloom(),
  new Vignette(),
  new ChromaticAberration()
));
```

## Resolution Scaling

Half resolution can double frame rate:

```javascript
// Render at half resolution
composer.setSize(window.innerWidth / 2, window.innerHeight / 2);
```

## Selective Bloom

Only bloom objects that need it:

```javascript
import { SelectiveBloomEffect } from 'postprocessing';

const bloom = new SelectiveBloomEffect(scene, camera, {
  luminanceThreshold: 0.9,
  luminanceSmoothing: 0.3
});

// Add objects to bloom selection
bloom.selection.add(glowingObject);
```

## Bloom Parameter Tuning

| Parameter | Range | Description |
|-----------|-------|-------------|
| intensity | 0.5-2.0 | Overall strength |
| luminanceThreshold | 0.8-1.0 | Minimum brightness to bloom |
| radius | 0.5-1.0 | Spread size |

## WebGPU Native Post-Processing

For WebGPU, use Three.js native TSL-based post-processing:

```javascript
import { pass, bloom, fxaa } from 'three/tsl';

const postProcessing = new THREE.PostProcessing(renderer);
const scenePass = pass(scene, camera);

postProcessing.outputNode = scenePass
  .pipe(bloom({ threshold: 0.8, intensity: 1.0 }))
  .pipe(fxaa());

// In render loop
postProcessing.render();
```

## Performance Checklist

- [ ] Use pmndrs/postprocessing for WebGL
- [ ] Disable renderer AA, stencil, depth when using post-processing
- [ ] Merge compatible effects into single pass
- [ ] Add AA (SMAA/FXAA) as final effect
- [ ] Apply tone mapping at end
- [ ] Consider resolution scaling for mobile
- [ ] Use selective bloom instead of full-screen
- [ ] Disable multisampling when not needed
- [ ] Use TSL post-processing for WebGPU

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

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

Все правила IDE по теме «Фронтенд и UI» →
threejs-postprocessing CloudAI-X Скилл threejs-postprocessing для Claude Code добавляет в Three.js постобработку: bloom, глубину резкости, ambient occlusion и экранные шейдеры. Создаёт эффекты, цветокоррекцию и размытие на WebGL и WebGPU. CX Codex +1 19 700установок r3f-postprocessing EnzeD Скилл r3f-postprocessing для Claude Code разбирает постобработку в React Three Fiber: блум по выбранным объектам, глубину резкости, SSAO и управление цветом после рендера. CX Codex +1 2 300установок postfx-effects Bbeierle12 Скилл postfx-effects для Claude Code собирает рецепты пост-эффектов для сцен на React Three Fiber: глубину резкости, виньетирование и ретро-стили. CX Codex +1 106установок threejs-shaders CloudAI-X Скилл threejs-shaders помогает писать кастомные GLSL-шейдеры и материалы для Three.js r186, настраивать униформы и переводить код на TSL для WebGPU. CX Codex +1 22 000установок three-best-practices three-agent-skills Скилл three-best-practices для Claude Code с правилами оптимизации Three.js. Срабатывает при написании, ревью и отладке кода с 3D-сценами, WebGL/WebGPU, шейдерами и TSL. CX Codex +1 1 700установок threejs mrgoonie Собирает 3D-сцены, шейдеры и VR-опыты на Three.js. Закрывает задачи с WebGL и WebGPU. CX Codex +1 1 300установок

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

Весь набор →
geometry-instanced-mesh Правило geometry-instanced-mesh задаёт использование THREE.InstancedMesh вместо отдельных мешей для рендеринга множества одинаковых 3D-объектов. CX Codex +1 ★ 4 719звёзд репо webgpu-renderer Правило webgpu-renderer для Claude Code описывает подключение WebGPU-рендерера Three.js и запасной путь через WebGL 2. Показывает настройку 3D-сцен с вычислениями на GPU. CX Codex +1 ★ 4 719звёзд репо tsl-material-slots tsl-material-slots — правило для Claude Code со справочником слотов TSL в Three.js. Помогает настраивать шейдерную логику через узлы без ошибок в типах и именах свойств. CX Codex +1 ★ 4 719звёзд репо core-web-vitals Правило core-web-vitals для Claude Code: грузит модели и текстуры в 3D-сценах на Three.js так, чтобы LCP, FID и CLS не проседали. Не даёт тяжёлому 3D тормозить первую отрисовку. CX Codex +1 ★ 4 719звёзд репо timeline-builder Скилл timeline-builder для Claude Code превращает JSON-данные в интерактивную HTML-хронологию с вертикальной, горизонтальной или двусторонней раскладкой. Отображает этапы проекта, историю выпусков и резюме. CX Codex +1 ★ 4 719звёзд репо loading-suspense Правило loading-suspense требует оборачивать асинхронные компоненты React Three Fiber в Suspense с заглушкой: без границы сцена останется пустой, пока грузится модель или текстура. CX Codex +1 ★ 4 719звёзд репо lighting-shadows-advanced Правило lighting-shadows-advanced для Claude Code настраивает освещение и тени в Three.js с учётом стоимости рендеринга. Оптимизирует тени при множестве источников света. CX Codex +1 ★ 4 719звёзд репо migration-checklist Правило migration-checklist подсказывает агенту, как мигрировать код при обновлении Three.js. Перечисляет breaking changes с r125 и актуальные пути импортов. CX Codex +1 ★ 4 719звёзд репо

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

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