2023年11月14日 (火) 18:38にYamyamによる

2023-11-14T18:38:43Z

Yamyam: ページの作成:「元記事：[https://wiki.blender.org/wiki/Reference/Release_Notes/4.0/Python_API Reference/Release Notes/4.0/Python API - Blender Developer Wiki] = Python API = ==…」

2023-10-26T22:48:53Z

ページの作成:「元記事：[https://wiki.blender.org/wiki/Reference/Release_Notes/4.0/Python_API Reference/Release Notes/4.0/Python API - Blender Developer Wiki] = Python API = ==…」

新規ページ

元記事：[https://wiki.blender.org/wiki/Reference/Release_Notes/4.0/Python_API Reference/Release Notes/4.0/Python API - Blender Developer Wiki]

= Python API =

== 互換性がなくなる変更 ==

=== アセットシステム ===

* `context.asset_file_handle` が削除されました。代わりに `context.asset` を使用してください。<br/>こちらは `FileSelectEntry` ではなく、`AssetRepresentation` を返すことに注意してください（提供するアクセス先の情報は同じです）。アセットプレビューアイコン ID が必要などの理由で無理な場合は、`context.active_file` が代替として利用できるかもしれません。({{GitCommit|f6a6b27ac1}})

* `context.selected_asset_files` が削除されました。代わりに `context.selected_assets` を使用してください。こちらも（上記の）`context.asset_file_handle` 同様に注意してください。

* `FileSelectEntry`:
** `.id_type` が削除されました。アセットでは `AssetRepresentation.id_type` を代わりに使用してください。({{GitCommit|d973cc7992}})
** `.local_id` が削除されました。アセットでは `AssetRepresentation.local_id` を代わりに使用してください。({{GitCommit|d973cc7992}})

* `AssetHandle`:
** `get_full_library_path()` が削除されました。代わりに `AssetRepresentation.full_library_path` を使用してください。({{GitCommit|d973cc7992}})
** `local_id` が削除されました。代わりに `AssetRepresentation.local_id` を使用してください。({{GitCommit|d973cc7992}})

* API 中の名前の `asset_library_ref` が `asset_library_reference` で置き換えられました。({{GitCommit|974d70918b582cff41b12b29105a0f85786b27fe}})

* `FileAssetSelectParams.import_type` は `FileAssetSelectParams.import_method` にリネームされました。({{GitCommit|ca2a8be15fef453bacc03be3eba66d7ca837f15d}})

注意：`AssetHandle` は現在 `UILayout.template_asset_view()` 用のコレクションカスタムプロパティの提供にのみ使用してください。

=== ウィンドウマネージャ ===
* `Operator.bl_property` はもう "type" がデフォルトではなくなりました。({{GitCommit|7bc34283eacce03fee8506ee5744ff07dd1e6820}})

=== メッシュ ===
* [[../../3.60/Python_API#内部メッシュフォーマット|前バージョン]]でのメッシュフォーマット変更が Blender ファイルフォーマットに入り、ファイル保存時のオーバーヘッドが削減され、ファイル保存時のファイルサイズも小さくなりました。({{GitCommit|1b63a290c68636211b16c5e212a699e6b63031b9}})
** Blender 3.6は4.0で保存されたファイルを読めますが、もっと前のバージョンではできません。
** Blender 3.6を4.0のファイルを、旧バージョンの Blender と互換性のあるフォーマットで保存するのに使用できます。

* Face Maps（面マップ）は削除され、その値は自動的に整数属性に変換されます。({{GitCommit|46cf09327001331c77bcd54ceab73404a1733172}}).

* ベベルウェイトは `bevel_weight_vert` と `bevel_weight_edge` という名の汎用属性に移行しました。({{GitCommit|2a56403cb0dbcbc1dfb19a9bf7e6434517cbdca9}})
** 既存のベベルウェイトへのアクセス（`MeshEdge.bevel_weight`）は属性 API 化に伴い削除されました。
** 前方互換性は維持されませんが、旧バージョンでこの新しい汎用属性の読み出しは可能です。

* 頂点と辺クリースも同様に `crease_vert` と `crease_edge` という汎用属性に移行しました。({{GitCommit|e5ec04d73c7873498f4052cbb9f58acfdaf4b7b0}})
** `MeshEdge.crease` プロパティは削除されました。
** メッシュプロパティの `vertex_creases` と `edge_creases` は、属性を直接返すようになりました。
** 新しい関数 `{vertex/edge}_creases_ensure` と `{vertex/edge}_creases_remove` は、適切なドメインとタイプで属性を生成・削除します。

* `sculpt_vertex_colors` API が削除され、`mesh.color_attributes` で置き換えられました。({{GitCommit|6805657a39b7eeb18b642c769900c6fac46d8367}})

* 他のメッシュカスタムデータ関数も、属性 API と重複する物は削除されました：`vertex_layers_float`、`vertex_layers_int`、`vertex_layers_string`、`polygon_layers_float`、`polygon_layers_int`、`polygon_layers_string` ({{GitCommit|d41021a7d4112bdc54fdc93c452348e01a57b5a2}})

* `Mesh.calc_normals` はもう必要なくなったため、削除されました。({{GitCommit|ab5fc46872b9960b5bb50d98147bea0d677028b9}})

* `bmesh_from_object` と `BVHTree`、`FromObject` が最終メッシュの取得に dependency graph（依存グラフ）の評価が必要になりました。({{GitCommit|e64b3c821252fc8707b4dcd9f8d1a0dee45c7d3f}})

* `split_faces` 関数の廃止予定の引数が削除されました。({{GitCommit|efbcfd870301b9d3d257c74fb13020575a0b6216}}).

=== カーブ ===
* `curves.select_end` オペレーターは、`curves.select_ends` という名前になりました。 `amount_start` と `amount_end` プロパティを持ち、前後の両方のポイントを選択できます。

=== ノード ===
* 未使用の `width_hidden` プロパティが削除されました。({{GitCommit|30a20b4def3350cced29eb72e7e586ccbe7f1821}})

* シェーダーとコンポジターノードの `NodeItem` と `NodeCategory` 定義は削除されました。({{GitCommit|15f5dfd45d14655f715617802f371f7f6b7a26ae}})
** Add（追加）メニューが Python API から ID 名 `NODE_MT_shader_node_add_all` と `NODE_MT_compositor_node_add_all` で、[https://docs.blender.org/api/4.0/bpy.types.Menu.html#extending-menus 標準の方法]により追加可能になりました。

=== シェーダーノード ===
* Glossy BSDF（光沢 BSDF）と Anisotropic BSDF（異方性 BSDF）ノードが統合されました（{{GitCommit|8cde7d8f8a5a07661ad614aa7716ddc1cc7c182e}}）。その結果のノードは Python API では `ShaderNodeBsdfAnisotropic` となります。<br />ノード作成時は `ShaderNodeBsdfGlossy` もエイリアスとして許容されますが、結果的には `ShaderNodeBsdfAnisotropic` が作成されます。アドオンとスクリプトは `ShaderNodeBsdfGlossy` の使用を `ShaderNodeBsdfAnisotropic` で置き換えてください。これは2.80以前まで幅広く動作します。

* [[../Rendering#プリンシプルBSDF|Principled BSDF(プリンシプル BSDF ノードが刷新され]]、Standard Surface や OpenPBR により近く調整されました。様々なソケットもリネームされました。
** `Subsurface（サブサーフェス）` → `Subsurface Weight（サブサーフェスウェイト）`
** `Subsurface Color（サブサーフェスカラー）`は削除され、代わりに `Base Color（ベースカラー）`を使用します
** `Specular（スペキュラー）` → `Specular IOR Level（スペキュラーIORレベル）`
** `Specular Tint（スペキュラーチント）`は Float から color になりました。
** `Transmission（伝播）` → `Transmission Weight（伝播ウェイト）`
** `Coat（コート）` → `Coat Weight（コートウェイト）`
** `Sheen（シーン）` -> `Sheen Weight（シーンウェイト）`
** `Emission（放射）` -> `Emission Color（放射カラー）`

=== ライト ===

* `Light` の falloff、attenuation とシャドウバッファのプロパティを削除。Cycles や EEVEE で使用されていないため。({{GitCommit|57d85b32a9aaa71b50c15d19f432462fa9fc4830}})

=== パーティクルシステム ===

* `ParticleSystem.child_nbr` が `child_percent` にリネーム。{{GitCommit|e82ca9b5ffb6480ec41f01e2bebf20326187d104}}.

=== Blender アプリケーション (`bpy.app`) ===

* 廃止予定の `bpy.app.version_char` を削除。({{GitCommit|345fc2b1f6de7624a09cd91048476e2a932f83fc}})

=== Blender オペレーター (`bpy.ops`) ===

* `bpy.ops` のコンテクストオーバーライド引数を `context.temp_override(..)` に伴い削除。({{GitCommit|ac263a9bce53e190d07d679a058a230e91e722be}})

=== フォントモジュール (`blf`) ===

* `blf.size()` `dpi` 引数が削除されました。({{GitCommit|9357f7b606262aa42cee0fc97dd4487b74ca9a29}})

=== GPU モジュール (`gpu`) ===

- ビルトインシェーダー名の廃止予定の 2D_ / 3D_ 接頭辞を削除。({{GitCommit|9a8fd2f1ddb491892297315a4f76b6ed2b0c1b94}})

=== アニメーション ===

* `FCurve.update()` が F カーブのキーの複製もするように。({{GitCommit|6452eccc800ff11cad4051ec24bdf6f7de451295}})

* `Action.frame_range` が長さ０フレームの報告を正確にするように。（{{GitCommit|49eab72141ee7e2df8d276156566f2cf9b660316}}）<br />

従来、アクションがちょうど０の長さの（0.001などではない）時は、その場合に限り、特別なケースとして、1フレーム長の範囲を生成、報告していました。これは最小1フレーム長の範囲になるのか、限定的に正しい範囲なのか（どちらのケースでもありません）と混乱を招き、簡単に誤解されます。<br />新しい挙動では、すべてのケースにおいて、単に実際のフレーム範囲をそのまま報告します。

=== アーマチュア ===

* レイヤーとボーングループは、関連する全プロパティとメソッドとともに削除されました。代わりに Bone collection が追加されました（{{GitCommit|998136f7a7b520ef10c998c5af744eb0d464fdd3}} とその後の多数のコミット）。<br />[[../BoneCollectionsUpgrading|ボーンコレクションとカラーへのアップグレード方法]] に、Python コードを新しい API に変更する方法の概要があります。

* `edit_bones.new()` の挙動がオブジェクト生成と同様、作成したボーンをどのコレクションにも自動的に追加しなくなりました。ボーン追加オペレーターの挙動に似せるには、自分でそのボーンに（None でなければ）`arm.collections.active` を割り当ててください。({{GitCommit|ab67d410a90d5d2d07f5c34d3dae197331b41dc8}})

* 廃止予定の `use_inherit_scale` ボーンプロパティが削除されました。({{GitCommit|2abd026cfedaecbb0be039c02f2aa142cef3fc09}})

=== ノードグループ ===

* ノードグループの API が、[https://docs.blender.org/api/3.6/bpy.types.NodeTree.html `NodeTree`] から [https://docs.blender.org/api/4.0/bpy.types.NodeTreeInterface.html `NodeTree.interface`] に移動しました。
<table>
<tr>
<td><b>旧</b></td> <td><b>新</b></td>
</tr>
<tr>
<td>

<pre>
# Make a socket
tree.inputs.new(name="My Input")
tree.outputs.new(name="My Output")

# Remove a socket
tree.inputs.remove(socket)
tree.outputs.remove(socket)

# Move a socket up or down
tree.inputs.move(from_index=4, to_index=2)

# Iterate over sockets
for socket in tree.inputs:
...
for socket in tree.outputs:
...

</pre>

</td>
<td>

<pre>
# Make a socket
# Note: socket_type accepts only base socket type names,
# e.g. `NodeSocketFloat` but not `NodeSocketFloatFactor`.
tree.interface.new_socket(name="My Input", in_out='INPUT')
tree.interface.new_socket(name="My Output", in_out='OUTPUT')
# Make node panel
tree.interface.new_panel(name="My Panel")

# Copy an existing socket or panel
tree.interface.copy(socket)

# Remove a socket or panel
tree.interface.remove(socket)
tree.interface.remove(panel)

# Move a socket up or down
tree.interface.move(socket, to_index=2)
# Move a socket into a panel
tree.interface.move_to_parent(socket, new_panel, to_index=2)

# Iterate over sockets
for item in tree.interface.items_tree:
if item.item_type == 'SOCKET':
if item.in_out == 'INPUT':
...
elif item.in_out == 'OUTPUT':
...
# Iterate over panels
for item in tree.interface.items_tree:
if item.item_type == 'PANEL':
...
</pre>

</td>
</tr>
</table>
: {{Note|アイテムの変更|従来のノードグループ API では一部のケースで処理中に入出力コレクションの変更が可能でした。これは偶然起こったことであり、一般的には無効化すべきことです。詳細は [https://docs.blender.org/api/4.0/info_gotcha.html#help-my-script-crashes-blender "Gotchas"] を参照してください}}

* カスタムノード：`NodeSocket.draw_color_simple` コールバックが、カスタムソケットタイプ用のカラー機能を優先するように。

*: これはコンテクストやノードインスタンスを取りませんが、大半の用途では充分です。この新しいコールバックは明らかにノードインスタンスが存在している場合（ノードグループのインターフェイスの表示など）で使用します。
<table>
<tr>
<td><b>旧</b></td> <td><b>新</b></td>
<tr>
<td>

<pre>
class MyCustomSocket(NodeSocket):
def draw_color(self, context, node):
return (1, 1, 1, 1)
</pre>

</td>
<td>

<pre>
class MyCustomSocket(NodeSocket):
@classmethod
def draw_color_simple(cls):
return (1, 1, 1, 1)
</pre>

</td>
</tr>
</tr>
</table>

=== シーケンサー ===

* `Sequence.speed_factor` がより複雑なリタイミングシステムで置き換えられました。({{GitCommit|86a0d0015ac7bb114cbc44a03dd6b422a5ac709f}})

=== その他 ===

* RNA API コールの `filename` を `filepath` にリネーム。({{GitCommit|efa4179982d9ea7007b88b1a60c3168a19b59305}})
** `Depsgraph.debug_relations_graphviz`、`Depsgraph.debug_stats_gnuplot`
** `RenderLayer.load_from_file`、`RenderResult.load_from_file`
** `bpy.app.icons.new_triangles_from_file`

== Hydra レンダーデリゲート ==

レンダラーアドオンを、[https://openusd.org/release/glossary.html#hydra USD Hydra] レンダーデリゲートとして実装可能になりました。アドオン開発者の皆さんにはこれの使用と、Blender 開発に参加し欠けている機能を追加することを推奨します。({{GitCommit|04bb5f999501d97ab142eb2bce8f3a696bb06fa5}})

Hydra は二つの大きな恩恵を提供します。
* 同じ Hydra レンダーデリゲートが複数の3Dアプリ間で動作することで、実装の多くが共有可能。

* Hydra は Python ではなく C++ API であるため、重いシーンでのパフォーマンスが大幅に改善。

Blender シェーダーノードは自動的にレンダラー用の [https://materialx.org/ MaterialX] ノードグラフに変換できます。現時点ではシェーダーノードのサブセットのみの対応で、状況については[https://projects.blender.org/blender/blender/issues/112864 互換性リスト]を見てください。

さらに [https://docs.blender.org/api/4.0/bpy.types.HydraRenderEngine.html `HydraRenderEngine` API ドキュメント]に詳細があります。

== 追加 ==

* `bpy.context.property`。マウスカーソル下のプロパティ用。({{GitCommit|6ba0346797f43cd73eb1003ce65a62b8409203fb}}).

* `UILayout.progress(..)` widget タイプ。スクリプトの進行状態を表示します。({{GitCommit|c6adafd8ef325de6e925e30504882057d8455a8f}}).

* `PoseBone.bbone_segment_index()`。頂点（その位置）と、それを変形する B ボーンセグメントとの内部の対応情報（Crazyspace）にアクセスできます。({{GitCommit|36c6bcca1a5aa2553d98a9b9e9af422b7458ad40}})

* `Curves.add_curves(..)`。Curves データブロックに新しいカーブを追加します。({{GitCommit|07f01b5fc2732406ab2183c831c3f1361d55375a}}).

= テキストエディター =

* 選択の前後の括弧のオートクローズに対応。({{GitCommit|96339fc3131789e6caa41f7ef01cc1edf5a38a28}})

* LUA 用のシンタックスハイライトの対応を廃止。({{GitCommit|95ca04dc207f8bbbdb18287223ba8fdabdd54511}})

= Python コンソール =

* カーソルモーション、選択などその他多くのテキスト編集操作に対応。({{GitCommit|18e07098ef25e7659e0c14e169a96b49c5a54cbf}})

* スペースによるインデントの代わりにタブストップに対応。({{GitCommit|a5cd4975433db6ab28f13c49d14a071f3ca8d2c2}})

@@ 62行目: / 62行目: @@
 * シェーダーとコンポジターノードの `NodeItem` と `NodeCategory` 定義は削除されました。({{GitCommit|15f5dfd45d14655f715617802f371f7f6b7a26ae}})
 ** Add（追加）メニューが Python API から ID 名 `NODE_MT_shader_node_add_all` と `NODE_MT_compositor_node_add_all` で、[https://docs.blender.org/api/4.0/bpy.types.Menu.html#extending-menus 標準の方法]により追加可能になりました。
 === シェーダーノード ===
@@ 265行目: / 267行目: @@
 * `Curves.add_curves(..)`。Curves データブロックに新しいカーブを追加します。({{GitCommit|07f01b5fc2732406ab2183c831c3f1361d55375a}}).

Dev:JA/Ref/Release Notes/4.00/Python API - 版の履歴

2023年11月14日 (火) 18:38にYamyamによる

Yamyam: ページの作成:「元記事：[https://wiki.blender.org/wiki/Reference/Release_Notes/4.0/Python_API Reference/Release Notes/4.0/Python API - Blender Developer Wiki] = Python API = ==…」