网格具有一个alpha_mode，它确定网格材料以及所有相关材料（如子网格和网格轴）的alpha模式。
对于除AlphaMode::Opaque之外的其他alpha模式，应具有alpha值，以便产生可见效果。
网格的默认alpha模式是AlphaMode::Blend。

子网格

SubGrid组件会在添加到网格旁边时生成一个可配置的网格子网格。
它会在主网格的线条之间创建线条。

commands.spawn((
    Grid { /* ... */ },
    SubGrid {
        // Line count between each line of the main grid
        count: 4,
        // Line color
        color: Color::Srgba(tailwind::GRAY_500),
    },
    // Other components...
));

网格轴颜色覆盖

GridAxis组件允许为每个网格轴设置自定义颜色。

commands.spawn((
    Grid { /* ... */ },
    GridAxis {
        x: Some(Color::Srgba(tailwind::RED_500)),
        z: Some(Color::Srgba(tailwind::BLUE_500)),
        // Fills the remaining axis with None
        ..default()
    },
    // Other components...
));

跟踪网格

TrackedGrid使网格沿着给定的轴进行跟踪。
网格将随摄像机移动，并在一定距离处剪裁其材质，从而产生无限网格的错觉。

commands.spawn((
    Grid { /* ... */ },
    TrackedGrid {
        // This will track it as a "floor"
        alignment: GridAlignment::Y,
        // The offset along the Y axis
        offset: 0.0_f32,
    },
    // Other components...
));

网格的定制跟踪

追踪网格通过将它们物理移动到摄像机旁边和一些着色器技巧，给人一种无限的感觉。然而，当涉及多个摄像机时，这可能会成为一个问题，因为不知道应该跟踪哪个摄像机。

使用泛型进行自定义跟踪

要实现泛型自定义跟踪，世界中必须恰好有一个具有标记组件的实体，该组件希望被跟踪。`DebugGridPlugin`跟踪`Camera`，因为它是对`TrackedDebugGridPlugin::<Camera>`的类型别名的别名。

要跟踪除`Camera`之外的其他组件，请将`TrackedDebugGridPlugin::<T>`而不是`DebugGridPlugin`添加到您的应用程序中，其中`T`是要跟踪的组件。

示例

use bevy::prelude::*;
use bevy_debug_grid::*;

// Custom component to track grids
#[derive(Component)]
struct MainCamera;

// Spawns the main camera
fn spawn_main_camera(
    mut commands: Commands,
) {
    commands.spawn((
        Camera3dBundle::default(),
        MainCamera,
    ));
}

// Reads inputs to control the camera
fn control_main_camera(/* ... */) { /* ... */ }

fn main() {
    App::new()
        .add_plugins((
            DefaultPlugins,
            TrackedDebugGridPlugin::<MainCamera>::with_floor_grid(),
        ))
        .add_systems(Startup, spawn_main_camera)
        .add_systems(Update, control_main_camera)
        .run();
}

在上面的示例中，追踪网格现在将跟踪具有`MainCamera`组件的实体。

使用实体覆盖进行自定义跟踪

可以通过设置自定义实体覆盖来跟踪网格。

当渲染到渲染到纹理的不同摄像机时，这可能是必需的，可能在不同渲染层上。

此覆盖通过设置`TrackedGrid`的`tracking_override`来定义。

let entity = commands.spawn(
    // Component bundle...
).id(); // Get the Entity

commands.spawn((
    Grid { /* ... */ },
    TrackedGrid {
        // Set the entity as the tracking override
        tracking_override: Some(entity),
        ..default()
    },
    // Other components...
));

具有覆盖的追踪网格将不再跟踪到插件的泛型组件，而是跟随指定的实体。

如果实体被销毁，追踪网格将停止更新其位置。

渲染层

将`RenderLayers`组件添加到具有`Grid`的实体，将确保所有生成的网格网格也将包含相同的`RenderLayers`。

`RenderLayers`在更新网格属性时也参与更改检测。

已知错误和缺失功能

• 错误：删除`TrackedGrid`或`GridAxis`将不会正确更新其他组件。目前它只会中断。当前的解决方案是销毁实体。

兼容性

许可证

此插件可在以下任一许可证下使用

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