Class TerrainView

三維場景視圖

Example

let terrainView = new ov.TerrainView("canvas", {
    antialias: true,
    transparentBackground: false,
    showSun: true,
    showOuterSpaceBox: true,
    showAtmosphere: true,
    outputSelectMap: true,
    outputDepthMap: true,
    backgroundColor: new ov.Color("#FFFFFF"),
    webglImage: url
});
Copy

新增KML場景。

取得所有KML場景。

匯入KML。

移除指定KML場景。

所有 Widget

加入提示圖片。

Example

let figure = terrainView.addFigure({
    url: "images/common/logo.png",
    width: "300px",
    height: "100px",
    bottom: "10px",
    right: "10px"
});
Copy

加入提示文字。

Example

terrainView.addPromptText({
    text: "測試文字",
    font: "標楷體",
    size: 120,
    color: new ov.Color("#00FF00"),
    align: ov.TEXT_ALIGN.HORZ_CENTER | ov.TEXT_ALIGN.VERT_VCENTER
});
Copy

添加UI物件到圖台。

清除全部提示圖片。

See

addFigure

清除全部提示文字。

See

addPromptText

取得指定類別的Widget陣列。

Example

new ov.Widget.Timeline({terrainView: terrainView});
let timeline = terrainView.getWidgetByType(ov.Widget.Timeline); // [ov.Widget.Timeline]
Copy

從圖台移除UI物件。

新增VR空間下的自畫圖素，會隨著頭盔更新位置。

加入一個VR UI容器。

關閉VR。

校正ARHitTest平面於地表，需在初始化時有開啟HitTest。

建立一個VR UI容器。

建立一個VR UI標籤。

Returns VR

UI標籤。

取得AR的模型，需在初始化時有開啟HitTest。

取得AR/VR的空間資訊

取得AR/VR畫面viewport，VR為雙眼各占一半寬。

初始化AR，需在https或localhost下。 如果系統支援AR，按鈕會變得可按。 啟動選項參閱 XRSystem.requestSession

Example

var terrainView = new ov.TerrainView("canvas"));
    terrainView.initAR(button, function(){
        console.log("AR");
        //建議關閉外太空，大氣，清除色，避免蓋住相機畫面
     terrainview.enableOuterSpaceBox = false;
     terrainview.enableAtmosphere = false;
     terrainview.backgroundColor = new ov.Color("#00000000");
    },
    {
        requiredFeatures: ["hit-test"], //請求hitTest功能
        optionalFeatures: ["dom-overlay"], //請求dom套疊功能
        domOverlay: {
            root: document.getElementById("MyControl") //設定要套疊在AR上的dom
        }
    });
Copy

初始化VR，需在https或localhost下。 如果系統支援VR，按鈕會變得可按。

設定模型於ARHitTest平面上，需在初始化時有開啟HitTest。

設定VR手把板機鍵功能

AR/VR移動到指定的位置。

AR/VR移動事件監聽器，使用手把傳送或 setXRPosition 會觸發。

AR/VR移動到指定的方向

AR/VR螢幕座標轉地圖座標。

圖台畫布

加入事件監聽器

Example

let result = terrainView.addEventListener("CameraPosChanged", myCallback);
Copy

關閉場景視圖，並釋放所有圖層。

Example

terrainView.close();
Copy

取得渲染環境的狀態。

地形場景是否開啟成功。

Example

let result = terrainView.isOpen();
Copy

移除事件監聽器。

Example

let result = terrainView.removeEventListener("InputCompleted", myCallback);
Copy

設定程式碼所在路徑。

Example

terrainView.setPath("../webgl/");
Copy

設定圖素選取模式，預設為 SELECT_TYPE.SELECT_REPLACE，如需點選多個圖素可設置為 SELECT_TYPE.SELECT_ADD

按住 Ctrl 亦可以觸發多選模式

所有圖層

加入自畫圖層。

Example

const customLayer = terrainView.addCustomLayer({
    layername: "custom"
});
Copy

加入模型圖層。

Example

const param = {
    url: "http://127.0.0.1:8080",
    identifier: "mesh",
    callback: (success, layer) => {
        if (success) {
            console.log(layer.name);
        }
    }
};
terrainView.addModelLayer(param);
Copy

加入模型集圖層。

Example

const param = {
    url: "http://127.0.0.1:8080",
    identifier: "modelSet",
    callback: (success, layer) => {
        if (success) {
            console.log(layer.name);
        }
    }
};
terrainView.addModelSetLayer(param);
Copy

加入OGC 3D Tiles圖層。

Example

let param = {
        url: "TilesetWithDiscreteLOD/tileset.json",
        callback: (success, layer) => {
            if (success) {
                console.log(layer.name);
            }
        };
};
terrainView.addOGC3DTilesLayer(param);
Copy

加入OGC I3S圖層。

Example

var param = {};
param.url = "https://tiles.arcgis.com/tiles/V6ZHFr6zdgNZuVG0/arcgis/rest/services/Buildings_NYC_BKG/SceneServer/layers/0";
param.callback = function(success, layer){if(success){console.log(layer.name);}};
terrainView.addOGCI3SLayer(param);
Copy

加入傾斜攝影模型圖層。

Example

let param = {
    url: "http://127.0.0.1:8080",
    identifier: "PhotogrammetryModel",
    callback: (success, layer) => {
        if (success) {
            console.log(layer.name);
        }
    }
};
terrainView.addPhotogrammetryModelLayer(param);
Copy

加入管線圖層。

Example

var param = {};
param.url = "http://127.0.0.1:8080";
param.identifier = "pipeline";
param.callback = function(success, layer){if(success){console.log(layer.name);}};
terrainView.addPipelineLayer(param);
Copy

加入點雲圖層。

Example

const param = {
    url: "http://127.0.0.1:8080",
    identifier: "pointCloud",
    callback: (success, layer) => {
        if (success) {
            console.log(layer.name);
        }
    }
};
terrainView.addPointCloudLayer(param);
Copy

加入監視器圖層。

加入S3雲端傾斜攝影模型圖層。

Example

let param = {
    url: "http://example.com/bucketroot/",
    callback: (success, layer) => {
        if (success) {
            console.log(layer);
        }
    }
};
terrainView.addPhotogrammetryModelLayer(param);
Copy

加入向量圖層。

Example

const param = {
    url: "http://127.0.0.1:8080",
    identifier: "vector",
    callback: (success, layer) => {
        if (success) {
            console.log(layer.name);
        }
    }
};
terrainView.addVectorLayer(param);
Copy

以圖層名稱取回圖層。

取得開啟中的圖層。

Example

let layers = terrainView.getLayers();
Copy

移除圖層。

恢復地形檔的WMTS影像。

設定地形檔的WMTS影像。

清除所有被選取的圖素。

取得所有被選取的圖素。

使用 File 新增Mesh， CFileMesh 不用時需自行呼叫 CFileMesh.Release。

在指定的圖層物件上選取或清除選取指定的圖素。

取得地形的作畫設定。 同 getDrawTerrainSetting。

設定地形的作畫設定。 同 setDrawTerrainSetting。

是否為球體

取得地形圖層名稱

球體的 EPSG

地形不透明度 (預設1.0，介於 0~1.0)

地形不透明度 (預設1.0，介於 0~1.0)

地形的原始 EPSG

地形可以被HitTest的最小不透明度閾值 (預設0.9，介於0 ~ 1.0)，若地形不透明度低於此值，則引擎允許點擊地形下的三角面。

地形可以被HitTest的最小不透明度閾值 (預設0.9，介於0 ~ 1.0)，若地形不透明度低於此值，則引擎允許點擊地形下的三角面。

地形圖層連結

新增一個固定地形節點Level的範圍。

取得指定EPSG位置地表的精確高度。

批次取得指定EPSG位置地表的精確高度。

取得地形的作畫設定。

取得指定位置地表當前LOD(Level of Detail)的高度。

取得攝影機離當前地面幾何的高度差。

取得地形節點載入的狀態百分比。

開啟地形場景。

Example

let param = {
    url: "http://127.0.0.1:8080",
    identifier: "terrainLayerName",
    callback: (layer, success) => {
        if(success) {
            console.log(layer.name);
        }
    }
};
terrainView.openTerrain(param);
Copy

重新載入同伺服器的另一個地形場景。

Example

terrainView.reloadTerrain("terrain", function(success){console.log(success);});
Copy

清除所有固定地形節點Level的範圍。

設定地形的作畫設定。

Example

terrainView.setDrawTerrainSetting({
    contourSetting: { isopen: true },
    aspectColorSetting: { isopen: true },
    baseColor: new ov.Color("#FFFFFF"),
    cullingSurface: true,
    surface: true,
    vertexWireframeWithBaseOverlay: true,
    wireframeColor: ov.Color("#FFFFFF"),
    emptyTileImage: "img.png"
});
Copy

設定地形開始淡出淡出參數。

是否顯示地形的包圍盒。

Example

terrainView.showTerrainBoundingVolume(true);  //顯示包圍盒
terrainView.showTerrainBoundingVolume(false); //關閉顯示包圍盒
Copy

將指定螢幕座標轉換成對應的地形位置。

將指定的世界座標轉換至螢幕座標。

背景顏色

背景顏色

雲的特性。

雲的特性。

是否畫天空大氣，預設為開

是否畫天空大氣，預設為開

大氣的開關

大氣的開關

是否畫雲，預設為關。

是否畫雲，預設為關。

光線的開關

光線的開關

外太空的開關

外太空的開關

是否畫海洋，預設為關

是否畫海洋，預設為關

陰影的開關

陰影的開關

是否畫太陽貼圖，預設為開

是否畫太陽貼圖，預設為開

是否開啟體積光散射，預設為關

是否開啟體積光散射，預設為關

光線的特性

光線的特性

設定海平面高度。

設定海渲染品質，預設為normal。

刪除所有indexedDB快取

刪除比指定時間舊的indexedDB快取

是否顯示控制面板

凍結鍵盤控制

凍結鍵盤控制

凍結滑鼠控制(只能用控制攝影機的方式處理) *

凍結滑鼠控制(只能用控制攝影機的方式處理)

凍結使用者輸入控制對Viewport的控制(凍結滑鼠與鍵盤)

凍結使用者輸入控制對Viewport的控制(凍結滑鼠與鍵盤) *

設定是否能以鍵盤、滑鼠或觸控操作圖台。

設定控制面板的參數。

Example

terrainView.panelSetting({
    color: new ov.Color("#00E8E8"),
    offset: new GeoPoint(10, 10),
    posType: POS_TYPE.LT
});
Copy

取得目前攝影機姿態

攝影機投影模式

攝影機投影模式

攝影機的方位角開始旋轉。

攝影機開始水平的移動。

攝影機的俯仰角開始旋轉。

攝影機開始縮放。

停止攝影機。

轉動攝影機面向指定方位。

鎖住螢幕中心轉動攝影機面向指定方位。

取得圖台水平視野角度(Fov)。

移動到設定的攝影機位置。

Example

let pos = new GeoPoint(120.3, 22.5, 100);
let v = new Geo3DPoint(0, 0, -1);
let up = new Geo3DPoint(0, 1, 0);
let camera = new ov.Camera(pos, v, up);
terrainView.gotoCamera(camera, true);
Copy