--- vocab: developer-facing --- (context-browser)= # Context Browser 使いたいプロパティや、条件に使う現在の状態が、Blenderの画面上で見つからないことがあります。**Context Browser（CB）** は、contextやデータをたどり、プロパティの値・Pythonのパス・メソッドを確認するためのアドオンです。見つけたプロパティをその場で編集し、パスや値をコピーできます。PMEと組み合わせると、プロパティをキャプチャメニューへ渡して、自分のメニューに追加できます。CBは単体でも利用できます。 PME-Fを購入済みの方は、[PME Repositoryの設定](../getting_started/installation.md)後、BlenderのPreferences → Get Extensionsで **Context Browser** を検索し、インストールして有効にしてください。 ## 画面の構成 ```{raw} html :file: common/_context_browser_overview_map.html ``` 1. {ref}`パスとブックマーク ` 2. {ref}`オブジェクトとコレクション ` 3. {ref}`プロパティとメソッド ` 4. {ref}`検索と表示フィルター ` 5. {ref}`Pins ` (cb-open)= ## 開く各エリアのヘッダーにあるCBボタンから、そのエリアのcontextを開きます。**F3 → Context Browser**、または画面左上の**Blenderメニュー → Context Browser...** からは、Pickerで調べたいエリア・リージョンを選びます。ハイライトを確認してクリックするとCBが開き、Escまたは右クリックで選択を中止します。たとえば3D Viewportを選ぶと、その場所のアクティブオブジェクトや表示設定をたどれます。Outlinerなど別のエリアでは、参照できるcontextの内容が変わります。アドオンのPreferencesから呼び出し用ショートカットも設定できます。 (cb-navigation)= ## パスとブックマーク ```{raw} html

``` 上部には現在のパスが表示されます。画像の **C → area** は `C.area`、つまりCBを開いた場所のエリアです。パスの各部分をクリックして、その階層へ戻れます。 **C** は `bpy.context`、**D** は `bpy.data` を表します。左端の▼メニューから **Context** と **Data** を切り替えます。右端のコピーボタンで現在のパスをコピーできます。 **Add Bookmark** は現在の場所をブックマークに追加します。同じ▼メニューから選び直せます。特定のプロパティを下部に置く場合は、{ref}`Pins `を使います。 (cb-objects)= ## オブジェクトとコレクション左の一覧から、現在の対象が持つオブジェクトやコレクションをたどります。`[..]` は一つ上の階層へ戻ります。画像では `C.area` の `regions` や `spaces` が並んでいます。`regions` を開くと、そのエリアを構成するリージョンを調べられます。左下の **Width** で、左右の一覧の幅の比率を調整します。 (cb-members)= ## プロパティとメソッド ```{raw} html

PropertiesにHeight、Show Menus、Editor Typeなど、Functionsにheader_text_set(text)とtag_redraw()が並ぶ。

``` 右の **Properties** には値が並びます。変更可能なプロパティは、チェックボックスや入力欄などから編集できます。配列などは **Edit...** から開きます。画像のHeightやWidthのような読み取り専用の値は確認のみです。 **Functions** にはメソッド名と引数が並びます。引数なしと分かるものは `tag_redraw()` のように表示されます。引数情報を取得できない場合は `(...)` になります。一覧を表示するだけでは、メソッドは実行されません。各行の左端はPin、隣は型のアイコン、右端は **Target Actions** です。 (cb-target-actions)= ### Target Actions 各行の右端から、対象のパスや値を使う操作を選びます。表示される項目は、対象の種類やPMEの利用可否によって変わります。 Copy Path : プロパティのPythonパスをコピーします。例: `C.object.display_type`。 Copy Value : 操作した時点の値をPythonの値としてコピーします。enumでは画面上のラベルではなく、`'WIRE'` などのidentifierをコピーします。 Copy Enum Identifiers : enumに宣言されているidentifierの一覧をコピーします。現在選択中の値だけを得る場合は **Copy Value** を使います。 Copy Method Path : メソッドまでのパスをコピーします。例: `C.area.tag_redraw`。 Copy Call Template : 引数を含む呼び出しのひな形をコピーします。例: `C.area.tag_redraw()`。メソッドを実行する操作ではありません。引数がある場合は、実行前に内容を調整してください。 Open API Reference : Blender公式APIドキュメントを開きます。掲載先を特定できない対象では、公式ドキュメントの検索へ進みます。 Capture in PME... : プロパティをPMEのキャプチャメニューへ渡します。続けて追加先を選び、メニュー項目を作成します。対応するPMEが有効な場合に利用できます。コピーやキャプチャの前に対象が失われたり、別の対象に変わった場合は、エラーを確認してCBを開き直してください。 (cb-filters)= ## 検索と表示フィルター ```{raw} html

``` 左右の検索欄は、それぞれの一覧を絞り込みます。プロパティは表示名とidentifierのどちらからも検索できます。右下の **Show Property Identifiers** で、プロパティ名をUIラベルとPythonのidentifierの間で切り替えます。画像の **Height** は `height`、**Show Menus** は `show_menus` に対応します。その隣の型フィルターで、Boolean、整数、数値、文字列、enum、配列の表示を切り替えます。項目が見当たらない場合は、検索文字列と型フィルターを確認してください。 (cb-pins)= ## Pins ```{raw} html

ピンしたカラーと頂点サイズ、その下のCopy All Paths、Copy Snapshot、全削除。

``` 行の左端のPinを押すと、対象を下部の一覧に追加します。もう一度押すと解除します。Pinがないときは、この一覧は表示されません。プロパティは通常の一覧と同じように値を確認・編集でき、メソッドは名前と引数を参照できます。各行のTarget Actionsも使えます。 Pinはパスを保持します。たとえば `C.active_object.color` は、そのときのアクティブオブジェクトを参照します。Pinした時点のオブジェクトを固定するものではありません。アクティブオブジェクトがないなど、参照できない場合は行に問題が表示されます。 **Copy All Paths** はピンしたパスをまとめてコピーします。**Copy Snapshot** はパスと取得時点の値などをまとめてコピーし、調査メモやAIへの相談に使えます。右端のごみ箱はすべてのPinを削除します。アドオンのPreferencesにも **Pinned Paths** があります。ここではパスの一覧を確認し、一括コピーや削除を行えます。 (cb-console-picker)= ## ConsoleのArea Picker Python Consoleのヘッダーにあるスポイト付きの **Area Picker** は、現在入力しているコードを、選んだエディターで実行するための文で包みます。 1. Consoleにコードを入力します。まだ実行しません。 2. **Area Picker** を押して、対象のエリアをクリックします。 3. `with C.temp_override(...):` が付いた入力を確認して実行します。たとえば、選択対象へ3D Viewを寄せるコードを入力します。 ```python bpy.ops.view3d.view_selected() ``` 3D Viewを選ぶと、選んだエリアとそのWINDOWリージョンを指定した `with C.temp_override(...): bpy.ops.view3d.view_selected()` の形になります。Pickerはコードを挿入するだけで、自動実行しません。隣のコピーアイコンは、選んだエリアのパスをクリップボードへコピーします。エリアのインデックスは画面の分割・結合で変わるため、レイアウトを変えた後は選び直してください。実行場所の指定は、モードや選択状態を変更しません。たとえばメッシュのEdit Modeで選択を広げる操作は `bpy.ops.mesh.select_more()`、Object Modeで親子関係の選択を広げる操作は `bpy.ops.object.select_more()` です。必要な状態が合わない場合は、場所を指定していても実行できません。 (cb-settings)= ## 表示設定 CB左上の▼メニュー末尾の **Settings...**、またはアドオンのPreferencesから変更します。 Show Header Button : 各エリアのヘッダーにCBの呼び出しボタンを表示します。 Show Console Area Picker : Python ConsoleのヘッダーにArea Pickerとパスコピーのボタンを表示します。 Width : CBポップアップの幅を指定します。次にCBを開いたときに反映されます。 Number of Rows : オブジェクト・プロパティ一覧に表示する行数を指定します。 ## 関連ページ ```{admonition} 関連ページ :class: seealso - {doc}`context_menu` — PMEのキャプチャメニュー - {doc}`property_stack_editor` — プロパティへの操作を組み立てる - {doc}`context_router_editor` — 現在の状況から呼び出す対象を選ぶ - {doc}`../reference/command_text` — コマンドを編集する ```