1. 概述
適用場景：安裝了「FVS企業戰情室編輯模式」插件的使用者，可參考本文了解 FVS 範本的相關功能。
1.1 版本
| 報表伺服器版本 | 插件版本 | 功能變動 |
|---|---|---|
| 11.0 | V1.x | V1.x 版本文檔請參考 三維城市組件歷史版本 |
| 11.0.16 | V2.0.0 |
|
| 11.0.22 | V2.5.0 | 「場景>環境」開放霧效果的開啟或關閉配置項 |
| 11.0.22 | V3.2.0 |
詳情參見第 4 章 |
1.2 應用場景
三維城市組件是一種基於 WebGL 技術實現的三維引擎，可以讓我們在瀏覽器端輕鬆的構建三維場景。
當使用者上傳 geojson 檔案後，三維城市會自動識別解析 geojson 檔案中的地理特徵元素（目前支援的特徵元素有: 建築,、草地、 河流以及道路），然後根據特徵的經緯度點資訊着手構建網格模型，並附着預設風格材質，最後再渲染出來，實現快速構建三維數位化城市。
注：geojson 相關知識和獲取方式，請參見：獲取三維城市所需geojson檔案的操作步驟 。
注：不支援行動端。
1.3 操作步驟
本文將為大家介紹 FVS 三維城市組件的場景匯入、屬性編輯、視角轉換等操作。
三維城市示意模型的搭建，建議操作步驟如下表所示：
序號 | 步驟 | 簡介 |
1 | 範本準備 | 建立企業戰情室範本，建立頁面，新增【三維城市】組件，編輯組件。 |
2 | 建立場景 | 生成新場景/匯入已有場景。 |
3 | 場景管理 | 配置三維場景的風格、環境特效、視角旋轉等。 |
4 | 模型管理 | 配置模型的名稱、隱藏、風格、配色等。 |
5 | 資料管理 | 新增資料集，配置資料圖層，讓資料和模型相結合。 |
6 | 視角調整 | 調整最終預覽視角效果。 |
另外本文提供一個範例 geojson 檔案，僅供使用者試用，請勿用於實際生產，請下載後解壓使用：範例地區.zip
2. 建立組件
點選設計器「檔案>建立視覺化看板」，建立一張空白看板。如下圖所示：
點選組件區「3D>三維城市場景」，即可將其新增到畫布中，點選「編輯組件」，進入三維城市場景編輯頁面。如下圖所示：
3. 場景管理
3.1 建立場景
若首次編輯該三維城市組件，則需要先建立場景，介面提示「當前沒有場景，請先建立場景，再進行配置」。如下圖所示：
點選「建立場景」彈出設定框，建立場景有兩種方式：生成新場景，匯入已有場景。
3.1.1 生成新場景
生成新場景，需要使用者在本地先準備好三維城市的 geojson 檔案。
注：geojson 相關知識和獲取方式請參見：獲取三維城市所需geojson檔案的操作步驟 ，自訂轉列3D城市或園區。
點選「選擇資料」，選擇準備好的 geojson 檔案，上傳成功後即可生成場景。
FVS 提供兩種建築風格：科技風格和簡約風格。
geojson 檔案大小及資料檢查機制：
1）上傳 geojson 檔案時，首先判斷是否為可編譯 Json 檔案。
若是，則繼續上傳；若不是，則提示「geojson檔案無法編譯」，需重新選擇檔案上傳。
2）若上傳的檔案超過 500M 時，提示檔案過大是否繼續生成。
點選「取消」，則取消上傳資料；點選「繼續生成」，則繼續上傳資料。
3）上傳資料成功後，點選「生成場景」，進行資料檢查。
資料檢查若均不合規，則無法生成場景，需重新上傳檔案；若僅部分不合規，則可選擇是否使用合規部分資料繼續生成場景。
注：geojson 屬性標準定義請參見文檔 三維城市geojson檔案說明 。
3.1.2 匯入已有場景
三維城市場景可匯出使用，詳情可參見 3.2 節。若使用者獲得了匯出的三維城市場景檔案，可選擇「匯入已有場景」直接匯入。如下圖所示：
3.2 匯出場景
在三維城市場景編輯介面，使用者可匯出當前場景。
匯出場景時，會包括場景 geojson、右側「場景」配置和「模型」配置，生成 .fcity 檔案。
匯出的檔案可參考上文 3.1.2 節，在其他三維城市場景組件中選擇「匯入已有場景」使用。
3.3 更換場景資料
在三維城市編輯介面，點選「場景>更換場景資料」，選擇本地準備好的 geojson 檔案，即可更換已有場景。
更換場景時，同樣遵循 3.1.1 節所述的 檔案大小及資料檢查機制 。
場景資料的更換，不影響配置好的場景屬性，不影響上傳的自訂模型。
3.4 設定場景屬性
新增場景後，可對場景的屬性進行配置，如下圖所示。
| 設定項 | 說明 | |
|---|---|---|
| 整體風格 | 整體風格包括兩種風格：科技風格和簡約風格 更改整體風格將會改寫所有已配置的樣式設定 | |
| 環境 | 地面 | 地面背景： 地面背景包括「GIS底圖」和「單色」 1）GIS底圖，可以看到城市的道路名稱、植被、水文等效果，可選擇內建五套色系，或輸入 自訂TileLayer 的 URL 2）單色，不顯示城市的道路名稱等效果，可顯示模型列表中有的建築、街道和水系草地。可任意選擇一種顏色作為底色 |
建築高度： 為了凸顯或淡化建築的視覺效果，FVS三維城市支援修改地圖的建築高度 geojson 中建築的原始高度作為100%，支援調節的高度範圍為 10%~200% 此處調節的是該三維城市組件中的所有建築，包括無名建築 | ||
| 霧 | 預設開啟霧，支援關閉霧。暫不支援配置更多效果 | |
| 粒子 | 若勾選「開啟粒子特效」，城市空中會有類似雪花飛舞的效果出現 | |
| 衝擊波 | 為了突出顯示某個區域，可設定衝擊波，將區域設定為衝擊波的中心點 支援新增、修改、刪除、隱藏衝擊波 支援設定衝擊波的名稱、座標、輻射範圍、衝擊波速度、衝擊波顏色等屬性 最多支援新增 10 個衝擊波 | |
| 飛昇線條 | 若勾選「開啟飛昇線條」，會不斷的有光柱從地面飛昇至空中 | |
| 相機 | 視角 | 支援設定場景視角基礎屬性：縮放設定、垂直角度 支援開啟景深、視角變化；支援新增相機視角 詳情請參見文檔：三維場景相機視角 |
| 漫遊路徑 | 支援新增漫遊路徑，設定漫遊路徑動畫。詳情請參見文檔：三維場景漫遊路徑動畫 | |
| 影像 | 抗鋸齒 | 為了提高三維畫面品質，支援開啟 MSAA 和 FXAA 抗鋸齒方案，支援同時開啟 1）MSAA：多重取樣抗鋸齒，可以簡單理解為只對多邊形的邊緣進行抗鋸齒處理 2）FXAA：快速近似抗鋸齒，是傳統 MSAA 效應的高效能近似值，適用於效能較低的計算機配置。其原理大概是將影像柔化，所以會使得畫面看起來有一些模糊 |
| 泛光 | 若勾選「開啟泛光」，會產生從影像明亮區域邊框向外延伸的光線條紋，達到泛光效果 可設定泛光的強度、臨界值和模糊度 | |
| 發光 | 若勾選「開啟發光」，具有發光效果材質的模型會透過模糊疊加的方式達到發光效果 可設定發光的強度和半徑 注：發光也會對線框和溶蝕生效 | |
| 飽和度 | 支援設定場景整體色彩的純度，飽和度越高色彩越純，低則逐漸變灰 調整區間為 -100~100，預設為 0 | |
| 亮度 | 支援設定場景整體的亮度，調整區間為 -100~100，預設為 0 | |
| 對比度 | 支援設定場景中明暗的對比度，調整區間為 -100~100，預設為 0 | |
4. 模型配置與管理
配置欄切換到模型 Tab ，在模型列表中展示的是 geojson 中已命名的建築、街道、草地/水系名稱，geojson 中未命名的一律合併為其他建築、其他街道、草地、水系。
同時支援在三維城市場景中「新增自訂模型」，上傳及使用方法與 三維自訂場景 組件一致，這裏不多贅述。
支援從列表中選中模型，也支援直接在場景中選中模型，列表中被選中的模型高亮。點選非模型外的區域或點選「取消選中」即可取消。
注：場景中由 geojson 直接生成的草地/水系、衝擊波、粒子特效、飛昇線條以及被隱藏的模型不支援點選選中。
如下圖所示：
選中模型後，在模型列表支援以下操作：
1）支援對模型進行隱藏、刪除、重新命名。注：模型刪除之後無法廢除，請謹慎操作。
V2.1.1 及之後版本，還支援在場景中按滑鼠右鍵或使用快捷鍵 delete 刪除選中模型。（複製、貼上僅對自訂模型生效）
2）支援修改建築頂面、立面風格，支援應用到所有建築。
3）支援修改街道風格，支援應用到所有街道。
4）支援修改草地、水系的風格和顏色。
5. 資料圖層
三維城市場景組件中支援新增四種資料圖層：點、柱體、線、模型。各圖層配置資料標籤效果如下圖所示：
新增資料圖層並綁定資料後，支援為圖層新增「資料更新後」和「按滑鼠左鍵」事件，實現模型資料展示、聯動交互等效果。
功能詳細介紹請參見文檔：三維場景組件資料圖層 。
6. 工具欄
V2.2.0 版本工具欄優化，固定在場景頂部顯示。工具欄具體介紹如下表所示：
| 設定項 | 說明 |
|---|---|
| 點選傳回視覺化看板畫布介面 |
| 開啟流暢渲染後，可提升場景編輯效能。詳情請參見：三維場景流暢渲染模式 |
| 一鍵查看場景頂檢視表、主檢視表、側檢視表 |
| 選中模型後，點選可取消選中 |
| 「廢除」和「還原」操作，僅對自訂模型的行動、旋轉和縮放操作生效 |
| 場景視角調整的操作說明，以及僅對自訂模型生效的「自訂模型位置調整」和「模型多選」操作說明 |
7. 範本下載
已完成範本請參見：FVS三維城市組件範例.fvs。
本文提供一個範例 geojson 檔案，僅供使用者試用，請勿用於實際生產。請下載後解壓使用：範例地區.zip。
