tinyppm
Simple .ppm loader written in Rust.
This is more of a toy project, I have written, to be able to easy reuse it for some of my experiments with 2d graphics in Rust.
Usage
v.0.20.0 Note: This version introduces proper error handling. Earlier tinyppm
was a bit of pain as it exited when something unexpected happened (unrecognized header, unsupported color depth, non-existing/unreadable file specified...).
Currently tinyppm
returns an error in case some problem occurs. It is responsibility of the consumer to decide if this is critical or not, and take appropriate action.
Note: the above change will require some slight modification of code that relies on tinyppm 0.1.x
.
- Add
tinyppm
to yourCargo.toml
- Call
read_image_data
:
extern crate tinyppm;
The structure returned is defined as follows:
and it exposes 3 public methods:
Details:
-
only 'raw ppm' format is supported (the most popular format of ppm. More details: ppm format specification ).
-
tinyppm
supports only True Color images (i.e. 24bits per pixel - 3 color channels & 8 bits per channel). After the image is read it is converted to RGB+A format (32bpp) so that it is ready to be pushed directly to framebuffer.
Additional examples:
If you want to check how it works, please have a look at ppm_viewer
which is simple image viewer written in Rust: https://github.com/MaciekTalaska/2d_effects/tree/master/ppm_viewer
License
This code is released under the MIT license.