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

tsl-post-processing — правило для Claude Code

Правило tsl-post-processing для Claude Code описывает постобработку Three.js на TSL: эффекты подключаются к postProcessing.outputNode без цепочки проходов EffectComposer. Агент обращается к нему при написании кода сцены.

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

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

Что делает tsl-post-processing

Правило описывает постобработку на TSL (Three.js Shading Language) для WebGPU и WebGL. Эффекты не собираются в список проходов, а вешаются на postProcessing.outputNode. Внутри таблица сигнатур: bloom, dof, gaussianBlur, ssr, ssgi, ao, traa, fxaa, smaa, lut3D, film, motionBlur, chromaticAberration и остальные. Рядом готовые цепочки — цветокоррекция через hue и saturation, размытие по глубине с нодой из scenePass.getDepthNode().

Это markdown-файл правила, а не библиотека. Агент читает его как справку, когда пишет код сцены, поэтому сигнатуры эффектов и порядок вызовов берутся оттуда, а не из памяти модели. Есть раздел со сравнением старого EffectComposer и TSL-подхода и пять правил сборки. Одно стоит держать в голове: постобработка обходит встроенное сглаживание WebGL, поэтому fxaa или smaa ставят в конец цепочки, иначе края поедут лесенкой.

Там же совет по альтернативе — библиотека postprocessing из экосистемы Poimandres, её добавляют через npm install postprocessing. Для сцен на чистом WebGL без TSL этот путь ближе.

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

  • Собрать цепочку bloom и размытия по глубине на нодах TSL
  • Перевести готовую сцену с EffectComposer на postProcessing.outputNode
  • Вернуть сглаживание после включения постобработки
  • Подобрать аргументы эффекта: что передавать в dof или anamorphic
  • Добавить цветокоррекцию через lut3D перед выводом кадра

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

  • Собери постобработку на TSL: bloom и размытие по глубине через postProcessing.outputNode
  • Перепиши цепочку проходов со EffectComposer на TSL-ноды, покажи разницу
  • Почему после постобработки пропало сглаживание? Добавь fxaa в конец цепочки

Как установить tsl-post-processing

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

.claude/rules/tsl-post-processing.md

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

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

Вопросы о tsl-post-processing

Как установить tsl-post-processing в Claude Code?

Положите файл правила по пути .claude/rules/tsl-post-processing.md в проект. Дальше Claude читает его как правило проекта.

Что делает tsl-post-processing?

Даёт агенту справку по эффектам TSL в Three.js: сигнатуры, примеры цепочек и порядок сборки. Пользуется ей при написании кода постобработки для WebGPU и WebGL.

Чем TSL-подход отличается от EffectComposer?

В EffectComposer проходы добавляются по одному и рендер идёт через composer.render(). В TSL вы собираете дерево нод и отдаёте его в postProcessing.outputNode.

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

tsl-post-processing.md · MIT
# TSL Post-Processing

Modern post-processing using TSL (Three.js Shading Language) for WebGPU and WebGL.

## TSL Post-Processing Setup

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

const scenePass = pass(scene, camera);
const beauty = scenePass.getTextureNode();

// Chain effects
postProcessing.outputNode = bloom(grayscale(beauty), 1, 0.4, 0.85);
```

## Available Effects

| Effect | Signature |
|--------|-----------|
| After Image | `afterImage(node, damp)` |
| Anamorphic Flare | `anamorphic(node, threshold, scale, samples)` |
| Bloom | `bloom(node, strength, radius, threshold)` |
| Box Blur | `boxBlur(textureNode, options)` |
| Chromatic Aberration | `chromaticAberration(node, strength, center, scale)` |
| Denoise | `denoise(node, depthNode, normalNode, camera)` |
| Depth of Field | `dof(node, viewZ, focusDistance, focalLength, bokehScale)` |
| Dot Screen | `dotScreen(node, angle, scale)` |
| Film Grain | `film(inputNode, intensity, uv)` |
| FXAA | `fxaa(node)` |
| Gaussian Blur | `gaussianBlur(node, direction, sigma, options)` |
| Grayscale | `grayscale(color)` |
| Hash Blur | `hashBlur(textureNode, blurAmount, options)` |
| LUT Grading | `lut3D(node, lut, size, intensity)` |
| Motion Blur | `motionBlur(inputNode, velocity, samples)` |
| Outline | `outline(scene, camera, params)` |
| RGB Shift | `rgbShift(node, amount, angle)` |
| Sepia | `sepia(color)` |
| SMAA | `smaa(node)` |
| Sobel | `sobel(node)` |
| SSR | `ssr(colorNode, depthNode, normalNode, metalness, roughness, camera)` |
| SSGI | `ssgi(beautyNode, depthNode, normalNode, camera)` |
| AO | `ao(depthNode, normalNode, camera)` |
| Transition | `transition(nodeA, nodeB, mixTexture, ratio, threshold, useTexture)` |
| TRAA | `traa(beautyNode, depthNode, velocityNode, camera)` |

## Common Patterns

### Bloom

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

const scenePass = pass(scene, camera);
const beauty = scenePass.getTextureNode();

postProcessing.outputNode = bloom(beauty, 1, 0.4, 0.85);
// Parameters: node, strength, radius, threshold
```

### Gaussian Blur

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

const scenePass = pass(scene, camera);
const beauty = scenePass.getTextureNode();

postProcessing.outputNode = gaussianBlur(beauty, 4);
// Parameters: node, sigma
```

### Color Grading Pipeline

```javascript
import { pass, grayscale, saturation, hue, bloom } from 'three/tsl';

const scenePass = pass(scene, camera);
const beauty = scenePass.getTextureNode();

// Chain multiple effects
const graded = saturation(hue(beauty, 0.1), 1.2);
const final = bloom(graded, 0.5, 0.4, 0.9);

postProcessing.outputNode = final;
```

### Depth of Field

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

const scenePass = pass(scene, camera);
const beauty = scenePass.getTextureNode();
const depth = scenePass.getDepthNode();

postProcessing.outputNode = dof(
  beauty,
  depth,
  5,     // focusDistance
  0.02,  // focalLength
  0.025  // bokehScale
);
```

## TSL vs EffectComposer

### EffectComposer (WebGL Traditional)

```javascript
import { EffectComposer } from 'three/addons/postprocessing/EffectComposer.js';
import { RenderPass } from 'three/addons/postprocessing/RenderPass.js';
import { UnrealBloomPass } from 'three/addons/postprocessing/UnrealBloomPass.js';

const composer = new EffectComposer(renderer);
composer.addPass(new RenderPass(scene, camera));
composer.addPass(new UnrealBloomPass(resolution, strength, radius, threshold));

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

### TSL Post-Processing (Modern)

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

const scenePass = pass(scene, camera);
const beauty = scenePass.getTextureNode();

postProcessing.outputNode = bloom(beauty, 1, 0.4, 0.85);
```

## Best Practices

1. **Tone Mapping**: When using postprocessing, set `renderer.toneMapping = NoToneMapping` and add tone mapping as last effect

2. **Precision**: Use `HalfFloatType` for high precision frame buffers

3. **Anti-Aliasing**: WebGL AA is bypassed with postprocessing; add FXAA/SMAA at the end

4. **Performance**: Combine multiple effects into single pass when possible

5. **Order**: RenderPass always first, AA always last

## Alternative: pmndrs/postprocessing

High-performance post-processing library from Poimandres ecosystem:
- Better performance than built-in EffectComposer
- Optimized effects
- Better selective bloom support

```bash
npm install postprocessing
```

## References

- [Three.js Examples - Post-Processing](https://threejs.org/examples/?q=postprocessing)
- [pmndrs/postprocessing](https://github.com/pmndrs/postprocessing)

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

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

Все правила IDE по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
3d-sky-rays MengTo Скилл 3d-sky-rays для Claude Code добавляет в Three.js-сцену лучи света из-за крыш и сквозь листву — эффект золотого часа в архитектурном рендере. CX Codex +1 859установок webgpu-threejs-tsl dgreenheck Скилл webgpu-threejs-tsl помогает писать Three.js-приложения с WebGPU, TSL-материалами, вычислительными шейдерами и постобработкой. CX Codex +1 1 800установок 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установок cloudai-threejs podo Скилл cloudai-threejs для Claude Code объединяет инструкции по Three.js, WebGL, WebGPU и React Three Fiber для создания 3D-сцен, шейдеров и анимаций без устаревших паттернов. CX Codex +1 207установок

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

Весь набор →
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звёзд репо audio-spatial Правило audio-spatial для Claude Code задаёт шаблоны настройки 3D-звука в Three.js: позиционирование источников, затухание и реакцию на действия пользователя. CX Codex +1 ★ 4 719звёзд репо debug-devtools Правило debug-devtools для Claude Code и Codex добавляет в Three.js-проект средства диагностики производительности, сцены и потери WebGL-контекста. Находит узкие места и проверяет параметры вживую. CX Codex +1 ★ 4 719звёзд репо tsl-compute-shaders Правило tsl-compute-shaders подсказывает агенту, как писать вычислительные шейдеры на Three.js TSL для WebGPU и настраивать GPGPU-симуляции вроде частиц с расчётом физики. CX Codex +1 ★ 4 719звёзд репо animation-system Правило animation-system объясняет систему анимации Three.js: от запуска и смешивания клипов до морфинга и управления костями. Пригодится при работе с анимированными 3D-моделями. CX Codex +1 ★ 4 719звёзд репо gltf-loading-optimization Правило gltf-loading-optimization для Claude Code содержит сниппеты и команды для загрузки glTF в Three.js, настройки декодеров, прогресса, ленивой подгрузки и сжатия моделей. CX Codex +1 ★ 4 719звёзд репо physics-integration Правило physics-integration задаёт правила связки Three.js с физическими движками Rapier и Cannon-es: настройка Vite, коллайдеры и синхронизация позиций. CX Codex +1 ★ 4 719звёзд репо

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

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