SunLighting

AMD: require(["geoscene/views/3d/environment/SunLighting"], (SunLighting) => { /* 代码 */ });
ESM: import SunLighting from "@geoscene/core/views/3d/environment/SunLighting";
类: geoscene/views/3d/environment/SunLighting
继承: SunLighting Lighting Accessor
起始版本: GeoScene API for JavaScript 4.23

SunLighting 类允许您将场景中的照明更改为阳光。 灯光的位置设置为太阳的位置。

scene-lightings

例子:

let view = new SceneView({
  container: "viewDiv",

  map: new Map({
    basemap: "geoscene-community",
    ground: "world-elevation"
  }),
  environment: {
    lighting: {
      type: "sun"    // 转换成 new SunLighting()
    }
  }
});

只要 type 属性更改,照明可视化就会更新:

view.environment.lighting = {
   type: "sun",
   directShadowsEnabled: true    // 转换成 new SunLighting({ directShadowsEnabled: true })
}

构造函数

new SunLighting(properties)
参数:
properties Object
optional

有关可能传递给构造函数的所有属性的列表,请参见属性

属性概述

可以设置任何属性,检索或收听。请参见使用属性主题。
展示继承属性 隐藏继承的属性
名称 类型 总结
Boolean更多信息

表示是否显示环境光遮蔽着色。

更多信息SunLighting
Boolean更多信息

表示模拟太阳的日期和时间是否自动更新以在相机更改时保持当前时间。

更多信息SunLighting
Date更多信息

模拟太阳的当前日期和时间。

更多信息SunLighting
String更多信息

类的名称。

更多信息Accessor
Boolean更多信息

表示是否显示太阳投射的阴影。

更多信息Lighting
Number更多信息

应在 UI 中显示以表示日期的 UTC 时区偏移量(以小时为单位)。

更多信息Lighting
String更多信息  SunLighting 类型总是"sun"更多信息SunLighting
Boolean更多信息

表示  WaterSymbol3DLayer 是否显示周围地形、建筑物和其他 3D 对象的反射。

更多信息SunLighting

属性详述

ambientOcclusionEnabled Boolean

表示是否显示环境遮挡阴影。

默认值:false
cameraTrackingEnabled Boolean

表示模拟太阳的日期和时间是否自动更新以在相机更改时保持当前时间。

默认值:true
date Date

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

默认值:new Date("March 15, 2022 12:00:00 UTC")
declaredClass Stringreadonly inherited

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

directShadowsEnabled Boolean inherited

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

默认值:false
displayUTCOffset Number inherited

UTC 中的时区偏移量小时,它应该显示在 UI 表示日期。此值并不影响实际现场的照明。

默认值:null
type Stringreadonly

SunLighting 工作类型总是"sun"

waterReflectionEnabled Boolean

表示 WaterSymbol3DLayer 是否显示周围地形、建筑物和其他 3D 对象的反射。

默认值:false

方法概述

展示继承方法 隐藏继承的方法
名称 返回类型 总结
Lighting更多信息

创建此对象的深层克隆。

更多信息Lighting
更多信息

在部分应用提供的网络场景照明设置的同时创建它的克隆。

更多信息SunLighting
Boolean更多信息

isFulfilled() 可用于验证创建类的实例是否已完成(已解决或已拒绝)。

更多信息Lighting
Boolean更多信息

isRejected() 可用于验证创建类的实例是否被拒绝。

更多信息Lighting
Boolean更多信息

isResolved() 可用于验证创建类的实例是否已解决。

更多信息Lighting
Promise更多信息

when() 一旦创建了类的实例,就可以利用它。

更多信息Lighting

方法详细说明

创建此对象的深拷贝。

返回:
类型 描述
Lighting 调用此方法创建一个新的实例的拷贝。
cloneWithWebsceneLighting()

在部分应用提供的网络场景照明设置的同时创建它的拷贝。

isFulfilled(){Boolean}inherited

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

返回:
类型 描述
Boolean 创建类的实例是否已完成(已解决或已拒绝)。
isRejected(){Boolean}inherited

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

返回:
类型 描述
Boolean 表示创建类的实例是否已被拒绝。
isResolved(){Boolean}inherited

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

返回:
类型 描述
Boolean 表示创建类的实例是否已解决。
when(callback, errback){Promise}inherited

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

参数:
callback Function
optional

当 promise 解决时调用的函数。

errback Function
optional

当 promise 失败时执行的函数。

返回:
类型 描述
Promise 返回 callback 结果的新承诺,可用于链接其他函数。
例子:
// 尽管此示例使用 MapView,但任何作为 Promise 的类实例都可以以相同的方式使用 when()
let view = new MapView();
view.when(function(){
  // 当 Promise resolved 时,函数将被执行
}, function(error){
  // 当 Promise 通过 rejected 抛错时,这个函数将被执行
});

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.