刘勇虎的官方网站

目录

• 创建CallbackProperty
• 应用于Entity
• 注意事项
• cesium 哪些属性 不能使用 callback

在Cesium中，CallbackProperty是一种特殊类型的属性，它允许你提供一个回调函数来动态计算或获取某个值。这对于那些依赖于时间、用户输入或其他动态条件的属性非常有用。每次访问这样的属性时，都会调用回调函数来获取最新的值。

创建CallbackProperty

const timeCallback = new Cesium.CallbackProperty(function() {
    // 此函数会在每次访问属性时被调用
    const currentTime = Cesium.JulianDate.now();
    return Cesium.Color.fromRandom({alpha: 1.0}); // 返回一个随机颜色作为示例
}, false); // 第二个参数为true表示该回调是持续性的，即每次场景更新都会调用；默认为false，仅在属性被访问时调用

应用于Entity

你可以将CallbackProperty应用于Entity的任何支持动态属性的地方，例如颜色、位置等。

const entity = viewer.entities.add({
    position: Cesium.Cartesian3.fromDegrees(-100.0, 40.0),
    point: {
        pixelSize: 10,
        color: timeCallback, // 使用CallbackProperty作为颜色属性
    },
});

在这个例子中，点实体的颜色将会随着每次访问或场景更新（如果标记为持续性回调）而变化，展示为随机颜色。

注意事项

• 回调函数应该快速执行，避免阻塞渲染循环。
• 如果回调涉及到复杂计算或资源访问，考虑缓存结果以提高效率。
• 使用持续性回调(new CallbackProperty(callback, true))时，确保考虑到性能影响，因为它会在每次场景渲染时被调用。

CallbackProperty提供了一种强大的机制来实现动态场景内容，是处理实时数据、动画效果或交互式应用的重要工具。

cesium 哪些属性 不能使用 callback

在Cesium中，尽管很多属性支持使用CallbackProperty来实现动态数据绑定，但并非所有属性都支持这种用法。CallbackProperty主要用于那些理论上可以随时间或条件动态变化的属性，以便于实时更新场景中的元素。以下是一些典型的不支持或不适合使用CallbackProperty的属性类型或场景：

1. 静态属性：直接描述对象静态特征的属性，如PointGraphics的pixelSize（像素大小），通常不需要动态更新，因此不支持CallbackProperty。

2. 颜色属性的特殊情况：如前所述，虽然大部分图形属性支持CallbackProperty，但标准的Color属性（如PointGraphics.color）直接设置时不支持CallbackProperty。需要动态颜色时，可以通过材质（如CustomShader或ColorMaterialProperty中的颜色回调）间接实现。

3. 几何属性：如PolygonGraphics.positions、CorridorGraphics.positions等定义几何形状的属性，通常期望是静态的几何数据，不支持动态回调。

4. 纹理图像路径：如ImageMaterialProperty.image或GridMaterialProperty.image等，这些属性指向外部资源的路径，通常在初始化时设定，不支持动态更改。

5. 部分内部处理属性：某些内部处理或计算属性，如BoundingSphere相关属性，这些是为了优化渲染性能而内部维护的，不对外公开修改接口，自然也不支持CallbackProperty。

6. 材质属性的直接颜色：当直接指定材质的color属性时，不支持CallbackProperty，但可以通过定义材质的uniforms中的颜色值来间接实现动态变化。

总之，当属性的设计意图是静态配置或直接关联到不可动态变化的数据时，通常不支持CallbackProperty。若需实现动态效果，应查找是否有支持动态更新的替代属性或方法，如通过材质和自定义着色器等。在使用时，最好查阅Cesium的官方文档，以确认具体属性是否支持CallbackProperty。