Crate image4

A no_std-friendly library for parsing and generation of Image4 images written in pure Rust.

This library is currently in EXPERIMENTAL state. It’s very likely that the API changes in the future.

Usage

This library is based on the der crate. Decoding and encoding is based on the Decode and Encode traits.

An Image4 file may be decoded as follows:

use image4::{der::Decode, ImageRef, Tag};

let bytes = include_bytes!("../tests/data/test.img4");
let image = ImageRef::from_der(bytes)?;

assert_eq!(image.payload().tag(), Tag::from_bytes(*b"TEST"));

Supported formats

The library supports the following formats:

• Full Image4 containers (IMG4) via the ImageRef and Image types;
• Image4 payload files (IM4P) via the PayloadRef and Payload types;
• Image4 manifest files (IM4M) via the ManifestRef and Manifest types.

Additionally the new payload properties format (PAYP) is supported via the PayloadPropsRef and PayloadProps types, though it likely isn’t stored as a separate file.

Features

• alloc: enables owned versions of reference types, alloc support in der and decoding of Image4 properties.
• std: implements std::error::Error trait on provided errors, enables std support in the der crate.
• payload: enables the payload module.
• manifest: enables the manifest module.
• restore_info: enables the restore_info module.
• image: enables the image module, requires payload, manifest and restore_info features.
• serde: implements (de)serialization for Image4 property lists. Useful for translating payload properties and manifest bodies to other formats and vice versa. Disabled by default.
• property: adds support for Image4 property lists (enables the property module). These are an implementation detail of the Image4 format and usually shouldn’t be used directly.

All features are enabled by default.

Re-exports

pub use image::Image;image and alloc

pub use image::ImageRef;image

pub use manifest::Manifest;manifest and alloc

pub use manifest::ManifestRef;manifest

pub use payload::Payload;payload and alloc

pub use payload::PayloadRef;payload

pub use restore_info::RestoreInfo;restore_info and alloc

pub use restore_info::RestoreInfoRef;restore_info

pub use der;

Modules

imageimage

Contains the ImageRef and Image types that represent an Image4 container (an IMG4 file).

manifestmanifest

Contains the ManifestRef, Manifest types that both represent a signed Image4 manifest, their unsigned counterparts and supporting types.

payloadpayload

Contains types used to parse and generate Image4 payload files (aka IM4P).

propertyproperty

Contains everything needed to implement Image4 properties parsing.

restore_inforestore_info

Contains the RestoreInfo type that represents Image4 restore info (an IM4R file).

Structs

Tag

A 4CC tag that is common in the Image4 format.

Type Aliases

Result

Result type.