【Blender×Python】「bpy」(Blender PythonAPI)について徹底解説

Blender

「bpy」とは、PythonからBlenderの機能を呼び出すことができるBlender Python APIのことです。Blenderはオープンソースの3Dアニメーションソフトウェアであり、「bpy」を使うことでBlenderの様々な機能をPythonスクリプトから呼び出して利用することができます。本記事では、「bpy」を使用する上で基礎的な情報を紹介します。

Blender Function

Basic Function

内容関数入力値出力値リンク
データの表示
Show Data
printデータ詳しくはこちら

データの表示

### Show Data

# print関数によるデータの表示
print(Data)

Data Access (bpy.data)

内容関数入力値出力値リンク
コレクションデータの一括取得
Get all collection data
bpy.data.collectionsBlendDataCollections詳しくはこちら
シーンデータの一括取得
Get all scene data
bpy.data.scenesBlendDataScenes詳しくはこちら
オブジェクトデータの一括取得
Get all object data
bpy.data.objectsBlendDataObjects詳しくはこちら
メッシュデータの一括取得
Get all mesh data
bpy.data.meshesBlendDataMeshes詳しくはこちら
カメラデータの一括取得
Get all camera data
bpy.data.camerasBlendDataCameras詳しくはこちら
ライトデータの一括取得
Get all light data
bpy.data.lightsBlendDataLights詳しくはこちら
テクスチャデータの一括取得
Get all texture data
bpy.data.texturesBlendDataTextures詳しくはこちら
マテリアルデータの一括取得
Get all material data
bpy.data.materialsBlendDataMaterials詳しくはこちら
ワークスペースデータの一括取得
Get all workspace data
bpy.data.workspacesBlendDataWorkSpaces詳しくはこちら
ワールドデータの一括取得
Get all world data
bpy.data.worldsBlendDataWorlds詳しくはこちら

Context Acess (bpy.context)

内容関数入力値出力値リンク
選択されているオブジェクトデータの一括取得
Get all selected object data
bpy.context.selected_objectsList[Object]詳しくはこちら
選択可能なオブジェクトデータの一括取得
Get all selectable object data
bpy.context.selectable_objectsList[Object]詳しくはこちら
見えている(可視可能な)オブジェクトデータの一括取得
Get all visible object data
bpy.context.visible_objectsList[Object]詳しくはこちら
編集可能なオブジェクトデータの一括取得
Get all editable object data
bpy.context.editable_objectsList[Object]詳しくはこちら
選択されている編集可能なオブジェクトデータの一括取得
Get all selected editable object data
bpy.context.selected_editable_objectsList[Object]詳しくはこちら
アクティブなオブジェクトデータの取得
Get an active object data
bpy.context.active_objectObject詳しくはこちら
コンテキストなエリアデータの取得
Get a context area data
bpy.context.areaArea詳しくはこちら
コンテキストなブレンドデータの取得
Get a context blend data
bpy.context.blend_dataBlendData詳しくはこちら
コンテキストなコレクションデータの取得
Get a context collection data
bpy.context.collectionCollection詳しくはこちら
コンテキストなモードデータの取得
Get a context mode data
bpy.context.modestr詳しくはこちら
コンテキストなプリファレンスデータの取得
Get a context preference data
bpy.context.preferencesPreferences詳しくはこちら
コンテキストなリージョンデータの取得
Get a context region data
bpy.context.regionRegion詳しくはこちら
コンテキストなシーンデータの取得
Get a context scene data
bpy.context.sceneScene詳しくはこちら
コンテキストなスクリーンデータの取得
Get a context screen data
bpy.context.screenScreen詳しくはこちら
コンテキストなスペースデータの取得
Get a context space data
bpy.context.space_dataSpace詳しくはこちら
コンテキストなビューレイヤーデータの取得
Get a context space data
bpy.context.view_layerViewLayer詳しくはこちら
コンテキストなウィンドウデータの取得
Get a context window data
bpy.context.windowWindow詳しくはこちら
コンテキストなウィンドウマネージャーデータの取得
Get a context window manager data
bpy.context.window_managerWindowManager詳しくはこちら
コンテキストなワークスペースデータの取得
Get a context workspace data
bpy.context.workspaceWorkSpace詳しくはこちら