Dev:JA/Ref/Release Notes/3.10/Python API

提供: wiki
移動先: 案内、 検索

元記事：Reference/Release Notes/3.1/Python API - Blender Developer Wiki

Blender 3.1: Python API

バンドル Python

Python 3.10

Python が3.9から3.10に更新されました。一部の変更がスクリプト作者に影響を与える可能性があります。

  • Python 3.10ではもう float から int への暗黙的変換を行いません（issue linked）。つまり、従来は float タイプの値を受け入れていた関数で、タイプエラーが発生するということです。
    浮動小数点数の引数は明示的に整数に変換する必要があります（コミットのサンプルを参照）。(rBAbb62f10715a8, rBA7476c1ac2484)

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

  • Prefences（プリファレンス）に括弧と引用符を自動的に閉じるオプションを追加。(c4ea5cb1a3811cb)

Crazy space（クレイジースペース）

crazy space は、デフォーム空間（デフォーム前のオブジェクトとシェイプキーとデフォームモディファイアーを適用したオブジェクト間の、頂点毎の位置の写像）と呼ばれる物の実装の一つです。

crazy space はデフォームされたメッシュでのスカルプトなどの機能で、ブラシストロークにおけるメッシュの変形を「キャンセル」し、ベースメッシュに適用するのに内部的に使用されていました。

この crazy space が Python API から利用可能になりました（196da819ba4）下記はサンプルです。 

object.crazyspace_eval(depsgraph, scene)

# 二つの頂点間に違いがあり
# 格納する空間（シェイプキー）に変換したい場合
delta_in_orig_space = rigged_ob.crazyspace_displacement_to_original(
    vertex_index=i, displacement=delta)
    
# 上の逆
delta_in_deformed_space = rigged_ob.crazyspace_displacement_to_deformed(
    vertex_index=i, displacement=delta)

object.crazyspace_eval_clear()

これにはデフォームメッシュでのスカルプトと同じ制限があります。主にシェイプキーがある場合に、アクティブシェイプキーが未デフォーム空間用の basis を定義していると仮定して空間の変換が計算されるなどです。 （訳注：この辺はあまり自信がないので元記事を参照されたし）

Demeter Dzadik 氏がリガーにとってどう役に立つかを、解説とデモの動画で行っています。

その他の追加

  • Mesh に新しく vertex_normals と polygon_normals プロパティが追加、値の配列への連続的なアクセスを提供します。(b7fe27314b25a7、cfa53e0fbeed71)
    • 内部的には法線はもう MeshVertex に直接格納されなくなりました。MeshVertex.normal プロパティは今も利用可能です。
  • 新しく便利なプロパティ Object.children_recursive と Collection.children_recursive が追加。(7c568e7d36710ab)

互換性がなくなる変更

  • Action.frame_range が、利用可能であれば手動でセットしたフレーム範囲が返ってくるようになりました。アドオン作者にはこれがユースケースに適しているか、もしくは常にキーから計算した範囲が返ってくる Action.curve_frame_range に切り替える必要があるかどうかを確認することをお勧めします。(rB5d59b38605d6)
「https://wiki.blender.jp/index.php?title=Dev:JA/Ref/Release_Notes/3.10/Python_API&oldid=172526」から取得