何でこんなことやろうと思ったか

自分でDTMしたMVで夜景の街並みを使いたい
- 国交省が公開しているOpenDataで、日本国の地図データを配布している
- それをゲームなどに応用出来る様にUnityやUnreal Engine向けのSDKも配布している
- Plateau SDKはCityGMLを読み込んで動的にメッシュを生成する
- 生成されたメッシュに動的にテクスチャを張り付ける
- Shader Graphでマテリアルを微調整している
SDKが動的に行っている動作に対して、様々なアプローチでオブジェクトの外観を変える事が出来る
- メッシュのみ流用（スクリプトでテクスチャとマテリアルを全部剥がして再生成）
- テクスチャのみそっくり差し替えてアニメ調にする→Shador Graghを弄って雰囲気を出す

などなどいろいろあるので、SDKの動きを実際に見ながら一番効率的なアプローチを考えたかった。

SDKはここ（Unity用）
https://project-plateau.github.io/PLATEAU-SDK-for-Unity/

PLATEAU SDK：GML → Unityの流れ（全体像）

SDKがCity GMLを読んで、マテリアルを生成するまでの流れを読んでみた

CityGML (XML/JSON)  
   ↓  
CityGml.Load()                        ← GMLファイルをパース  
   ↓  
CityModel                             ← 全建物・地物の親コンテナ  
 ├── RootCityObjects[]               ← 建物などのトップレベルCityObject  
 └── GetCityObjectsByType()         ← COT_Building 等でフィルタ  
        ↓  
   CityObject                         ← 建物/道路/橋などの個別オブジェクト  
    ├── Geometries[]                ← 面・体の3D形状  
    ├── Appearances[]              ← テクスチャ・マテリアル情報  
    └── Attributes[]               ← 属性（用途/高さ/住所など）
        ↓  
   Geometry                          ← 建物の形状構造  
    ├── Polygons[]                 ← 面（屋根/壁など）  
    └── TextureTargetDefinitions[]← ポリゴンとテクスチャの対応づけ情報
        ↓  
   TextureTargetDefinition           ← 面と画像（Texture）の対応  
    ├── TargetID                   ← ポリゴンID  
    └── Appearance (Texture)      ← テクスチャ画像とUV情報
        ↓  
   Texture                            ← UnityのTexture2D相当  
    ├── URL                         ← Assets内のファイルパス  
    └── TextureCoordinates         ← UV情報
        ↓  
   UnityEngine:  
   Mesh + UV + Material + Texture2D を生成し、ビルオブジェクトとして配置

各クラスの役割（ざっくり一覧）

クラス名	役割
CityGml.cs	GMLファイルのエントリポイント。全体読み込み
CityModel.cs	全体をまとめる親コンテナ（複数のCityObjectを持つ）
CityObject.cs	1つの建物や地物など。GeometryやAppearance、属性を保持
Geometry.cs	ポリゴンやUV情報を持つ形状構造
Polygon.cs	1つの面（壁や屋根など）を表す
LinearRing.cs	ポリゴンの辺を構成する頂点座標群
Appearance.cs	テクスチャ/マテリアル（≒MaterialSet）情報
AppearanceTarget.cs	ポリゴンとAppearanceの関係づけ（1対多）
TextureTargetDefinition.cs	ポリゴンとTextureのマッピング
TextureCoordinates.cs	各頂点に対するUV座標を保持
Texture.cs	実際の画像（BaseColor / Emission など）
Material.cs	Unity的なマテリアル構成（Shaderへの情報）
MaterialTargetDefinition.cs	Materialと面の対応（= UnityのMaterial割当）
Object.cs	全てのCityObject・FeatureObjectの共通親
FeatureObject.cs	Addressや建物属性などの情報ブロック
Address.cs	建物の住所情報
NativeAttributesMap.cs	GMLの属性名/型のマッピング管理
NativeAttributeValue.cs	属性の型と値を表すユニット
CitygmlParserParams.cs	GML読み込み時のオプション設定

処理フロー（超ざっくり）

1.CityGMLファイルを読み込む
・CityGml.Load() がエントリポイント
・Scriptの中でネイティブDLLに渡してパースされる（高速）
↓
2.CityModel（全体構造）を作成
・すべての地物（CityObject）を保持する親
↓
3.CityObject（建物など）を1つずつ処理
・GML内の属性（高さ・用途・住所）もこの時点で取得
・cityObjectType == COT_Building で建物だけ抽出可
↓
4.各オブジェクトに対応する形状（Geometry）とマテリアル（Appearance）を構成
・面単位でポリゴンを生成
・TextureTargetDefinition 経由でテクスチャを取得
・MaterialTargetDefinition でマテリアルを適用
↓
5.UV座標（TextureCoordinates）と一緒にMesh生成
・頂点に Vector2(U, V) を付与
・テクスチャが正しく貼られる
↓
6.Unity上にGameObjectとして建物が出現
・メッシュ＋マテリアル＋テクスチャを持つ
・ShaderGraph のスロット名（例：_SideMainTexture）にテクスチャが自動でバインドされる

以下蛇足

PLATEAU SDKは結局CityGMLを読み込んで何をやっているのか

建物メッシュの生成
UV展開
テクスチャの読み込みとマッピング
ShaderGraphへの割当
GML属性データの構造化

メッシュのみ再利用してみた時の画像例

Plateau SDKでCityGMLを読み込んだ時の画像

マテリアルやテクスチャを全部剥がしてピンク色にしてみた