bevy_mod_billboard

为bevy提供Billboard文本和纹理支持

待办事项

• 添加文档
• 遵循Rust API指南：https://rust-lang.github.io/api-guidelines/about.html
• 批处理

功能

• 具有多种字体的样式文本。
• 纹理。
• 启用/禁用深度裁剪（默认启用）。
• Y轴锁定（默认禁用）。
• 全旋转锁定，用于类似3D世界空间文本的内容（@robftm）
• HDR支持（@robtfm）

Bevy兼容性

示例

设置

use bevy_mod_billboard::prelude::*;

App::new()
    .add_plugins((DefaultPlugins, BillboardPlugin));

文本

commands.spawn(BillboardTextBundle {
    transform: Transform::from_translation(Vec3::new(0., 2., 0.))
        .with_scale(Vec3::splat(0.0085)),
    text: Text::from_sections([
        TextSection {
            value: "IMPORTANT".to_string(),
            style: TextStyle {
                font_size: 60.0,
                font: fira_sans_regular_handle.clone(),
                color: Color::ORANGE,
            }
        },
        TextSection {
            value: " text".to_string(),
            style: TextStyle {
                font_size: 60.0,
                font: fira_sans_regular_handle.clone(),
                color: Color::WHITE,
            }
        }
    ]).with_alignment(TextAlignment::CENTER),
    ..default()
});

纹理

commands.spawn(BillboardTextureBundle {
    transform: Transform::from_translation(Vec3::new(0., 5., 0.)),
    texture: BillboardTextureHandle(handle.clone()),
    mesh: BillboardMeshHandle(meshes.add(Quad::new(Vec2::new(4.0, 4.0)).into()).into()),
    ..default()
});

完整示例请参阅示例。

变更日志

[0.7.0] - 2024-07-11

• 升级到Bevy 0.14（@interwhy）。
• 添加Billboard标记组件。

[0.6.0] - 2024-06-09

• 升级到Bevy 0.13（@RobWalt）。
• 启用bevy的wayland & X11功能。

[0.5.1] - 2023-12-05

• 修复Billboard传播不工作的问题。

[0.5.0] - 2023-12-04

• 升级到Bevy 0.12（@robftm）。
• 移除纹理数组实现。
• 使用1:N游戏世界 -> 渲染世界映射。
• 移除资产类型BillboardTexture。
• 添加BillboardTextureHandle包装器。
• 减少内存使用。
• 提高最常用文本情况的性能。
• 添加stress_test示例（@alice-i-cecile）。
• 将旋转相机添加到大多数示例中，以更好地展示。

许可证

根据您的选择，许可协议为

• Apache许可证版本2.0（LICENSE-APACHE 或 https://apache.ac.cn/licenses/LICENSE-2.0）
• MIT许可证（LICENSE-MIT 或 http://opensource.org/licenses/MIT）

。

贡献

除非您明确声明，否则您提交的任何贡献，根据Apache-2.0许可证定义，都将按上述方式双重许可，不附加任何额外条款或条件。