ShadowMode

概览

字段	值
Kind	Enum · 枚举 Enum
Realm	common

• Inherit: Int
• 继承链: Int → ShadowMode

场景阴影模式枚举，用于区分两种阴影距离来源：按画质档位自动决定，或由开发者指定自定义距离。成员 DEFAULT 表示自动策略，成员 CUSTOM 表示自定义策略，后者结合阴影距离配置共同决定场景阴影的开启与覆盖范围。

适用场景

在调整场景光照表现时，把光照服务的阴影模式切换为该枚举的某个成员，即可在自动阴影与按自定义距离控制阴影之间选择。

使用要点

以 Enums.ShadowMode.DEFAULT 或 Enums.ShadowMode.CUSTOM 的形式引用成员值，并把它赋给光照服务的 ShadowMode 属性。选择 Enums.ShadowMode.CUSTOM 后，再配合 ShadowDistance 指定阴影距离。需要分支判断时，将当前值与 Enums.ShadowMode.CUSTOM 比较，而不要硬编码数字。

注意事项

枚举值必须写成 Enums.ShadowMode.成员名 的形式，禁止用数字代替。Enums.ShadowMode.CUSTOM 的实际效果取决于 ShadowDistance 的取值，该距离为零时场景阴影等于关闭。除 DEFAULT 与 CUSTOM 之外不存在其他成员，也不存在与该枚举同名的方法。

枚举值

值	名称	说明
0	DEFAULT	自动
1	CUSTOM	自定义