https://github.com/imageoptim/mozjpeg-rust
Safe Rust wrapper for the MozJPEG library
https://github.com/imageoptim/mozjpeg-rust
libjpeg-turbo rust-bindings
Last synced: about 1 month ago
JSON representation
Safe Rust wrapper for the MozJPEG library
- Host: GitHub
- URL: https://github.com/imageoptim/mozjpeg-rust
- Owner: ImageOptim
- License: other
- Created: 2018-02-12T06:24:58.000Z (over 7 years ago)
- Default Branch: main
- Last Pushed: 2024-03-25T23:07:41.000Z (about 1 year ago)
- Last Synced: 2024-04-14T13:51:51.555Z (about 1 year ago)
- Topics: libjpeg-turbo, rust-bindings
- Language: Rust
- Homepage: https://lib.rs/mozjpeg
- Size: 751 KB
- Stars: 71
- Watchers: 7
- Forks: 18
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Rust wrapper for MozJPEG library
This library adds a safe(r) interface on top of libjpeg-turbo and MozJPEG for reading and writing well-compressed JPEG images.
The interface is still being developed, so it has rough edges and may change.
In particular, error handling is weird due to libjpeg's peculiar design. Error handling can't use `Result`, but needs to depend on Rust's `resume_unwind` (a panic, basically) to signal any errors in libjpeg. It's necessary to wrap all uses of this library in `catch_unwind`.
In crates compiled with `panic=abort` setting, any JPEG error will abort the process.
## Decoding example
```rust
std::panic::catch_unwind(|| -> std::io::Result>> {
let d = mozjpeg::Decompress::with_markers(mozjpeg::ALL_MARKERS)
.from_path("tests/test.jpg")?;
d.width(); // FYI
d.height();
d.color_space() == mozjpeg::ColorSpace::JCS_YCbCr;
for marker in d.markers() { /* read metadata or color profiles */ }
// rgb() enables conversion
let mut image = d.rgb()?;
image.width();
image.height();
image.color_space() == mozjpeg::ColorSpace::JCS_RGB;
let pixels = image.read_scanlines()?;
image.finish()?;
Ok(pixels)
});
```
## Encoding example
```rust
# let width = 8; let height = 8;
std::panic::catch_unwind(|| -> std::io::Result> {
let mut comp = mozjpeg::Compress::new(mozjpeg::ColorSpace::JCS_RGB);
comp.set_size(width, height);
let mut comp = comp.start_compress(Vec::new())?; // any io::Write will work
// replace with your image data
let pixels = vec![0u8; width * height * 3];
comp.write_scanlines(&pixels[..])?;
let writer = comp.finish()?;
Ok(writer)
});
```