This article's documentation is for anything that uses the Source engine. Click here for more information.

color_correction

From Valve Developer Community
Jump to: navigation, search
English (en)Русский (ru)中文 (zh)
... Icon-Important.png

注意:此篇翻译略有出处,若您有更好的内容请完善它!

Color correction.png

color_correction is a point entity available in all Source Source games.它可以载入调色 lookup table (.raw)文件并控制其强度。色彩校正用于其实体周围的球体范围,可以设置衰减值。

Left 4 Dead series求生之路1求生之路2中,此实体表现的像以前的source游戏的color_correction当实体 fog_volume固实体至少有一个被应用于fogvolume 材。标签(FLAGS)MasterSimulate 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 of your choice.(命名建议,啰里啰嗦)。

Icon-Bug.pngBug:在军团要塞2中 color_correction会导致控制点(control point)的hud界面显示不正确。(example).


In code, it is represented by theCColorCorrectionclass, defined in thecolorcorrection.cppfile.

标志/Flags

  • 1: Master (与L4D的fog_volume使用的默认color_correction) (in all games since Left 4 Dead)
  • 2: Simulate client-side 同上(in all games since Left 4 Dead)

键值

Lookup Falloff Start Distance (minfalloff) <float> | 浮点型
实体效果发挥的最大作用的起始范围。如果比End Distance的范围大,那么效果会作用于整张地图
Lookup Falloff End Distance (maxfalloff) <float> | 浮点型
效果可应用的最大范围。范围外则效果不明显,随着玩家越接近 Start Distance范围则越明显。
Maximum Weight (maxweight) <float> | 浮点型
对于调色的最大重量。[Clarify]
Lookup Fade In Duration (fadeInDuration) <float> | 浮点型
当实体设置为Enable时,淡入的时间。
Lookup Fade out Duration (fadeOutDuration) <float> | 浮点型
同上,淡出时间。
Lookup Table Filename (filename) <string简体中文> | 字符串
.raw调色文件位置,详见color correction。譬如HL2的位置: materials/colorcorrection.raw
Exclusive (exclusive) <布尔型> (in all games since Left 4 Dead)
特定的次color_correction实体启用时候会取消其他的调色实体。同一时间应该只能有一个color_correction被设置为特定。

EnableDisable/启动禁用:

Start Disabled (StartDisabled) <boolean> | 布尔值
保持休眠状态,直到被唤醒。(利用Enable输入)。

Base/基础:
Name (targetname) <string简体中文> | 字符串
其他实体用来指代该实体的名称。
Parent简体中文 (parentname) <targetname> | 目标名
实体的父级实体,该实体可以与父实体保持移动偏移。名称后面可以添加一个附属点,以逗号隔开。 (parentname [targetname],[attachment]
Tip.pngTip:转换至下一张地图的实体关系会依然存在。
Tip.pngTip:一些不适合做父实体的实体可能难以运行,利用phys_constraint可以解决。
Origin (X Y Z) (origin) <coordinates>
实体处于世界中的位置,旋转实体会以实体坐标原点旋转。
Note.pngNote:Hammer 不会仅在编辑器中相应地移动实体。
Pitch Yaw Roll (X Y Z) (angles) <angle>
实体在世界中的方位,Pitch围绕X轴旋转,可以称为俯仰角。Yaw围绕Z轴旋转,可以称为偏航角,roll围绕Y轴旋转。
Note.pngNote:尽管 Hammer 不显示新角度,但其仍然适用于固实体。
Classname (classname) <string简体中文> | 字符串 不存在于FGD!
确定实体之前它生成的特征。
Tip.pngTip:使用AddOutput输入更改 Classname 仍然会影响游戏的代码,例如使类名与 S_PreserveEnts 列表中的一个元素匹配将使实体在新一轮中持续存在!
Flags (spawnflags) <integer> | 整数 不存在于FGD!
实体所具有的标志/标签,依实体所具有而定。
Effects (effects) <integer> | 整数 不存在于FGD!
要使用的效果标志的组合。
Entity Scripts简体中文 (vscripts) <scriptlist> | 脚本列表 (存在于自 Left 4 Dead 2 以来)
在所有实体生成后执行的 VScript简体中文 文件(无文件扩展名)的空格分隔列表。这些脚本都在同一个脚本范围内执行,以后的脚本会覆盖任何相同的变量和函数。
Thinker Function简体中文 (thinkfunction) <string简体中文> | 字符串 (存在于自 Left 4 Dead 2 以来)
此实体脚本中的函数名称,该函数将在脚本持续时间内每 100 毫秒(每秒 10 次)自动调用一次。它可用于创建计时器或模拟自主行为。返回值(如果存在)将设置下一次调用之前的时间。尽量避免在此函数中进行昂贵的操作,因为它可能会导致性能问题。
Lag Compensation (LagCompensate) <boolean> | 布尔值 (存在于自 Left 4 Dead 2 以来) 不存在于FGD!
设置为以延迟补偿此实体。应该非常谨慎地使用!
Is Automatic-Aim Target (is_autoaim_target) <boolean> | 布尔值 (in all games since Counter-Strike: Global Offensive) 不存在于FGD!
如果设置为 1,当实体位于十字准线下方时,该实体将减慢控制台和操纵杆控制器的瞄准移动速度。


输入

SetFadeInDuration<float> | 浮点型
设置Lookup Fade In Duration淡入时间.
SetFadeOutDuration<float> | 浮点型
设置 Lookup Fade out Duration淡出时间.

EnableDisable/启动禁用:

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

Base:
AddContext<string简体中文> | 字符串
添加到实体的 Response Contexts/响应上下文列表。格式是<key>:<value>
AddOutput<string简体中文> | 字符串
在此实体上分配新的键值/输出。对于键值,有些依赖于额外的必要代码来运行,如果它只是通过这个输入改变就行不通。必须遵循严格的格式:
语法:

ClearContext
从此实体的列表中删除所有上下文。
ClearParent
从移动层次结构中删除该实体,使其可以自由移动。
FireUser1FireUser4
触发相应的OnUser输出;详见 User Inputs and OutputsEnglish
Kill
从这个世界中删除此实体。
KillHierarchy
功能类似Kill,尽管此实体与其父实体都被删除了,但比Kill快一点。
RemoveContext
从实体列表删除一个上下文。名字应与现有上下文进行匹配。
SetParent<string简体中文> | 字符串
跟随此实体移动,详见 实体层级(依赖关系)
SetParentAttachment<string简体中文> | 字符串
更改此实体到其父级上的特定附属English点。实体将传送,以至于其骨骼方位English与附属匹配。在使用此输入前必须设置好实体的父实体。
SetParentAttachmentMaintainOffset<string简体中文> | 字符串
同上,但没有传送。在接收到输入时,实体保持其相对于附件的位置。
Use 不存在于FGD!
与调用 +use English 的玩家相同[玩家按 +use(使用,默认E按钮)];大多数情况下没有影响。
DispatchResponse<string简体中文> | 字符串 不存在于FGD!
向实体发送一个上下文。 详见 ResponseEnglishConceptEnglish.
DispatchEffect<string简体中文> | 字符串 (自从 Left 4 Dead移除) 不存在于FGD!
在实体的原点坐标设置一个特定效果;参见 List of Client EffectsEnglish。自从Left 4 Dead Left 4 Dead后由粒子系统取代。
RunScriptFile<script> | 脚本 (存在于自 Left 4 Dead 2 以来)
从硬盘执行一个 VScript 脚本文件,不带文件后缀名。会合并接收实体的脚本域。
RunScriptCode<string简体中文> | 字符串 (存在于自 Left 4 Dead 2 以来)
在接收输入的实体范围内执行一串 VScript 源代码。通过控制台触发时可能需要字符串引用。
Icon-Bug.pngBug:在 Hammer 中,使用带有字符串的参数会破坏 VMFEnglish 文件的结构,使下一个 Hammer 会话无法查看该文件。
Fix: 使用文本编辑器手动删除带有字符串的参数。
CallScriptFunction<string简体中文> | 字符串 (存在于自 Left 4 Dead 2 以来) 不存在于FGD!
在接受实体脚本域上执行一段 VScript 函数。
SetLocalOrigin<coordinates> (存在于自 Alien Swarm 以来) 不存在于FGD!
将此实体设置到地图中的某个位置。如果此实体是某实体父级,那么它的子级也会随着移动。
SetLocalAngles<angles> (存在于自 Alien Swarm 以来) 不存在于FGD!
设置该实体的角度。

输出

实体目标名:

OnUser1OnUser4
这些输出将分别响应于FireUser1FireUser4 输入。 详见 User Inputs and Outputs
OnKilled (only in Left 4 Dead series)
当实体被删除时触发此输出。

参见