Struct EncodeRequest 

pub struct EncodeRequest<'a> { /* private fields */ }

An encoding request — binds config + image dimensions + pixel layout.

Created via LosslessConfig::encode_request or LossyConfig::encode_request.

Implementations

impl<'a> EncodeRequest<'a>

pub fn with_metadata(self, meta: &'a ImageMetadata<'a>) -> Self

Attach image metadata (ICC, EXIF, XMP).

pub fn with_limits(self, limits: &'a Limits) -> Self

Attach resource limits.

pub fn with_stop(self, stop: &'a dyn Stop) -> Self

Attach a cooperative cancellation token.

The encoder will check this periodically and return EncodeError::Cancelled if stopped.

pub fn encode(self, pixels: &[u8]) -> Result<Vec<u8>>

Encode pixels and return the JXL bytes.

pub fn encode_with_stats(self, pixels: &[u8]) -> Result<EncodeResult>

Encode pixels and return the JXL bytes together with EncodeStats.

pub fn encode_into( self, pixels: &[u8], out: &mut Vec<u8>, ) -> Result<EncodeResult>

Encode pixels, appending to an existing buffer. Returns metrics.

pub fn encode_to(self, pixels: &[u8], dest: impl Write) -> Result<EncodeResult>

Encode pixels, writing to a std::io::Write destination. Returns metrics.