threejs-scenes について
three.js 開発者向けに、Scene、フォグ、背景設定を扱うシーン API のスキルです。フォグとカメラの far 平面の関係を説明し、HDR やテクスチャなどの関連資料を案内します。
主な機能
- 01Scene と背景の設定
- 02線形フォグと指数フォグの区別
- 03フォグ距離とカメラ far 平面の調整
- 04背景、環境、レンダラー設定の関係の説明
- 05HDR、ローダー、テクスチャ資料の案内
活用シーン
- 01three.js シーンの背景設定
- 02シーンの規模に合わせたフォグ調整
- 03フォグとカメラのクリッピング問題の調査
- 04フォグ設定から HDR 環境設定への移行
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ full-stack-skills/ threejs-skills --skill threejs-scenesインストール後、Claude Code で/threejs-scenesを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yamlexamples/workflow-fog-background.md
詳細
このスキルを使用するタイミング
ユーザーが次の内容に言及した場合は、必ずこのスキルを使用してください。
Sceneをルートにする構成、scene.background、シーンレベルでの環境またはスカイボールの設定FogまたはFogExp2のパラメーター(near、far、color、密度)と、カメラの far 平面との相互作用- レンダーリストを概念的に整理すること(シーンの子要素)
重要:シーンとテクスチャとローダーの違い
| 対象 | スキル |
|---|---|
| Scene + fog API | threejs-scenes |
| テクスチャのサンプリング、PMREM ジェネレーターの使用 | threejs-textures |
| HDR/glTF の取得 | threejs-loaders |
トリガーとなる語句の例:
- 「Scene」、「Fog」、「FogExp2」、「background」、「霧」
- 「シーンルートノード」、「線形フォグ」、「指数フォグ」
このスキルの使用方法
Sceneをインスタンス化し、グラフのルールに従ってライト/メッシュ/カメラを子要素として追加します(threejs-objects)。- 屋外や地平線の雰囲気に合わせて、線形の
Fogと指数関数的なFogExp2のどちらかを選びます。 - クリッピングのアーティファクトを避けるため、カメラの
farと併せてフォグのnear/farを調整します。 - ドキュメントに従って
scene.backgroundにColor、Texture、またはキューブマップを設定します。環境ライティングには、対応するレンダラー/マテリアルの設定も必要です。 - ユーザーが HDR ファイルを使った IBL を求めている場合は、ローダー → テクスチャ → マテリアルのパイプラインを明示的に案内します。
- パフォーマンス向上のためのフラスタムカリングを、フォグで代替できないことを説明します。
examples/workflow-fog-background.md を参照してください。
ドキュメントの一覧(公式)
| ドキュメントのセクション | 代表的なリンク |
|---|---|
| シーン | https://threejs.org/docs/#Scenes |
| シーン | https://threejs.org/docs/Scene.html |
| Fog | https://threejs.org/docs/Fog.html |
| FogExp2 | https://threejs.org/docs/FogExp2.html |
対象範囲
- 対象範囲内: API レベルでの
Scene、フォグの種類、background フィールドの意味。 - 対象範囲外: HDR/glTF ファイルの取得(threejs-loaders);PMREM とテクスチャのサンプリング(threejs-textures);トーンマッピング/出力色空間のデフォルト(threejs-renderers);シーンの
Fogと関連付ける場合を除く、全画面フォグ専用のポストプロセススタック(threejs-postprocessing);コアのフォグ API を超えるカスタム大気散乱シェーダー。
よくある落とし穴とベストプラクティス
- 地平線の継ぎ目を目立たなくするには、フォグの色を背景と調和させます。
- フォグを使っていても、カメラの
farが非常に大きい場合は、シーンのスケールとの整合性が必要です。 backgroundの回転/強度に関する機能はレンダラーのバージョンに依存するため、最新のドキュメントを参照してください。
ドキュメントとバージョン
Scene、Fog、background フィールドは、three.js docs の Scenes に記載されています。環境に関するビジュアル表現では、多くの場合、このスキルと threejs-textures(PMREM)および threejs-loaders(HDR ファイル)を組み合わせます。ユーザーの関心が「フォグの色」から「HDR スカイ」に移ったら、該当ページへのリンクを案内してください。
エージェントの回答チェックリスト
このスキルに基づいて回答する際は、次の点を優先してください。
Scene、Fog、またはFogExp2の公式ページにリンクします。- フォグの距離を threejs-camera の
far平面およびワールドスケールに関連付けて説明します。 - PMREM/HDR ファイルの手順は、threejs-textures/threejs-loaders に委ね、それぞれ一文で説明します。
- 色管理のチュートリアル全体を重複して説明せず、レンダラーとテクスチャのスキルを参照するよう案内します。
参考資料
- https://threejs.org/docs/Scene.html
- https://threejs.org/docs/Fog.html
- https://threejs.org/docs/FogExp2.html
キーワード
英語: scene、fog、fogexp2、background、environment、three.js
中国語: シーン、霧、Fog、背景、環境、three.js
コメント
Markdown 対応