「bpy」とは、PythonからBlenderの機能を呼び出すことができるBlender Python APIのことです。Blenderはオープンソースの3Dアニメーションソフトウェアであり、「bpy」を使うことでBlenderの様々な機能をPythonスクリプトから呼び出して利用することができます。本記事では、「bpy」を使用する上で基礎的な情報を紹介します。
Blender Function
Basic Function
| 内容 | 関数 | 入力値 | 出力値 | リンク |
|---|---|---|---|---|
| データの表示 Show Data | データ | 詳しくはこちら |
データの表示
### Show Data
# print関数によるデータの表示
print(Data)Data Access (bpy.data)
| 内容 | 関数 | 入力値 | 出力値 | リンク |
|---|---|---|---|---|
| コレクションデータの一括取得 Get all collection data | bpy.data.collections | BlendDataCollections | 詳しくはこちら | |
| シーンデータの一括取得 Get all scene data | bpy.data.scenes | BlendDataScenes | 詳しくはこちら | |
| オブジェクトデータの一括取得 Get all object data | bpy.data.objects | BlendDataObjects | 詳しくはこちら | |
| メッシュデータの一括取得 Get all mesh data | bpy.data.meshes | BlendDataMeshes | 詳しくはこちら | |
| カメラデータの一括取得 Get all camera data | bpy.data.cameras | BlendDataCameras | 詳しくはこちら | |
| ライトデータの一括取得 Get all light data | bpy.data.lights | BlendDataLights | 詳しくはこちら | |
| テクスチャデータの一括取得 Get all texture data | bpy.data.textures | BlendDataTextures | 詳しくはこちら | |
| マテリアルデータの一括取得 Get all material data | bpy.data.materials | BlendDataMaterials | 詳しくはこちら | |
| ワークスペースデータの一括取得 Get all workspace data | bpy.data.workspaces | BlendDataWorkSpaces | 詳しくはこちら | |
| ワールドデータの一括取得 Get all world data | bpy.data.worlds | BlendDataWorlds | 詳しくはこちら |
Context Acess (bpy.context)
| 内容 | 関数 | 入力値 | 出力値 | リンク |
|---|---|---|---|---|
| 選択されているオブジェクトデータの一括取得 Get all selected object data | bpy.context.selected_objects | List[Object] | 詳しくはこちら | |
| 選択可能なオブジェクトデータの一括取得 Get all selectable object data | bpy.context.selectable_objects | List[Object] | 詳しくはこちら | |
| 見えている(可視可能な)オブジェクトデータの一括取得 Get all visible object data | bpy.context.visible_objects | List[Object] | 詳しくはこちら | |
| 編集可能なオブジェクトデータの一括取得 Get all editable object data | bpy.context.editable_objects | List[Object] | 詳しくはこちら | |
| 選択されている編集可能なオブジェクトデータの一括取得 Get all selected editable object data | bpy.context.selected_editable_objects | List[Object] | 詳しくはこちら | |
| アクティブなオブジェクトデータの取得 Get an active object data | bpy.context.active_object | Object | 詳しくはこちら | |
| コンテキストなエリアデータの取得 Get a context area data | bpy.context.area | Area | 詳しくはこちら | |
| コンテキストなブレンドデータの取得 Get a context blend data | bpy.context.blend_data | BlendData | 詳しくはこちら | |
| コンテキストなコレクションデータの取得 Get a context collection data | bpy.context.collection | Collection | 詳しくはこちら | |
| コンテキストなモードデータの取得 Get a context mode data | bpy.context.mode | str | 詳しくはこちら | |
| コンテキストなプリファレンスデータの取得 Get a context preference data | bpy.context.preferences | Preferences | 詳しくはこちら | |
| コンテキストなリージョンデータの取得 Get a context region data | bpy.context.region | Region | 詳しくはこちら | |
| コンテキストなシーンデータの取得 Get a context scene data | bpy.context.scene | Scene | 詳しくはこちら | |
| コンテキストなスクリーンデータの取得 Get a context screen data | bpy.context.screen | Screen | 詳しくはこちら | |
| コンテキストなスペースデータの取得 Get a context space data | bpy.context.space_data | Space | 詳しくはこちら | |
| コンテキストなビューレイヤーデータの取得 Get a context space data | bpy.context.view_layer | ViewLayer | 詳しくはこちら | |
| コンテキストなウィンドウデータの取得 Get a context window data | bpy.context.window | Window | 詳しくはこちら | |
| コンテキストなウィンドウマネージャーデータの取得 Get a context window manager data | bpy.context.window_manager | WindowManager | 詳しくはこちら | |
| コンテキストなワークスペースデータの取得 Get a context workspace data | bpy.context.workspace | WorkSpace | 詳しくはこちら |
