Shadow control/zh
< Shadow control(Redirected from Shadow control:zh-cn)
定义整个地图的动态阴影的方向、颜色和衰减距离。
注意:此翻译仅供参考。本译文是翻译2013年7月30日修改的文章。如果原文有大改动，请以最新修改日期的原文为准。注意:这个实体的属性适用于整个地图。地图中存在这个实体的多个实例可能会导致错误。天空盒照明通过每一个toolsskybox纹理的固体进入地图。其基本属性由三个实体组合使用来控制（有些游戏是四个实体）：
light_environment指定直射日光的方向、颜色和强度，以及漫反射光的颜色和强度。shadow_control实体指定light_environment所创建的动态阴影的方向、颜色和距离。如果没有该实体，动态阴影将会有bug且不可配置。env_sun在天空盒中放置一个发光的图标来表示太阳在天空中的明显位置。env_cascade_light给地图投射一个精细的实时阴影，其设置通常来自light_environment。只能用于
。
要使它们有意义，确保以上每个实体在地图中只有一个，并且实体的Pitch and Yaw <角度>设置为相同的值。（Pitch相当于太阳的仰角，而Yaw则类似于指南针轴承。）
这些照明设置——方向、颜色、强度等，是以具体2D天空盒的图像而定的。天空列表文章提供了一些Valve的天空盒的设置。worldspawn实体定义了使用的天空盒。另外请注意，如果env_fog_controller的设置与使用的特定天空盒不对应，雾气看起来会不正确。
注意:Pitch会对light_environment和env_sun强制，但不能对shadow_control。Pitch的强制也不能被关闭，且它的旋转是从水平方向逆时针开始的（因此竖直向下是-90°），而<角度> Pitch的旋转是顺时针的（因此竖直向下是+90°）。一个应对方法是确保你的Pitch强制只重复<角度>的值；例如，如果你的shadow_control、light_environment和env_sun的<角度>是「45 -60 0」，把Pitch设置为「-45」。请与light_environment和env_sun一起使用。
键值
角度:
- Pitch Yaw Roll (Y Z X)
<angle> - 这个实体在世界的方向。Pitch是围绕Y轴旋转，Yaw是围绕Z轴的旋转，Roll是围绕X轴的旋转。
提示:Pitch相当于太阳的仰角，而Yaw则类似于指南针轴承。
- Shadow Color
<color255
> - 这是阴影的颜色。
- All Shadows Disabled
<boolean>| 布尔值 - 此功能仅在半条命2中可用。[证实]
Base/基础:
- Parent
(parentname)<targetname>| 目标名 - 实体的父级实体，该实体可以与父实体保持移动偏移。名称后面可以添加一个附属点，以逗号隔开。 （
parentname [targetname],[attachment]）提示:转换至下一张地图的实体关系会依然存在。提示:一些不适合做父实体的实体可能难以运行，利用phys_constraint可以解决。
- Origin (X Y Z)
(origin)<coordinates> - 实体处于世界中的位置，旋转实体会以实体坐标原点旋转。注意:Hammer 不会仅在编辑器中相应地移动实体。
- Pitch Yaw Roll (X Y Z)
(angles)<angle> - 实体在世界中的方位，Pitch围绕X轴旋转，可以称为俯仰角。Yaw围绕Z轴旋转，可以称为偏航角，roll围绕Y轴旋转。注意:尽管 Hammer 不显示新角度，但其仍然适用于固实体。
- Classname
(classname)<string> | 字符串 不存在于FGD！ - 确定实体之前它生成的特征。提示:使用
AddOutput输入更改 Classname 仍然会影响游戏的代码，例如使类名与 S_PreserveEnts 列表中的一个元素匹配将使实体在新一轮中持续存在！
- Entity Scripts
(vscripts)<scriptlist>| 脚本列表 (存在于自
以来) - 在所有实体生成后执行的 VScript 文件（无文件扩展名）的空格分隔列表。这些脚本都在同一个脚本范围内执行，以后的脚本会覆盖任何相同的变量和函数。
- Thinker Function
(thinkfunction)<string> | 字符串 (存在于自 以来) - 此实体脚本中的函数名称，该函数将在脚本持续时间内每 100 毫秒（每秒 10 次）自动调用一次。它可用于创建计时器或模拟自主行为。返回值（如果存在）将设置下一次调用之前的时间。尽量避免在此函数中进行昂贵的操作，因为它可能会导致性能问题。
- Lag Compensation
(LagCompensate)<boolean>| 布尔值 (存在于自 以来) 不存在于FGD！ - 设置为是以延迟补偿此实体。应该非常谨慎地使用！
输入
color<color255>- 设置阴影颜色。
direction<vector>| 向量- 设置阴影方向。
SetDistance<float>| 浮点型- 设置最大阴影投射距离。
SetAngles<string> | 字符串- 设置阴影角度。（译：原文为direction，意思为方向，但译者觉得翻译成角度更合理。）
SetShadowsDisabled<integer>| 整数- 设置阴影禁用状态。
Base:
AddContext<string> | 字符串- 添加到实体的 Response Contexts/响应上下文列表。格式是
<key>:<value>。
语法:
ClearContext- 从此实体的列表中删除所有上下文。
ClearParent- 从移动层次结构中删除该实体，使其可以自由移动。
FireUser1到FireUser4- 触发相应的
OnUser输出；详见 User Inputs and Outputs
。
Kill- 从这个世界中删除此实体。
KillHierarchy- 功能类似
Kill，尽管此实体与其父实体都被删除了，但比Kill快一点。
RemoveContext- 从实体列表删除一个上下文。名字应与现有上下文进行匹配。
SetParent<string> | 字符串- 跟随此实体移动，详见 实体层级（依赖关系)。
SetParentAttachmentMaintainOffset<string> | 字符串- 同上，但没有传送。在接收到输入时，实体保持其相对于附件的位置。
DispatchResponse<string> | 字符串 不存在于FGD！- 向实体发送一个上下文。 详见 Response 和 Concept.
DispatchEffect<string> | 字符串 (自从 
被移除) 不存在于FGD！- 在实体的原点坐标设置一个特定效果；参见 List of Client Effects。自从 求生之路后由粒子系统取代。
RunScriptCode<string> | 字符串 (存在于自 以来)- 在接收输入的实体范围内执行一串 VScript 源代码。通过控制台触发时可能需要字符串引用。
错误:在 Hammer 中，使用带有字符串的参数会破坏 VMF 文件的结构，使下一个 Hammer 会话无法查看该文件。 - 修复: 使用文本编辑器手动删除带有字符串的参数。
SetLocalOrigin<coordinates>(存在于自
以来) 不存在于FGD！- 将此实体设置到地图中的某个位置。如果此实体是某实体父级，那么它的子级也会随着移动。
输出
Base/基础:
OnUser1到OnUser4- 这些输出将分别响应于
FireUser1到FireUser4输入。 详见 User Inputs and Outputs。
