Struct ConvertPlan 

pub struct ConvertPlan { /* private fields */ }

Pre-computed conversion plan.

Stores the chain of steps needed to convert from one format to another. Created once, applied to every row.

Implementations

impl ConvertPlan

pub fn new( from: PixelDescriptor, to: PixelDescriptor, ) -> Result<Self, At<ConvertError>>

Create a conversion plan from from to to.

Returns Err if no conversion path exists.

pub fn new_explicit( from: PixelDescriptor, to: PixelDescriptor, options: &ConvertOptions, ) -> Result<Self, At<ConvertError>>

Create a conversion plan with explicit policy enforcement.

Validates that the planned conversion steps are allowed by the given policies before creating the plan. Returns an error if a forbidden operation would be required.

pub fn compose(&self, other: &Self) -> Option<Self>

Compose two plans into one: apply self then other.

The composed plan executes both conversions in a single convert_row call, using one intermediate buffer instead of two. Adjacent inverse steps are cancelled (e.g., SrgbU8ToLinearF32 + LinearF32ToSrgbU8 → identity).

Returns None if self.to != other.from (incompatible plans).

pub fn is_identity(&self) -> bool

True if conversion is a no-op.

pub fn from(&self) -> PixelDescriptor

Source descriptor.

pub fn to(&self) -> PixelDescriptor

Target descriptor.

Trait Implementations

impl Clone for ConvertPlan

fn clone(&self) -> ConvertPlan

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ConvertPlan

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

Formats the value using the given formatter.