Lighting

属性概览

属性详情

date Date

模拟太阳的当前日期和时间。设置日期时，指定时区很重要，否则会使用浏览器的时区。 这可能会导致不同时区的用户使用不同的照明。

默认值:null

declaredClass Stringreadonly inherited

起始版本：GeoScene API for JavaScript 4.7

类的名称。声明的类名格式为 geoscene.folder.className。

directShadowsEnabled Boolean

指示是否显示太阳投射的阴影。阴影仅针对真实世界的 3D 对象显示。地形不会投射阴影。在小缩放级别的局部场景中，不显示阴影。要更好地控制哪些 3D 对象投射阴影，请使用 ObjectSymbol3DLayer、FillSymbol3DLayer、ExtrudeSymbol3DLayer 和 PathSymbol3DLayer 上可用的 castShadows 属性。

默认值:false

displayUTCOffset Number

应在 UI 中显示以表示日期的 UTC 时区偏移量（以小时为单位）。该值对场景的实际照明没有影响。

默认值:null

方法概览

方法详情

clone(){Lighting}

创建此对象的深拷贝。

返回：

类型	说明
Lighting	创建调用此方法的实例的新拷贝。

isFulfilled(){Boolean}

isFulfilled() 可用于验证创建类的实例是否已完成（已解决或已拒绝）。如果满足，则返回 true。

返回：

类型	说明
Boolean	指示创建类的实例是否已完成（已解决或已拒绝）。

isRejected(){Boolean}

isRejected() 可用于验证创建类的实例是否被拒绝。如果被拒绝，则返回 true。

返回：

类型	说明
Boolean	指示创建类的实例是否已被拒绝。

isResolved(){Boolean}

isResolved() 可用于验证创建类的实例是否已解决。如果已解决，将返回 true。

返回：

类型	说明
Boolean	指示创建类的实例是否已解决。

when(callback, errback){Promise}

起始版本：GeoScene API for JavaScript 4.6

when() 一旦创建了类的实例，就可以利用它。这个方法有两个输入参数：一个 callback 函数和一个 errback 函数。callback 在类的实例加载时执行。如果类的实例无法加载，则执行 errback。

参数：

callback Function 可选 当 promise 解决时调用的函数。

errback Function 可选 当 promise 失败时执行的函数。

返回：

类型	说明
Promise	返回 callback 结果的新承诺，可用于链接其他函数。

示例：

// Although this example uses MapView, any class instance that is a promise may use when() in the same way
let view = new MapView();
view.when(function(){
  // This function will execute once the promise is resolved
}, function(error){
  // This function will execute if the promise is rejected due to an error
});