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

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()