• 追加された行はこの色です。
  • 削除された行はこの色です。
[[SprBlender/manual]]

#contents

* インストール方法 [#yb31c0f5]
**動作環境 [#u24f06f1]
- SprBlenderの動作にはBlender、Python、Springhead2が動作する環境が必要です
- SprBlender本体はpythonスクリプトで、BlenderにバンドルされたPythonによって動作します
- Springhead2はpython用のDLLとしてビルドされたSpr.pydを用います
-- Spr.pydは、現在Windows32bit、Windows64bit向けのものが整備されています
-- 現在、Python3.2でビルドされているのでPython3.3を使っているBlender2.65以降では利用することができません
-- BlenderとSpr.pydとでPythonのバージョンを合わせる必要があります
--- Blender2.64まではPython3.2で、Blender2.65以降はPython3.3です

** 必要なもの [#l73c644f]
- 以下を32bit版または64bit版'''どちらかに統一して'''揃えます
- Blender 2.5以降 32bit or 64bit
-- インストーラ版だとうまく動作しないようなのでzip版をダウンロードしてください
-- 現在は2.64a版にて動作確認を行なっています
-- Blender2.65以降ではPython3.3を使っているため現在利用できません
-- 現在は2.65a版にて動作確認を行なっています
-- Blenderのダウンロードは[[こちらの公式サイトから>http://www.blender.org/download/get-blender/]]
- springhead2のpythonDLL: Spr.pyd 32bit or 64bit
//-- http://springhead.info/spr2/Springhead2/trunk/bin/win32/Spr.pyd
//-- or http://springhead.info/spr2/Springhead2/trunk/bin/win64/Spr.pyd
//-- 最新バージョンのビルドは\Springhead2\src\EmbPython\SprPythonDLL.sln
-- 現在SVNが非公開となっているため、[[ダウンロード>SprBlender/download]]にて暫定配布中です
-- SVNが非公開となっているため、[[ダウンロード>SprBlender/download]]にて暫定配布中です
-- PythonのバージョンをBlenderと合わせる必要があります
--- Blender2.64まではPython3.2で、Blender2.65以降はPython3.3です
- Springhead2の動作に必要なライブラリ 32bit or 64bit
//-- http://springhead.info/spr2/Springhead2/trunk/bin/win32
//-- or http://springhead.info/spr2/Springhead2/trunk/bin/win64
-- 現在SVNが非公開となっているため、[[ダウンロード>SprBlender/download]]にて暫定配布中です
-- SVNが非公開となっているため、[[ダウンロード>SprBlender/download]]にて暫定配布中です
- Blender用pythonスクリプト(SprBlender本体)
-- 安定版
--- [[ダウンロード>SprBlender/download]]
//-- SVNリポジトリ(開発版)
//--- http://springhead.info/spr2/SprBlender/trunk

** インストール [#ybcae2de]
+ Blenderをインストール
+ Blender用モジュールスクリプトの"scripts"をBlender本体のフォルダ内の"(バージョン番号)\scripts"に上書き
-- "scripts\module"の中に"spr_op"を入れることになります
-- ※後述しているようにSVNでチェックアウトしたscriptsフォルダにシンボリックリンクを貼ると楽にupdateできます
+ Spr.pydをBlender本体フォルダ内の"(バージョン番号)\scripts\modules"に入れる
+ Springhead2の動作に必要なライブラリにPATHを通す(環境変数)
+ Springhead2の動作に必要なライブラリにパスを通す(PATH、環境変数)
+ 環境変数 SPRPYTHONPATH を,下記のいずれかに設定する
-- C:\Python32\Lib (c:\Python32にPythonがインストールされている場合)
-- (Springhead2のパス)\Springhead2\bin\src\Python32\Lib (Springhead2のソースをダウンロードした場合)
-- C:\Program Files\Blender Foundation\Blender\2.63\python\lib (Blenderのみインストールされている場合)

** Tips:常に最新のspr_opを使いたい場合 [#tfe87ce5]
- シンボリックリンクを使うと便利です
*** Windows7、vista [#s88a2a77]
- 管理者権限でコマンドプロンプト起動

コマンド例
 mklink /J "D:\Program Files (x86)\Blender Foundation\blender-2.63a-release-windows64\2.63\scripts\modules\spr_op" "D:\project\SprBlender\scripts\modules\spr_op"

*** windows XP [#f8ff3baf]
- Link Creation Shell Extension[[(SourceForge.net):http://sourceforge.jp/projects/sfnet_lnhdr/]]をダウンロード、インストール
- 右クリックドラッグ&ドロップ→「リンクを作る」
-- ※フォルダには使えますがファイル単体には使えないようです

* 起動と実行 [#fdab740e]
----
&color(red){※注意:SprBlenderはオブジェクトの位置・姿勢を実際に変更します。つまり、シーンを壊してしまいます。};~
&color(red){実行前にはデータをファイルに保存してください。};~
&color(red){また、実行後に誤って上書きしてしまわないようファイルのバックアップをとることを推奨します。};~
----
**1.Blenderを起動する [#tcc84352]
- Blenderを起動します

**2.testシーンを読み込む [#a917b620]
&ref(SprBlender/introduction/import_spr_op.png,zoom,480x270);
- SprBlender/samples/test.blendを読み込みます
-- 様々なオブジェクトのパラメータの設定が済んだシーンとなっています
-- 環境によってGLSLがうまく描画されない場合はひとまず3D Viewの"Viewport Shading"から"Solid"を選択してください(Zキー2回)

**3.右下のpythonコンソールで"import spr_op"と入力してEnter [#h6f50738]
&ref(SprBlender/02_import.png,320x240,02_import.png);
- 右下のpythonコンソールで"import spr_op"と入力してEnterキーを押します
- BlenderにSpringhead2用のOperatorが登録されます
- SprBlenderのための各種インタフェースが表示されます
-- 3DView Properties(右側): Spr Operator Panel
--- SprBlenderの全体を操作するためのインタフェースです
-- Scene: Spr Scene panel
--- Springhead2のシーンのパラメータを設定します
-- Object: Spr Object Panelなど
--- Springhead2の物理モデルのパラメータを設定します

&ref(SprBlender/SprOperatorPanel.png,zoom,320x240);
&ref(SprBlender/SprScenePanel.png,zoom,320x240);
&ref(SprBlender/SprObjectPanel.png,zoom,320x240);
-- Springhead2の初期化が行われ、SprBlenderのメインループが始動します

**4."Set Scene"を押してSpringhead2のシーンを初期化 [#kd19d73c]
&ref(SprBlender/OperatorSetScene.png,zoom,320x240);
- "Set Scene"ボタンを押すとSpringhead2のシーンが初期化されます
- Blenderのオブジェクトのパラメータに従って物理モデルが生成されます

**5."Physics Step Enable"をチェックするとStepが有効になり動き出す [#z7c6e088]
&ref(SprBlender/PhysicsStepEnable.png,zoom,320x240);
- "Physics Step Enable"をチェックすると物理シミュレーションのステップが進み動き出します

**6.オブジェクトを移動したり回転するとリアルタイムに影響 [#vf17a300]
&ref(SprBlender/04_move.png,zoom,320x240);
- オブジェクトを移動したり回転すると物理シーンにリアルタイムに影響します
- オブジェクトの移動:選択(右クリック)→G(または右ドラッグ)→マウス移動→左クリックで決定(右クリックキャンセル)
- オブジェクトの回転:選択(右クリック)→R→マウス移動→左クリックで決定(右クリックキャンセル)
- "Enable Throw"を押すとオブジェクトに初速を与えられるようになります

**7."Restore Scene"を押すと初期姿勢に戻る(変位、回転) [#b579ee6e]
&ref(SprBlender/OperatorRestoreScene.png,zoom,320x240);
-"Restore Scene"を押すとシーン内の全てのオブジェクトが初期位置・初期姿勢に戻ります
- 初期位置・初期姿勢は各物理モデルを生成した時の位置・姿勢です

**8.コピー・追加したオブジェクトに物理を適用 [#g1c5b6ec]
&ref(SprBlender/OperatorSetObjects.png,zoom,320x240);
-コピーしたオブジェクトや追加したオブジェクトに物理を適用したい場合は、対象を選択(右クリック、shiftを押しながらで複数選択可)、"Set Objects"を押す [#z31da3d9]
- オブジェクトのコピー:選択(右クリック)→shift+D→マウス移動→左クリックで決定
- 追加時に物理法則に従うかどうか、BoxかSphereかの設定が適用される


**9."Set Scene"を押してその場でSpringhead2のシーン全体を初期化 [#u625a8c3]
&ref(SprBlender/OperatorSetScene.png,zoom,320x240);
- "Set Scene"を押すとその場でSpringhead2のシーン全体を初期化します
- その時のオブジェクトの位置・姿勢を初期位置・初期姿勢として物理モデルが生成されます

**10.Text Editorでデバッグ情報を確認 [#z86cb18b]
&ref(SprBlender/introduction/text_debug_out.png,zoom,480x270);
- Text Editorでフレームレート等のデバッグ情報を確認できます
- text"spr_main"にSprBlenderのフレームレートや物理シミュレーションのステップ間隔等の情報が毎ステップ更新されます

**memo [#n87fc6a8]
- 現状では"import spr_op"後にblendファイルをロードすると動かなくなります
-- "ReRegister"を'''1度'''押すと再び動くようになります
---"ReRegister"を複数回押すとStepが重複して呼ばれるようになるので注意してください