View source for Zh/VRAD

{{langsp}}
{{toc-right}}

'''VRAD'''是一个[[command-line|命令行]]工具，它接受已编译的BSP映射并将光照数据嵌入其中。VRAD的静态和预烘焙的光照通过[[Wikipedia:Radiosity (3D computer graphics)|辐射度算法]]在世界空间内进行反弹计算。

VRAD将进行：

* 生成[[lightmap|光照贴图]]
* 生成[[Ambient light|环境光]]
* 生成每个对象或每个顶点的[[prop_static]]和[[detail prop|细节道具]]的照明

VRAD通常是三种编译器中最慢的，它完全使用CPU的计算单元来算辐射度方程。这是非常恐怖的算力消耗。[[Lighting optimization|照明优化]]可以提供些许性能上的优化，但确保你的地图没有[[leak|泄漏的部分]]。

{{tip|如果你正在观察编译对话框，并且发现它看起来好像停留在''<code>9...</code>''这个地方，这是因为 VRAD 在使用 CPU 执行辐射度矩阵方程的求解计算，需要大量时间。}}
{{warning|在尝试烘焙光照的过程中，VRAD会占用大量的CPU。截止至{{source2|4}}的第三版VRAD，仍不支持 GPU 加速。}}
{{bug|《半条命2:第一章》和求生之路的地图作者如果发现VRAD在编译HDR光照时出现崩溃，那就应该阅读[[VRAD_HDR_Crash_Fix:zh-cn|VRAD中的HDR崩溃修复]]这篇文章。}}

{{bug|在非求生之路分支的游戏里，没有包含<code>.dx80.vtx</code>文件的<code>.mdl</code>文件将导致VRAD跳过这些道具的光照编译，复制<code>.dx90.vtx</code>文件并将其重命名为<code>.dx80.vtx</code>将会修复此问题。}}
{{bug|此外，具有<code>IDST1</code>开头的<code>.mdl</code>文件将无法被[[VBSP]]加载，并且会显示一条错误消息，指出无法加载此道具；这可以通过在十六进制编辑器中将文件头更改为IDST0，或通过在非求生之路分支引擎的[[Studiomdl]]程序（如Source 2013）中重新编译该道具来解决。}}
{{bug|从大约5 - 10年前到2017年10月，VRAD的所有已知副本都有一个共享线程调度的错误，这会导致应用无法利用多个线程，特别是在带有-final参数的室外场景中（尽管CPU使用显示为100％）。不过在SDK 2013已经提供了修复此漏洞的程序，在这里可以找到：[https://github.com/ValveSoftware/source-sdk-2013/pull/436 https://github.com/ValveSoftware/source-sdk-2013/pull/436]，编辑的DLL可在此处获得：[http://www.content.tophattwaffle.com/Content/modded_vrad_dll.zip www.content.tophattwaffle.com/Content/modded_vrad_dll.zip]。更新：Valve发布了针对CS:GO的SDK的VRAD的补丁版本。}}

== 语法 ==

 vrad [选项...] <bsp文件>

例如：

 "Half-Life 2\bin\vrad.exe" -both -StaticPropLighting sdk_trainstation_01

这将在prop_static实体的每个顶点细节处生成并嵌入标准和[[HDR/zh|高动态范围]]的光照数据。

==选项==

通过[[expert compile mode|专家编译模式]]或批处理文件来结合使用。

=== 效果 ===

{{ColumnBox|count=2|
; <code>-ldr</code>
; <code>-hdr</code>
; <code>-both</code>
: 是否编译标准或[[HDR/zh|高动态范围]]的光照，或两者一起编译。
: {{Note|在{{insurgency}}，你需要使用-hdr或-both进行编译才能看到瀑布阴影。}}
;<code>-fast</code>
: 快速和较差的照明。不要随便使用它。
;<code>-final</code>
: 通过花费更多时间发射光照射线来改进[[Light environment|light_environment]]和间接光照的质量。
;<code>-extrasky <[[int]]></code>
: 对间接光线和天空环境追踪N倍的光线。{{clr}}（-final等同于-extrasky 16；正常等同于-extrasky 1）
;<code>-lights <filename>.rad</code>
:除了<code>lights.rad</code>和地图指定的光照文件之外，还加载自定义[[#光照文件|光照文件]]。在参数中包含文件扩展名。
;<code>-bounce <[[int]]></code>
: 设置光线反弹的最大数量（默认值：100）。
;<code>-smooth <int></code>
:设置[[smoothing group|平滑组]]的阈值（以度为单位）（默认值：45）。
;<code>-luxeldensity <[[normal]]></code>
:缩小所有像素值。默认（和最大）值为1。
;<code>-softsun <[[float]]></code>
:将太阳视为多个度数的区域光源。产生柔和的阴影。建议值为0-5，默认为0。与[[Light environment|light_environment]]中的SunSpreadAngle参数相同。
;<code>-StaticPropLighting</code>
:生成[[prop_static]]的每个顶点的光照；始终对[[light_spot]]实体启用。 在没有法线贴图的道具的情况下禁用[[info_lighting]]实体。不支持启用Phong的道具。
{{Note|在{{csgo}}，为了在你的静态道具上获得适当的照明，你需要用这个命令来运行VRAD。}}
;{{EP2 add:zh-cn|<code>-StaticPropPolys</code>}}
:以多边形精度执行<code>prop_static</code>的阴影测试。默认使用[[collision mesh|碰撞网格]]。
;{{EP2 add:zh-cn|<code>-TextureShadows</code>}}
:从[[#光照文件|光照文件]]中指定的与[[prop_static]]一起使用的模型（非笔刷）的[[$translucent]]表面生成光照贴图阴影。通常需要<code>-StaticPropPolys</code>才能起作用。
:{{Note|对于大多数纹理阴影来说，一个表面将需要较低的[[lightmap|光照贴图]]比例来识别。}}
}}

=== 性能 ===

{{ColumnBox|count=2|
;<code>-low</code>
:作为低优先级进程运行。
;<code>-threads <[[int]]></code>
:设置最大使用的CPU线程数量。最多是16个线程。使用[[Increased_Thread_Limit_for_Compile_Tools|修补的vrad_dll]]你可以使用32个线程。
;<code>-mpi</code>
:使用[[Vmpi|VMPI]]分发计算。
;<code>-mpi_pw <[[string]]></code>
:使用密码来选择一组特定的VMPI工作人员。
;<code>-noextra</code>
:禁用超采样。
;<code>-chop <int></code>
:用于边缘的反弹补丁的最小数量的[[luxel|像素]]宽度。
;<code>-maxchop <int></code>
:最粗糙的允许数量的像素宽度的补丁，用于内部表面。
;<code>-LargeDispSampleRadius</code>
:如果地形上有反弹光斑，可以使用此功能。编译将需要更长时间，但它会在更广泛的区域聚集光线。
;<code>-compressconstant <int></code>
:压缩颜色变化小于这么多单位的[[lightmap|光照贴图]]。
;<code>-StaticPropSampleScale x</code>{{since:zh-cn|{{Csgo}}}}
:调节生成的prop_static的每个顶点的光照。
:慢：16（高质量）；默认值：4（正常）；快速：0.25（低质量）
:{{Note|-final相当于带有参数-StaticPropLightingScale 16。}}
}}

=== 调试 ===

{{ColumnBox|count=2|
;<code>-rederrors</code>
:当“一个发光像素没有样本”是发出红光。
;<code>-vproject <directory></code>
;<code>-game <directory></code>
:覆盖VPROJECT环境变量。
;<code>-v</code>
;<code>-verbose</code>
: 打开详细输出。
;<code>-novconfig</code>
:不要在vproject错误上显示图形用户界面。
;<code>-dump</code>
:转储补丁以调试文件。
;<code>-dumpnormals</code>
:将法线写入.txt调试文件。
;<code>-debugextra</code>
:将调试数据置于光照贴图中以可视化超级采样。
;<code>-dlightmap</code>
:强制直射照明到不同的光照贴图而不是光线传递。
;<code>-stoponexit</code>
:等待退出按键。
;<code>-nodetaillight</code>
:不要点亮细节道具。
;<code>-centersamples</code>
:移动样品中心。
;<code>-loghash</code>
:将样本哈希表记录到samplehash.txt。
;<code>-onlydetail</code>
:只有光照细节道具和每片叶子的照明。
;<code>-maxdispsamplesize #</code>
:设置最大位移样本大小（默认值：512）。
;<code>-FullMinidump</code>
:在崩溃时写入大型小型转储。
;<code>-OnlyStaticProps</code>
:仅执行直接的静态道具照明。
;<code>-StaticPropNormals</code>
:当照明静态道具时，只显示它们的法向矢量。
;<code>-noskyboxrecurse</code>
:关闭递归到3d天空盒（世界上的天空盒阴影）。
;<code>-nossprops</code>
:全局禁用静态道具上的自我阴影。
}}

==光照文件==

光照文件是一种纯文本文件，可用于在编译静态光照时操纵VRAD处理给定[[material|材质]]的方式。所有光照文件必须具有.rad文件扩展名，并且必须与[[Gameinfo.txt|gameinfo.txt]]位于同一文件夹中。

这里有：

#'''<code>lights.rad</code>'''，全局文件。
#'''自动加载的地图光照文件'''，使用<code><map name>.rad</code>格式。该文件必须放在与<code><map name>.vmf</code>相同的文件夹中。
#可以使用[[#效果|<code>-lights</code>参数]]添加'''任意数量的其他光照文件'''。

=== 规则 ===

Lights文件执行这些功能，每行一个规则：

;<code><material> <red> <green> <blue> <intensity> <hdr_red> <hdr_green> <hdr_blue> <hdr_intensity></code>
:当应用到[[brush|笔刷]]表面时，使材质发出指定的光照值（<code>hdr_</code>值是可选的）。纹理比例对最终强度有影响。{{Note|不在文件夹中的材质在名称前必须有斜杠。}}
;<code>noshadow <材质名称></code>
:阻止指定材质投射阴影。
;<code>forcetextureshadow <模型路径>.mdl</code>
:使用<code>[[#效果|-TextureShadows]]</code>运行VRAD时，为模型启用半透明阴影测试。路径相对于模型文件夹。
;<code><nowiki>ldr:</nowiki></code>
;<code><nowiki>hdr:</nowiki></code>
:制定任何规则的前缀仅适用于LDR或HDR照明。
;<code><nowiki>hdr:ldr:</nowiki></code>
:VRAD会始终忽略以这两个标签开始的行（按此顺序）。可用于添加注释或快速禁用某些条目。

==另见==
* [[Map_Compiling_Theory:zh-cn|地图编译理论]]
* [[HDR_Lighting_Basics:zh-cn|HDR光照基础]]
* [[VRAD_HDR_Crash_Fix:zh-cn|VRAD中的HDR崩溃修复]]
* [[Static Props show up black|静态模型全黑显示]]