• Blender Python API 公式
• Blender 2.63 での Python の使い方についてまとめてみた - 凹みTips
• blenderをpythonのモジュールとして使う
• Blender でモーショングラフィックス（忙しい人向け） - 恣意的思逸記
• BlenderのWiki

Ubuntu18.04では最初からapt install blenderでインストールが可能． インストールされるバージョンは2019年5月現在は2.79である．

Inria大学のThomas Schiexさんが管理しているppaからインストールするのが良さそう．

sudo add-apt-repository ppa:thomas-schiex/blender
sudo apt update
sudo apt install blender

Python開発の必要な設定を行う． bpy.context.preferences.view.show_tooltips_python = True

アドオンとはサードパーティが作成するプラグインのようなものである． アドオンでインストールするファイル自体は ~/.config/blender/2.79/scripts/addonsに入る．

日本語化をするには設定を変更する必要がある． 設定は設定ファイルとして特定の場所に保存されている．

初めて環境設定をしたときに~/.config/blender/$(version)/config/にuserpref.blendが出来る．

Blender2.8にて，

旧) Blender > Preferences > Interface > Translation > Language

新) Edit > Preferences > Interface > Translation をチェックしないと日本語文字が表示されない．

日本語話者で海外のチュートリアルなど参照して勉強している場合は， 日本語で操作したい場面と英語で操作したい場面があると思う．

トグル設定をしておくとPauseキーで一発切り替えできるようになる． 設定にはサードパーティのアドオン(プラグイン)が必要．

以下のようにダウンロードしてアドオンのディレクトリに置く．

wget https://blender.jp/modules/newbb/download.php?url=/1_ToggleTranslatedUI-111.zip.1368622219000 -O ToggleTranslatedUI.py.zip
unzip ToggleTranslatedUI.py.zip 

BlenderにはPythonで操作するためのAPIであるbpyパッケージがある． bpyは/usr/share/blender/scripts/modules/bpyにある

実行されているPython自体のバイナリがどこにあるのか　sys.executable　で調べられるのだが， BlenderのPythonコンソールでこれを調べると，/usr/lib/blender/blenderというバイナリファイルのようだ(pythonという名前では無いっぽい)． ちなみに普通のpythonでこれを調べると /home/horiuchi/.pyenv/versions/anaconda3-2018.12/bin/python みたいな感じで出てくる．

ちなみにパッケージ検索パス一覧(弊実行環境での例)

/usr/share/blender/2.80/scripts/addons_contrib
/home/horiuchi/.config/blender/2.80/scripts/addons
/usr/share/blender/2.80/scripts/addons
/usr/share/blender/2.80/scripts/startup
/usr/share/blender/2.80/scripts/modules
/usr/lib/python37.zip
/usr/lib/python3.7
/usr/lib/python3.7/lib-dynload
/home/horiuchi/.local/lib/python3.7/site-packages
/usr/lib/python3/dist-packages
/usr/share/blender/2.80/scripts/freestyle/modules
/usr/share/blender/2.80/scripts/addons/modules
/home/horiuchi/.config/blender/2.80/scripts/addons/modules

Blenderの全機能を利用しPythonでフルコントロールするならBlender CUIを利用するのが良さそう．

ライブラリの検索パスを動的に変更してしまえばnumpyなどが使えるようになる．

blenderが使用しているpythonのパッケージを見えないようにして， anacondaのsite-packageを検索対象として追加してしまえば良い．

import sys
# システムのpythonはnumpyが動かないので消す
sys.path.remove('/usr/lib/python3/dist-packages')
# anacondaの環境のパッケージを追加する
sys.path.append('/home/$(USER)/.pyenv/versions/anaconda3-2018.12/envs/$(ENVNAME)/lib/python3.6/site-packages')

それ専用にコンパイルして作ったバイナリが必要．

面倒くさいのでpythonコードを生成してsubprocess.callでCUIのblenderを呼び出したほうが楽かも．

難しいので　dir(hoge) などで中のattributeを確認するのが良い．

operatorsの略．処理のまとまりがOperatorクラスで作られていて， たとえばアドオンなどではOperatorクラスを継承したクラスを作成してシステムにそのOperatorを登録して使えるようにする． ユーザーはそのOperatorを呼び出すことで処理が行われる．

Operatorsクラスのexecuteメソッドが呼ばれる．引数はcontext．

下の名前空間にジャンル分けしている．基本的に戻り値は成功か否かというだけ．

blend データへのアクセス． なるべくこれだけで処理できるとmodelessになって嬉しい．

現在選択中のものなどからアクセスしていく． モーダルなので自動化ではあまり使いたくはない．

Blenderに存在するあらゆるものはここに記述された何らかのクラスのインスタンスである．

import bpy
 
# 言語の変更設定をONに
bpy.context.preferences.view.use_international_fonts = True
# 使用言語を日本語に
bpy.context.preferences.view.language = 'ja_JP'
# インターフェース，新規作成ファイル名，ツールヒントを翻訳対象に
bpy.context.preferences.view.use_translate_interface = True
bpy.context.preferences.view.use_translate_new_dataname = True
bpy.context.preferences.view.use_translate_tooltips = True
 
# 設定を保存
bpy.ops.wm.save_userpref()

• pythonスクリプトファイルで使う場合
  blender –background –python hogehoge.py
• python対話でやる場合
  blender –python-console

独特

モード

• ミドルクリック ドラッグ で注視点を中心に回転
• shift ミドルクリック ドラッグ で平行移動
• ctrl ミドルクリック 上下ドラッグ または スクロール で拡大縮小

• G : 移動
• R : 回転
• S : 拡縮

• 作成: オブジェクトモードで Add → Mesh → Cube
• 削除: X