Struct EncodeOptions 

pub struct EncodeOptions {

    pub num_decomposition_levels: u8,
    pub reversible: bool,
    pub code_block_width_exp: u8,
    pub code_block_height_exp: u8,
    pub guard_bits: u8,
    pub use_ht_block_coding: bool,
    pub progression_order: EncodeProgressionOrder,
    pub write_tlm: bool,
    pub write_plt: bool,
    pub write_plm: bool,
    pub write_sop: bool,
    pub write_eph: bool,
    pub use_mct: bool,
    pub num_layers: u8,
    pub quality_layer_byte_targets: Vec<u64>,
    pub validate_high_throughput_codestream: bool,
    pub irreversible_quantization_scale: f32,
    pub irreversible_quantization_subband_scales: IrreversibleQuantizationSubbandScales,
    pub component_sampling: Option<Vec<(u8, u8)>>,
    pub tile_size: Option<(u32, u32)>,
    pub precinct_exponents: Vec<(u8, u8)>,
}

Encoding options for JPEG 2000.

Fields

num_decomposition_levels: u8

Number of decomposition levels (default: 5).

reversible: bool

Use reversible (lossless) transform (default: true).

code_block_width_exp: u8

Code-block width exponent minus 2 (default: 4, meaning 2^6=64).

code_block_height_exp: u8

Code-block height exponent minus 2 (default: 4, meaning 2^6=64).

guard_bits: u8

Number of guard bits (default: 1 for reversible, 2 for irreversible).

use_ht_block_coding: bool

Encode using HT block coding (HTJ2K / Part 15) instead of classic EBCOT.

progression_order: EncodeProgressionOrder

Packet progression order to write in COD and use for packetization.

write_tlm: bool

Write a TLM marker segment for the single tile-part.

write_plt: bool

Write PLT packet-length marker segments in the tile-part header.

write_plm: bool

Write PLM packet-length marker segments in the main header.

write_sop: bool

Write SOP marker segments before packets.

write_eph: bool

Write EPH markers after packet headers.

use_mct: bool

Apply the JPEG 2000 multi-component color transform for 3+ component inputs.

num_layers: u8

Number of cumulative quality layers to emit.

quality_layer_byte_targets: Vec<u64>

Optional cumulative packet-body byte targets for each quality layer.

validate_high_throughput_codestream: bool

Decode and verify HTJ2K codestreams inside the native encoder.

irreversible_quantization_scale: f32

Multiplier applied to irreversible 9/7 scalar quantization step sizes.

1.0 preserves the near-lossless default step sizes. Larger values produce smaller codestreams by coarsening quantization.

irreversible_quantization_subband_scales: IrreversibleQuantizationSubbandScales

Per-subband multipliers applied on top of irreversible_quantization_scale.

component_sampling: Option<Vec<(u8, u8)>>

Optional per-component SIZ sampling factors (XRsiz, YRsiz).

None means every component is stored at the reference-grid resolution. This is experimental and primarily intended for precomputed coefficient encoders that preserve JPEG-native chroma subsampling.

tile_size: Option<(u32, u32)>

Optional tile width and height for multi-tile codestream output.

precinct_exponents: Vec<(u8, u8)>

Optional precinct exponents in COD order, one per resolution level.

Trait Implementations

impl Clone for EncodeOptions

fn clone(&self) -> EncodeOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EncodeOptions

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

Formats the value using the given formatter.

impl Default for EncodeOptions

fn default() -> EncodeOptions

Returns the “default value” for a type.