查看“光源”的源代码

[[File:Lights.jpg|320px|thumb|right|三种光源（从左至右依次是点光源、平行光源、投影式光源）以及显示它们作用效果的辅助线。为了便于辨别，平行光源的颜色被调成了蓝绿色，并附上了[[路面]]以便观察效果。]]
'''光源'''（Light），又称'''灯泡'''，是 [[Virtools/zh|Virtools]] 内的提供照明的物体，不同于其他 3D Object 物件，它在 Virtools 内被单独分至 {{Code|Lights}} 类中。然而，光源的效果可以在 Ballance 内直接显出。

Ballance 内已有在 [[Gameplay.nmo/zh|Gameplay.nmo]] 和 [[Levelinit.nmo/zh|Levelinit.nmo]] 中配置好的平行光源，因此地图中再添加光源一般没有太大用处，甚至可能和游戏自身光源叠加导致过分明亮，影响游戏体验。但由于 Virtools 中的场景默认是非常黑暗的，制图者常在[[制图]]过程中使用光源提供照明，使得在 Virtools 内对地图进行设计、调整、检查更加方便；而制图成品中则删去光源或将光源隐藏或为其[[归组]]，使之不再生效。

也有些[[自制地图]]如[[暮光之城]]等会故意留下光源，将其用于提供特殊的色调，渲染氛围。但在此时，光源一般会设置得颜色较暗，以避免最终游戏内亮度过高，影响游戏体验。

== 三种光源 ==

Virtools 内存在三种光源，分别是点 (point) 光源、平行 (directional) 光源，以及投影式 (spot) 光源。

=== 点光源 ===

最常见的一种光源，也是创建光源时默认的种类。光照由一点发出，向各个方向均匀散发并减弱，最终整个作用区域为球形。

=== 平行光源 ===

直译为方向光源。Ballance 的配置文件内提供的光源种类。平行光作用效果为整个地图文件。

=== 投影式光源 ===

直译为热点光源。类似于投影仪或舞台灯光。

== 选项和配置 ==

{{NeedContent/zh}}

光源的选项除了正常 3D 物件的坐标和旋转角度外，还有是否在播放器模式中展示（Show In Player Mode）和高光（Specular），以及光源类型，一共三个选项。

光源有如下配置：

* 光照颜色（Color）：默认为 {{Square|1em|white}} 白色。
* 是否激活（Influence）：是否为 Active。默认已激活。
* 是否显示辅助线（Show Influence = True/False）（仅点光源、投影式光源）：默认为显示。会在光源的边界处显示浅蓝色的辅助线。
* 范围（Range）（仅点光源、投影式光源）：照射半径或投影距离。默认为 200（所提供的滑块最大可以滑动到 200，但通过手动输入数值或者使用放缩功能可以获得更大的范围）。处在光源范围内的物体会获得最大亮度。
* 衰减（Attenuation）（仅点光源、投影式光源）：通过多个子参数调整光源范围''之外''的亮度强度衰减。
** 常数（Constant）：默认为 1（滑块最大至 10）。
** 线性（Linear）：默认为 0（滑块最大至 10）。
** 二次（Quadratic）：默认为 0（滑块最大至 10）。
* 对象（Target）（仅投影式光源）：投影式光源照明的对象（仅限 {{zh|3D Frames}}）。默认为无（None）。设置后光源将会被旋转至正对该对象的方向。
* 投影圆锥参数（Spot Cone）（仅投影式光源）：通过多个子参数调节投影范围。
** 热点（Hot Spot）：默认为 40（滑块最大至 180）。
** 减弱（Fall Off）：默认为 45（滑块最大至 180）。
** 减弱形状（Fall Off Shape）：默认为 1（滑块最大至 10）。

== 你知道吗 ==

* 虽然 Virtools 内的范围调节滚动条显示点光源照明范围最大为 200，但手动可以输入任意大小的范围值，甚至可以将其照明范围提高至极大。
* 虽然光源并不属于其他物件的 3D Objects 类，但在 Virtools 内仍然可以将之归组，若归入[[机关]]组和[[小节]]组，它甚至能在 Ballance 内被加载为机关而生效，但此时照明效果会消失。
* 光源过多时，可能会产生地图亮度（由 {{zh|Levelinit.nmo}} 提供的）消失，全图黑暗的 bug。
* Ballance 中绝大多数关卡的环境光照的平行光光源颜色被设为 {{Square|1em|#fff}} RGB(255, 255, 255)，但第 9 关是 {{Square|1em|RGB(233, 233, 233)}} RGB(233, 233, 233)，第 12 关则是 {{Square|1em|RGB(127, 127, 127)}} RGB(127, 127, 127)。

{{制图教程}}