bevy_debug_lines

提供简单线条绘制 API 的 bevy 插件。

点击上面的演示来播放。

主分支没有稳定性保证。

关于

此插件使用着色器并将单个点发送到 GPU，然后通过移动几何体来绘制线条。对于大量线条来说，这相当快，并且移动线条没有额外的成本。

用法

将 bevy_prototype_debug_lines 添加到您的 Cargo.toml

[dependencies]
bevy_prototype_debug_lines = "0.12"
# Or, for 3d:
# bevy_prototype_debug_lines = { version = "0.12", features = ["3d"] }

在 App:: 阶段中添加插件

use bevy::prelude::*;
use bevy_prototype_debug_lines::*;

fn main() {
    App::new()
        .add_plugins(DefaultPlugins)
        .add_plugins(DebugLinesPlugin::default())
//      ...
        .run();
}

使用 DebugLines 资源在您拥有的任何系统中绘制线条

fn some_system(
//  ...
    mut lines: ResMut<DebugLines>,
) {
    let start = Vec3::splat(-1.0);
    let end = Vec3::splat(1.0);
    let duration = 0.0;     // Duration of 0 will show the line for 1 frame.
    lines.line(start, end, duration);
}

使用 DebugLinesPlugin:: 方法更改深度测试（通过几何体绘制线条而不是始终在顶部）

use bevy::prelude::*;
use bevy_prototype_debug_lines::*;

fn main() {
    App::new()
    .add_plugins(DefaultPlugins)
    .add_plugins(DebugLinesPlugin::with_depth_test(true))
//  ...
    .run();
}

请参阅 示例 以获取更完整的用法示例。

故障排除

线条不显示

问题：即使在添加了 DebugLinesPlugin 并使用 DebugLines::lines 后，线条仍然不会显示在屏幕上。

解决方案：检查 bevy_debug_lines 的维度功能，在运行游戏时，应该会有一个类似以下日志消息：

INFO bevy_prototype_debug_lines: Loaded 2d debug lines plugin.

请注意 Loaded 2d debug，这应该与你在游戏中使用的匹配。这是3D游戏吗？如果是，你应该将 bevy_prototype_debug_lines/3d 功能标志添加到你的 Cargo.toml 中。它看起来应该是这样的：

bevy_prototype_debug_lines = { version = "0.12", features = ["3d"] }

运行示例

你可以这样运行示例

cargo run --example 3d --features="example_deps"

其中 3d 是 示例 中的一个文件。

0.3.0 版本中的更改

在 0.3.0 中，已经删除了 thickness 参数。我认为它对性能、时间或问题的影响不大。但是，如果你有不同的看法，请在 此问题 中告诉我。