Dev:JA/Ref/Release Notes/4.30/python api

元記事：Python API & Text Editor - Blender Developer Documentation

Blender 4.3: Python API とテキストエディター

bpy.app モジュール

• bpy.app.python_args を追加、Blender の Python 環境にマッチした環境での Python の呼び出しに対応します (14b03fca3c)。注意：これは4.2.1にバックポートされています。

• 新しく bpy.app.handlers.blend_import_pre と bpy.app.handlers.blend_import_post ハンドラを追加。リンクデータ関連の操作（通常リンクやアペンド、アセットのインポートやドラッグ＆ドロップ、リンクデータの再読み込みまたは再配置など）の前後に呼び出されます。これらのハンドラのコールバックは両方とも単一の 'BlendImportContext' パラメータを取ります。(76e7770bc9)

データブロック

• 新しく rename 関数 を ID クラスに追加。より複雑な ID のリネームの挙動が可能になります。ID.name プロパティに直接割り当てても効果はありません。(3e03576b09)

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

• uiLayout.template_search() にテンプレートにラベルを追加させる text 引数を許容するようになりました。uiLayout.use_property_split と uiLayout.use_property_decorate を考慮します。(a3a5793a28)

Attribute（属性）

• domain_size 関数をすべての bpy.types.AttributeGroup* に追加。(a1630792cf)

  この関数はそのジオメトリが与えたドメインに未対応であった場合に 0 を返します。下がその一例です。

>>> cube.attributes.domain_size('CORNER')
24

• 属性データでの foreach_set 呼び出しが、適正な更新のトリガになりました。(cd577f02b9)

Curves

API に二つの新しい関数を追加。(1672b03e84):

• curves.remove_curves(indices=[]): 全カーブを削除します。indices リストが指定されていれば、そのインデックスのカーブのみ削除します。

• curves.resize_curves(sizes, indices=[]): sizes に合わせてカーブをリサイズします。indices リストが指定されていれば、そのインデックスのカーブのみリサイズします。この場合、sizes と indices は同じリスト長である必要があります。

互換性が失われる変更

プロパティへエンベッドした ID ポインタの割り当ての禁止

プロパティへエンベッドした ID ポインタ（scene.collection メインコレクションや、マテリアルやコンポジターのルートノードツリーなど）の PointerProperty への割り当てが禁止になり、RuntimeError 例外が発生するように (コミット de47fee2e1 と、関連するバグ報告 #126156 も参照)。いずれにせよ、これは信頼できない処理でした。

属性

bpy.types.AttributeGroup が、属性の所有者毎のタイプで置き換えられました：bpy.types.AttributeGroupMesh、bpy.types.AttributeGroupPointCloud、bpy.types.AttributeGroupCurves、bpy.types.AttributeGroupGreasePencil。

さらに active_color、active_color_index、active_color_name、default_color_name、render_color_index プロパティが bpy.types.AttributeGroupMesh でアクセス可能になりました。これらはすでにメッシュから内部でのみ使用されていました。

グリースペンシル

グリースペンシルの Python API が書き直されました。変更点のフルリストと Blender 4.3への移行方法については、Migration Process の Python API の項（英文） をお読みください。

ノード

• Reroute（リルート）ノードのデータタイプの変更を、ソケットを直接弄るのではなく、reroute_node.socket_idname で行うように。(c40dc9aa03)

テキストエディター

• Find（検索）がデフォルトで "Wrap Around"（ラップアラウンド）を有効に。(1f95b0f43f)

• UI: 検索設定に column を使用。(d254a12be9)

EEVEE

• 次の旧プロパティが削除されました: Light.use_contact_shadow Light.contact_shadow_distance Light.contact_shadow_bias Light.contact_shadow_thickness Material.shadow_method Scene.gi_irradiance_smoothing Scene.gi_filter_quality Scene.gi_show_irradiance Scene.gi_show_cubemaps Scene.gi_irradiance_display_size Scene.gi_cubemap_display_size Scene.sss_samples Scene.sss_jitter_threshold Scene.use_ssr_refraction Scene.use_ssr_halfres Scene.ssr_quality Scene.ssr_max_roughness Scene.ssr_thickness Scene.ssr_border_fade Scene.ssr_firefly_fac Scene.use_volumetric_lights Scene.use_gtao_bent_normals Scene.use_gtao_bounce Scene.gtao_factor Scene.bokeh_denoise_fac Scene.use_bokeh_high_quality_slight_defocus Scene.use_bloom Scene.bloom_threshold Scene.bloom_color Scene.bloom_knee Scene.bloom_radius Scene.bloom_clamp Scene.bloom_intensity Scene.shadow_cube_size Scene.shadow_cascade_size Scene.use_shadow_high_bitdepth Scene.use_soft_shadows