https://github.com/paolobarbolini/img-parts

Low level crate for reading and writing Jpeg, Png and RIFF image containers
https://github.com/paolobarbolini/img-parts

exif hacktoberfest icc image jpeg png reader rust webp writer

Last synced: 14 days ago
JSON representation

Low level crate for reading and writing Jpeg, Png and RIFF image containers

• Host: GitHub
• URL: https://github.com/paolobarbolini/img-parts
• Owner: paolobarbolini
• License: apache-2.0
• Created: 2020-03-20T17:44:54.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2022-08-11T17:43:16.000Z (over 2 years ago)
• Last Synced: 2024-10-16T11:58:00.583Z (29 days ago)
• Topics: exif, hacktoberfest, icc, image, jpeg, png, reader, rust, webp, writer
• Language: Rust
• Homepage: https://crates.io/crates/img-parts
• Size: 867 KB
• Stars: 25
• Watchers: 4
• Forks: 6
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGES.md
  • License: LICENSE-APACHE

Awesome Lists containing this project

README

        
# img-parts

[![crates.io](https://img.shields.io/crates/v/img-parts.svg)](https://crates.io/crates/img-parts)

[![Documentation](https://docs.rs/img-parts/badge.svg)](https://docs.rs/img-parts)

[![dependency status](https://deps.rs/crate/img-parts/0.3.1/status.svg)](https://deps.rs/crate/img-parts/0.3.1)

[![Rustc Version 1.57.0+](https://img.shields.io/badge/rustc-1.57.0+-lightgray.svg)](https://blog.rust-lang.org/2021/12/02/Rust-1.57.0.html)

[![CI](https://github.com/paolobarbolini/img-parts/actions/workflows/ci.yml/badge.svg)](https://github.com/paolobarbolini/img-parts/actions/workflows/ci.yml)

The `img-parts` crate provides a low level API for reading and

writing containers from various image formats, and a high level

API for reading and writing raw ICC profiles and EXIF metadata.

It currently supports `Jpeg`, `Png` and `RIFF` (with some helper

functions for `WebP`).

More examples can be found in the `examples` directory on GitHub.

## Reading and writing raw ICCP and EXIF metadata

```rust,ignore

use std::fs::{self, File};

use img_parts::jpeg::Jpeg;

use img_parts::{ImageEXIF, ImageICC};

let input = fs::read("img.jpg")?;

let output = File::create("out.jpg")?;

let mut jpeg = Jpeg::from_bytes(input.into())?;

let icc_profile = jpeg.icc_profile();

let exif_metadata = jpeg.exif();

jpeg.set_icc_profile(Some(another_icc_profile.into()));

jpeg.set_exif(Some(new_exif_metadata.into()));

jpeg.encoder().write_to(output)?;

```

## Modifying chunks

```rust,no_run

use std::fs::{self, File};

use img_parts::jpeg::{markers, Jpeg, JpegSegment};

use img_parts::Bytes;

let input = fs::read("img.jpg")?;

let output = File::create("out.jpg")?;

let mut jpeg = Jpeg::from_bytes(input.into())?;

let comment = Bytes::from("Hello, I'm writing a comment!");

let comment_segment = JpegSegment::new_with_contents(markers::COM, comment);

jpeg.segments_mut().insert(1, comment_segment);

jpeg.encoder().write_to(output)?;

```

## License

Licensed under either of

 * Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or https://www.apache.org/licenses/LICENSE-2.0)

 * MIT license ([LICENSE-MIT](LICENSE-MIT) or https://opensource.org/license/MIT)

at your option.

### Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted

for inclusion in the work by you shall be dual licensed as above, without any

additional terms or conditions.