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

Yamyam: /* 互換性のなくなる変更 */

2022-06-02T17:10:57Z

‎互換性のなくなる変更

2022年6月2日 (木) 17:10にYamyamによる

2022-06-02T17:10:23Z

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

2022-05-31T21:31:58Z

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

新規ページ

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

= Python API とテキストエディター=

== Text Editor（テキストエディター） ==

* テキストエディターの Python 例外が Info（情報）エディター内（とコンソール）に表示されるように。({{GitCommit|rB2d2baeaf04d481f284bc2f098fb6d7ee9268151f}})

* ソフトキーワードがシンタックスハイライト表示されるように。({{GitCommit|c6ed879f9aa7cd863f146cc7104f16cfe8a73e8a}})

== 追加 ==

* [https://docs.blender.org/api/3.2/bpy.types.Context.html#bpy.types.Context.temp_override `Context.temp_override`] が追加。一時的なコンテクスト設定に対応します。例えば、ファイル読み込み後にコンテクストがクリアされ、多数のオペレーターが実行に失敗するような場面で便利です。({{GitCommit|f438344cf243632e497772cf1f855b9c8856fd37}})

* `Context.path_resolve` が、"active_object" や "scene" などの属性の解決に対応、`context.path_resolve("active_object.modifiers[0].name")` のような式が期待通り動作するようになりました。({{GitCommit|7bb8eeb3a871eb1e72ee129f8ff441f2752b37be}})

* `Text.region_from_string` と `Text.region_as_string` メソッドで、選択に get と set が使用可能に。アクセスする region もオプションで渡すことができます。({{GitCommit|rBf49a736ff4023231483c7e535ca2a7f2869d641d}})

* `mathutils.Color` に、シーンのリニア色空間と、sRGB や CIE XYZ、ACES、Linear Rec.709を相互変換するメソッドを追加。Blender API による返値の大半はシーンのリニア色空間ですが、例外的にユーザーインターフェイスのテーマカラーは sRGB で返ることに注意してください。({{GitCommit|469ee7f}})

* `bpy.app.handlers` の Persistent ハンドラがクラスのメソッドを利用可能になりました。({{GitCommit|0f583d9d604f45606e238f88eb2300eb75e492bb}})

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

* `XrActionMapItem.user_paths` コレクションプロパティは、`XrActionMapItem.user_path0/user_path1` の置き換えます。同様に、`XrActionMapBinding.component_paths` コレクションプロパティは、`XrActionMapBinding.component_path0/component_path1` の置き換えになります。これにより、アクション毎に上限が2つだった XR アクションのバインド数が好きなだけ持てるようになります。({{GitCommit|rB6a8709ba136e}})

* `gpu.shader.code_from_builtin` はもう Blender の内部 gpu モジュールと互換性はなく、削除されました。({{GitCommit|rB3e98331a094b}})

* The `MeshVertex.normal` プロパティが読み込み専用になりました。これは頂点の法線の計算方法がオンデマンドであり、混乱を防ぐためです。({{GitCommit|891268aa824f0f}})

* `KeyMapItem.type` から Tweak イベント（`EVT_TWEAK_L`、`EVT_TWEAK_M`、`EVT_TWEAK_R`）が削除されました。
: 特別なタイプの代わりに、通常のマウスボタンタイプ（`LEFTMOUSE`、`MIDDLEMOUSE`、`RIGHTMOUSE`）と、`KeyMapItem.value` を `CLICK_DRAG`にセットして使用してください。ドラッグ方向は、`KeyMapItem.direction` で指定可能です。({{GitCommit|4986f718482b061082936f1f6aa13929741093a2}}、{{GitCommit|7e4c0313283304bd8f020eaedb94b35e75b50068}})

== 廃止予定 ==

* `GPUBatch` 内で使用されているプリミティブ描画タイプ `'LINE_LOOP'` と `'TRI_FAN'` が廃止予定になり、将来的には削除されます。({{GitCommit|rBe2d8b6dc06}})

* オペレーターにコンテクストを辞書で渡すのは、代わりに使用が推奨されている `Context.temp_override` の一部となったため廃止予定です。({{GitCommit|f438344cf243632e497772cf1f855b9c8856fd37}})

: <source lang="python"># Deprecated API
bpy.ops.object.delete({"selected_objects": objects_to_delete})

# New API
with context.temp_override(selected_objects=objects_to_delete):
bpy.ops.object.delete()
</source>

* `Mesh.vertex_colors` は廃止予定になり、今後のリリースで削除されます。新しいスカルプトペイントツールが `Mesh.attributes` にあるカラー属性（color attribute）を、`BYTE_COLOR` または `FLOAT_COLOR` で生成できるようになりました。インポーターとエクスポーターは両タイプのカラー属性と一般的な属性に、対応することをお勧めします。<br />旧頂点カラーとの違いは、カラー属性値は sRGB 色空間ではなく、シーンのリニア色空間であることです。sRGB カラーが必要なファイルフォーマット向けには、`mathutils.Color.from_scene_linear_to_srgb` で変換が可能です。

@@ 34行目: / 34行目: @@
 : 特別なタイプの代わりに、通常のマウスボタンタイプ（`LEFTMOUSE`、`MIDDLEMOUSE`、`RIGHTMOUSE`）と、`KeyMapItem.value` を `CLICK_DRAG`にセットして使用してください。ドラッグ方向は、`KeyMapItem.direction` で指定可能です。({{GitCommit|4986f718482b061082936f1f6aa13929741093a2}}、{{GitCommit|7e4c0313283304bd8f020eaedb94b35e75b50068}})
-* Sequence のプロパティ、`frame_still_start` と `frame_still_end` が削除されました。同じ機能は `frame_offset_start` や `frame_offset_end` に負の数を設定することで可能です。({{GitCommit|rB8ca9ce09865e6a617d6c2f78f3483ba1fd5d6aef}}
+* Sequence のプロパティ、`frame_still_start` と `frame_still_end` が削除されました。同じ機能は `frame_offset_start` や `frame_offset_end` に負の数を設定することで可能です。({{GitCommit|rB8ca9ce09865e6a617d6c2f78f3483ba1fd5d6aef}})
 == 廃止予定 ==

← 古い版		2022年6月2日 (木) 17:10時点における版
33行目:		33行目:
	* `KeyMapItem.type` から Tweak イベント（`EVT_TWEAK_L`、`EVT_TWEAK_M`、`EVT_TWEAK_R`）が削除されました。		* `KeyMapItem.type` から Tweak イベント（`EVT_TWEAK_L`、`EVT_TWEAK_M`、`EVT_TWEAK_R`）が削除されました。
	: 特別なタイプの代わりに、通常のマウスボタンタイプ（`LEFTMOUSE`、`MIDDLEMOUSE`、`RIGHTMOUSE`）と、`KeyMapItem.value` を `CLICK_DRAG`にセットして使用してください。ドラッグ方向は、`KeyMapItem.direction` で指定可能です。({{GitCommit\|4986f718482b061082936f1f6aa13929741093a2}}、{{GitCommit\|7e4c0313283304bd8f020eaedb94b35e75b50068}})		: 特別なタイプの代わりに、通常のマウスボタンタイプ（`LEFTMOUSE`、`MIDDLEMOUSE`、`RIGHTMOUSE`）と、`KeyMapItem.value` を `CLICK_DRAG`にセットして使用してください。ドラッグ方向は、`KeyMapItem.direction` で指定可能です。({{GitCommit\|4986f718482b061082936f1f6aa13929741093a2}}、{{GitCommit\|7e4c0313283304bd8f020eaedb94b35e75b50068}})
		+
		+	* Sequence のプロパティ、`frame_still_start` と `frame_still_end` が削除されました。同じ機能は `frame_offset_start` や `frame_offset_end` に負の数を設定することで可能です。({{GitCommit\|rB8ca9ce09865e6a617d6c2f78f3483ba1fd5d6aef}}