Skip to content
导览

环境 EnvironmentManager

环境管理器是用于控制云渲染环境的工具,通过获取该管理器,用户可以方便地进行环境的控制和管理。 该工具的主要功能包括:

  1. 设置太阳光照强度
  2. 获取太阳光照强度
  3. 设置轮廓线的颜色
  4. 设置天空盒
  5. 设置环境光强度
  6. 获取环境光强度
  7. 设置太阳光方向
  8. 设置是否显示阴影
  9. 设置viewCube是否显示
  10. 设置调试信息是否显示
  11. 设置网格是否显示
  12. 设置坐标轴类型

我们将提供详细的使用指南和功能说明,帮助用户更好地使用该工具。

environmentManager

用户可以调用云渲染实例 cloud 上的 getEnvironmentManager() 方法来获取 EnvironmentManager 相机管理器。

ts
const EnvironmentManager = await cloud.getEnvironmentManager()
const EnvironmentManager = await cloud.getEnvironmentManager()

用户调用 cloud.getEnvironmentManager() 后,EnvironmentManager 会被自动挂载到当前 cloud 实例上。

ts
await cloud.getEnvironmentManager()
const EnvironmentManager = cloud.EnvironmentManager
await cloud.getEnvironmentManager()
const EnvironmentManager = cloud.EnvironmentManager

设置太阳光照强度 | setSunLightIntensity

  • 说明:设置模型的太阳光照强度

我们可以调用 EnvironmentManager 上面的 setSunLightIntensity 方法来设置模型的太阳光照强度。

  • 参数说明
NameTypeDescription
SunStrengthnumber光照强度,取值范围 [0,100]

调用示例:

ts
const environmentManager = await cloud.getEnvironmentManager()
const num = 0.5
environmentManager.setSunLightIntensity(num)
const environmentManager = await cloud.getEnvironmentManager()
const num = 0.5
environmentManager.setSunLightIntensity(num)

获取太阳光照强度 | getSunLightIntensity

  • 说明:获取模型的太阳光照强度

我们可以调用 EnvironmentManager 上面的 getSunLightIntensity 方法来设获取模型的太阳光照强度。

调用示例:

ts
const environmentManager = await cloud.getEnvironmentManager()
const num = await environmentManager.getSunLightIntensity()
const environmentManager = await cloud.getEnvironmentManager()
const num = await environmentManager.getSunLightIntensity()

设置轮廓线的颜色 | setOutlineConfig

  • 说明:设置轮廓线的颜色

我们可以调用 EnvironmentManager 上面的 setOutlineConfig 方法来设置轮廓线的颜色。

  • 参数说明
NameTypeDescription
configOutlineConfig轮廓线设置

调用示例:

ts
const environmentManager = await cloud.getEnvironmentManager()
const config: OutlineConfig = {
  color: '0xff33ffff',
}
const temp = await environmentManager.setOutlineConfig(config)
const environmentManager = await cloud.getEnvironmentManager()
const config: OutlineConfig = {
  color: '0xff33ffff',
}
const temp = await environmentManager.setOutlineConfig(config)

设置天空盒 | setSkybox

  • 说明:设置天空盒

我们可以调用 EnvironmentManager 上面的 setSkybox 方法来设置天空盒。

  • 参数说明
NameTypeDescription
typeSkyboxType天空盒类型
exposureIntensitynumber曝光强度

调用示例:

ts
const environmentManager = await cloud.getEnvironmentManager()
const type = 0
const Intensity = 1
environmentManager.setSkybox(type, Intensity)
const environmentManager = await cloud.getEnvironmentManager()
const type = 0
const Intensity = 1
environmentManager.setSkybox(type, Intensity)

设置环境光强度 | setEnvironmentLightIntensity

  • 说明:设置环境光强度

我们可以调用 EnvironmentManager 上面的 setEnvironmentLightIntensity 方法来设置环境光强度。

  • 参数说明
NameTypeDescription
environmentLightnumber环境光强度

调用示例:

ts
const environmentManager = await cloud.getEnvironmentManager()
environmentManager.setEnvironmentLightIntensity(2.0)
const environmentManager = await cloud.getEnvironmentManager()
environmentManager.setEnvironmentLightIntensity(2.0)

获取环境光强度 | getEnvironmentLightIntensity

  • 说明:获取环境光强度

我们可以调用 EnvironmentManager 上面的 getEnvironmentLightIntensity 方法来获取环境光强度。

调用示例:

ts
const environmentManager = await cloud.getEnvironmentManager()
const intensity = environmentManager.getEnvironmentLightIntensity()
const environmentManager = await cloud.getEnvironmentManager()
const intensity = environmentManager.getEnvironmentLightIntensity()

设置太阳光方向 | setSunDirection

  • 说明:设置太阳光方向

我们可以调用 EnvironmentManager 上面的 setSunDirection 方法来设置太阳光方向。

  • 参数说明
NameTypeDescription
timeZonenumber时区
yearnumber
monthnumber
daynumber
hournumber小时
minutenumber分钟

调用示例:

ts
const environmentManager = await cloud.getEnvironmentManager()
environmentManager.setSunDirection(timeZone, year, month, day, hour, minute)
const environmentManager = await cloud.getEnvironmentManager()
environmentManager.setSunDirection(timeZone, year, month, day, hour, minute)

设置是否显示阴影 | setShadow

  • 说明:设置是否显示阴影

我们可以调用 EnvironmentManager 上面的 setShadow 方法来设置是否显示阴影。

  • 参数说明
NameTypeDescription
isShowbooleantrue为显示,false为不显示

调用示例:

ts
const environmentManager = await cloud.getEnvironmentManager()
environmentManager.setShadow(true)
const environmentManager = await cloud.getEnvironmentManager()
environmentManager.setShadow(true)

设置viewCube是否显示 | setViewCube

  • 说明:设置viewCube是否显示

我们可以调用 EnvironmentManager 上面的 setViewCube 方法来设置viewCube是否显示。

  • 参数说明
NameTypeDescription
isShowbooleantrue为显示,false为隐藏

调用示例:

ts
const environmentManager = await cloud.getEnvironmentManager()
environmentManager.setViewCube(false)
const environmentManager = await cloud.getEnvironmentManager()
environmentManager.setViewCube(false)

设置调试信息是否显示 | showDebugInfo

  • 说明:设置调试信息,可以获取云渲染的相关信息

我们可以调用 EnvironmentManager 上面的 showDebugInfo 方法来设置调试信息是否显示。

  • 参数说明
NameTypeDescription
isShowbooleantrue为显示,false为隐藏

调用示例:

ts
const environmentManager = await cloud.getEnvironmentManager()
environmentManager.showDebugInfo(isShow)
const environmentManager = await cloud.getEnvironmentManager()
environmentManager.showDebugInfo(isShow)

设置网格是否显示 | showGrid

  • 说明:设置网格显隐状态

我们可以调用 EnvironmentManager 上面的 showGrid 方法来设置网格是否显示。

  • 参数说明
NameTypeDescription
isShowbooleantrue为显示,false为隐藏

调用示例:

ts
const environmentManager = await cloud.getEnvironmentManager()
environmentManager.showGrid(isShow)
const environmentManager = await cloud.getEnvironmentManager()
environmentManager.showGrid(isShow)

设置坐标轴类型 | setCoordStyle

  • 说明:设置坐标轴类型(可以在setting.json中进行配置)

我们可以调用 EnvironmentManager 上面的 setCoordStyle 方法来设置坐标轴类型。

  • 参数说明
NameTypeDescription
stylestringCS_ENU或者CS_XYZ

调用示例:

ts
const environmentManager = await cloud.getEnvironmentManager()
environmentManager.setCoordStyle('CS_ENU')
const environmentManager = await cloud.getEnvironmentManager()
environmentManager.setCoordStyle('CS_ENU')