UI を作成する方法 (Python API / bpy) [Blender]

class MYTOOL_PT_render(bpy.types.Panel):
    """My Tool"""
    bl_idname      = "MYTOOL_PT_render"
    bl_label       = "Render"
    bl_space_type  = 'VIEW_3D'
    bl_region_type = 'UI'
    bl_category    = "My Tool"

    def draw(self, context):
        layout = self.layout
        scene = context.scene

        layout.label(text="Size:")
        row = layout.row(align=True)
        row.prop(scene, "resolution_x")
        row.prop(scene, "resolution_y")

        layout.label(text="Are You Ready?:")
        row = layout.row()
        row.scale_y = 1.5
        row.operator("render.render")

def register():
    bpy.utils.register_class(MYTOOL_PT_render)

def unregister():
    bpy.utils.unregister_class(MYTOOL_PT_render)

if __name__ == "__main__":
    register()

参考：

Blender 2.8 の Python 実行で UI パネルを追加する | MR が楽しい

Blender 2.8 で UI パネルに自作のプロパティを追加する | MR が楽しい

Panel 編 | めもてう

bpy.types.Panel | Blender Python API [Official]

templates_py/ui_tool_simple.py – blender/blender – GitHub

templates_py/ui_panel.py – blender/blender – GitHub

How to change the location of an addon in the UI – Blender Stack Exchange

列／行を作成する (row / column)

参考：

User interface elements alignment by columns | Interplanety

User Interface Layout – Best Practice | Blender Python API [Official]

How do I use multiple columns in my add-on UI? – Blender Stack Exchange

グリッドフロー (grid_flow / column_flow)

参考：

bpy.types.UILayout.grid_flow | Blender Python API [Official]

bpy.types.UILayout.column_flow | Blender Python API [Official]

Column Align – Blender Stack Exchange

split

参考：

bpy.types.UILayout.split | Blender Python API [Official]

keeping a UIlayout box a specific width percentage – Blender Artists Community

プロパティ欄を作成する (prop)

参考：

bpy.types.UILayout.prop | Blender Python API [Official]

オブジェクトを選択する

スポイトアイコン付きのオブジェクト選択欄を作成する。

参考：

オブジェクト指定のアドオンスクリプト | MR が楽しい

Object selection box with eyedropper – Blender Stack Exchange

Make the eyedropper tool available in add-ons via Python | Right-Click Select (Blender.Community)

GUI を作成する

参考：

Addon のチェックボックスの追加とプロパティへのアクセス | ぬの部屋 (仮)

Code snippets/Interface | wiki.blender.jp

アイコンを表示する

使用できるアイコンを確認する → Icon Viewer

参考：

UILayout.prop | Blender Python API [Official]

UILayout.label | Blender Python API [Official]

New icons for Blender 2.8x – Blender Developer Talk [Official]

2.8 Outlined/Coloured Icon Adaptation – Blender Developer Talk [Official]

Colored icons in add-on – Blender Developer Talk [Official]

New icons for Blender 2.8 – Blender Artists Community

2.8 Outlined/Coloured Icon Adaptation – Blender Artists Community

Is there a list or something available which shows the code of the Symbols of Blender – Blender Stack Exchange

How to edit 2.8 UI icons? – Blender Stack Exchange

項目に色を付ける (alert)

参考：

In Python is it possible to change the background color of a property ui? – Blender Stack Exchange

パイメニューを作成する

参考：

Permanently expanded submenu in pie menu – Blender Artists Community

How to properly overwrite Blender default keys with Pie Menu hotkeys – Blender Stack Exchange

Mesh / Object Mode with Pie menu? – Blender Stack Exchange

Make a Pie-Specials Menu, dependent on selection type – Blender Stack Exchange

shift in my hotkeys toggles multiselection mode between vertex edge and faces, how to toggle off previous mode? – Blender Stack Exchange

パネルを条件に応じて表示する (poll)

条件を判定してパネルの表示・非表示を切り替えるにはクラスメソッド poll を定義する。

    @classmethod
    def poll(cls, context):
        return context.object is not None

参考：

Blender で選択されているオブジェクトがメッシュで名前が Cube の時だけ UI を表示する (dskjal) – GitHub Gist

Simple Object Panel | Blender Python API [Official]

パネルを一時的に無効化する

enabled プロパティに False を指定する。

class MYTOOL_PT_test(bpy.types.Panel)
    # ...
    def draw(self, context)
        layout = self.layout
        col = layout.column()
        col.enabled = False
        col.prop(scene, ...)

参考：

UILayout.enabled | Blender Python API [Official]

How to disable a single component in a custom panel? – Blender Artists Community

How to do i disable a row.operator in my custom panel by detecting if there is a specific modifier type and name is present or not? – Blender Stack Exchange