SprBlenderはBlender上で動作するPythonモジュールです.そのため,Blenderのインストールフォルダ内の所定の位置に配置する必要があります.今のところ,インストーラは用意されていないため手動でのインストールが必要です.
SprBlenderの動作に必要なものは以下のとおりです.
SprBlender zipパッケージをダウンロードすると,3,4をまとめて入手することができます.
インストーラ版のBlenderは,ダウンロードしたexeファイルを実行するとインストールが始まります.指示に従い,インストールを行なってください.
Blenderの標準的なインストールフォルダは
C:\Program Files\Blender Foundation\Blender
です.本文書では,以後Blenderをこのフォルダにインストールしたものとして話を進めます(異なるフォルダにインストールした場合は適宜読み替えてください).
次に,SprBlenderのインストールを行います.
フォルダ構成
- SprBlender/ +- samples/ | +- blend/ .............. サンプルの.blendファイル | +- textures/ +- scripts/ | +- modules/ | +- spb/ ............. SprBlender本体 +- spbapi_cpp/ +- bin/ ................ Springhead DLL格納フォルダ +- py32/ | +- win32/ | | +- Spr.pyd ..... Blender2.64以下, 32bit用 | +- win64/ | +- Spr.pyd ..... Blender2.64以下, 64bit用 +- py33/ +- win32/ | +- Spr.pyd ..... Blender2.65以上, 32bit用 +- win64/ +- Spr.pyd ..... Blender2.65以上, 64bit用
- <dependency> +- bin +- win32/ .............. Springhead依存ライブラリのDLL (32bit用) +- win64/ .............. Springhead依存ライブラリのDLL (64bit用)
C:\Program Files\Blender Foundation\Blender\2.65\scripts\modules
C:\Program Files\Blender Foundation\Blender\2.65\scripts\modules
C:\Program Files\Blender Foundation\Blender\dependency
次に,スタートメニューから
ユーザー環境変数の一覧に「Path」変数があればそれを選択して「編集」を,なければ「新規」をクリックします.新規の場合は変数名を「Path」としてください.
変数値に
C:\Program Files\Blender Foundation\Blender\dependency\win64 (* 32bitの場合は \win32)
を追加します.新規の場合はそのまま入力し,編集の場合は既存の内容の最後にセミコロンをつけてから上記の内容を入力します.
OKを押すと環境変数の登録が完了します.環境変数を設定したあとはPCを再起動してください.
SprBlenderにはいくつかのサンプルが付属しています.ここでは基本的なサンプルである test.blend を実行してみることにします.
Blenderを起動し,Fileメニューの Open を選ぶとファイルダイアログが表示されます.
SprBlender zipパッケージを解凍したものの中に samples というフォルダが含まれているはずです.samplesフォルダへのパスをファイルダイアログのフォルダパスのボックスに入力します.
出てきたファイル一覧からtest.blendを選択して Open Blender File をクリックするとファイルが開きます.
test.blendがロードされたら,画面中央下寄りにある,右三角の付いた「Start」ボタンを押すことで,SprBlenderのシミュレーションを開始することができます.
シミュレーションの停止は「Pause」または「Stop」です(詳しくはシミュレーションの実行で解説します.).
以下のURLでSprBlenderのSubversionレポジトリにアクセスできます.
http経由でのアクセスはアカウント登録が要りませんが,コミットすることができません.最新版を使用したいだけの場合に利用してください.
TortoiseSVN等を使ってチェックアウトしてください.ここでは
C:\users\(ユーザ名)\SprBlender
にチェックアウトしたとします.
SprBlenderの動作には,Springheadに含まれている依存ライブラリのDLL(glut等)が必要です.これはパッケージ版には含まれていますが,Subversionレポジトリには含まれていないためSpringheadのSubversionレポジトリから別途チェックアウトする必要があります.
以下のURLでSpringheadのSubversionレポジトリ内にアクセスできます.
ここでは,
C:\users\(ユーザ名)\Springhead2\bin
にチェックアウトしたとします.
(以下は手動でインストールする場合です。インストーラを利用すると以下の手順を自動で実行します。)
SprBlenderの開発はSubversionレポジトリで進められており,レポジトリにアクセスすれば開発者向けの最新版が利用可能です(当然ですが動作の保証はありません).
通常はspbフォルダをBlenderのインストールフォルダにコピーして使いますが,Subversionからチェックアウトして開発を行う場合,ワーキングコピーをProgram Files内に置くのは何かと面倒です.
ワーキングコピーをユーザーフォルダに置いたまま,編集やsvn upを行った時に(再度Blenderフォルダにコピーすることなく)Blenderの動作に反映させるには,{\bf シンボリックリンク}を利用すると便利です.
- Blender/2.65/ - C:/users/(ユーザ名)/SprBlender +- scripts/ +- scripts/ | +- modules/ | +- modules/ | +- [spb] <-----[Link]--- | -- +- spb/ +- spbapi_cpp/ +- spbapi_cpp/ +- bin/ +- bin/ +- py33/ +- py33/ +- win64/ +- win64/ +- [Spr.pyd] <-----[Link]----- +- Spr.pyd
シンボリックリンクを利用すると,このように同じファイルやフォルダが複数の場所にあるような状態を作ることができます.開発はユーザーフォルダで行いつつ,動作チェックも瞬時に行うことができます.
シンボリックリンクを張るにはコマンドプロンプトを{\bf 管理者権限で起動}し,
> cd C:\Program Files\Blender Foundation\Blender\2.65\scripts\modules > mklink /j spb C:\users\(ユーザ名)\SprBlender\scripts\modules\spb > mklink Spr.pyd C:\users\(ユーザ名)\SprBlender\spbapi_cpp\bin\py33\win64\Spr.pyd
のようにします.
Blenderが32bit版か64bit版かで設定する内容が異なります.
c:\users\(ユーザ名)\Springhead2\bin\win32
c:\users\(ユーザ名)\Springhead2\bin\win32 c:\users\(ユーザ名)\Springhead2\bin\win64
に環境変数PATHを設定してください.64bit版の場合はwin32とwin64の両方にPATHを通す必要があることに注意してください