Communitygithub.com

linegel/threejs-complete-set-of-skill

25 compétences d'agent expert pour des scènes Three.js WebGPU/TSL ambitieuses — océans procéduraux, nuages, planètes, optiques aquatiques, pipelines d'images et validation visuelle basée sur des captures d'écran. Pour Claude Code, Codex, Cursor et tout agent doté de compétences.

Qu'est-ce que threejs-complete-set-of-skill ?

Cette compétence d'agent fournit un ensemble complet de 25 outils spécialisés pour la création de scènes Three.js avancées exploitant WebGPU et TSL. Elle couvre des effets visuels complexes comme les océans procéduraux, les nuages, les planètes, les systèmes optiques aquatiques, les pipelines de traitement d'images, et un système de validation visuelle par captures d'écran. La compétence est conçue pour fonctionner avec des agents IA comme Claude Code, Codex et Cursor, en suivant une architecture de production basée sur WebGPURenderer et les derniers pipelines de rendu de Three.js. L'utilisateur peut ainsi déléguer la création d'effets de bloom sélectif, de rendu HDR, de gestion des ressources de stockage et de validation qualité à un agent qui comprend les contraintes de budget GPU et les architectures modernes de rendu.

Compatible avec✓Claude Code✓Codex CLI✓Cursor
npx skills add linegel/threejs-complete-set-of-skill

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Bloom

Bloom est une réponse de la caméra/affichage à un signal HDR lumineux. Traitez-le comme un effet de pipeline de nœud unique alimenté par la luminance de scène créée, et non comme la seule forme visible d'un objet ou d'effets.

Architecture d'abord

Le chemin de production est le dernier WebGPURenderer de Three.js depuis three/webgpu, TSL depuis three/tsl, RenderPipeline, pass(), mrt({ output, emissive }) et BloomNode depuis bloom().

Construisez un bloom sélectif à partir de la sortie MRT emissive du passage de scène :

passage de scène avec sortie MRT + emissive
  -> nœud de texture de couleur de scène
  -> nœud de texture de contribution emissive
  -> bloom(emissive).setResolutionScale(...)
  -> couleur de scène + bloom
  -> un seul propriétaire renderOutput / outputColorTransform

C'est l'architecture de premier ordre pour cette compétence : un rendu de scène, contribution sélective directe MRT, signal HDR préservé jusqu'à la transformation de sortie finale, et mise à l'échelle de résolution par passage pour le travail coûteux de flou.

Lisez references/hdr-bloom-system.md pour le squelette WebGPU/TSL de l'ère r185, la porte de capacité, les niveaux de qualité, les budgets, les règles de couleur, les diagnostics et les notes de remplacement.

Exemple canonique WebGPU/TSL : examples/node-selective-bloom/.

Workflow

  1. Exécutez $threejs-choose-skills en pré-vérification lorsque bloom fait partie d'un pipeline d'images plus large.
  2. Créez une contribution emissive avec des matériaux NodeMaterial et acheminez-la vers MRT emissive.
  3. Alimentez BloomNode à partir du nœud de texture emissive, pas à partir d'un rendu de scène séparé.
  4. Réglez strength, radius, threshold, smoothWidth et setResolutionScale() en HDR avant la carte tonale.
  5. Gardez exactement un propriétaire de carte tonale et de conversion de sortie.
  6. Validez les vues de base, de contribution emissive, de bloom seul et de sortie finale aux budgets de bureau-discrète, bureau-intégrée et mobile.

Porte de capacité

Toute implémentation utilisant MRT ou des ressources de stockage doit passer par une porte après l'initialisation du rendu :

await renderer.init();

if ( renderer.backend.isWebGPUBackend !== true ) {
  throw new Error(
    'Le backend WebGPU est requis pour threejs-bloom. Si l'utilisateur demande explicitement comment appliquer un repli lorsque WebGPU n'est pas disponible, acheminez vers threejs-compatibility-fallbacks.'
  );
}

// Les niveaux WebGPU peuvent réduire bloomScale, pixelRatioCap, le nombre de contributeurs, ou
// désactiver bloom tout en préservant une scène de base lisible.

Implémentation WebGL héritée (obsolète, ne pas étendre) : aucune dans ce dossier de compétence ; les demandes de repli explicites sont acheminées vers $threejs-compatibility-fallbacks.

Conditions d'échec

  • bloom crée la seule forme visible d'un effet ;
  • l'albédo ordinaire ou les surfaces éclairées fuient dans la cible de contribution emissive ;
  • tous les matériaux brillants partagent un seul multiplicateur d'émission arbitraire ;
  • le seuil est réglé après la carte tonale ou la conversion d'affichage ;
  • plusieurs systèmes possèdent la carte tonale ou la conversion de couleur de sortie ;
  • le passage bloom s'exécute en pleine résolution par défaut sur des appareils à bande passante limitée ;
  • les chemins de redimensionnement omettent setSize() ou la validation de l'échelle de résolution ;
  • les hautes lumières deviennent grises car l'énergie HDR est écrasée avant bloom.

Frontière de routage

Utilisez $threejs-exposure-color-grading pour la mesure, l'adaptation, la carte tonale et les LUTs. Utilisez $threejs-image-pipeline lorsque bloom doit partager la profondeur, les normales, l'occlusion ambiante, l'anti-aliasing temporel ou d'autres ressources d'espace d'image. Utilisez $threejs-visual-validation pour les diagnostics de passage à vue fixe et les preuves de temps GPU.

Skills associés