BagaCam – OSL Camera Presets for Blender ドキュメント
Blender内でOpen Shading Language（OSL）カメラシェーダーを直接閲覧、適用、カスタマイズ可能なアドオン。
BagaCamとは？
BagaCamは OSLカメラシェーダー を使用するツールです。レンダリング画像の上に単純なポストエフェクトを重ねるのではなく、カメラ自体がシェーダーとして機能し、シーンへの光線の射出方法（歪み、色収差、周辺減光、被写界深度、ボケの形状、グローなど）を制御します。
この処理はCyclesの 内部 で行われるため、エフェクトはモーションブラー、透明度、ボリューム、反射、解像度に対して正しく反応します。単なるフィルター処理ではなく、実際のレンズのような挙動を再現します。
インストールと導入
- Edit > Preferences > Add-ons > Install… からアドオンをインストールします。
- BagaCam を有効にします。3Dビューポートとカメラプロパティに新しいパネルが表示されます。
- ギャラリーから任意のプリセットを選択し、アクティブなカメラに対して Apply Preset（プリセットを適用）をクリックします。
オプション： Add Preset ボタンを使用して、任意の .osl ファイルを Presets リストにインポートすることも可能です。
プリセットブラウザ
プリセットブラウザは、モジュールの presets フォルダにあるすべてのOSLカメラシェーダーを表示します。
- プリセットサムネイル: 各カードにプレビューを表示します。
- カテゴリ: 上部のドロップダウンでプリセットを分類してフィルタリングします。
- タグ: キーワードを入力して、そのタグを含むプリセットを表示します。
- 検索: 名前でプリセットをフィルタリングします。
- お気に入りのみ: お気に入りに登録されたプリセットのみを表示します。
- クイックナビゲーション: 左右の矢印を使用して、表示されているプリセット間を移動します（リストの端でループします）。
- プリセットの更新: プリセットの追加、名前変更、削除を行った後にリストを再読み込みします。
プリセットの追加と適用
カメラを選択し、ブラウザでプリセットを選んで Apply Preset をクリックします。BagaCamがそのカメラにカスタムカメラシェーダーとコントロールを設定します。
BagaCamは Cyclesのみ で動作します。他のエンジンがアクティブな場合、ワンクリックで切り替えられる Switch to Cycles ボタンが表示されます。
シーン内の 各カメラに異なるプリセット を割り当てることができます。
プリセットのパラメータを調整した後に別のプリセットに切り替え、再度元のプリセットに戻った場合、値はそのプリセットの デフォルト設定 に戻ります。
カメラパネル
カメラにBagaCamプリセットが使用されている場合、2つのセクションが表示されます。
- Parameters（パラメータ）: ユーザーフレンドリーにグループ化されたコントロール（歪み、色収差、周辺減光、被写界深度、ボケ、グローなど）。
- Preset Parameters（プリセットパラメータ）: 高度な調整のために、すべての生のシェーダー入力を表示します。
Cyclesがアクティブでない場合、Switch to Cycles ボタンが自動的に表示されます。
ツールとインターフェース
| ボタン名 | 機能説明 |
|---|---|
| Apply Preset | 選択したカメラプリセットをアクティブなカメラに適用し、コントロールを表示します。 |
| Previous / Next | 現在のフィルタリング状態を維持したまま、前後のプリセットに移動します。 |
| Switch to Cycles | シーンのレンダリングエンジンをCyclesに切り替えます（OSLカメラに必須）。 |
| Add Preset | 外部のOSLファイル（およびオプションのメタデータ）をプリセットライブラリにインポートします。 |
| Refresh Presets | ファイルの追加、名前変更、削除後にプリセットリストを再読み込みします。 |
| Save as New Preset | 現在カメラに適用されている設定値をデフォルト値として読み取り、新しい名前、説明、タグでプリセットを複製・保存します。 |
| Rename Preset | プリセットおよび関連ファイル（OSL、コンパイル済みシェーダー、プレビュー、メタデータ）を安全に名前変更します。 |
| Favorite | 「⭐」を切り替えてプリセットをお気に入りに登録します。お気に入りはリストの上部に固定されます。 |
| Set Preview | 選択したプリセットにカスタムサムネイル（PNGまたはJPG）を割り当てます。 |
| Edit Preset Metadata | フォームを通じてプリセットの説明、カテゴリ、タグを編集します。 |
| Generate Previews | 付属の Classroom シーンを使用して、画像がないプリセットのサムネイルを自動的にレンダリングします。 |
OSLシェーダー設定
Strength: 機械的な口径食（ビネッティング）をシミュレートします。端にあるボケ形状がレンズ鏡筒によって切り取られ、猫の目のような形になります。
Falloff: 画像中心から離れるにつれて、キャッツアイ効果がどれだけ早く現れるかを制御します。 Anamorphic (アナモルフィック):
Squeeze: アナモルフィックシネマレンズの外観を模倣するために、ボケ点を強く引き伸ばします（1.33や2.0などの値を推奨）。
Rotation: アナモルフィックストレッチの軸を回転させます。 Doughnut (ドーナツ):
Strength: ボケた光点を、反射望遠レンズ（カセグレン式など）に特徴的なリング状（ドーナツ形）に変形させます。
メタデータの編集
プリセットのメタデータ（カテゴリ、タグ、説明、お気に入り状態、プレビューパス、デフォルト値など）は、各プリセットと共に保存されます。すべての管理ツールは、既存のカメラやシーンを壊すことなく、このメタデータを安全に更新します。
メタデータは以下のように.oslファイル自体に格納されます：
知っておくべきこと
- カスタムOSLカメラは Cyclesのみ で動作します。
- プリセットを切り替えると、パラメータは各プリセットのデフォルト値に リセット されます。
- お気に入りは常にプリセットリストの最上部に固定され、素早くアクセスできます。
よくある質問 (FAQ)
独自のプリセットを追加するには？
OSLファイルをpresetsフォルダにドロップするか、Add Preset ボタンを使用し、その後 Refresh Presets をクリックしてください。
なぜCyclesが必要なのですか？
OSLカメラシェーダーはCyclesでのみサポートされており、Eeveeでは動作しません。Switch to Cycles ボタンを使用して有効化してください。
プリセットの名前を変更しても安全ですか？
はい、安全です。Rename Preset はOSLファイル、コンパイル済みシェーダー、プレビュー、メタデータを更新するため、既存のカメラは引き続き機能します。
プリセットにプレビューがない場合は？
Generate Previews を使用すると、画像が不足しているすべてのプリセットに対してサムネイルを自動的にレンダリングします。
更新履歴
v1.0.0 初回公開リリース：完全なプリセットブラウザ、OSLカメラ、メタデータシステム、サムネイル、管理ツールが含まれます。
コメント