SuperAPI AI 工具集

bevy-3d-lighting

通用与其它

查看项目

更新于 10-16 12:42

技能介绍

用途:当 3D 场景需要太阳光、局部灯光或在摄像机上添加雾效时使用。材质仍由 bevy-3d-materials 负责;本技能只生成灯光实体,光照聚类与阴影提取由引擎负责。

主要能力:bevy::light 模块提供平行光、点光、聚光灯,以及光照探针、大气、体积光和阴影配置;对应 Cargo feature 为 bevy_light。PBR 相关类型包括 DirectionalLightViewEntities、ExtractedDirectionalLight、ExtractedPointLight、ExtractedRectLight、GpuClusteredLight(点、聚光或矩形)、DistanceFog、LightProbePlugin、ContactShadows。

灯光选择:太阳用 DirectionalLight 加 CascadeShadowConfig;局部全向光用 PointLight(intensity 单位为流明,range 单位为米);锥形光用 SpotLight 的 inner_angle 与 outer_angle(弧度);距离雾在摄像机实体上加 DistanceFog;局部基于图像的照明用 LightProbe 配合 EnvironmentMapLight 立方体贴图句柄。bevy_solari 是实验性光线追踪光照 Cargo feature,示例使用 bevy::light 中的光栅灯光。

使用方式:添加依赖 bevy = "0.20",在 Startup 或后续调度中用 Commands 生成灯光实体并插入相应组件,例如为太阳设置 CascadeShadowConfigBuilder 的 num_cascades、minimum_distance、first_cascade_far_bound、maximum_distance、overlap_proportion,以及 SunDisk 和 Transform 旋转。可用系统在 Update 中旋转太阳、按摄像机距离对 PointLight 排序并只对最近若干个启用 shadow_maps_enabled,实现最近光源阴影预算。

限制:本技能仅命名有文档的 Bevy crate 与模块,不得虚构物理、导航、网络或 XR crate;不要使用其他引擎的灯光节点类型;两个无序系统不得可变查询同一组件,需用 .chain() 排序或拆分;文档 URL 中不要固定 /0.20.0/。Bevy 版本目标为 0.20+。ecs-ownership.md 参考仅用于判断灯光值是组件还是资源,不用于材质制作。