本技能用于在 Bevy 中处理相机系统。资料指出,当一个视图需要渲染 2D 或 3D 时应加载本技能,其命名来源为 Camera、Camera2d、Camera3d 以及 two_passes 示例,库版本锁定为 0.20。
用途 相机用于提供可渲染的 2D 或 3D 视图。核心是 ECS 结构:Camera 代表视点(投影与渲染目标),Camera2d 启用 2D 图并需要 Camera、Projection、Frustum,Camera3d 启用主 3D 图并需要 Camera 与 Projection。3D 空间为右手系:X 向右、Y 向上、Z 向后,因此前方为 -Z。
主要能力
- 生成相机:示例使用 commands.spawn((Camera3d::default(), Transform::from_xyz(...).looking_at(Vec3::ZERO, Vec3::Y)))。第二个相机设置 Camera { order: 1, clear_color: ClearColorConfig::None, ..default() },以便叠加绘制而不清除。
- 查询:系统可使用 (&Camera, &GlobalTransform) 配合 With<Camera2d>;Camera::viewport_to_world_2d 可将视口位置映射到正交相机沿 Z 的 2D 世界位置。
- 调度:在 Startup 生成;跟随、分屏与 trauma 偏移作为自定义组件放在 Update 上。
- 跟随目标:通过 FollowTarget 与 FollowCam 组件,按 stiffness 进行插值并 look_at 目标。
- 分屏:使用 bevy::camera::Viewport 设置 physical_position 与 physical_size。
- 屏幕坐标转世界:使用 viewport_to_world_2d 配合 GlobalTransform。
- 镜头震动:通过 Trauma 组件随时间衰减并施加正弦偏移。 视图选择:活动视图使用带 Camera2d 或 Camera3d 的实体;相机姿态使用该实体上的 Transform;绘制顺序/叠加使用 Camera.order 与 ClearColorConfig::None;屏幕点到 2D 世界使用 viewport_to_world_2d 配合 GlobalTransform。
使用方式 依赖为 bevy = "0.20"。相机仍需要其渲染图:应生成 Camera2d 或 Camera3d,以便 Bevy 插入 CameraRenderGraph。纹理目标为相机实体上的 RenderTarget::Image 组件;分屏示例保留窗口目标并设置 Camera::viewport。状态所有权方面:单实体数据由 Component 拥有,可由一个系统通过 Query 修改,位于 Update 或 FixedMain;全应用单值由 Resource 拥有;生成本身由 Commands 负责;不能竞争的排序使用 .chain();插件边界由 Plugin 在 build 中注册系统与资源。
适用场景 适用于需要 2D/3D 视图渲染、相机跟随、分屏视口、屏幕坐标拾取、镜头震动等常见游戏相机需求。
限制 资料强调:不要在文档 URL 中固定 /0.20.0/;不要从两个无序系统可变查询同一组件;不要虚构物理、导航、网络或 XR crate;不要使用场景树相机节点类型;不要声称 Bevy 自带跟随、弹簧臂或震动组件;不要使用第三方相机 crate。资料未提供收费、价格、平台或效果等事实信息。