Communitygithub.com

dnlgalleguillos/gauge-light-render

Blenderの被写体に対してライティング、フレーミング、レンダリングを行い、測定結果を出力します。サブジェクトのサイズに合わせたリグ、ターゲットフレーミングに解かれたカメラ距離、レンダープリセット、ターンテーブル、そして露出、コントラスト、クロッピング、ショット内の可視ライトをチェックするレンダリング検証を行います。ライティング、カメラ、ルック開発、最終レンダリングに使用します。

gauge-light-render とは?

このスキルは、Blenderにおけるライティングとカメラワークを、被写体のサイズに基づいて自動化し、小さなプレビューレンダリングで検証するためのツールです。まず、指定したレンズ焦点距離とフレーム内の被写体占有率(フィル率)から、カメラ距離を二分法で自動計算し、被写体の中心にカメラを向け、被写界深度を設定します。次に、被写体サイズに応じてスケーリングされた複数のライトプリセット(スリーポイント、ソフトボックス、ドラマチック、曇天)を配置し、キーライトとフィルライトの比率を計測します。さらに、ドラフト、プレビュー、ファイナルの3段階のレンダープリセットを適用し、最後にレンダリング結果に対して、白飛びや黒つぶれの割合、コントラスト、平均輝度、フレーム内への被写体収まり、ライトの可視性などをチェックします。ターンテーブル機能も備えており、被写体を周回するアニメーションを生成します。このスキルは主にClaude CodeやClineなどのBlender scriptingスキルと組み合わせて使用され、Gateによる検証結果の読み取りが可能で、再現性の高いライティングとレンダリングワークフローを実現します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dnlgalleguillos/blender-gauge/tree/HEAD/skills/gauge-light-render

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

ゲージ ライト&レンダー

ライトとカメラは被写体のサイズから設定され、小さなレンダリングで検証されます。

1. フレーミング

run_blender_script path=skills/gauge-light-render/scripts/frame_camera.py
  args={"subject":"Props","lens":85,"azimuth":25,"elevation":18,"fill":0.55,"aperture":2.8}

fill は、被写体がその制限側(幅または高さ)に対してフレーム内で占める割合です。距離は二分法で決定され、カメラは被写体の中心を見つめ、被写界深度は被写体に焦点を合わせます。Gate camera-framing:カメラの前、クロップされていない、制限内に収まっている。プロダクトやポートレートには長めのレンズ(85-135 mm)、インテリアには24-35 mmを使用します。

2. ライティング

run_blender_script path=skills/gauge-light-render/scripts/rig.py args={"subject":"Props","preset":"three_point","ground":true}
プリセットキャラクター
three_pointキー+フィル+リム、汎用
softbox_product大きなトップライトと2つのストリップ、クリーンなスペキュラエッジ
dramatic小さなハードキー、リム、ほとんどフィルなし
overcastソフトな空、ハードシャドウなし

距離とサイズは被写体の半径に比例し、パワーは距離の二乗に比例します。strength はすべてをスケーリングします。ライトはカメラに見えません。Gate light-rig はキー対フィル比を報告します(有用範囲 0.8-12;3-4 が自然)。

3. 設定

scripts/render_preset.py と preset = draft(16サンプル、50%)、preview(64、75%)、final(256、100%);Cyclesとノイズ除去、AgXを使用。Gate render-settings。

4. チェック

scripts/render_check.py がレンダリングし、Gate render-check:クリップされた白 <= 2%、つぶれた黒 <= 10%、コントラスト (p95-p5) >= 0.25、平均輝度 0.12-0.75、被写体がフレーム内に完全に収まっている、ショット内にエリアライトが表示されていない。reference を追加すると、別の画像との距離も取得できます。保存したコピーでヘッドレス実行:python skills/gauge-core/scripts/run_headless.py skills/gauge-light-render/scripts/render_check.py --blend scene.blend subject=Props。

ターンテーブル

scripts/turntable.py はカメラを被写体中心のピボットにペアレントし、一定速度で360度回転させます。最初のフレーム、1/4フレーム、最後のフレーム、および frame_end + 1 で検証されます。

ルール

  • 大きな光源 = ソフトな光。キーを被写体と同程度の大きさにし、近づけると柔らかくなります。
  • 常にライトをカメラの視界外に保ちます。Blender 5.3 はライトを自動的にカメラから不可視にしますが、ゲートがそれをチェックします。
  • AgX がデフォルトのビュートランスフォームです。ハイライトがまだクリップする場合は、露出を触る前にキーを下げてください。
  • 最終レンダリング:コピーを保存し、ヘッドレスで実行します。ライブセッションからは決して実行しないでください(Blenderがブロックされ、クラッシュするとシーンが失われます)。
  • ワイヤーフレーム表示:Workbenchはレンダリングでワイヤーフレームを無視します。代わりに一時的なワイヤーフレームモディファイアを追加してください。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

関連スキル