Merge branch 'v4_alpha'

# Conflicts:
#	Editor/Window/Main/PlateauWindow.cs

Author: linoal

.coderabbit.yaml

@@ -0,0 +1,7 @@
+# AIレビューCodeRabbitの設定
+language: "ja"
+
+reviews:
+  profile: "chill"
+  path_filters:
+    - "!Tests/TestData/**"

.github/pull_request_template.md

@@ -1,15 +1,18 @@
-## 関連リンク
-<!-- libplateauのPR等、関連するPRがあれば書く。 -->
+## 🔗 関連リンク
+<!-- 関連するPR、仕様書のリンク(社外の方を除く)、Jiraチケットのリンク(社外の方を除く)等を書いてください。 -->
 
-## 実装内容
-<!-- 実装した内容、背景について書く。妥協点があれば書いておく。 -->
+## ✅ レビュー前確認項目
+- [ ] ユニットテストが通ること
+- [ ] ビルドが通ること
 
-## マージ前確認項目
-- [ ] Squash and Mergeが選択されていること
-- [ ] UI、挙動に変更ある場合、ユーザーマニュアルが更新されていること
+<!-- 社内の人向け: 以下の項目は、開発当初のストーリー設計書通りであれば省略可能です。
+                 設計に変更があった場合のみ、変更点を周知するために記載してください。 -->
 
-## 動作確認
+## 🚀 実装内容
+<!-- GUIに関する実装がある場合はスクリーンショットを貼ってください。実装した内容について書いてください。 -->
+## 🌐 影響範囲
+<!-- 既存の実装に対して行った変更や、影響がある部分があれば書いてください(特に同時並行している他の作業に影響する時、今後必要な変更を書く)。また社内の人は、影響先の担当者に対して周知をお願いします。 -->
+## 🛠️ 動作確認
 <!-- レビュアーが動作確認するのに必要な手順と結果を書く。 -->
-
-## その他
+## ⚠️ 懸念点
 <!-- 気になる点、特にレビューしてほしい点等があれば書く。 -->

Documentation~/manual/ImportCityModels.md

@@ -39,6 +39,17 @@
   - `データセットの選択`で`都道府県`を選択します。
   - するとその都道府県に対応する `データセット`が選択肢に出てくるので選びます。
 
+### インポート形式の選択
+
+インポート形式を次から選択します。
+
+- `シーンに配置`
+  - インポートした都市モデルを現在のシーンに直接配置します。  
+- `動的タイル（Addressables出力）`
+  - 広大な範囲を表示したいとき、描画負荷を抑えつつ表示できる機能です。 
+  - 広範囲の描画に耐えるよう、3D都市モデルを最適化しながらタイル状に出力し、カメラの距離に応じて読み込む機能です。
+  - 詳しくは[動的タイル機能について](./dynamicTile.md)をご覧ください。
+
 ### 基準座標系の選択
 リストのうち、都市が属する場所として近いものを選択します。  
 ![](../resources/manual/importCityModels/coordinateSystemSelect.png)   
@@ -257,14 +268,9 @@
   再度`モデルをインポート`ボタンが表示されたらキャンセル完了です。
 
 >[!NOTE]
->   インポート元となる都市データは `Assets/StreamingAssets/.PLATEAU` にコピーされます。  
->   .PLATEAU は隠しフォルダである点にご注意ください。Unityのインポート処理を削減する目的でこうなっています。
->   なお、インポート対象として選択したものに関連するもののみがコピーされます。
-
->[!NOTE]
->   インポートされた都市モデルは、プレハブ化するとメッシュとテクスチャが missing になってしまいます。  
->   データはシーンに埋め込まれているためです。  
->   プレハブ化またはモデルとテクスチャを別ファイルに分けたい場合は、エクスポート機能を利用して別ファイルに書き出してください。
+> インポートされた都市モデルは、このままプレハブ化するとメッシュとテクスチャが missing になってしまいます。  
+> データはシーンに埋め込まれているためです。  
+> 「Assetsに保存」機能またはエクスポート機能を使ってテクスチャ等をファイルに書き出すことでプレハブ化できるようになります。
 
 配置されたゲームオブジェクト階層のトップには、コンポーネント`PLATEAUInstancedCityModel` がアタッチされます。  
 このインスペクタから緯度、経度などの情報を確認できます。  

Documentation~/manual/dynamicTile.md

@@ -0,0 +1,90 @@
+# 【試験的機能】動的タイル機能について
+
+
+## 概要
+広大な範囲を表示したいとき、描画負荷を抑えつつ表示できる機能です。  
+例えば、下図のように範囲選択画面で新宿区のすべての建物をインポートしたいとします。  
+
+![新宿区全域を範囲選択した例](../resources/manual/dynamicTile/areaSelectShinjukuAll.png)  
+
+通常のシーンへのインポートであれば、描画負荷が問題となり実用の難しさが課題でした。  
+そこで動的タイル機能を使えば、下図のとおりすべて表示できます。  
+ただしPCのスペックによります。  
+
+![動的タイルで新宿区の全建物を表示した例](../resources/manual/dynamicTile/dynamicTileShinjuku.png)
+
+## 描画負荷が軽減される仕組み
+本機能は次の処理からなります。
+- 3D都市モデルをタイル状に分けます。
+- Addressableの機能を使って3D都市モデルを出力します。  
+- 出力時、各タイルが最適化されます（後述）。
+- 読込時、カメラの距離に応じてタイルを読み込みます。
+
+### 都市のタイルの最適化手法
+本機能は試験的機能であり、今後も新たな最適化を追加していく予定です。
+- 【実装済】テクスチャサイズの変更
+  - 各タイルで利用されるテクスチャの大きさについて、縦と横でそれぞれ等倍のタイル、2分の1のタイル、そして4分の1にしたタイルを出力します。
+  - カメラに近いタイルは解像度の高いテクスチャ版を読み込み、遠いタイルは解像度の低いテクスチャ版を読み込みます。
+  - PLATEAUデータはテクスチャが大きい傾向にあるため、これにより描画負荷が減ります。
+- 【実装済】遠いタイルを消す
+  - カメラからかなり遠いタイルは読み込まず、シーンから消去します。
+- 【今後実装予定】タイルのサイズを変更する
+  - 各タイルの大きさについて、3次メッシュコードを基準とし、それを2×2に結合したサイズと2×2に分割したサイズを作ります。
+  - カメラから遠いタイルは結合した版を読み込むことで、オブジェクト数とディスク読込回数を減らします。
+- 【今後実装予定】ポリゴン数の低いLOD1の建物に、LOD2のテクスチャを投影することでポリゴン数を下げます。
+
+## 動的タイル形式でのインポート方法
+
+![動的タイルのインポート画面設定](../resources/manual/dynamicTile/tileImportConfig.png)  
+
+- インポートの設定画面で、インポート形式を`動的タイル（Addressable出力）`にします。
+- 出力先を指定します。プロジェクト外でも動作しますが、ビルドに含めたい場合はAssetsフォルダ内のお好みのフォルダを選びます。
+- 範囲選択など、他のインポート設定をしてインポートボタンを押します。
+  - インポート設定については[こちら(3D都市モデルのインポート)](./ImportCityModels.md)とおおむね同じです。
+  - ただし、モデル結合の粒度については地域単位に固定されます。
+- インポートおよびAddressableのビルドが行われ、完了すると3D都市モデルがタイル形式で読み込まれ表示されます。
+
+## 動的タイルの動作
+
+- シーンビューでは、タイルと視点の距離に応じたタイルが読み込まれます。
+- プレイ中は、タイルとメインカメラの距離に応じたタイルが読み込まれます。
+- タイルの管理は、シーンに配置された`DynamicTileManager`が行います。
+
+### 生成されるアセット
+- 出力先フォルダをAssetsフォルダ内に設定した場合
+  - 出力先にタイルのプレハブが生成されます。
+  - Assets/StreamingAssets/PLATEAUBundles/(出力先フォルダ名)にアセットバンドルがビルドされます。
+- 出力先フォルダをプロジェクト外に設定した場合
+  - 出力先にアセットバンドルがビルドされます。
+  - Assets/PLATEAUBundles/(出力フォルダ名)にプレハブが生成されます。
+    - プロジェクト外への出力のケースでプレハブ非依存にする機能は今後実装予定です。
+
+## DynamicTileManagerの操作
+![ズームレベルを表示した例](../resources/manual/dynamicTile/showZoomLevel.png)  
+
+シーンに配置された`DynamicTileManager`を選択すると、インスペクターから次の操作ができます。
+- `Addressableカタログパス(json)`の指定
+  - 参照ボタンからAddressableのカタログ(json)を指定することで、読み込む動的タイルのセットを変更できます。
+  - カタログファイルとはAddressableの仕様上、アセットバンドルのビルド時に生成されるものです。  
+    カタログの場所は上記「生成されるアセット」に記載のアセットバンドルのビルド先に生成されます。
+- `シーンビューで都市にフォーカス`ボタンを押すと、シーンビューの視点が都市を映す位置に移動します。
+- `SDKデバッグ用情報を表示`のチェックを入れると、インスペクタにデバッグ用の詳細情報が表示されます。詳しくは後述します。
+
+
+## デバッグ情報
+DynamicTileManagerのインスペクタから「SDKデバッグ用情報」にチェックを入れると次のボタンと情報がインスペクタに表示されます。
+- `Clear Tile Assets`: 読み込んだタイルをシーンから消去します。
+- `Clear Tile List`: 保持しているタイル情報を消去します。元に戻すには「参照」からカタログを指定します。
+- `Load Tile Scriptable Objects`: タイルの情報を読み直します。
+- `Show Tile Bounds`: 各タイルのBounds(範囲)を線で表示します。
+- `Show Zoom Level`: タイルのズームレベル（詳細度）を数字で表示します。
+  - ズームレベル11番: もっとも詳細で、テクスチャ解像度は等倍です。
+  - ズームレベル10番: 2番目に詳細で、テクスチャ解像度は縦と横が2分の1倍です。
+  - ズームレベル9番:  もっとも粗く、テクスチャ解像度は縦と横が4分の1倍です。
+- `Cancel Load Task`: ロードに異様に時間がかかっているタイルがある場合、進行中の読み込みを取り消します。
+- `Disable Realtime Load On Editor`: エディタでの視点位置に応じたタイルの読み込みを停止します。
+- `Update Assets On Camera Position`: カメラ位置に応じたタイルの読み込みをやり直します。
+- `Zoom Level & Load Distance`: 各ズームレベルがカメラからのどの距離で読み込まれるかを設定します。Load DistanceのXが最小距離、Yが最大距離です。
+- `各タイルの情報`: 各タイルのAddressableのアドレス、位置、ズームレベル、ゲームオブジェクト、カメラからの距離、読み込み状態が表示されます。
+- `Use Job System`: タイルとカメラの距離判定にJob Systemを利用します。
+- `Show Debug Log`: チェックを入れると詳細なログを表示します。

Documentation~/manual/toc.yml

@@ -6,6 +6,8 @@
     href: Installation.md
   - name: 3D都市モデルのインポート
     href: ImportCityModels.md
+  - name: 動的タイル機能について
+    href: dynamicTile.md
   - name: 3D都市モデルのエクスポート
     href: ExportCityModels.md
   - name: 3D都市モデルの調整