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

【概要】

BlenderVR の手動インストール法を図解で示す。BlenderVR は、Blender をベースに仮想現実（VR）環境を扱うためのシステムである。

BlenderVR は 2014 年ごろに開発され、更新は止まっている。BlenderVR は Blender のゲームエンジンを利用するため、Blender 2.79（2.75 以降で、ゲームエンジンが削除された 2.80 より前のバージョン）を使う。BlenderVR の操作画面は Python 3.4 と PySide（Qt4）で動作する。2.80 以降と同じ環境でゲームエンジンを使う場合は、派生版の UPBGE を用いる。

【目次】

前準備
手動インストール手順

【関連する外部ページ】

Blenderの公式ページ: https://www.blender.org/
BlenderVRマニュアル: http://blender-vr-manual.readthedocs.io/
UPBGEの公式ページ: https://upbge.org/

前準備

Blender 2.79 のインストール

BlenderVR はゲームエンジンを利用するため、最新版ではなく Blender 2.79 を使う。以降の手順は Windows 環境を対象とする。

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

手動インストール手順

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

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

Blender に同梱された Python のバージョンを確認する。Blender を起動し、画面レイアウトを「Scripting」に切り替え、Python コンソールで次のコードを実行する。

import sys
print(sys.version)

Blender 2.79b では Python 3.5.3 である。BlenderVR の操作画面は Blender の外側で動くため、次の手順で別に Python 3.4 環境を用意する。

Python 3.4環境の準備

管理者権限でコマンドプロンプトを起動する（手順：Windowsキーまたはスタートメニュー → cmd と入力 → 右クリック → 「管理者として実行」）。
新しいPython環境を作成する。今のコマンドプロンプトで、次のコマンドを実行する。
* 「--name py34」の「py34」は任意の名前でよいが、後で識別しやすい名前にすること。
```
conda create --name py34 python=3.4
```
「Proceed ([y]/n)?」と表示されたら、y + Enter で続行する。応答がない場合は、Enter キーを押す。
インストール終了の確認。

以上の手順で、元からインストールされていた Python と、新しく作成した Python 3.4 を共存させることができる。Python 3.4 は 2019 年 3 月にサポートが終了しており、conda のチャネルから python=3.4 を取得できない場合がある。取得できない場合は、後述の「代替手順」を用いる。

インストール

引き続き、今のコマンドプロンプトで、次のコマンドを実行し、Python 3.4 環境に切り替える。
```
conda activate py34
```
* このとき、エラーメッセージが出ないことを確認する。
BlenderVR が使う PySide（Qt4 ベースのバインディング）をインストールするため、今のコマンドプロンプトで、次のコマンドを実行する。
* Anaconda または Miniconda を使用していない場合は conda コマンドが使えないため、pip install pyside を実行する。
```
conda install pyside
```
「Proceed ([y]/n)?」と表示されたら、y + Enter で続行する。応答がない場合は、Enter キーを押す。
インストール終了の確認。
BlenderVRの手動インストールのWebページを開く。
http://blender-vr-manual.readthedocs.io/installation/installation-manual.html
「BlenderVR Sources」をクリックする。
.zip 形式ファイルのダウンロードが始まる。
ファイル名は source-master.zip である。
ダウンロードした .zip ファイルを展開（解凍）し、任意のディレクトリに置く。
Windowsでの展開（解凍）に使える 7-Zip: 別ページで説明する。

このページでは、E:\source-master\source-master に展開（解凍）したものとして説明するので、各自の環境に応じて読み替えること。
Windowsでコマンドプロンプトを起動する。

確認のため、blendervr を起動する。

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

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

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

BlenderVR 公式マニュアルが示す、pip と virtualenv を用いる方法である。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）の例を次に示す。Blender は既定のインストール先にあるものとしている。

<?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="user A"/>
  </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>