キーワード

目次

• まえがき
• 用語の説明
• スクリプトの実行方法
• Pythonコンソールに直接コマンドを入力する
• テキストエディタからスクリプトを実行する
• エラーが出たときは
• BPYコマンドの調べ方

まえがき

用語の説明

• Python

　プログラミング言語のひとつ．Blender2.8にはPython3が組み込まれているので別途インストールする必要はありません． ちなみに，Python2とPython3ではかなり構文に違いがあるので調べるときはPythonのバージョンをよく確認すると良いです．



• Blender Python（BPY）

　Blenderの様々な機能をPythonで簡単に呼び出せるようにするため，Blender開発者が公開している橋渡し的な役割を持つモジュール（関数・構造体の集まり）のことです．この橋渡し的な役割を持つモジュールは一般にAPIと呼ばれています．



• スクリプト

　書いたプログラムのことです．厳密にはコンパイルを介さないプログラムのことですが，ここではそこまで気にしなくても大丈夫です．

スクリプトの実行方法

• Pythonコンソールに直接コマンドを入力する

　最もお手軽な方法です．コマンドを直接入力して実行します．コンソールは対話形式でコマンド実行時に戻り値がある場合は直後に戻り値が表示されます．
　


• テキストエディタからスクリプトを実行する

　Blender内蔵のテキストエディタにスクリプトを書き込み（または外部のテキストファイルから読み込み）実行する方法です． Pythonコンソールでは実行時に毎回スクリプトを手入力なり，コピペなりしなくてはいけないですが，この方法なら1クリックで実行できます．基本的に当サイト内で扱うスクリプトはこの方法での実行を推奨しています．



• アドオンを作成する

　BlenderのUIにボタン等と一緒に機能を組み込んでしまう方法です．よっぽど使用頻度が高いものや，不特定多数にスクリプトを配布するときなどはこの手段が良いでしょう． ただし，全然初心者向けじゃないので今回は扱わないことにします．

Pythonコンソールに直接コマンドを入力する

1. ウィンドウ切り替えボタンをクリックします（各ウィンドウの左上部）
2. [Pythonコンソール]ウィンドウを開く
3. Pythonコンソール下部の>>>にコマンドを入力して[Enter]で実行する
   
　例）print("hello")と入力すると直後にhelloが表示される

a = 2
b = 3
sum = a + b

print(sum)
		

#現在のシーンをレンダリングする
bpy.ops.render.render()
		

#選択オブジェクトをx方向に2動かす
bpy.ops.transform.translate(value=(2, 0, 0))
		

テキストエディタからスクリプトを実行する

1. ウィンドウ切り替えボタンをクリックします（各ウィンドウの左上部）
2. [テキストエディター]ウィンドウを開く






3. スクリプトを入力，または外部ファイルから取り込む
　テキストを新規で入力する場合は，最初にテキストをBlender内で新規作成します．このテキストはBlendファイル内に保存されます． 外部のテキストファイルとして出力するときは[テキスト]＞[名前をつけて保存]から出力できます．

　既にスクリプトのテキストファイルが用意されているときは，フォルダマークのボタンからテキストを取り込んでください．

　テキストエディタでBPYモジュールを使用する場合は必ず冒頭に"import bpy"と記述する必要があります． これを最初に記述しておくことでbpyと名のついた関数を実行できるようになります．

　例として以下にスクリプトを用意してみました．選択オブジェクトを適当に並べながらコピーしていくスクリプトです．

import bpy

#2重forループ
for i in range(5):
    for j in range(5):
        
        #選択オブジェクトをコピー
        bpy.ops.object.duplicate()
        
        #オブジェクトの座標を指定
        bpy.context.object.location.x = i * 2
        bpy.context.object.location.y = j * 2
        
        #オブジェクトのスケールを指定
        bpy.context.object.scale.x = (5-i) / 5
        bpy.context.object.scale.y = (5-i) / 5
        bpy.context.object.scale.z = (5-i) / 5
        
        #オブジェクトの角度をオイラー角[rad]で指定
        bpy.context.object.rotation_euler.x = i / 5
        bpy.context.object.rotation_euler.y = j / 5
			



4. [スクリプト実行]ボタンをクリックして実行する
　ボタンが右端の方にあるので，隠れている場合は[マウスホイール中ボタン]ドラッグで表示範囲を移動してください． または，[テキストエディター]ウィンドウにマウスカーソルを乗せた状態で[Alt]+[P]でも実行できます．

　※上記のスクリプト実行時は必ず何かオブジェクトを選択してください．

エラーが出たときは

BPYコマンドの調べ方

こちらもおすすめ