Struct ColorConvertKernel 

pub struct ColorConvertKernel { /* private fields */ }

GPU-style color space conversion kernel (CPU simulation via Rayon).

All operations work on packed RGBA (4 bytes per pixel) buffers. The alpha channel is always passed through unchanged.

Implementations

impl ColorConvertKernel

pub fn new(standard: ColorStandard, range: RangeMode) -> Self

Create a new kernel with the given color standard and range mode.

pub fn standard(&self) -> ColorStandard

The color standard used by this kernel.

pub fn range(&self) -> RangeMode

The range mode used by this kernel.

pub fn rgb_to_yuv( src: &[u8], dst: &mut [u8], width: u32, height: u32, standard: ColorStandard, range: RangeMode, ) -> Result<BatchConvertStats, ColorKernelError>

Convert packed RGBA → packed YUVA (in-place style: src/dst separate).

The A channel is passed through unchanged.

Errors

Returns ColorKernelError if buffer lengths or dimensions are invalid.

pub fn matrix(&self) -> &ConversionMatrix

The cached ConversionMatrix for this kernel’s standard and range.

pub fn convert_rgb_to_yuv( &self, src: &[u8], dst: &mut [u8], width: u32, height: u32, ) -> Result<BatchConvertStats, ColorKernelError>

Instance method variant of rgb_to_yuv.

Uses the pre-built cached matrix rather than constructing a new one.

pub fn yuv_to_rgb( src: &[u8], dst: &mut [u8], width: u32, height: u32, standard: ColorStandard, range: RangeMode, ) -> Result<BatchConvertStats, ColorKernelError>

Convert packed YUVA → packed RGBA.

The A channel is passed through unchanged.

Errors

Returns ColorKernelError if buffer lengths or dimensions are invalid.

pub fn convert_yuv_to_rgb( &self, src: &[u8], dst: &mut [u8], width: u32, height: u32, ) -> Result<BatchConvertStats, ColorKernelError>

Instance method variant of yuv_to_rgb.

Uses the pre-built cached matrix rather than constructing a new one.

pub fn expand_limited_to_full( src: &[u8], dst: &mut [u8], width: u32, height: u32, ) -> Result<BatchConvertStats, ColorKernelError>

Expand a limited-range (studio swing) packed RGBA buffer to full range.

Y channel: [16, 235] → [0, 255]. Cb/Cr channels: [16, 240] → [0, 255].

Errors

Returns ColorKernelError on dimension or size mismatch.

pub fn compress_full_to_limited( src: &[u8], dst: &mut [u8], width: u32, height: u32, ) -> Result<BatchConvertStats, ColorKernelError>

Compress a full-range packed YUVA buffer to limited (studio swing) range.

Y channel: [0, 255] → [16, 235]. Cb/Cr channels: [0, 255] → [16, 240].

Errors

Returns ColorKernelError on dimension or size mismatch.

pub fn rgba_to_planar_yuv444( src: &[u8], width: u32, height: u32, standard: ColorStandard, range: RangeMode, ) -> Result<(Vec<u8>, Vec<u8>, Vec<u8>), ColorKernelError>

Convert packed RGBA to planar YUV 4:4:4 (separate Y, Cb, Cr planes).

Returns (Y_plane, Cb_plane, Cr_plane), each width * height bytes.

Errors

Returns ColorKernelError on dimension or size mismatch.

pub fn planar_yuv444_to_rgba( y_plane: &[u8], cb_plane: &[u8], cr_plane: &[u8], width: u32, height: u32, standard: ColorStandard, range: RangeMode, ) -> Result<Vec<u8>, ColorKernelError>

Convert planar YUV 4:4:4 to packed RGBA.

Alpha channel is set to 255.

Errors

Returns ColorKernelError if any plane size or dimensions are invalid.

Trait Implementations

impl Clone for ColorConvertKernel

fn clone(&self) -> ColorConvertKernel

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ColorConvertKernel

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

Formats the value using the given formatter.