pxl-build

pxl-build is a compile-time resource loader, intended for use with pxl.

Usage

Add a folder called resources with your resources, and create a build script with the following code:

extern crate pxl_build;

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

This will create a rust source file containing your resources in $OUT_DIR/resources.rs, which can be used in your pxl program like so:

extern crate pxl;

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

Your resources will then available with names derived from their filenames.

For example, the image resources/images/player.png will be available in your program as images::PLAYER.

Supported Resource Types

Image Colorspace

pxl uses the rust image crate, which does not expose color space information. Image pixel data will be loaded as is appears on disk, without color space, linearity, or gamma correction. See issue #79 for details.