如何在C# WPF的Helix 3D中添加阴影

以下是新手适配Helix Toolkit阴影功能的必查配置项，按顺序逐一核对即可解决90%以上的阴影不显示问题：

• 首先确认渲染管线支持：仅*WPF版本的Helix Toolkit（SharpDX后端）*支持实时光影，Winform封装版本、旧版软件渲染管线默认不支持阴影功能。
• 检查视口全局阴影开关：
  需在HelixViewport3D控件中主动开启阴影支持，XAML配置示例：

  <helix:HelixViewport3D EnableShadows="True" ShadowMapSize="2048">
  <!-- 场景内容配置 -->
  </helix:HelixViewport3D>
  

  其中ShadowMapSize控制阴影清晰度，数值越高性能消耗越大，新手测试阶段建议设置为1024或2048即可。
• 检查光源配置：
  仅方向光（DirectionalLight）、*聚光灯（SpotLight）*支持投射阴影，点光源默认无阴影支持。需给对应光源开启CastShadows属性，C#代码示例：

  var dirLight = new DirectionalLight
  {
      Color = Colors.White,
      Direction = new Vector3D(-1, -2, -3),
      CastShadows = true,
      ShadowIntensity = 0.3 // 阴影透明度，默认值极低容易导致肉眼看不到阴影
  };
  viewport.Children.Add(dirLight);
  

• 检查模型阴影属性：
  每个需要投射阴影的模型需开启CastShadows属性，需要接收阴影的模型需开启ReceiveShadows属性，两个属性默认均为关闭状态，是新手最容易遗漏的配置项：

  var meshModel = new MeshGeometryModel3D
  {
      Geometry = customMesh,
      Material = PhongMaterials.Red,
      CastShadows = true, // 配置该模型投射阴影
      ReceiveShadows = true // 配置该模型表面显示其他物体的阴影
  };
  

• 常见适配问题：

  如果场景范围过大，默认的阴影裁剪距离会导致阴影被截断/不显示，可以调整ShadowNearPlaneDistance和ShadowFarPlaneDistance属性匹配你的实际场景大小。
  默认透明材质无法投射阴影，需要自定义深度材质才能实现透明阴影效果。

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