Repository files navigation

Support for additional image formats beyond those provided by theimage crate.

Call theregister function at program startup:

fnmain(){    image_extras::register();// Now you can use the image crate as normallet img = image::open("path/to/image.pcx").unwrap();}

By default, all supported formats are enabled. For finer control, enableindividual formats via Cargo features:

[dependencies]image_extras = {version ="0.1",features = ["pcx"],default-features =false }

By default,image-extras enables support for all included formats. This isconvenient for prototyping, but for other uses you are encouraged to evaluatethe individual implementations and enable only the ones that meet yourquality/robustness requirements.

We welcome PRs to add support for additional image formats.

• Must be one of the raster image formatsrecognized by ImageMagick.
• No patent or licensing restrictions.
• Specification or sufficiently detailed file format description freely available online.
• Must include multiple test images, and their source/license should be mentioned in the PR description.
• Implementation must be entirely in Rust.

• Minimal or no dependencies on external libraries.
• No use of unsafe code.

Fuzzing is not a priority for this crate and decoders may panic or worse onmalformed input. Please do not open issues for crashes found by fuzzing,unless they are memory safety violations, though PRs fixing them are welcome.

This is an intentional tradeoff to balance the inclusion criteria for newformats with maintainer time and effort.