Lib.rs

extol_sprite_layer 允许您使用单独的组件来指定 Bevy 游戏中精灵的绘制顺序，而不是通过变换的z坐标。

如何使用

use bevy::prelude::*;
use extol_sprite_layer::{LayerIndex, SpriteLayerPlugin, SpriteLayerOptions};

// Define a type to represent your layers. All the traits here other than Copy
// are mandatory.
#[derive(Debug, Copy, Clone, Component, PartialEq, Eq, Hash)]
enum SpriteLayer {
    Background,
    Object,
    Enemy,
    Player,
    Ui,
}

impl LayerIndex for SpriteLayer {
    // Convert your type to an actual z-coordinate.
    fn as_z_coordinate(&self) -> f32 {
        use SpriteLayer::*;
        match *self {
            // Note that the z-coordinates must be at least 1 apart...
            Background => 0.,
            Object => 1.,
            Enemy => 2.,
            // ... but can be more than that.
            Player => 990.,
            Ui => 995.
        }
    }
}

let mut app = App::new();
// Then, add the plugin to your app.
app
  .add_plugins(DefaultPlugins)
  .add_plugins(SpriteLayerPlugin::<SpriteLayer>::default());

// Now just use SpriteLayer as a component and don't set the z-component on any
// of your transforms.

// To disable y-sorting, do
app.insert_resource(SpriteLayerOptions { y_sort: false });

注意事项

总的来说，它执行以下操作

1. 在 Last 调度中，它为具有层的每个实体（及其后代）在 GlobalTransform 上设置z坐标（而不是 Transform）
2. 在 First 调度中，它重新将它们的 GlobalTransform 的z坐标重置为零。
3. 在这两种情况下，它都会 跳过变更检测。

这是因为子应用都在您的应用程序的主 Main 调度之后运行。

这很丑陋，可能会以微妙的方式破坏事物，但它具有以下属性

• 精灵层可以继承
• 您的应用程序代码可以计算距离，而无需截断位移的z坐标（如果您不将z坐标重置为零，您就必须这样做）

动机

当在 bevy 中制作2D游戏时，z坐标实际上被用作层索引：z坐标较高的东西被渲染在z坐标较低的东西之上。这很有效，但也有一些问题

z坐标对于距离或归一化等事物并不相关。下面的代码有细微的错误

use bevy::prelude::*;

/// Get a unit vector pointing from the position of `source` to `target`, or
/// zero if they're close.
fn get_normal_direction(query: Query<&GlobalTransform>, source: Entity, target: Entity) -> Vec2 {
    let from_pos = query.get(source).unwrap().translation();
    let to_pos = query.get(target).unwrap().translation();
    (from_pos - to_pos).normalize_or_zero().truncate()
}

错误在于我们在截断之前进行归一化，因此z坐标仍然“计算”长度。所以如果源在 (0, 0, 0) 和目标在 (0, 1, 100)，那么我们将返回 (0, 0.001)！