color_correction

注意：此篇翻译略有出处，若您有更好的内容请完善它！

color_correction是一个点实体(en)，可在所有的 起源 游戏中使用。它可以载入调色(en) lookup table (.raw)文件并控制其强度。色彩校正用于其实体周围的球体范围，可以设置衰减值。

在求生之路1(en)和求生之路2(en)中，此实体表现的像以前的source游戏的color_correction当实体 fog_volume固实体至少有一个被应用于fogvolume 材。标签(FLAGS)Master和Simulate client-side必须在主color_correction实体上勾选。并且只能有一个主color_correction实体。It is recommended that the other color_correction entities be triggered with fog_volume with an override of the master（推荐用覆盖主实体的fog_volume实体来触发其他color_correction实体。）。 The override is done by setting the fog_volume entity property called ColorCorrection Name to a color_correction targetname(en) of your choice.（命名建议，啰里啰嗦）。

错误:在军团要塞2中 color_correction会导致控制点（control point）的hud界面显示不正确。(example).  [todo tested in?]

在源代码中，它由 class CColorCorrection 代表，定义于 colorcorrection.cpp。

标志/Flags

• 1: Master (与L4D的fog_volume使用的默认color_correction) Template:L4D add
• 2: Simulate client-side 同上Template:L4D add

键值

Lookup Falloff Start Distance (minfalloff) <浮点型(en)>

实体效果发挥的最大作用的起始范围。如果比End Distance的范围大，那么效果会作用于整张地图。

Lookup Falloff End Distance (maxfalloff) <浮点型(en)>

效果可应用的最大范围。范围外则效果不明显，随着玩家越接近 Start Distance范围则越明显。

Maximum Weight (maxweight) <浮点型(en)>

对于调色的最大重量。^[澄清]

Lookup Fade In Duration (fadeInDuration) <浮点型(en)>

当实体设置为Enable时，淡入的时间。

Lookup Fade out Duration (fadeOutDuration) <浮点型(en)>

同上，淡出时间。

Lookup Table Filename (filename) <字符串(en)>

.raw调色文件位置，详见color correction(en)。譬如HL2的位置: materials/colorcorrection.raw

Exclusive (exclusive) <布尔型(en)> (存在于自 以来)

特定的次color_correction实体启用时候会取消其他的调色实体。同一时间应该只能有一个color_correction被设置为特定。

EnableDisable/启动禁用:

Start Disabled (StartDisabled) <boolean(en)>

保持休眠状态，直到被唤醒。(利用Enable输入)。

1. REDIRECT Template:KV BaseEntity:zh-cn

输入

SetFadeInDuration<浮点型(en)>

设置Lookup Fade In Duration淡入时间.

SetFadeOutDuration<float(en)>

设置 Lookup Fade out Duration淡出时间.

EnableDisable/启动禁用:

Enable

Disable

启动/禁用此实体所具备的效果。同样会使实体消失。

Base:

AddContext<string(en)>

添加到实体的 Response Contexts/响应上下文列表。格式是<key>:<value>。

AddOutput<string(en)>

在此实体上分配新的键值/输出。对于键值，有些依赖于额外的必要代码来运行，如果它只是通过这个输入改变就行不通。必须遵循严格的格式：

语法:

// 更改键值的格式： "AddOutput [键] [值]"
//// 原始文本：
"OnUser1" "!self,AddOutput,targetname new_name"

// 添加输出的格式： "AddOutput {目标名称}:{输入名称}:{参数}:{延迟}:{最大触发次数，-1 代表无限}"
//// 原始文本：
"OnUser1" "!self,AddOutput,OnUser1:SetParent:!activator:0.0:-1"
// 参数可以留空，但仍应包含空的空白。
//// 原始文本：
"OnUser1" "!self,AddOutput,OnUser1:ClearParent::0.0:-1"

ClearContext

从此实体的列表中删除所有上下文。

ClearParent

从移动层次结构中删除该实体，使其可以自由移动。

FireUser1到FireUser4

触发相应的OnUser输出；详见 User Inputs and Outputs。

Kill

从这个世界中删除此实体。

KillHierarchy

功能类似Kill，尽管此实体与其父实体都被删除了，但比Kill快一点。

RemoveContext

从实体列表删除一个上下文。名字应与现有上下文进行匹配。

SetParent<string(en)>

跟随此实体移动，详见 实体层级（依赖关系)。

SetParentAttachment<string(en)>

更改此实体到其父级上的特定附属点。实体将传送，以至于其骨骼方位与附属匹配。在使用此输入前必须设置好实体的父实体。

SetParentAttachmentMaintainOffset<string(en)>

同上，但没有传送。在接收到输入时，实体保持其相对于附件的位置。

Use 不存在于FGD！

与调用 +use 的玩家相同［玩家按 +use（使用，默认E按钮)]；大多数情况下没有影响。

DispatchResponse<string(en)> 不存在于FGD！

向实体发送一个上下文。 详见 Response 和 Concept.

DispatchEffect<string(en)> (自从 被移除) 不存在于FGD！

在实体的原点坐标设置一个特定效果；参见 List of Client Effects。自从 求生之路后由粒子系统取代。

RunScriptFile<script(en)> (存在于自 以来)

从硬盘执行一个 VScript 脚本文件，不带文件后缀名。会合并接收实体的脚本域。

RunScriptCode<string(en)> (存在于自 以来)

在接收输入的实体范围内执行一串 VScript 源代码。通过控制台触发时可能需要字符串引用。

错误:在 Hammer 中，使用带有字符串的参数会破坏 VMF 文件的结构，使下一个 Hammer 会话无法查看该文件。  [todo tested in?]

修复:使用文本编辑器手动删除带有字符串的参数。

CallScriptFunction<string(en)> (存在于自 以来) 不存在于FGD！

在接受实体脚本域上执行一段 VScript 函数。

SetLocalOrigin<coordinates(en)> (存在于自 以来) 不存在于FGD！

将此实体设置到地图中的某个位置。如果此实体是某实体父级，那么它的子级也会随着移动。

SetLocalAngles<angles(en)> (存在于自 以来) 不存在于FGD！

设置该实体的角度。

输出

实体目标名:

OnUser1到OnUser4

这些输出将分别响应于FireUser1到FireUser4 输入。 详见 User Inputs and Outputs。

OnKilled (仅存在于 之中)

当实体被删除时触发此输出。

参见

• color_correction_volume (brush entity(en))
• fog_volume