4 releases (2 breaking)

0.3.2 Mar 20, 2020
0.3.1 Feb 17, 2020
0.3.0 Feb 17, 2020
0.2.0 Dec 17, 2019
0.1.0 Jun 4, 2019

#358 in Embedded development

Download history 119/week @ 2020-05-22 53/week @ 2020-05-29 76/week @ 2020-06-05 88/week @ 2020-06-12 66/week @ 2020-06-19 93/week @ 2020-06-26 51/week @ 2020-07-03 198/week @ 2020-07-10 113/week @ 2020-07-17 204/week @ 2020-07-24 274/week @ 2020-07-31 189/week @ 2020-08-07 386/week @ 2020-08-14 168/week @ 2020-08-21 156/week @ 2020-08-28 212/week @ 2020-09-04

684 downloads per month
Used in 10 crates (2 directly)

MIT/Apache

110KB
2K SLoC

TinyTGA

Build Status Crates.io Docs.rs

Documentation

A small TGA parser designed for embedded, no-std environments but usable anywhere. Beyond parsing the image header, no other allocations are made. A reference to the input image data is kept and slices are returned from it.

Call Tga.into_iter() to get an iterator over individual pixels in the image.

Example

use tinytga::{ImageType, Pixel, Tga, TgaFooter, TgaHeader};

// Include an image from a local path as bytes
let data = include_bytes!("../tests/chessboard_4px_rle.tga");

// Create a TGA instance from a byte slice
let img = Tga::from_slice(data).unwrap();

// Take a look at the header
assert_eq!(
    img.header,
    TgaHeader {
        id_len: 0,
        has_color_map: false,
        image_type: ImageType::RleTruecolor,
        color_map_start: 0,
        color_map_len: 0,
        color_map_depth: 0,
        x_origin: 0,
        y_origin: 4,
        width: 4,
        height: 4,
        pixel_depth: 24,
        image_descriptor: 32,
    }
);

// Take a look at the footer
assert_eq!(
    img.footer,
    Some(TgaFooter {
        extension_area_offset: 0,
        developer_directory_offset: 0
    })
);

// Collect pixels into a `Vec<Pixel>`
let pixels = img.into_iter().collect::<Vec<Pixel>>();

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~680KB
~14K SLoC