2. iRIC2Blenderの実装方法

# アドオンのインストール方法
## Windows & Mac共通
###	通常のインストールの流れ
1. [編集]→[プリファレンス]を選択します。
   ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3508676/b2fe5b31-4e62-8cde-9216-d97e8c7ba210.png)


1.	以下の画面が現れます
   ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3508676/64eb21c8-de7c-c479-0b37-192a54155dce.png)


1. iRIC2blenderを保存したフォルダを選択し、[iRIC2blender.zip]を選択し、[アドオンをインストール]を選択します。
   ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3508676/15753dfc-0fad-374a-eee6-aa5780bda099.png)
   ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3508676/57724141-9ea2-fc7c-355a-be45510166a1.png)


1. インストールが完了すると、以下のような画面となります。iRIC2blenderのチェックボックスが入っていない状態です。
   ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3508676/fd5b14d8-2ca9-6237-7e31-aaf963439977.png)


1. iRIC2blenderのチェックボックスを選択します。エラー等が生じていない場合は無事にインストールが完了してます。
   ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3508676/9d7c9aff-c256-bc1f-75df-48489c2a77cf.png)

## Windows編
### アドオンの初回インストール時のエラー（外部ライブラリのインストール）対応


1. [アドオン]にてiRIC2blenderのチェックボックスを初回時に選択すると、エラーがでます。これはアドインが外部ライブラリを用いているために生じているものです。外部ライブラリのインストールを行っていきます。
   ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3508676/de9e2c5d-7e68-c55c-b11e-b81a39be7f06.png)
   ![Pasted Graphic 3.tiff](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3508676/925e55ef-2e60-ee78-218f-2f21aaaa4c20.tiff)


1. Windowsキーを選択し、[cmd]と検索すると、コマンドプロンプトが見つかります。[コマンドプロンプト]の[管理者として実行]を選択します。
   ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3508676/a3ad38b5-d166-06d6-11d2-7ea21f5cb538.png)

1. Blenderに内蔵してあるpythonにアクセスします。cd コマンドで“blenderのpythonの保存されているディレクトリ”に移動します。
  - Blender3.2の場合の例を示します。

   ```
   cd "C:\Program Files\Blender Foundation\Blender 3.2\3.2\python\bin\" 
   ```

   - エクスプローラーで同じファイルにアクセスすると、pythonが確認できます。
   ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3508676/6be75b1f-4826-f14b-868c-73c31140b02e.png)
 
1. 【参考】pythonの場所が不明な場合はBlenderを開いて確認します。[scripting]タブを選択します。
[scripting]タブのコンソール画面に以下のコマンドを入力します。


   ```diff_python
   >>> import sys
   >>> sys.path
   ```

   ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3508676/395ed589-cc07-6475-2416-d3c8f6a8a560.png)


   - 以下の出力が出てきます。
   ```
   C:\Program Files\Blender Foundation\Blender 3.2\3.2\python\bin\
   ```
   が該当するフォルダになります。

   ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3508676/4b303dfe-c94b-c285-8211-5e657d365d6e.png)


1. 外部ライブラリをインストールしていきます。コマンドプロンプトでPythonのあるディレクトリにおいて、以下のコマンドを実行し、外部ライブラリをインストールします。まずは、pipのパッケージをアップデートします。

   ```Batchfile
   > .\python.exe -m pip install --upgrade pip
   ```

1. 外部ライブラリをインストールしていきます。pyproj、requests、pillow、staticmap、matplotlibがiric2blenderにおいて必要な外部ライブラリになります。インストール時はBlenderを閉じてください。

   ```
   > .\python.exe -m pip install pyproj
   > .\python.exe -m pip install requests
   > .\python.exe -m pip install Pillow
   > .\python.exe -m pip install staticmap
   > .\python.exe -m pip install matplotlib
   ```

1. 外部ライブラリのインストールが完了したら、以下のコメントを入力し、外部ライブラリが入っているかを確認します。

   ```
   > .\python.exe -m pip list
   ```

   ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3508676/0f48a3b4-5a2f-8d30-d720-9969e6d6fb93.png)


1. Blenderに戻り、[scripting]タブのコンソール画面で以下のコマンドを入力し、外部ライブラリが無事にインポートできるか確認します。エラー等が生じない場合は無事にインポートできます。

   ```diff_python
   >>> import pyproj
   >>> import staticmap
   >>> import matplotlib
   ```
   ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3508676/c7457115-c1f3-388b-e20f-3c8f6016bb45.png)


1. Blenderのコンソール画面にて、外部ライブラリをインポートした際に、以下のようなエラーが生じている場合はパッケージに不具合がある可能性があります。
   ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3508676/3f056c8f-3ccc-7875-e1e8-5c8d96ad454c.png)
   ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3508676/0d85b281-09dc-6ef4-a060-a12c57eab087.png)

1. コマンドプロンプトにおいて、以下のコマンドを実行し、外部ライブラリの再インストールを実行します。
   ```batch
   >.\python.exe -m pip install --upgrade --force-reinstall matplotlib
   >.\python.exe -m pip install --upgrade --force-reinstall requests
   >.\python.exe -m pip install --upgrade --force-reinstall Pillow
   >.\python.exe -m pip install --upgrade --force-reinstall staticmap
   ```

   - なお、上のコマンドを実行する際には、blenderを必ず閉じてください。閉じない場合は以下のようなエラーが生じます。
   ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3508676/3c4f11d7-9b0e-de2c-80d7-41b0d48e3138.png)

 
1. Blenderに戻り、[scripting]タブのコンソール画面で以下のコマンドを入力し、外部ライブラリが無事にインポートできるか確認します。エラー等が生じない場合は無事にインポートできます。
   ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3508676/4bf7efbd-47f2-ac88-10ce-3132e90a0d21.png)


## mac編
### アドオンの初回インストール時のエラー（外部ライブラリのインストール）対応
1. blender のコンソールで以下を入力し、blenderに内蔵されているpythonの場所を探す。
   ```bash
   $ import sys
   $ print(sys.executable)
   ```
   以下の出力結果を得た場合の例を下記に載せる。Blenderのインストールしたバージョンによって、内容が異なるため、`$ print(sys.executable)`の出力結果に沿って、Blenderのpythonへの外部ライブラリのインストールを進めること。
   ```bash
   > /Applications/Blender3-2.app/Contents/Resources/3.2/python/bin/python3.10
   ```

1. pipの更新を行う
   ```bash
   $ /Applications/Blender3-2.app/Contents/Resources/3.2/python/bin/python3.10 -m pip install --upgrade pip
   ```


1. 外部ライブラリのインポート

    1. staticmapのインポート

       ```bash
       $ /Applications/Blender3-2.app/Contents/Resources/3.2/python/bin/python3.10  -m    pip install staticmap
       ```

   1. pyprojのインポート
      ```bash
      $ /Applications/Blender3-2.app/Contents/Resources/3.2/python/bin/python3.10  -m    pip install pyproj
      ```

   1. matplotlibのインポート
      ```bash
      $ /Applications/Blender3-2.app/Contents/Resources/3.2/python/bin/python3.10  -m    pip install matplotlib
      ```

1. blenderのコンソールより、importを行い、ライブラリがちゃんとインポートされるかを確認
   ```python
   from staticmap import StaticMap
   import pyproj
   import matplotlib.pyplot as plt
   ```