#resources #loader #compile-time #build #image #pxl #out-dir-resources

pxl-build

👷‍♀️ 用于与 pxl crate 一起使用的编译时资源加载器

1 个不稳定版本

使用旧的Rust 2015

0.0.9 2018年6月27日

#114#loader

CC0 许可证

17KB
389

pxl-build

pxl-build 是一个编译时资源加载器,旨在与 pxl 一起使用。

用法

添加一个名为 resources 的文件夹,并将你的资源放入其中,然后创建一个包含以下代码的 构建脚本

extern crate pxl_build;

fn main() -> Result<(), pxl_build::Error> {
  pxl_build::build("resources")
}

这将创建一个包含你的资源并在 $OUT_DIR/resources.rs 中使用的rust源文件,你可以在你的 pxl 程序中使用它,如下所示

extern crate pxl;

include!(concat!(env!("OUT_DIR"), "/resources.rs"));

你的资源将通过它们的文件名生成名称来提供。

例如,图像 resources/images/player.png 将在你的程序中以 images::PLAYER 的形式提供。

支持的资源类型

文件类型 扩展名 Rust类型 注释
二进制数据 .blob &[u8] 以字节切片形式公开的任意数据
PNG图像 .png pxl::图像<'static> 无损图像格式
JPEG图像 .jpg, .jpeg pxl::图像<'static> 有损图像格式

图像色彩空间

pxl 使用rust图像crate,该crate不公开色彩空间信息。图像像素数据将按其在磁盘上出现的方式加载,不涉及色彩空间、线性或伽玛校正。有关详细信息,请参阅问题 #79。

依赖关系

~16MB
~156K SLoC