2024年11月16日 (土) 11:17にYamyamによる

2024-11-16T11:17:16Z

Yamyam: ページの作成:「{{MARKDOWN}} 元記事：[Python API - Blender Developer Documentation](https://developer.blender.org/docs/release_notes/4.2/python_api/#statically-typed-idproperties)…」

2024-07-16T17:52:15Z

ページの作成:「{{MARKDOWN}} 元記事：[Python API - Blender Developer Documentation](https://developer.blender.org/docs/release_notes/4.2/python_api/#statically-typed-idproperties)…」

新規ページ

{{MARKDOWN}}

元記事：[Python API - Blender Developer Documentation](https://developer.blender.org/docs/release_notes/4.2/python_api/#statically-typed-idproperties)

# Blender 4.2LTS: Python API

## アドオンのパッケージ化
[新しいエクステンションプラットフォーム](../extensions)に伴い、アドオンをパッケージ化する新しい方法も登場しました。これはスクリプト内に `bl_info` を入れる代わりに、別の `blender_manifest.toml` ファイルを使用します。詳細は [エクステンションユーザーマニュアル（英文）](https://docs.blender.org/manual/en/4.2/extensions/getting_started.html)を参照してください。

旧パッケージ化方法も動作しますが、Legacy（旧版）とみなされるため、アドオンをこの新しいマニュフェストファイルに切り替えることをお勧めします。

## 追加

### オンラインアクセス
- `bpy.app.online_access` は読み込み専用のプロパティで、Blender（とアドオン）がインターネットへのアクセスを要求しているかどうかをチェックします。

- アドオンはインターネットへアクセスする前に、このプロパティのチェックが求められます。[ドキュメント（英文）](https://docs.blender.org/manual/en/dev/advanced/extensions/addons.html#internet-access)をチェックしてみてください。

- また、`bpy.app.online_access_override` で、Blender が `--offline-mode` や `--online-mode` で起動したのかどうかがわかります。

### `bpy.utils` モジュール
- `EXTENSIONS` オプションが `bpy.utils.user_resource()` に追加。([dc9430c480](https://projects.blender.org/blender/blender/commit/dc9430c48039bda36c1ba052f00c20e554f6aef0))

- `bpy.utils.register_cli_command` と `unregister_cli_command` が追加、スクリプトが（`-c`, `--command`）による専用のコマンドライン機能を設定可能に。([9372e0dfe0](https://projects.blender.org/blender/blender/commit/9372e0dfe092e45cc17b36140d0a3182d9747833))

- `bpy.utils.extension_path_user(__package__, path="", create=False)` を追加。([96906536db](https://projects.blender.org/blender/blender/commit/96906536dbc458424a567590c26b1fc2047ba963)).

### <span id="animation"></span>アニメーション
- `rna_struct.keyframe_insert()` に、キータイプを設定する新しいオプションキーワード引数 `keytype` が追加（[1315991ecb](https://projects.blender.org/blender/blender/commit/1315991ecbd179bbff8fd08469dda61ec830d72f)）。これにより、新規キーのタイプを直接設定可能になりました。<br />例：`bpy.context.object.keyframe_insert("location", keytype='JITTER')`

- F カーブの新しい関数：`bake`。既存のカーブに与えられた間隔で与えられた範囲にキーを作成します。([20a4c9c928](https://projects.blender.org/blender/blender/commit/20a4c9c928)

### レイアウトパネル
ポップアップや Redo（やり直す）パネル、ファイルブラウザーのサイドバー内のオペレータープロパティ表示用のレイアウトパネルに対応しました。現在、アドオンは Blender ユーザーインターフェイスの仕様に準じ、プロパティの構成にパネルを使用することを推奨します。
([aa03646a74](https://projects.blender.org/blender/blender/commit/aa03646a74), [02681bd44d](https://projects.blender.org/blender/blender/commit/02681bd44d285b51ffe9cf6d3df71af1980a6f70))

## エクスポーター
エクスポーターアドオンが、新しい[エクスポーターコレクション](../pipeline_assets_io/#collection-exporters)に対応しました。

これには `bl_export_operator` を設定した [`FileHandler`](https://docs.blender.org/api/main/bpy.types.FileHandler.html) と、そのオペレーターにエクスポートするコレクションを示す、`collection` という名の文字列プロパティが必要です。サンプルとして FBX と glTF アドオンをチェックしてみてください。

### モーダルオペレーター
- `Window.modal_operators`。実行中のモーダルオペレーターのリストを提供します。([#122193](https://projects.blender.org/blender/blender/issues/122193))

- `bl_options` に `MODAL_PRIORITY` を追加し、モーダルオペレーターが他のモーダルオペレーターより前にイベントを処理できるようになりました。([6efd7a6a50](https://projects.blender.org/blender/blender/commit/6efd7a6a507c2691d2de72ced9ea9577a68a4f3b))

### ハンドラー
- Render: "render_stats" ハンドラーに情報文字列を入れることができるように。([fcc481a407](https://projects.blender.org/blender/blender/commit/fcc481a40746014465bc2a6c025abd5ee4b0e3fa))

### UI
- オペレーターの確定・キャンセルボタン用で、キャンセルのデフォルト化に対応：`WindowManager.invoke_props_dialog(..., cancel_dfault=False)`。([1cfc83d5f6](https://projects.blender.org/blender/blender/commit/1cfc83d5f66fa978f41041560a45fd514be0cf10))

- `Region.tag_refresh_ui` を追加、ポップオーバーやオペレーターダイアログなどのポップアップのリフレッシュに対応。([fa27d2fe65](https://projects.blender.org/blender/blender/commit/fa27d2fe65c5e08e7e3d504890b12450c88a20fe))

- `Context.region_popup` を追加、ポップアップの領域にアクセスできます。([742a8b47cd](https://projects.blender.org/blender/blender/commit/742a8b47cdad3b28be2c365caaeb1cb3959811a6))

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

### 静的型付けされた ID プロパティ
従来、IDプロパティは静的型付けがされておらず、Python で簡単に変更できていました。IDProperty への float 値の割り当てを Python コードで、例えばこのプロパティを 'double' に変換するなど。

これは特にシステム定義の ID プロパティで問題になっていました（つまり、これらがジオメトリノードモディファイアープロパティや、Python 定義の「動的 RNA」プロパティなどの内部 Blender データ用のバックエンドストレージとして使用されているため）。

また、簡単にライブラリオーバーライドを壊してしまい、参照の型とオーバーライドデータの型に違いがある時に、望ましくない結果になる可能性があります

以下の ID プロパティは Python API から変更できない、固定の静的な型になりました。配列（vector）の場合、長さも型の一部とみなされ、固定となります。

- システム定義：
- ジオメトリノードモディファイアー設定 ID プロパティ
- Python 定義の（`bpy.props.` モジュールを通じた）プロパティ

- ユーザー定義：
- UI から作成したプロパティ（「Properties」（プロパティ）エディター内の「Custom Properties」（カスタムプロパティ）パネルから作成したプロパティ）で「Overridable」（オーバーライド可）オプションを有効にした時

このようなプロパティに値を割り当てる時、可能であれば「適切な変換」を試します（例えば整数は float に変換可能ですが、float は整数の ID プロパティに割り当てできません）が、無理であれば割り当てに失敗します。

#### 注意
技術的には、これは互換性が失われる変更の一つです。特にジオメトリノードモディファイアーの場合、現在の Python からの、これらのデータに「予測される」アクセス方法は、「生の」 ID プロパティパスを通じた物です。しかし、実際に「適切でない」使用による ID プロパティの互換性はなくなると思われます。

詳細は [設計タスク（英文）](https://projects.blender.org/blender/blender/issues/122743) をご覧ください。

コミット：[4d1fe98604](https://projects.blender.org/blender/blender/commit/4d1fe98604)、[b278e37f70](https://projects.blender.org/blender/blender/commit/b278e37f70)、[76f03eb141](https://projects.blender.org/blender/blender/commit/76f03eb141)、[9c41bf4fa2](https://projects.blender.org/blender/blender/commit/9c41bf4fa2)

### `bpy.utils` モジュール
- `AUTOSAVE` オプションが `bpy.utils.user_resource()` から削除されました。([6bfc8612bf](https://projects.blender.org/blender/blender/commit/6bfc8612bf757f24fe1abaa03dbf4bc194cfae4d))

### レンダー設定
- EEVEE 識別子が `BLENDER_EEVEE_NEXT` に変更されました。

- モーションブラー設定が Cycles と EEVEE で統合され、`bpy.types.RenderSettings` に移動しました。([74b8f99b43](https://projects.blender.org/blender/blender/commit/74b8f99b43))
- `scene.cycles.motion_blur_position` → `scene.render.motion_blur_position`
- `scene.eevee.use_motion_blur` → `scene.render.user_motion_blur`
- `scene.eevee.motion_blur_position` → `scene.render.motion_blur_position`
- `scene.eevee.motion_blur_shutter` → `scene.render.motion_blur_shutter`

- ライトの影の投射（cast）設定が Cycles と EEVEE で統合され、`bpy.types.Light` に移動しました。([1036d9bdb2](https://projects.blender.org/blender/blender/commit/1036d9bdb2))
- `light.cycles.cast_shadow` → `light.use_shadow`

- EEVEE の Bloom（ブルーム）は廃止予定となりました。([#123059](https://projects.blender.org/blender/blender/issues/123059))
- `view_layer.eevee.use_pass_bloom`
- `scene.eevee.use_bloom`
- `scene.eevee.bloom_threshold`
- `scene.eevee.bloom_color`
- `scene.eevee.bloom_knee`
- `scene.eevee.bloom_radius`
- `scene.eevee.bloom_clamp`
- `scene.eevee.bloom_intensity`

- EEVEE（4.2より前）固有のマテリアル設定は廃止予定となり、可能な物はエイリアスになりました。([c7807a425a](https://projects.blender.org/blender/blender/commit/c7807a425a56a93a62420c264258fa94d18aba3d))
- `bpy.types.Material.blend_method` → `bpy.types.Material.surface_render_method`。'Opaque' と 'Alpha Clip' は deferred（Dithered）になります。
- `show_transparent_back` は `use_transparency_overlap` にリネームされました。
- `use_screen_refraction` は `use_raytrace_refraction` にリネームされました。
- `use_sss_translucency` と `use_sss_translucency` は廃止予定です。

- Light probe（ライトプローブ）API が変更されました。([6a71a91b83](https://projects.blender.org/blender/blender/commit/6a71a91b83e5ec2174267b03865595cc7ad4ad5b))
- 各ライトプローブタイプが自身のタイプを持つように。
- `grid_` 接頭辞が削除され、ボリュームプローブへのアクセスに制限されました。
- Parallax と他の球型（sphere）プローブのみのプロパティは球型プローブに限定されました
- `visibility` プロパティは廃止予定です。

- 廃止予定の影（shadow）の設定
- `shadow_cube_size` と `shadow_cascade_size` はもう使用されておらず、将来のリリースで削除される予定です。

### ノード
- ノードグループパネルを作成する `NodeTreeInterface.new_panel` 関数から、未使用の `parent` 引数が削除されました。([#118792](https://projects.blender.org/blender/blender/issues/118792))

- 一部ノードプロパティは名前の衝突の修正のためリネームされました。([deb332601c](https://projects.blender.org/blender/blender/commit/deb332601c2a5c5c41df21543c08ac1381ca4a0a)):
- コンポジターの Box/Ellipse Mask（ボックス/楕円）マスクノード：`width` → `mask_width`（`height` も同様）
- シェーダー AOV の Output（出力）ノード：`name` → `aov_name`
- ジオメトリノードの Color（カラー）ノード：`color` → `value`

### Image Object オペレーター
- "add image object"（画像オブジェクト追加）オペレーターが廃止予定となり、単一オペレーター `object.empty_image_add` に統合されました。([013cd3d1ba](https://projects.blender.org/blender/blender/commit/013cd3d1ba))
従来、画像エンプティを追加するオペレーターは二つあり（`object.load_reference_image` と `object.load_background_image`）、ドロップ用のオペレーターが分かれていました（`object.drop_named_image`）。

- "add/remove background image from camera" オペレーターがリネームされ、カメラオブジェクト専用とはっきりわかるようになりました。([013cd3d1ba](https://projects.blender.org/blender/blender/commit/013cd3d1ba)):
- `view3d.background_image_add` → `view3d.camera_background_image_add`
- `view3d.background_image_remove` → `view3d.camera_background_image_remove`

@@ 1行目: / 1行目: @@
 {{MARKDOWN}}
-元記事：[Python API - Blender Developer Documentation](https://developer.blender.org/docs/release_notes/4.2/python_api/#statically-typed-idproperties)
+元記事：[Python API - Blender Developer Documentation](https://developer.blender.org/docs/release_notes/4.2/python_api)
 # Blender 4.2LTS: Python API

Dev:JA/Ref/Release Notes/4.20/python api - 版の履歴

2024年11月16日 (土) 11:17にYamyamによる

Yamyam: ページの作成:「{{MARKDOWN}} 元記事：[Python API - Blender Developer Documentation](https://developer.blender.org/docs/release_notes/4.2/python_api/#statically-typed-idproperties)…」