Floating Panel Editor¶
Floating Panel は、作業中に開いて使うパネルを、行と列に操作や設定を並べて作るエディターです。複数の設定を一つの作業用パネルに集めたり、Vector Menu に組み込んだりできます。
行や列を追加し、その中にスロットを配置する編集方法は、Popup Dialog Editor と同じ考え方です。Popup Dialog のレイアウト編集を出発点に、作業用のパネルを組み立てられます。
開発中の機能
Floating Panel は、Blender の UI レイアウトを GPU で描画するための PME の仕組み GPULayout を使っています。Vector Menu も同じ仕組みで描画されます。
Floating Panel と GPULayout は開発中です。編集方法は Popup Dialog と似ていますが、対応するウィジェット・レイアウト API・表示や操作は完全に同じではありません。現在の対応範囲は下の構成ガイドを参照してください。
構成ガイド — 作業用パネルを組み立てる(AI 向け)
呼び名:Floating Panel/種別 ID:FPANEL。 行・列のレイアウトに Command / Property / Menu / Hotkey / Custom を配置します。編集レイアウトは Popup Dialog と共通する部分がありますが、実行時の表示と対応 UI は同一ではありません。
Property:RNA パスを指定して設定を配置。Custom では
Lの対応レイアウト API を使います。Blender のあらゆる UI をそのまま描けるとは仮定しません。Menu:別のカスタマイズを参照。Vector Menu から配置する場合は Expand Panel の構成を使います。
用途:色や数値を調整する作業パネル/頻繁に使う操作を並べる/Vector Menu の方向スロットや上下の追加スロットに設定群を配置。
設計時の判断:パネルを単独で開くのか、別メニューに展開するのかを先に決めます。展開先ごとの幅・位置は配置先のスロットで指定します。
レイアウトは 行とスロット、表示の整列は Advanced settings、組み込みは 活用例へ。
画面と編集の流れ¶
名前と呼び出すキーを決め、行にスロットを追加してパネルを組み立てます。実際に使うエディターで開き、操作対象が合っているか確認します。
名前と基本操作¶
有効状態、プレビュー、名前、タグなどの共通操作です。各ボタンは 選択メニューの設定を参照してください。
Advanced settings¶
Description と Poll に加え、プロパティのラベルと入力欄の表示方法を設定します。
Added in version 2.1: Property Split によるプロパティ名と入力欄の整列に対応。
Property Split はラベルと値を分けて整列します。Property Decorators はアニメーションに関する装飾表示を設定します。この入力欄は Property Split が ON のときに有効になります。項目ごとの表示設定も確認してください。共通の説明文・利用条件は 詳細設定を参照してください。
Keymap / Hotkey¶
使う場所を Keymap、起動キーと修飾キーを Hotkey で設定します。入力操作は 共通の Hotkey 設定を参照してください。
行とスロット¶
行を追加し、その中に操作やプロパティを配置します。列やサブ行を組み合わせて、例えば上段を状態表示、下段を操作ボタンにできます。
Command は選択時に実行する Python コード。
Property は既存の RNA プロパティを表示・変更するウィジェット。
Menu は別のカスタマイズへの参照。
Hotkey は実行時のキー割り当てからオペレーターを探して呼び出す項目。
Custom は Python で描画する UI。描画時にデータを変更する処理を置かないでください。
行・列の編集操作は Popup Dialog のレイアウト と共通する部分があります。コードの入力制限は コードの書き方と入力制限 を参照してください。