VirtualLighting

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

VirtualLighting 类允许您将场景中的照明更改为虚拟光。 灯光的位置跟随相机并设置在相机后面,向左侧有一个小的偏移。

scene-lightings

例如:

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

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

可视化照明尽快更新类型属性更改:

view.environment.lighting = {
   type: "virtual",
   directShadowsEnabled: true    // 转换成 new VirtualLighting({ directShadowsEnabled: true })
}
另参阅:

构造函数

new VirtualLighting(properties)
参数:
properties Object
optional

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

属性概述

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

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

更多信息VirtualLighting
Date更多信息

使用虚拟光时,不使用此属性并设置为 null。

更多信息VirtualLighting
String更多信息

类名称

更多信息Accessor
Boolean更多信息

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

更多信息Lighting
Number更多信息

在使用虚拟光时,不使用此属性并将其设置为 null。

更多信息VirtualLighting
String更多信息  VirtualLighting 类型为 "virtual"更多信息VirtualLighting
Boolean更多信息

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

更多信息VirtualLighting

属性详情

ambientOcclusionEnabled Boolean

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

默认值:false
date Date

在使用虚拟光时,不使用此属性并将其设置为 null。

默认值:null
declaredClass Stringreadonly inherited

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

directShadowsEnabled Boolean inherited

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

默认值:false
displayUTCOffset Number

使用虚拟光时,不使用此属性并设置为 null。

默认值:null
type Stringreadonly

 VirtualLighting 类型总为 "virtual"

waterReflectionEnabled Boolean

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

默认值:false

方法概述

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

创建此对象的深拷贝。

更多信息Lighting
更多信息

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

更多信息VirtualLighting
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.