Yamyam: ページの作成:「元記事：[https://developer.blender.org/docs/release_notes/4.1/python_api/ Python API - Blender Developer Documentation] = Blender 4.1: Python API = == Python 3.11 =…」

2024-03-15T21:39:02Z

ページの作成:「元記事：[https://developer.blender.org/docs/release_notes/4.1/python_api/ Python API - Blender Developer Documentation] = Blender 4.1: Python API = == Python 3.11 =…」

新規ページ

元記事：[https://developer.blender.org/docs/release_notes/4.1/python_api/ Python API - Blender Developer Documentation]

= Blender 4.1: Python API =

== Python 3.11 ==

Python が VFX platform 2024に合わせて[https://www.python.org/downloads/release/python-3110/ バージョン 3.11]にアップグレードしました。

== Enum ID プロパティ ==

整数型（integer）プロパティが列挙（enum）型アイテムに対応しました。[https://projects.blender.org/blender/blender/commit/92cf9dd2f2d7f4d8d380d4b1dcc17f6c2b5b175d 92cf9dd2f2d7f4d8d380d4b1dcc17f6c2b5b175d]

UI を通じた列挙アイテムの編集は未対応です（技術的な理由は上のコミットメッセージを見てください）。

列挙アイテムは整数型プロパティに [https://docs.blender.org/api/main/bpy.types.bpy_struct.html#bpy.types.bpy_struct.id_properties_ui id_properties_ui] Python メソッドを使用して追加できます。`as_dict` メソッドを使用してプロパティの列挙リストアイテムを取得できます。

<syntaxhighlight lang="Python">
my_object["my_prop"] = 2
ui_data = my_object.id_properties_ui("my_prop")
ui_data.update(items=[
("TOMATOES", "Tomatoes", "Solanum lycopersicum"),
("CUCUMBERS", "Cucumbers", "Cucumis sativus"),
("RADISHES", "Radishes", "Raphanus raphanistrum"),
])
print(ui_data.as_dict())
</syntaxhighlight>

既存の便利なラッパー関数も同様に対応しています。

<syntaxhighlight lang="Python">
from rna_prop_ui import rna_idprop_ui_create

rna_idprop_ui_create(my_object, "my_prop", default=2, items=[
("TOMATOES", "Tomatoes", "Solanum lycopersicum"),
("CUCUMBERS", "Cucumbers", "Cucumis sativus"),
("RADISHES", "Radishes", "Raphanus raphanistrum"),
])
</syntaxhighlight>

列挙アイテムの付いた整数型プロパティは、UI 内でドロップダウンボタンとして表示されます。

[[File:Id_property_enums.png|center]]


== レイアウトパネル ==
Blenderに新しく "layout panel" が追加されました。このパネルは `draw` 関数内で定義され、新たな登録は必要ありません。

これにより、パネル内の開閉可能なセクションの作成に必要なコード量が大幅に削減されます。([https://projects.blender.org/blender/blender/commit/f824476bd5f81f98f9b969661e8e9ac4d50a5521 f824476bd5f81f98f9b969661e8e9ac4d50a5521]、[https://projects.blender.org/blender/blender/commit/8896446f7e72084018bf7a45306a83d92e22f34a 8896446f7e72084018bf7a45306a83d92e22f34a]、[https://projects.blender.org/blender/blender/commit/ddd06eeb8f7495600c3a42a1c664c8b4de958ede ddd06eeb8f7495600c3a42a1c664c8b4de958ede])

<syntaxhighlight lang="Python">
import bpy
from bpy.props import BoolProperty

class LayoutDemoPanel(bpy.types.Panel):
bl_label = "Layout Panel Demo"
bl_idname = "SCENE_PT_layout_panel"
bl_space_type = 'PROPERTIES'
bl_region_type = 'WINDOW'
bl_context = "scene"

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

layout.label(text="Before")

header, panel = layout.panel("my_panel_id", default_closed=False)
header.label(text="Hello World")
if panel:
panel.label(text="Success")

header, panel = layout.panel_prop(scene, "show_demo_panel")
header.label(text="My Panel")
if panel:
panel.prop(scene, "frame_start")
panel.prop(scene, "frame_end")

layout.label(text="After")

bpy.utils.register_class(LayoutDemoPanel)
bpy.types.Scene.show_demo_panel = BoolProperty(default=False)
</syntaxhighlight>

[[File:layout_panels_python.png|center]]


==<span id="breaking-changes"></span>互換性の失われる変更 ==

=== Foreach ===
* `foreach_get` と `foreach_set` が、8、16、64ビットの内部ストレージに最適化されました。([https://projects.blender.org/blender/blender/pulls/115761 PR#115761])

* `foreach_set` が、より正確な境界チェックを行うようになり、従来こっそり不正な書き込みを行っていた場所では、`TypeError` が発生します。

=== Light Probes ===
* Lightprobe タイプのアイテムがリネームされました。`bpy.types.LightProbe.type`、` bpy.types.BlendDataProbes.new()`、`bpy.ops.object.lightprobe_add()` に影響します。
** `CUBEMAP` → `SPHERE`
** `PLANAR` → `PLANE`
** `GRID` → `VOLUME`

* `show_data` が廃止予定になりました。代わりに `use_data_display` を使用してください。

* 各 `LightProbe` に、自身の `data_display_size` プロパティが付きました。

=== Mesh ===
* スカルプトのマスク値が汎用属性に格納されるように。([https://projects.blender.org/blender/blender/commit/f2bcd73bd25625d6b5c1194a4199e96fc5fafa2e f2bcd73bd25625d6b5c1194a4199e96fc5fafa2e])
** 名前は ".sculpt_mask"（`FLOAT` タイプ）
** マスクのアクセス、追加、削除がシンプルになりました。
*** `Mesh.vertex_paint_mask` プロパティで集合（collection）ではなく、この属性が直接返ってきます。
*** `Mesh.vertex_paint_mask_ensure()` と、`Mesh.vertex_paint_mask_remove()` 関数で、属性の追加と削除が可能。

* `Mesh` の `auto_smooth` プロパティがモディファイアーノードグループアセットで置き換えられました。([https://projects.blender.org/blender/blender/commit/89e3ba4e25c9ff921b2584c294cbc38c3d344c34 89e3ba4e25c9ff921b2584c294cbc38c3d344c34])
** `use_auto_smooth` は削除されました。スムーズとスムーズ以外のタグが混ざっている場合、面コーナーの法線が自動的に使用されます。メッシュはカスタム法線が存在していれば、常にそれを使うようになりました。
** `auto_smooth_angle` は削除されました。`"sharp_edge"` 属性をコントロールするモディファイアー（またはオペレーター）で置き換えられました。つまり、もう（オブジェクトなしの）メッシュ単体では、角度による自動スムージングに関することは何も知ることはできなくなったということです。
** `create_normals_split`、`calc_normals_split`、`free_normals_split` が削除され、もっとシンプルな `Mesh.corner_normals` 集合プロパティ（bpy_prop_collection）によって置き換えられました。これは法線のキャッシュへのアクセスを与えるため、関連データに変更がある時は自動的に更新されます。
** `MeshLoop.normal` が読み込み専用プロパティになりました。カスタム法線は `normals_split_custom_set` または `normals_split_custom_set_from_vertices` で作成してください。

=== Material ===
* `displacement_method` プロパティが、`cycles.properties.CyclesMaterialSettings` から `bpy.types.Material` に移動しました。[https://projects.blender.org/blender/blender/commit/a001cf9f2b08a67aa3b20f1857eac5c915f5ef33 a001cf9f2b08a67aa3b20f1857eac5c915f5ef33]

=== Sequencer ===
* ストリップの変換フィルタータイプの `SUBSAMPLING_3x3` が、`BOX` にリネームされました。`bpy.types.SequenceTransform.filter` に影響します。([https://projects.blender.org/blender/blender/pulls/117584 PR#117584])

=== View Layer ===
* `Scene.view_layers.move()` メソッドを追加、ビューレイヤーを再配置できます。([https://projects.blender.org/blender/blender/pulls/117037 PR#117037])

=== Nodes ===
* 一部ノード（`Store Named Attribute` など）が一度に存在するすべてのソケットタイプを持つ代わりに、動的なソケットタイプを使用するようになりました。つまり、`node.outputs[some_index]` のようなことをしても、もうこれらのノードでは同じ動作はしなくなってしまったということです。代わりにもっと信頼性の高い `node.outputs[some_socket_identifier]` を使用してください。([https://projects.blender.org/blender/blender/commit/8149678d5e1d6e0d00668c3f209736721401b4e9 8149678d5e1d6e0d00668c3f209736721401b4e9])

== 追記 ==
* `Preferences.filepaths.asset_libraries.new/remove` メソッドを追加。([https://projects.blender.org/blender/blender/commit/0061f2f65030 0061f2f65030])

* `ID.session_uid` 読み込み専用プロパティを追加。([https://projects.blender.org/blender/blender/commit/c68b22cfdf c68b22cfdf])

* `NodesModifierBake.bake_id` 読み込み専用プロパティを追加。([https://projects.blender.org/blender/blender/commit/7149424087 7149424087])

* `NodesModifierBake.node` 読み込み専用プロパティを追加。([https://projects.blender.org/blender/blender/commit/65b722bc3003 65b722bc3003])

* 翻訳変更時に実行される `bpy.app.handlers.translation_update_post` アップデートハンドラを追加。([https://projects.blender.org/blender/blender/commit/8564e03cdf59fb2a71d545e81871411b82f561d9 8564e03cdf59fb2a71d545e81871411b82f561d9])

* `Image.scale()` に、オプションの "frame" と "tile_index" 引数を追加。([https://projects.blender.org/blender/blender/commit/3d60209d3d30c9ac99fead690ceafc18d594fcb1 3d60209d3d30c9ac99fead690ceafc18d594fcb1])

* `ShapeKey.points` プロパティを追加。([https://projects.blender.org/blender/blender/commit/7d77caab9b 7d77caab9b])

* 複数入力のソケットにリンクする順序へのアクセスを追加。([https://projects.blender.org/blender/blender/commit/8f362817875a9b2bcdd77e53130672624dadb2da 8f362817875a9b2bcdd77e53130672624dadb2da])

== シェイプキーのロック ==
シェイプキーをユーザーがロックし、スカルプトや編集モードによる不意の編集の防止が可能になりました ([https://projects.blender.org/blender/blender/commit/b350d7a4c311ec6a3065ac89febafc3ba6bd43a2 b350d7a4c311ec6a3065ac89febafc3ba6bd43a2])。アクティブシェイプをトポロジーの変更なしでトランスフォームするオペレーターを実装している、またはすでにこのチェックを行っている他のビルトインオペレーターを呼び出しているアドオンは、これらのコードにチェックを追加することを考えた方がいいかもしれません。

ビルトインオペレーターの例：

* `mesh.vertices_smooth` はアクティブシェイプをトランスフォームするためチェックします。
* `mesh.subdivide` はトポロジーを変更するのでチェックしません。
* `object.transform_apply` は（アクティブシェイプキーの選択がなんであれ）同じトランスフォームを全シェイプに適用するため、チェックしません。
* `mesh.polybuild_extrude_at_cursor_move` は、内部的に他のチェックを行うオペレーターを呼び出すため、チェックします。

チェックの実装のサンプル：

<syntaxhighlight lang="Python">
from bpy_extras.object_utils import object_report_if_active_shape_key_is_locked

def execute(self, context):
if object_report_if_active_shape_key_is_locked(context.object, self):
return {'CANCELLED'}
</syntaxhighlight>

Dev:JA/Ref/Release Notes/4.10/python api - 版の履歴

Yamyam: ページの作成:「元記事：[https://developer.blender.org/docs/release_notes/4.1/python_api/ Python API - Blender Developer Documentation] = Blender 4.1: Python API = == Python 3.11 =…」