如何为Autodesk Forge Viewer设置默认光照背景选项

一、设置默认背景颜色 #

可以通过Viewer的setBackgroundColor方法配置，需在Viewer初始化完成后调用，设置面板的颜色选择器会自动同步当前背景色。

• 纯色背景设置示例：

  // 参数为RGB值（0-255范围），这里设置浅灰色背景
  viewer.setBackgroundColor(240, 240, 240);
  

• 渐变背景设置示例：

  // 前三个参数为顶部颜色RGB，后三个为底部颜色RGB
  viewer.setBackgroundColor(240, 240, 240, 220, 220, 220);
  

二、设置光照默认值（对应设置面板光照选项） #

使用setLightPreset方法绑定预设光照，预设值对应面板中的选项，枚举值在Autodesk.Viewing.Presets.Lighting中：

• 预设光照设置示例：

  const LightingPresets = Autodesk.Viewing.Presets.Lighting;
  // 设置为Studio光照（对应面板的Studio选项）
  viewer.setLightPreset(LightingPresets.STUDIO);
  
  // 其他可选预设：
  // LightingPresets.NONE：无光照
  // LightingPresets.UNIFORM：均匀光照
  // LightingPresets.DAYLIGHT：日光
  // LightingPresets.CONTRAST：高对比度
  

• 自定义光照参数（可选）：
  若预设不满足需求，可直接调整光照细节：

  // 调整主光源强度
  viewer.impl.light.setMainLightIntensity(1.5);
  // 调整环境光强度
  viewer.impl.light.setEnvironmentIntensity(0.8);
  

注意事项 #

所有设置需在Viewer完全初始化完成后执行，可放在viewer.initialize()回调或Autodesk.Viewing.GEOMETRY_LOADED_EVENT事件监听中，避免因Viewer未就绪导致API调用失败。若需持久化默认设置，可将配置存储至localStorage，每次加载Viewer时读取应用。

内容的提问来源于stack exchange，提问作者sercanduyar