full-stack-skills/threejs-skills

threejs-lights

three.js lighting: AmbientLight, HemisphereLight, DirectionalLight, PointLight, SpotLight, RectAreaLight, LightProbe, IESSpotLight, ProjectorLight, shadow subtypes, and addon helpers such as RectAreaLightUniformsLib, RectAreaLightTexturesLib, LightProbeGene…

ソースを見る

使い方

  1. インストールコマンドをコピーし、自分の環境へ導入する前にソースを確認します。
  2. 必要なツール、認証情報、対応環境を原文で確認します。
  3. 入力と成果物を指定し、出力を資料と照合します。
npx skills add https://github.com/full-stack-skills/threejs-skills --skill threejs-lights

開始前の確認

  • 導入にはモデル契約、API枠、ファイルへのアクセス許可は含まれません。
  • スター数や導入数は活動の指標であり、独立した品質・安全性試験ではありません。
リポジトリの原文

見出し、例、コード、表、リンク、参照画像を含む原文を表示しています。

When to use this skill

ALWAYS use this skill when the user mentions:

  • Enabling castShadow / receiveShadow, shadow map size, bias, normal bias, camera frusta for shadow casters
  • Physical lights: intensity, distance/decay, angle/penumbra for spots, rect area setup
  • LightProbe for irradiance-style probes; IESSpotLight with IES data

IMPORTANT: lights vs loaders vs node-tsl

TopicSkill
Light classes and shadowsthreejs-lights
Loading IES/HDR filesthreejs-loaders
LightNode / TSL lightingthreejs-node-tsl

Trigger phrases include:

  • "DirectionalLight", "SpotLight", "RectAreaLight", "castShadow", "shadow map"
  • "阴影", "点光源", "面光源", "LightProbe"

How to use this skill

  1. Base recipe: ambient/hemisphere fill + directional sun + local points/spots.
  2. Shadows: enable on renderer, mark casters/receivers, tune map size vs performance, adjust bias to remove acne/peter-panning.
  3. RectArea: initialize addon libs per docs page before using light type.
  4. Probes: place probes; generate data via addon generator when applicable; relate to materials env reflections (threejs-materials, threejs-textures).
  5. IES: load profile via loader skill, attach to IESSpotLight per docs.
  6. Performance: limit shadow-casting lights; use layers (threejs-objects) to exclude objects.

See examples/workflow-directional-shadow.md.

Doc map (official)

Docs sectionRepresentative links
Lightshttps://threejs.org/docs/Light.html
Directionalhttps://threejs.org/docs/DirectionalLight.html
Spothttps://threejs.org/docs/SpotLight.html
Rect areahttps://threejs.org/docs/RectAreaLight.html

Scope

  • In scope: Core lights, shadow maps, probes, listed addons for rect area and probe generation.
  • Out of scope: CSM deep theory (see addon Csm docs if user names it); baked lightmaps in DCC.

Common pitfalls and best practices

  • Shadow map resolution must match scene scale—tiny shadows on huge worlds look blocky.
  • Point light shadows are six-face expensive—use wisely.
  • RectAreaLight without required libs yields black or wrong shading—verify init.
  • Mismatched physical units (intensity vs exposure) with threejs-renderers tone mapping causes blown or dim scenes.
  • Shadow bias / normalBias trade-offs: acne vs peter-paning—tune with helper frusta (threejs-helpers).

Documentation and version

Light and shadow classes live under Lights in three.js docs. RectAreaLight and probe addons depend on extra init from Addons → Lights; IES profiles require threejs-loaders for file fetch before the light API is usable.

Agent response checklist

When answering under this skill, prefer responses that:

  1. Link the concrete light type (DirectionalLight, SpotLight, …) and shadow pages when shadows are on.
  2. Separate IES loading to threejs-loaders and LightNode topics to threejs-node-tsl.
  3. Give practical shadow map size / bias guidance with threejs-helpers for frustum visualization.
  4. Mention renderer.shadowMap.enabled alongside light castShadow (see threejs-renderers).
  5. Note performance cost of multiple shadow-casting lights.

References

  • https://threejs.org/docs/#Lights
  • https://threejs.org/docs/DirectionalLight.html
  • https://threejs.org/docs/SpotLight.html
  • https://threejs.org/docs/LightShadow.html

Keywords

English: lights, shadows, directional, spotlight, rectarea, lightprobe, three.js

中文: 灯光、阴影、平行光、聚光灯、面光源、LightProbe、three.js

同じリポジトリから

関連する Skills

すべての Skills
full-stack-skills
コミュニティ

threejs-audio

three.js audio spatialization: AudioListener attached to camera rig, Audio and PositionalAudio sources, AudioAnalyser for FFT/time-domain data, and integration with Web Audio API contexts; AudioLoader is referenced from threejs-loaders for file decoding. Use when placing 3D sound, configuring panner parameters, or visualization; not a replacement for full game audio middleware.

1時間の導入数
3
GitHub Stars
14
更新日
10月3日
full-stack-skills
コミュニティ

threejs-camera

three.js cameras: Camera base, PerspectiveCamera, OrthographicCamera, CubeCamera, ArrayCamera, StereoCamera; projection matrices, aspect, FOV, orthographic frustum sizes, near/far planes, and dynamic environment maps with CubeCamera. Use when placing views, rendering reflections, or multi-view splits; for XR projections and eye matrices use threejs-webxr; for post pass camera tricks use threejs-postprocessing alongside threejs-renderers.

1時間の導入数
3
GitHub Stars
14
更新日
10月3日
full-stack-skills
コミュニティ

threejs-controls

Addon camera and object manipulation controls: OrbitControls, MapControls, FlyControls, FirstPersonControls, TrackballControls, ArcballControls, DragControls, PointerLockControls, TransformControls; damping, target focal point, and integration with the animation loop. Use for editor-style navigation and gizmos—not a full game character controller stack; pair with Raycaster selection patterns in threejs-objects when transforming selections.

1時間の導入数
3
GitHub Stars
14
更新日
10月3日
full-stack-skills
コミュニティ

threejs-dev-setup

Bootstrap and toolchain guidance for three.js applications using npm, Vite/Webpack/Rollup, bare ESM import maps, and TypeScript. Covers canonical import paths for three core versus three/addons/ (examples/jsm re-exports), version alignment with https://threejs.org/docs/, and fixing "module not found" for loaders and controls. Use when scaffolding a new 3D project, migrating bundler, or debugging resolution of addons—do not use for rendering API details (see threejs-renderers) or asset loading lo

1時間の導入数
3
GitHub Stars
14
更新日
10月3日