BlenderVR システムのインストール

前準備

Blenderのインストール

BlenderVRは古いバージョンのBlenderを前提とするシステムであるため，現行の最新版ではなくBlender 2.79を用いる。以降の手順はWindows環境を対象とする。

1. Blender公式サイトの旧バージョン配布ページ（https://www.blender.org/download/releases/2-79/）を開く。
2. 「Download Blender 2.79b」からWindows用インストーラをダウンロードする。
3. ダウンロードしたインストーラを実行し，画面の指示に従ってインストールする。

手動インストール手順

http://blender-vr-manual.readthedocs.io/installation/installation-manual.html の記載に従う。

Blender用Pythonのバージョンの確認

BlenderVRの動作には，Blenderに同梱されたPythonのバージョンの確認が必要である。Blenderを起動し，画面上部のワークスペースを「Scripting」に切り替え，Pythonコンソールで次のコードを実行して確認する。

import sys
print(sys.version)

Blender 2.79の場合，Python 3.4系であることが確認できる。

Python 3.4環境の準備

1. 管理者権限でコマンドプロンプトを起動する （手順：Windowsキーまたはスタートメニュー → cmd と入力 → 右クリック → 「管理者として実行」）。
   
2. 新しいPython環境を作成する。今のコマンドプロンプトで、次のコマンドを実行する。

   * 「--name py34」の「py34」は任意の名前でよいが，後で識別しやすい名前にすること。

   conda create --name py34 python=3.4
   

   
3. 「Proceed ([y]/n)?」と表示されたら、y + Enter で続行する。応答がない場合は、Enter キーを押す。
   
4. インストール終了の確認。
   

以上の手順により、元からインストールされていたPythonと、新しく作成したPythonバージョン3.4という、異なるバージョンのPythonを共存させることができる。Python 3.4は2016年にサポートが終了した古いバージョンであるため、利用しているconda環境によっては python=3.4 を取得できない場合がある。取得できない場合は、後述の「代替手順」を用いる。

インストール

1. 引き続き、今のコマンドプロンプトで、次のコマンドを実行し、Python 3.4 環境に切り替える。

   conda activate py34
   

   

   * このとき、エラーメッセージが出ないことを確認する。

2. BlenderVRが要求するPySide（Qt4ベースのバインディング）をインストールするため、今のコマンドプロンプトで、次のコマンドを実行する。

   * Anaconda または Miniconda を使用していない場合は conda コマンドが利用できないため、pip コマンドを使用する。

   conda install pyside
   

   
3. 「Proceed ([y]/n)?」と表示されたら、y + Enter で続行する。応答がない場合は、Enter キーを押す。
   
4. インストール終了の確認。
   
5. BlenderVRの手動インストールのWebページを開く。

   http://blender-vr-manual.readthedocs.io/installation/installation-manual.html

6. 「BlenderVR Sources」をクリックする。
   
7. .zip 形式ファイルのダウンロードが始まる。

   ファイル名は source-master.zip である。

8. ダウンロードした .zip ファイルを展開（解凍）し、任意のディレクトリに配置する。

   Windowsでの展開（解凍）に利用できる 7-Zip: 別ページで説明する。

   本書では、この .zip ファイルを E:\source-master\source-master に展開（解凍）したものとして説明を続けるため、各自の環境に応じて読み替えること。

9. Windowsでコマンドプロンプトを起動する。
10. 確認のため、blendervr を起動する。

    e:
    cd e:\source-master\source-master
    python .\blendervr
    

11. アクセス許可についての警告が表示された場合は、内容を確認のうえ「アクセスを許可する」をクリックする。
    
12. 下のような画面が表示されれば、インストールは成功である。
    

【代替手順（conda で python=3.4 が取得できない場合）】

BlenderVR公式マニュアルが示す，pip と venv を用いる方法である。E:\BlenderVR を作業用ディレクトリとし，そこにBlenderVRのソース（source フォルダ）を配置済みであることを前提とする。

cd E:\BlenderVR
pip3 install --no-user virtualenv
virtualenv venv
venv\Scripts\activate
pip3 install --no-user -r source\requirements.txt
python venv\Scripts\pyside_postinstall.py -install
python source\blendervr

書きかけのXMLファイル（設定ファイルの例）を次に示す。

<?xml version="1.0"?>
<blendervr>

  <starter blender="C:/Program Files/Blender Foundation/Blender/blender.exe">
    <config name='Fullscreen'>fullscreen</config>
    <config name='Console'>console</config>
    <config name='Split'>console half left, console half right</config>
  </starter>

  <users>
    <user name="kaneko"/>
  </users>

  <computers>
    <system>
      <daemon transmit='True'>
        <environment>SystemRoot=C:/Windows</environment>
      </daemon>
      <blenderplayer executable="C:/Program Files/Blender Foundation/Blender/blenderplayer.exe" />
    </system>
    <computer name='Any' hostname='*' />
  </computers>

  <screens>
    <screen name="fullscreen" computer="Any">
      <display options="-f">
        <graphic_buffer buffer="mono" user='user A' eye="middle"/>
      </display>
      <wall>
        <corner name="topRightCorner">1.0, 1.0, -1.0</corner>
        <corner name="topLeftCorner">-1.0, 1.0, -1.0</corner>
        <corner name="bottomRightCorner">1.0, -1.0, -1.0</corner>
      </wall>
    </screen>

    <screen name="console" computer="Any">
      <display options="-w 400 400">
        <graphic_buffer buffer="mono" user='user A' eye="middle"/>
      </display>
      <wall>
        <corner name="topRightCorner">1.0, 1.0, -1.0</corner>
        <corner name="topLeftCorner">-1.0, 1.0, -1.0</corner>
        <corner name="bottomRightCorner">1.0, -1.0, -1.0</corner>
      </wall>
    </screen>

    <screen name="console half left" computer="Any">
      <display options="-w 400 400 200 300">
        <graphic_buffer user='user A'/>
      </display>
      <wall>
        <corner name="topRightCorner">0.0, 1.0, -1.0</corner>
        <corner name="topLeftCorner">-1.0, 1.0, -1.0</corner>
        <corner name="bottomRightCorner">0.0, -1.0, -1.0</corner>
      </wall>
    </screen>

    <screen name="console half right" computer="Any">
      <display options="-w 400 400 600 300">
        <graphic_buffer user='user A'/>
      </display>
      <wall>
        <corner name="topRightCorner">1.0, 1.0, -1.0</corner>
        <corner name="topLeftCorner">0.0, 1.0, -1.0</corner>
        <corner name="bottomRightCorner">1.0, -1.0, -1.0</corner>
      </wall>
    </screen>

  </screens>

  <plugins>
  </plugins>
</blendervr>