View source for Zh/Env fog controller

{{LanguageBar}}
{{this is a|point entity|name=env_fog_controller}}


{{infotable
|env_fog_controller
|img=[[File:fog_controller.png]]
|type=e0
|engine=2
|in=0
}}

这个实体定义了整个地图的雾气效果。

{{Tip|在多人游戏中，此实体可以向{{ent|player}}（玩家）实体发送输入<code>SetFogController</code>来修改每个客户端的雾气效果，最好是通过{{ent:zh-cn|!activator}}！}}

在{{l4ds}}中, 多个 {{ent:zh-cn|env_fog_controller}}可以结合{{ent:zh-cn|fog_volume}}实体来创建不同区域实现不同雾气效果。 除此之外，如果不设置<code>fog_volume</code>指定到任意一个<code>env_fog_controller</code>上，或者未启用单个<code>fog_volume</code>则可以设置标签/flags ''Master''作为主要的全局雾气控制。
{{PreservedEnt}}

向地图增加雾气可以导致/要求{{L|lighting|光照}}更加真实。光照穿过雾气的时候会散射和被吸收。雾气越浓，效果会越好：
*{{L|Falloff|光照衰减}}，是光线随着距离而衰减的率。 雾气越浓厚则衰减距离越小。
*[[Lighting#Tyndall effects|丁达尔效应]] - 可以透过雾气粒子反射光效给玩家。 雾气越浓厚，光圈效果和光束则越明显。
*漫反射光照 - 随着雾气的浓淡，光与影的边界将不明显。 详见 [[Lightmap#Lightmap Scale|Lightmap Scale]] 和 {{ent:zh-cn|shadow_control}}的distance属性。

比较古老的起源游戏将雾渲染成离摄像机一定距离的平面。这种方法很糟糕，因为旋转视角会加强或减弱某个地方的明显雾量，即使玩家根本没有移动。在{{L|Left 4 Dead|求生之路1}}中，V社通过实施一种与视角无关的新径向方法来解决的。
<!-- 傻逼VDC阉割了Mediawiki的主页面注释功能，按照起源模组制作圈的共识，以L4D1区分起源整体分支的新旧。半条命2、传送门等在L4D1之前发布的起源游戏称为“旧起源”，L4D2、传送门2等在L4D1之后发布的起源游戏称为“新起源” -->

{{Note|{{L|3D Skybox}}的远景效果，其{{ent:zh-cn|sky_camera}}相关雾气属性应该与{{ent:zh-cn|env_fog_controller}}一致。}}

{{code class:zh-cn|CFogController|fogcontroller.cpp}}

==标签/Flags==
*1: Master - 如果有多个{{ent:zh-cn|env_fog_controller}}被弃用，此实体永远是优先的。

==键值==
{{KV:zh-cn|Fog Enabled|intn=fogenable|bool|使雾实体启用。}}
{{KV:zh-cn|Fog Start|intn=fogstart|float|雾效果应该距离玩家视角多远开始出现。即雾开始的距离。}}
{{KV:zh-cn|Fog End|intn=fogend|float|距离玩家视角多远达到'''Fog Max Density'''（雾效果最大浓度）。即雾结束的距离，挂钩与最大浓度。}}
{{KV:zh-cn|Fog Max Density|intn=fogmaxdensity|float|雾效果能达到的最大浓度。以小数点表示百分比，如0.45代表45%。}}
{{KV:zh-cn|Far Z Clip Plane|intn=farz|integer|以世界距离为单位，超过多远的物体不渲染。这项应该比'''Fog End'''更高。如果启用了此项， '''Fog Max Density'''则应该设置为<code>1</code>，否则有可能看到{{L|void|空洞}}（地图外面的黑色效果） 。}}
{{KV:zh-cn|Primary Fog Color|intn=fogcolor|color255|雾气的主要颜色。}}
{{KV:zh-cn|Secondary Fog Color|intn=fogcolor2|color255|雾气的次要颜色。如果 '''Fog Blend''' 被禁用，则不会启用此颜色。}}
{{KV:zh-cn|Fog Blend|intn=fogblend|bool|启用在'''Primary Fog Color''' 和 '''Secondary Fog Color'''之间的色彩混合。 当玩家注视着 '''Primary Fog Direction'''，则启用''Primary''颜色。 当远离这个特定位置，雾气启用 ''Secondary'' 颜色。如果即不是远离也不是注视, 则混合两种颜色。利用'''Primary Fog Direction''' 为 "-1 -1 1", '''Primary Fog Color''' 为 "120 110 100" 和'''Secondary Fog Color''' 为 "80 70 60"可以用来提升角度为Yaw 45度，Pitch -45度的太阳光。}}
{{KV:zh-cn|Primary Fog Direction|intn=fogdir|vector|向量(以空格分割XYZ)， which the viewer camera is checked against to figure out the blend between the primary and secondary fog colors.}}
{{KV:zh-cn|Use Angles for Fog Dir|intn=use_angles|bool|以'''Pitch Yaw Roll''' 设置 '''Fog Blend''' 方向而不是 '''Primary Fog Direction'''. 除非你想要方位旋转，否则没什么用。}}
{{KV:zh-cn|Interpolate time|intn=foglerptime|float|输入 <code>StartFogTransition</code> 的淡入时间。}}
{{KV:zh-cn|HDR Color Scale|intn=HDRColorScale|since=L4D|float|{{L|HDR}} 模式下雾颜色的倍数.}}
{{KV:zh-cn|Zoom Fog Scale|intn=ZoomFogScale|since=CSGO|float|利用瞄准镜的时候，玩家起始雾和结束雾距离的标量。(e.g. AWP).}}
{{KV DXLevelChoice:zh-cn}}
{{KV SystemLevelChoice:zh-cn}}
{{KV BaseEntity:zh-cn|css=1}}

==输入==
{{IO:zh-cn|TurnOn|开启.}}
{{IO:zh-cn|TurnOff|关闭.}}
{{IO:zh-cn|SetStartDist|param=float|设置 '''Fog Start'''距离}}
{{IO:zh-cn|SetEndDist|param=float|设置 '''Fog End''' 距离}}
{{IO:zh-cn|SetColor|param=color255|设置 '''Primary Fog Color'''的颜色}}
{{IO:zh-cn|SetColorSecondary|param=color255|设置 '''Secondary Fog Color'''的颜色}}
{{IO:zh-cn|SetFarZ|param=integer|设置 '''Far Z Clip Plane'''距离.}}
{{IO:zh-cn|SetAngles|param=angles|设置 '''Primary Fog Direction'''角度.}}
{{IO:zh-cn|Set2DSkyboxFogFactor|param=float|since=l4d2|把当前雾气的量混合到2D skybox，表示为小数百分比，45%请使用0.45{{l4d2}} only.}}
{{IO:zh-cn|SetZoomFogScale|param=float|since=CSGO|设置 '''Zoom Fog Scale'''.}}
{{IO:zh-cn|SetColorLerpTo|param=color255|since=EP1|储存一个'''Primary Fog Color'''的颜色值，在 <code>StartFogTransition</code> 输入时触发。}}
{{IO:zh-cn|SetColorSecondaryLerpTo|param=color255|since=EP1|储存一个 '''Secondary Fog Color''' 的颜色值，在 <code>StartFogTransition</code>输入时触发。}}
{{IO:zh-cn|SetStartDistLerpTo|param=float|since=EP1|储存一个 '''Fog Start''' 的距离值，在 <code>StartFogTransition</code>输入时触发。}}
{{IO:zh-cn|SetEndDistLerpTo|param=float|since=EP1|储存一个 '''Fog End''' 的距离值，在 <code>StartFogTransition</code> 输入时触发。}}
{{IO:zh-cn|SetMaxDensityLerpTo|param=float|since=L4D|储存一个 '''Fog Max Density'''的浓度，在 <code>StartFogTransition</code>输入时触发 This one does ''not'' have any non-"LerpTo" counterpart.}}
{{IO:zh-cn|Set2DSkyboxFogFactorLerpTo|param=float|since=l4d2|把当前雾气的量混合到2D skybox，表示为小数百分比，45%请使用0.45。只有  <code>StartFogTransition</code>输入时触发。 {{only:zh-cn|{{l4d2}}}}.}}
{{IO:zh-cn|StartFogTransition|since=EP1|当输入触发，雾气变化通过 "<code>LerpTo</code>" 输入。变化时间通过 '''Interpolate time''' 键值定义。

{{bug|并没有正确地工作。过度时间为0会突然改变为新值。见于{{l4d2}}{{csgo}}.}}}}
{{I BaseEntity:zh-cn|prel4d=1}}

==输出==
{{O BaseEntity:zh-cn|l4d=1}}

==参见==
*{{L|Fog tutorial|雾教程（已有中文，右上角切换）}}
*{{L|Fog Basics|雾基础}}
*{{L|Dust, Fog, & Smoke|尘，雾和烟}}