#png #gif #jpeg #image #bmp #load-image #format

stb_image_rust

Rust port of the stb_image

3 stable releases

Uses old Rust 2015

2.27.2 Jan 6, 2022
2.27.1 Jan 3, 2022
2.27.0 Jan 1, 2022

#388 in Images

Download history 10/week @ 2024-01-08 7/week @ 2024-01-22 4/week @ 2024-02-12 19/week @ 2024-02-19 30/week @ 2024-02-26 15/week @ 2024-03-04 23/week @ 2024-03-11 16/week @ 2024-03-18 22/week @ 2024-03-25 60/week @ 2024-04-01 10/week @ 2024-04-08 14/week @ 2024-04-15

107 downloads per month
Used in 3 crates

Unlicense

305KB
8K SLoC

About

stb_image_rust is Rust port of the stb_image.h, which is C library to load images in JPG, PNG, BMP, TGA, PSD and GIF formats.

It is important to note, that this project is port, not wrapper. Original C code had been ported to Rust. Therefore stb_image_rust doesnt require any native binaries.

The porting hasn't been done by hand, but using Hebron.

Crate

https://crates.io/crates/stb_image_rust

Sample Code

        // Load file into memory
        let mut f = File::open(path).expect("file not found");
        let mut contents = vec![];
        f.read_to_end(&mut contents);

	// Load the image
        let mut x: i32 = 0;
        let mut y: i32 = 0;
        let mut comp: i32 = 0;
        let img: *mut u8;
		
        unsafe {
            img = stb_image_rust::stbi_load_from_memory(
                contents.as_mut_ptr(),
                contents.len() as i32,
                &mut x,
                &mut y,
                &mut comp,
                stb_image_rust::STBI_rgb_alpha,
            );
        }
		
	// Do something with it
	...
		
	// Free the allocated memory
        unsafe {
            stb_image_rust::c_runtime::free(img);
        }		

License

Public Domain

No runtime deps