Struct ConstantQualityGifEncoder 

pub struct ConstantQualityGifEncoder { /* private fields */ }

Constant-quality GIF encoder.

Translates a floating-point quality value into concrete GifEncoderConfig parameters using a combination of quality tiers and, optionally, content- adaptive perceptual analysis.

Example

use oximedia_codec::gif::quality::{ConstantQualityConfig, ConstantQualityGifEncoder};

let cfg = ConstantQualityConfig::new(0.8).non_adaptive();
let enc = ConstantQualityGifEncoder::new(cfg).expect("valid quality");
let params = enc.resolve();
assert!(params.colors() >= 128);

Implementations

impl ConstantQualityGifEncoder

pub fn new(config: ConstantQualityConfig) -> CodecResult<Self>

Create a new constant-quality GIF encoder.

Errors

Returns CodecError::InvalidParameter when quality is outside [0.0, 1.0] or min_colors > max_colors.

pub fn resolve(&self) -> ResolvedGifParams

Resolve encoder parameters from quality alone (no content analysis).

pub fn resolve_with_metrics( &self, metrics: &PerceptualMetrics, ) -> ResolvedGifParams

Resolve encoder parameters using pre-computed PerceptualMetrics.

When config.content_adaptive is false this is identical to Self::resolve.

pub fn analyse_and_resolve( &self, rgba: &[u8], width: usize, height: usize, ) -> CodecResult<ResolvedGifParams>

Analyse an RGBA pixel buffer and resolve parameters content-adaptively.

Errors

Propagates errors from PerceptualMetrics::analyse.

pub fn tier(&self) -> QualityTier

Quality tier this encoder was created with.

Trait Implementations

impl Clone for ConstantQualityGifEncoder

fn clone(&self) -> ConstantQualityGifEncoder

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ConstantQualityGifEncoder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.