Ambient Light COMP 完全ガイド | 使い方・パラメータ解説【TouchDesigner】

記事更新の通知はXでアナウンス٩(๑❛ᴗ❛๑)
→ @maru6o6をフォロー

概要 📖 – 3D シーンの環境光ベース

Ambient Light COMPは、シーン全体に均一な環境光 (Ambient) を加算する COMPです。位置や方向を持たず、Light Color と Dimmer のみで強度を制御するシンプルな光源で、Render TOP の Lights パラメータに登録して指向性 Light COMP のフィルとして使用します。

主な用途 🎯

全ジオメトリへ均一に作用する環境光 (Ambient) をシーンに追加
Light COMP (Point / Cone / Distant) の指向性光源と併用して暗部のディテールを底上げ
PBR ワークフローのフォールバック として最低限の拡散ベースを供給
Dimmer によるシーン全体の明るさ調整 (静的または CHOP/Expression 駆動)
Render TOP の Lights パラメータ に登録するだけで反映される簡易ベースライト

データフロー 🔄

入力: 環境光の色 (Light Color) + 強度 (Dimmer)
 ↓
Render TOP がシーン内全ジオメトリに均一加算
 ↓
出力: 暗部が持ち上がった最終ピクセル色

Tips

初心者の方は、以下日本語書籍も手元にあると安心です。

リンク

まる。

実際の案件事例まで踏み込んで紹介されていて、効率よくスキルアップするなら必携の二冊です！

パラメータ解説 ⚙️

Light Page ✨

Color / Dimmer 🎨

環境光の色と強度:

Light Color (R / G / B): c (cr / cg / cb) — 環境光の色を RGB で指定。Color List / HSV / RGB のいずれの入力方式でも切替可能
Dimmer: dimmer — 色相を維持したまま強度を変えるスカラ係数。静的値だけでなく CHOP / Expression で時間変化させて昼夜サイクル等にも利用可能

Render Page 🖼️

Material `.material` 🧪

COMP 内部ジオメトリ用の MAT:

Material: material — この COMP 内部のジオメトリに適用する MAT を選択 (Ambient Light の見た目自体には影響しないが、子ジオメトリを持つ場合のフォールバック)

Render Flag `.render` 🎬

Render TOP での描画可視性 (COMP の Render Flag と AND 評価):

Render: render — Render TOP でこのコンポーネントのジオメトリを描画するか。コンポーネントの Render Flag と論理 AND で評価される

Draw / Pick Priority 🔢

描画順序 (Draw) とピック優先度 (Pick):

Draw Priority: drawpriority — 描画順序を制御 (値が小さいほど後に描画)。同一親内・あるいは Render TOP の Geometry 同階層 COMP 間で比較。透明度を扱う際の前後関係調整に頻用
Pick Priority: pickpriority — Render Pick CHOP / Render Pick DAT の Search Area 内で複数候補がある場合、値が高い方が選ばれる。描画順序やピクセル単位のピックには影響しない

Wireframe Color `.wcolor` 🖍️

ワイヤーフレーム表示モード時の色:

Wireframe Color (R / G / B): wcolor (wcolorr / wcolorg / wcolorb) — ワイヤーフレーム表示モード時のコンポーネント色 (RGB)

Light Mask `.lightmask` 🎭

影響を受ける光源のサブセット指定:

Light Mask: lightmask — Render TOP に登録された光源のうち、このコンポーネントのジオメトリに影響させる光源だけをサブセット指定。空欄なら全光源が影響

Common Page 🔧

Parent Shortcut `.parentshortcut` 🔗

コンポーネント内部からこの COMP へのパスとして使えるショートカット名:

Parent Shortcut: コンポーネント内部の任意の場所からこの COMP を参照する際のショートカット名 (parent.<name> 形式で利用可能)

Global OP Shortcut `.opshortcut` 🌐

プロジェクト全体からこの COMP を参照するグローバル名:

Global OP Shortcut: プロジェクト内のあらゆる場所からこの COMP へのパスとして使えるグローバル名 (op.<name> 形式で利用可能)

Internal OP `.iop` 📎

Internal OP シーケンス (コンポーネント内部 OP への名前付き参照):

Shortcut: iop0shortcut — コンポーネント内部の OP に対するショートカット名
OP: iop0op — このコンポーネント内部の対象 OP へのパス

Node View `.nodeview` 👁️

ノードビューア (Network エディタ上のサムネイル) に表示する内容を決定

項目	内部名	説明
Default Viewer	`.default`	コンポーネントタイプ標準のビューアを表示
Operator Viewer	`.opviewer`	指定した任意 OP のノードビューアを表示

Operator Viewer `.opviewer` 🖼️

Operator Viewer モード時に表示する対象 OP:

Operator Viewer パス: Node View が opviewer モードのとき、そのビューア内容として表示する OP のパス

Cloning `.cloning` 🧬

マスター COMP の内容を複製する Cloning 設定:

Enable Cloning: enablecloning — Clone Master の内容を継続的に複製するかを切替
Enable Cloning Pulse: enablecloningpulse — その瞬間だけ Clone Master の内容を瞬時に複製
Clone Master: clone — 複製元となるマスターコンポーネントへのパス

Load on Demand `.loadondemand` ⏳

必要時のみメモリにロードする遅延ロード設定:

Load on Demand: オンの場合、このコンポーネントは実際に必要となるまでメモリにロードされない (起動時間・メモリ消費の最適化)

External .tox `.externaltox` 💾

外部 .tox ファイルとの連携設定:

Enable External .tox: enableexternaltox — 起動時に外部 .tox ファイルからロード
Enable External .tox Pulse: enableexternaltoxpulse — 外部 .tox ファイルから即時リロード
External .tox Path: externaltox — ディスク上の .tox ファイルへのパス
Reload Custom Parameters: reloadcustom — コンポーネントのカスタムパラメータ値を再読み込み
Reload Built-In Parameters: reloadbuiltin — コンポーネントの組み込みパラメータ値を再読み込み
Save Backup of External: savebackup — .toe ファイル内に外部 .tox のバックアップコピーを保存
Sub-Component to Load: subcompname — .tox 内部の特定 COMP のみを取り出してロード

Relative File Path Behavior `.relpath` 📁

このコンポーネント内部での相対ファイルパスの解決基準

項目	内部名	説明
Use Parent’s Behavior	`.inherit`	親コンポーネントの設定を継承
Relative to Project File (.toe)	`.project`	`.toe` プロジェクトファイルからの相対パスとして解決
Relative to External COMP File (.tox)	`.externaltox`	外部 `.tox` ファイルからの相対パスとして解決

Parameter Color Space `.parmcolorspace` 🎨

このコンポーネント内の色パラメータをどの色空間として解釈するか

項目	内部名	説明
sRGB	`.srgb`	標準的な sRGB ガンマ空間
sRGB – Linear	`.srgblinear`	sRGB プライマリでガンマ線形 (1.0)
Rec.601 (NTSC)	`.rec601ntsc`	Rec.601 NTSC 規格の色空間
Rec.709	`.rec709`	HDTV 用 Rec.709 色空間
Rec.2020	`.rec2020`	UHDTV / HDR 向け Rec.2020 広色域
DCI-P3	`.dcip3`	デジタルシネマ DCI-P3 色空間
DCI-P3 (D60)	`.dcip3d60`	D60 白点 DCI-P3
Display-P3 (D65)	`.displayp3d65`	D65 白点 Display-P3 (Apple ディスプレイ等)
ACES2065-1	`.aces2065-1`	ACES アーカイブ用色空間 (AP0 プライマリ)
ACEScg	`.acescg`	ACES CG 作業用色空間 (AP1 プライマリ)
Passthrough	`.passthrough`	色変換を行わず値をそのまま扱う

Parameter Reference White `.parmreferencewhite` ⚪

色パラメータの基準白色の扱い

項目	内部名	説明
Default For Color Space	`.default`	選択した色空間のデフォルト基準白を使用
Use Parent Panel	`.useparent`	親パネルの基準白設定を継承
Standard (SDR)	`.sdr`	標準ダイナミックレンジ (SDR) 基準白
High (HDR)	`.hdr`	ハイダイナミックレンジ (HDR) 基準白
UI	`.ui`	UI 表示用の基準白

実践アイデア 💡

Example 1: Cone Light + Ambient Light で暗部底上げ 💡

Light COMP (Cone Light) + Ambient Light COMP → Render TOP (Lights = /light1 /ambient1)

Cone Light の指向性スポットだけだとシーンの暗部が真っ黒に潰れる。Ambient Light COMP を Dimmer 0.15-0.25 程度で追加し Render TOP の Lights[] に並べると、暗部のディテールが見える状態を維持しつつ主光源のコントラストも残せる。

Ambient Light COMP を作成し Light Color を (1, 1, 1) のニュートラル白に設定
Dimmer を 0.15-0.25 (主光源 Cone Light より 5-10 倍弱い値) に設定
Render TOP の Lights パラメータに /light1 /ambient1 のように両光源のパスを並べて記述
プレビューで暗部のディテール量を見ながら Dimmer を微調整

Example 2: PBR ワークフローのフォールバック・ベース照明 🎨

Ambient Light COMP → Render TOP → PBR MAT 適用ジオメトリ

PBR マテリアル中心の制作で Environment Light COMP (IBL) をまだ用意していない初期段階に、Ambient Light COMP を低めの Dimmer でベース照明として配置すると、ワークインプログレスでも黒つぶれせずに法線とラフネスの目視確認が進められる。後で IBL に差し替えるとき Ambient Light を残しておくと最終仕上げのコントラスト微調整スライダとしても機能する。

Ambient Light COMP を 1 つ配置し Light Color を (1, 1, 1)、Dimmer を 0.1-0.2 に設定
PBR MAT を適用した Geometry COMP を Render TOP に接続
Environment Light COMP (IBL) を後から追加した後も、Ambient Light は残してハイライト/シャドウ平衡を取る

Example 3: Light Mask で対象ジオメトリだけ環境光を強める 🎭

Ambient Light COMP (/ambient_strong) → Geometry COMP (Light Mask = /ambient_strong)

ヒーローオブジェクトだけを強めの Ambient で持ち上げたい時、Ambient Light COMP を専用 2 個目として配置し、対象 Geometry COMP の Light Mask にその Ambient Light のパスのみを指定する。これで全体光は維持しつつ特定オブジェクトのみが明るく強調される。

通常 Ambient Light /ambient1 (Dimmer 0.15) と、ヒーロー用 /ambient_hero (Dimmer 0.5) を 2 個用意
ヒーロー Geometry COMP の Light Mask に /ambient_hero を追加指定
それ以外の Geometry COMP は Light Mask を空のままにして両光源の影響を受ける
Render TOP の Lights[] に両方の Ambient Light を登録

Info COMP情報 📊

この COMP は Info CHOP / Info DAT による詳細情報取得に対応しています。

COMP 固有情報 📦

num_children: コンポーネント内部の子 OP の総数
num_dats: 内部 DAT の数
num_chops: 内部 CHOP の数
num_tops: 内部 TOP の数
num_sops: 内部 SOP の数

汎用オペレータ情報 🔄

total_cooks: プロセス開始からのクック回数
cook_time: 最後のクック時間 (ミリ秒)
cook_frame: 最後にクックされたフレーム番号
warnings: 警告数
errors: エラー数

トラブルシューティング ⚠️

よくある問題と解決策 🔧

❌ Problem: シーンが全体的に白っぽくフラットになる
✅ Solution:

Dimmer を下げる (0.1-0.3 程度が目安。主光源より明らかに弱くする)
Light Color を純白ではなく主光源の補色寄り (例: 暖色光源には寒色 Ambient) にしてコントラストを保つ
ヒーローオブジェクトのみ強めにしたい場合は Geometry COMP の Light Mask を併用

❌ Problem: Render TOP に光が反映されない
✅ Solution:

Render TOP の Lights パラメータに Ambient Light COMP のパスが追加されているか確認
Render Page の Render パラメータがオンになっているか確認
Geometry COMP 側の Light Mask がこの Ambient Light を除外していないか確認

❌ Problem: PBR MAT で Ambient の効果が薄い
✅ Solution:

Environment Light COMP (IBL) を併用し IBL の Diffuse 寄与と組み合わせて使う
Material の Roughness / Metallic 設定を見直す (高 Metallic では Ambient の Diffuse 寄与が弱くなる)
Dimmer を 0.5-1.0 まで上げる (PBR の暗部リフトには SDR より高めの値が必要)

参考資料 📚

その他 🔗

公式リソース 📖

この記事はLLMと共に内容を執筆、更新しています。
最新バージョンとの項目差異など、情報の不一致を見つけた心優しい方はXもしくはInsta、メールなどよりサイト管理者までご連絡ください😎

まる。

お仕事のご依頼はDM又はメールにて。
━━━━━━━━━━━━━━━━━
Python/Touchdesigner/M5Stackをこよなく愛すフルスタックエンジニア。
専門は生理心理学、趣味はヨガやサウナ、EMS電気風呂などヘルスケア全般。
脳波や筋電、心拍を中心とした生体情報のセンシング＆インタラクティブアートづくりがライフワーク。

普段はワントゥーテンという会社で空間演出エンジニアをしています。
リファラル採用お繋ぎできますので、我こそはという尖った方は経歴と希望職種添えてDMください(エンジニア以外、営業職等もOK)。
ご飯行きましょう。

↓日常垢
Instagram：＠malmal0v0

概要 📖 – 3D シーンの環境光ベース

主な用途 🎯

データフロー 🔄

パラメータ解説 ⚙️

Light Page ✨

Color / Dimmer 🎨

Render Page 🖼️

Material .material 🧪

Render Flag .render 🎬

Draw / Pick Priority 🔢

Wireframe Color .wcolor 🖍️

Light Mask .lightmask 🎭

Common Page 🔧

Parent Shortcut .parentshortcut 🔗

Global OP Shortcut .opshortcut 🌐

Internal OP .iop 📎

Node View .nodeview 👁️

Operator Viewer .opviewer 🖼️

Cloning .cloning 🧬

Load on Demand .loadondemand ⏳

External .tox .externaltox 💾

Relative File Path Behavior .relpath 📁

Parameter Color Space .parmcolorspace 🎨

Parameter Reference White .parmreferencewhite ⚪