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

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

Blender 2.80: Python API の変更

Blender 2.80では API の互換性が失われています。アドオンとスクリプトを2.80で実行するには新機能の処理と、API の一貫性と信頼性を向上させるための変更への適合の、両面においてアップデートが必要です。

Addoons API(英文)

モジュールとクラスの登録が変更され、全アドオンはこれらの処理を更新する必要があります。

Scene and Object API(英文)

新しいビューレイヤー、コレクション、選択と依存グラフシステムになり、スクリプトの更新が必要です。

Mesh API(英文)

メッシュ API では主にトライアングルテッセレーション用のデータ構造について少し変更があります。

Preferences API(英文)

リデザイン・再構成された Preferences の UI に合わせるため、Python API も更新されました。

User Interface API(英文)

新しいツールバー、プロパティレイアウト、アイコンでアドオンの更新が必要です。

アドオンの2.8ユーザーインターフェイスへの適合(英文)

Blender 2.8は新しい UI になり、アドオンを適合させる必要があります。

Draw API(英文)

Blender が OpenGL コアプロファイルにアップグレードされた影響を、アドオンも受けます。

Timer API(英文)

指定の時間の間隔で関数を実行させるための新しい API です。

Animation & Rigging API(英文)

アニメーションとリギングに関するユーティリティメソッドが多数追加されました。

Helper Modules(英文)

様々なヘルパーモジュールが追加・削除・変更されました。

名前の変更

ユーザーインターフェイス内でいくつかの語句が変更され、Python API もこれに追従しています。主な物は、

  • Lamp → Light
  • Group → Collection
  • Dupli → Instance
  • Render Layer → View Layer
  • User Preferences → Preferences

キーワードのみの引数

すべてのオプション引数はキーワードとして与える必要があり、位置によって渡すことはできなくなりました。

2.7x

context.scene.frame_set(10, 0.25)
noise.noise(position, noise.types.BLENDER)

2.8x

context.scene.frame_set(10, subframe=0.25)
noise.noise(position, noise_basis='BLENDER')

行列の乗算

従来の行列の乗算は * を使用していましたが、現在スクリプトは @ を乗算に使用してください(PEP 465 より)。これは以下に適用されます。

  • Vector * Vector
  • Quaternion * Vector
  • Matrix * Vector
  • Vector * Matrix
  • Matrix * Matrix

注意:将来的に * は要素ごとの積に使用される予定です。

2.7x:

mat = Matrix()
vec = Vector()
result = mat * vec

2.8x:

mat = Matrix()
vec = Vector()
result = mat @ vec

2.7xの構文を2.80以降で使用した場合、下記のエラーが出ます。

TypeError: Element-wise multiplication: not supported between 'xxx' and 'yyy' types


インプレース行列乗算

注意:従来 mat_a *= mat_b では元の行列を変更しませんでしたが、2.8では変更するようになりました(Vector や Python のリストなどの他のタイプと合わせました)。

新しい行列を作成するスクリプトで、特に行列が関数の引数として渡され、予期せぬ変更が行われた場合、互換性が失われる可能性があります。

テキストのインポート

Blender のテキストデータブロックをモジュールとしてインポートする機能が削除されました。(dc8dd24351).

テキストデータブロックをモジュールとして取得する必要があるときは、以下を使用してください。

my_module = bpy.data.text["my_module"].as_module()