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

2025-07-18T21:10:05Z

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

新規ページ

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

= Blender 4.5 LTS: Python API =

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

=== `gpu` ===

* `gpu.types.GPUShader` コンストラクタが廃止予定になり、Blender 5.0で削除されます。変わりに `gpu.shader.create_from_info()` を使用してください。([https://projects.blender.org/blender/blender/commit/9d0650883762afe22feb06f7bafa4c83e388c4a3 9d06508837])

* `shader.program` が廃止予定になり、つねに `-1` を返すように。([https://projects.blender.org/blender/blender/commit/3562433ae7a9f730f631e1f22145fd300647f7a7 3562433ae7])

* `GPUVertFormat.attr_add()` 内での `INT_TO_FLOAT` の使用が非推奨に。これらを使用する属性はデータ転送前、またはシェーダー内部で明示的に float へ変換すべきです。([https://projects.blender.org/blender/blender/commit/91627b3d471c8aa87c321f87d57eefe718760201 91627b3d47])

* 4バイトに揃っていない頂点フォーマットの使用が非推奨に。これらの属性タイプは5.0では対応されなくなる予定です。([https://projects.blender.org/blender/blender/commit/57d9c2c09881f5218d97b1ebf15e45cab89cb7fe 57d9c2c098])

* ビルトインシェーダーで `GPUBatch` を使用したワイドラインまたはスムーズラインの描画では、`POLYLINE` の使用が必要になりました ([シェーダーバリアント](https://docs.blender.org/api/4.5/gpu.shader.html)。([https://projects.blender.org/blender/blender/commit/3d8854b021195fdb253c85133b1db350d3d4c753 3d8854b021])

* ビルトインシェーダーによるポイントの描画では、`POINT` の使用が必須となりました。[シェーダーバリアント](https://docs.blender.org/api/4.5/gpu.shader.html). ([https://projects.blender.org/blender/blender/commit/c56a855b9fbfc6997a4d37a187b055bc7dbf6565 c56a855b9f])

=== ビデオシーケンサー ===

* `strips.new_effect()` 関数の、エフェクトストリップの入力を指定するオプションパラメータの `seq1` と `seq2` が、`input1` と `input2` と呼ばれるように。([https://projects.blender.org/blender/blender/commit/41781df1a658ff78d2f894a5c4b4fb62c3f893f0 41781df1a6])

=== レンダーパス ===

* `scene.render.frame_path()` は絶対失敗しない物として使用されてきましたが、今後はレンダー出力パスに、[https://docs.blender.org/manual/en/4.5/files/file_paths.html#path-templates パステンプレート（英文）]のエラー処理がある場合、失敗する可能性があります。

=== シェーダー ===

* Bump（バンプ）と Displacement（ディスプレイスメント）ノードのデフォルト距離が変更されました。これらのノードを作成するインポーターは、同じ結果を得るにはこれらの値を1.0に設定する必要があるでしょう。([https://projects.blender.org/blender/blender/commit/bb6a88b95de4daeed056f21aed0707401a1d8827 bb6a88b95d])

== 追加 ==

=== ユーザーインターフェイス ===

* `KeyConfig.keymaps.find_match(keymap)` 他のキー設定のキーマップとマッチする物を探すのに便利な関数を追加。 これは既存の `find` メソッドに複数の引数を渡す必要を回避します。([https://projects.blender.org/blender/blender/commit/28126b83a527c081677d45906e2d18dc1c0bf976 28126b83a5])

* `KeyMap.keymap_items.find_match(keymap, keymap_item)` 他のキーマップのキーマップアイテムの参照に対応するメソッドを追加しました。 これにより、アドオンが元のキーマップエントリを（"Reset to Default"（デフォルトにリセット）の使用で）維持しつつ、アドオン用のキーマップアイテムを定義するためのキーマップエディターをプリファレンスに表示できます。 一般的に、アドオンが `context.window_manager.keyconfigs.addon` 内で作成したキーマップアイテムを参照するには、`context.window_manager.keyconfigs.user` のキーマップで `find_match` メソッドを呼ぶべきです。([https://projects.blender.org/blender/blender/commit/4a6d687d53b42a6ce69ea324f59ee7202777056b 4a6d687d53])

* `GIZMO_GT_button_2d` Gizmo タイプの `icon_value` プロパティ カスタムアイコン値の使用に対応すべく、`GIZMO_GT_button_2d` Gizmo タイプに新しく `icon_value` プロパティを追加しました。これにより、（カスタムプレビューコレクションを通じて）ユーザー定義のアイコンを、またはマテリアルや画像のプレビューのように生成したアイコンを使用できます。([https://projects.blender.org/blender/blender/commit/ec149a919abd4021f722a3757427f7226b27de1d ec149a919a]) このプロパティは新しい Python テンプレート内にもドキュメント化されており、Text Editor（テキストエディター）の Templates（テンプレート）メニュー→ Python → Gizmo Simple 2D にあります。([https://projects.blender.org/blender/blender/commit/bcb343c59786746076ca199578538f153528cd4e bcb343c597])

=== ウィンドウマネージャ ===

* NDOF モーション（3Dマウスモーションデータ）を、[https://docs.blender.org/api/4.5/bpy.types.NDOFMotionEventData.html `Event.ndof_motion`] にて公開。([https://projects.blender.org/blender/blender/commit/776e2eb707cd931fc577bcb1da4facc86008a84a 776e2eb707])

=== パイプラインと入出力 ===

* `Mesh.calc_smooth_groups(use_bitflags=False, use_boundary_vertices_for_bitflags=False)` 
スムーズグループを計算する Mesh API が更新、オプションで境界の辺だけではなく、境界の頂点も考慮されるように。 これは他の DCC ツールやゲームエンジンなどで、法線をこのデータから正しく再計算してスムーズグループを生成するのに適した方法だと思われます。 詳細は [https://projects.blender.org/blender/blender-addons/pulls/105516 PR#105516]と[https://projects.blender.org/blender/blender/pulls/135248 PR#135248]をお読みください。([https://projects.blender.org/blender/blender/commit/00de07f752d8c0ee44e2ea84a25e11e5fbcef96d 00de07f752])

==== `blf` ====

* `blf.bind_imbuf` と `blf.draw_buffer` 関数による、画像バッファへの描画に対応しました。

<syntaxhighlight lang="python">
with blf.bind_imbuf(font_id, imbuf):
blf.draw_buffer(font_id, text)
</syntaxhighlight>
([https://projects.blender.org/blender/blender/commit/c3e5a35ecd3869f46977acdf22e934980113411d c3e5a35ecd])

==== `bpy.app` ====

* `bpy.app.build_options.image_webp` に対応。([https://projects.blender.org/blender/blender/commit/e94068e8d2bffc4b6fb684ff7419b4de7ce3dbe9 e94068e8d2])

==== `imbuf` ====

* `imbuf.load_from_buffer` によるメモリからの画像読み込みに対応。([https://projects.blender.org/blender/blender/commit/10e1aaf02cde960e6ea08db785a7ea3d73a6e01b 10e1aaf02c])

=== スカルプト ===

* `brush.asset_activate` が、バックグラウンドモードでの使用中は読み込みをブロックするように。([https://projects.blender.org/blender/blender/commit/898e6f368765e0f15aa1ed83a5da37eefe35ca08 898e6f3687])

* `sculpt.mask_by_color` に、`location` パラメーターが付き、スクリプトから region 空間のマウス位置を指定してオペレーターを実行できるようになりました。([https://projects.blender.org/blender/blender/commit/956a0fad80a5bc1bf203cab78d7a8598583e4342 956a0fad80]).

=== GeometrySet ===

* 新しく `GeometrySet` API が追加、従来よりもっと直接的な方法でオブジェクトから評価済みジオメトリデータの取得できるようになりました。([https://projects.blender.org/blender/blender/commit/29fddf4710a16b660018c371c22ce4c81fbb006f 29fddf4710])

* [https://docs.blender.org/api/4.5/bpy.types.GeometrySet.html ドキュメント（英文）]

=== ライト ===

新しい[ライト制御](https://developer.blender.org/docs/release_notes/4.5/rendering/#new-light-controls)。ネイティブで未対応のエクスポーターは下記のように変換可能です。

<syntaxhighlight lang="python">
if object.type == 'LIGHT':
light = object.data

energy = light.energy * math.pow(2.0, light.exposure)
if not light.normalize:
energy *= light.area(matrix_world=object.matrix_world)

color = light.color
if light.use_temperature:
temperature_color = light.temperature_color
color[0] *= temperature_color[0]
color[1] *= temperature_color[1]
color[2] *= temperature_color[2]
</syntaxhighlight>

=== ノード ===

* 新しい `NodeSocket.is_inactive` と `NodeSocket.is_icon_visible` アクセサ。([https://projects.blender.org/blender/blender/commit/fbb120491385c442bcea1d4dd51e17a4037ae3a1 fbb1204913]).

=== グリースペンシル ===

[[../grease_pencil/#python-api|グリースペンシルのページの Python API]]の項をご覧ください。

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

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