light components 的脚本接口。
它用于对 Unity 光源进行全面控制。这些属性与 Inspector 中显示
的值完全匹配。
通常光源仅在 Editor 中创建,但是有时需要通过脚本创建光源:
using UnityEngine;
public class Example : MonoBehaviour { void Start() { // Make a game object GameObject lightGameObject = new GameObject("The Light");
// Add the light component Light lightComp = lightGameObject.AddComponent<Light>();
// Set color and position lightComp.color = Color.blue;
// Set the position (or any transform property) lightGameObject.transform.position = new Vector3(0, 5, 0); } }
areaSize | 面光源的大小。 |
bakingOutput | 此属性描述最后一个全局光照烘焙的输出。 |
bounceIntensity | 定义反弹光照强度的乘数。 |
color | 光的颜色。 |
colorTemperature | 光的色温。 在计算光源的最终颜色时,会将相对色温(缩写为 CCT)乘以颜色过滤器。从理想黑体发出的电磁辐射的色温定义为其以开尔文为单位的表面温度。根据 D65 标准,白色光色温为 6500K。蜡烛光色温为 1800K。 如果要使用 lightsUseCCT,必须启用 lightsUseLinearIntensity 以确保物理上的正确输出。 另请参阅:GraphicsSettings.lightsUseLinearIntensity、GraphicsSettings.lightsUseCCT。 |
commandBufferCount | 此光源上设置的命令缓冲区数(只读)。 |
cookie | 光投射的阴影的剪影纹理。 |
cookieSize | 方向光剪影的大小。 |
cullingMask | This is used to light certain objects in the Scene selectively. |
flare | 要用于此光的 flare asset。 |
intensity | 光的强度乘以光颜色。 |
layerShadowCullDistances | Per-light, per-layer shadow culling distances. |
lightmapBakeType | 此属性描述可以对光贡献的哪个部分进行烘焙。 |
lightShadowCasterMode | Allows you to override the global Shadowmask Mode per light. Only use this with render pipelines that can handle per light Shadowmask modes. Incompatible with the legacy renderers. |
range | 光照范围。 |
renderMode | 如何渲染光。 |
shadowAngle | 控制由方向光应用于阴影投射边缘的人工柔化量。 |
shadowBias | 阴影贴图恒定偏差。 |
shadowCustomResolution | 阴影贴图的自定义分辨率。 |
shadowNearPlane | 要用于阴影视锥体的近平面值。 |
shadowNormalBias | 阴影贴图基于法线的偏差。 |
shadowRadius | 控制由点光源或聚光灯应用于阴影投射边缘的人工柔化量。 |
shadowResolution | 阴影贴图的分辨率。 |
shadows | 此光如何投射阴影。 |
shadowStrength | 光阴影的强度。 |
spotAngle | 光的聚光灯锥体的角度(以度为单位)。 |
type | 光源类型。 |
AddCommandBuffer | 添加要在指定位置执行的命令缓冲区。 |
AddCommandBufferAsync | 向 GPU 的异步计算队列添加命令缓冲区,并在图形处理到达给定点时执行该命令缓冲区。 |
GetCommandBuffers | 获取要在指定位置执行的命令缓冲区。 |
RemoveAllCommandBuffers | 删除在此光源上设置的所有命令缓冲区。 |
RemoveCommandBuffer | 从指定位置的执行中删除一个命令缓冲区。 |
RemoveCommandBuffers | 从指定位置的执行中删除多个命令缓冲区。 |
Reset | Revert all light parameters to default. |
SetLightDirty | 将光源设置为“脏”可通知光照烘焙后端更新其内部光源表示形式。 |
enabled | 启用的 Behaviour 可更新,禁用的 Behaviour 不可更新。 |
isActiveAndEnabled | Has the Behaviour had active and enabled called? |
gameObject | 此组件附加到的游戏对象。始终将组件附加到游戏对象。 |
tag | 此游戏对象的标签。 |
transform | 附加到此 GameObject 的 Transform。 |
hideFlags | Should the object be hidden, saved with the Scene or modifiable by the user? |
name | 对象的名称。 |
BroadcastMessage | 调用此游戏对象或其任何子项中的每个 MonoBehaviour 上名为 methodName 的方法。 |
CompareTag | 此游戏对象是否使用 tag 进行了标记? |
GetComponent | 如果游戏对象附加了类型为 type 的组件,则将其返回,否则返回 null。 |
GetComponentInChildren | 使用深度首次搜索返回 GameObject 或其任何子项中类型为 type 的组件。 |
GetComponentInParent | 返回 GameObject 或其任何父项中类型为 type 的组件。 |
GetComponents | 返回 GameObject 中类型为 type 的所有组件。 |
GetComponentsInChildren | 返回 GameObject 或其任何子项中类型为 type 的所有组件。 |
GetComponentsInParent | 返回 GameObject 或其任何父项中类型为 type 的所有组件。 |
SendMessage | 调用此游戏对象中的每个 MonoBehaviour 上名为 methodName 的方法。 |
SendMessageUpwards | 调用此游戏对象中的每个 MonoBehaviour 上或此行为的每个父级上名为 methodName 的方法。 |
GetInstanceID | 返回对象的实例 ID。 |
ToString | 返回 GameObject 的名称。 |
Destroy | 删除 GameObject、组件或资源。 |
DestroyImmediate | 立即销毁对象 /obj/。强烈建议您改用 Destroy。 |
DontDestroyOnLoad | Do not destroy the target Object when loading a new Scene. |
FindObjectOfType | 返回第一个类型为 type 的已加载的激活对象。 |
FindObjectsOfType | 返回所有类型为 type 的已加载的激活对象的列表。 |
Instantiate | 克隆 original 对象并返回克隆对象。 |
bool | 该对象是否存在? |
operator != | 比较两个对象是否引用不同的对象。 |
operator == | 比较两个对象引用,判断它们是否引用同一个对象。 |