Cesium开发：鼠标交互事件的注意事项

声明：该文章转自 vtxf大神的笔记

在这仅作后期资料归纳整理用

此处插入完美分割线

---

 

Cesium拾取的方法有多个，使用时，经常发现结果不准确，这里测试scene.pickPosition和globe.pick的适用场景。

使用场景

1. 地形的使用 默认地形(EllipsoidTerrainProvider) 或者Cesium全球地形(Cesium World Terrain)
2. 地形深度测试 开启或者关闭 viewer.scene.globe.depthTestAgainstTerrain = true/false;

测试结果

注意：以下测试结果中， Alt 是scene.pickPosition的结果， Alt2 是globe.pick的结果。

地形深度开启&默认地形

相机距离底面较近时，Alt和Alt2的结果基本相同。如下图所示：

但是相机高度较大时，scene.pickPosition忽大忽小；globe.pick结果相对稳定。

地形深度开启&Cesium全球地形

不论相机距离地面的远近，两者结果基本都准确。

 

 

地形深度关闭&默认地形

scene.pickPosition结果不准。 

globe.pick基本为0，符合预期。

地形深度关闭&默认地形

相机据地面较远时，scene.pickPosition误差很大；
相机据地面较近时，scene.pickPosition误差较小，但是为负值，显然不对。
scene.pickPosition结果不准。
globe.pick结果稳定。

 

 

结论

综上试验结论：
1. globe.pick的结果相对稳定准确，不论地形深度检测开启与否，不论加载的是默认地形还是别的地形数据；
2. scene.pickPosition只有在开启地形深度检测，且不使用默认地形时是准确的。
注意点：
1. globe.pick只能求交地形； 2. scene.pickPosition不仅可以求交地形，还可以求交除地形以外其他所有写深度的物体。
所以使用时可以二者结合来使用。

附录（测试代码）

var viewer = new Cesium.Viewer('cesiumContainer', {
    selectionIndicator : false,
    infoBox : false,
    // 注释时相当于使用默认地形，解开注释相当于使用全球地形
    //terrainProvider: Cesium.createWorldTerrain()
});

// 深度开启或关闭
viewer.scene.globe.depthTestAgainstTerrain = true; 

var scene = viewer.scene;
if (!scene.pickPositionSupported) {
    console.log('This browser does not support pickPosition.');
}

var handler;

Sandcastle.addToolbarButton('Pick position', function() {
    var modelEntity = viewer.entities.add({
        name : 'milktruck',
        position : Cesium.Cartesian3.fromDegrees(-123.0744619, 44.0503706),
        model : {
            uri : '../../SampleData/models/CesiumMilkTruck/CesiumMilkTruck-kmc.gltf'
        }
    });
    viewer.zoomTo(modelEntity);

    var labelEntity = viewer.entities.add({
        label : {
            show : false,
            showBackground : true,
            font : '14px monospace',
            horizontalOrigin : Cesium.HorizontalOrigin.LEFT,
            verticalOrigin : Cesium.VerticalOrigin.TOP,
            pixelOffset : new Cesium.Cartesian2(15, 0)
        }
    });

    var tempRay = new Cesium.Ray();
    var tempPos = new Cesium.Cartesian3();

    // Mouse over the globe to see the cartographic position
    handler = new Cesium.ScreenSpaceEventHandler(scene.canvas);
    handler.setInputAction(function(movement) {

        var foundPosition = false;

        var scene = viewer.scene;
        if (scene.mode !== Cesium.SceneMode.MORPHING) {
            //var pickedObject = scene.pick(movement.endPosition);
            if (true) {
                labelEntity.label.text = '';

                var cartesian = viewer.scene.pickPosition(movement.endPosition);

                if (Cesium.defined(cartesian)) {
                    var cartographic = Cesium.Cartographic.fromCartesian(cartesian);
                    var longitudeString = Cesium.Math.toDegrees(cartographic.longitude).toFixed(2);
                    var latitudeString = Cesium.Math.toDegrees(cartographic.latitude).toFixed(2);
                    var heightString = cartographic.height.toFixed(2);

                    labelEntity.label.text +=
                        'Lon: ' + ('   ' + longitudeString).slice(-7) + '\u00B0' +
                        '\nLat: ' + ('   ' + latitudeString).slice(-7) + '\u00B0' +
                        '\nAlt: ' + ('   ' + heightString).slice(-7) + 'm';        
                }

                var ray = scene.camera.getPickRay(movement.endPosition, tempRay);
                var cartesian2 = scene.globe.pick(ray, scene, tempPos);

                if (Cesium.defined(cartesian2)) {
                    var cartographic2 = Cesium.Cartographic.fromCartesian(cartesian2);
                    var longitudeString2 = Cesium.Math.toDegrees(cartographic2.longitude).toFixed(2);
                    var latitudeString2 = Cesium.Math.toDegrees(cartographic2.latitude).toFixed(2);
                    var heightString2 = cartographic2.height.toFixed(2);

                    labelEntity.label.text += 
                        '\nLon2: ' + ('   ' + longitudeString2).slice(-7) + '\u00B0' +
                        '\nLat2: ' + ('   ' + latitudeString2).slice(-7) + '\u00B0' +
                        '\nAlt2: ' + ('   ' + heightString2).slice(-7) + 'm';           
                }

                if (cartesian || cartesian2) {
                    labelEntity.position = cartesian || cartesian2;
                    labelEntity.label.show = true;  

                    labelEntity.label.eyeOffset = new Cesium.Cartesian3(0.0, 0.0, 0);
                    labelEntity.label.disableDepthTestDistance  = Number.POSITIVE_INFINITY;

                    foundPosition = true;            
                }
            }
        }

        if (!foundPosition) {
            labelEntity.label.show = false;
        }
    }, Cesium.ScreenSpaceEventType.MOUSE_MOVE);
});

Sandcastle.reset = function() {
    viewer.entities.removeAll();
    handler = handler && handler.destroy();
};