yuv 0.8.13

High performance utilities for YUV format handling and conversion.
Documentation
/*
 * Copyright (c) Radzivon Bartoshyk, 1/2025. All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without modification,
 * are permitted provided that the following conditions are met:
 *
 * 1.  Redistributions of source code must retain the above copyright notice, this
 * list of conditions and the following disclaimer.
 *
 * 2.  Redistributions in binary form must reproduce the above copyright notice,
 * this list of conditions and the following disclaimer in the documentation
 * and/or other materials provided with the distribution.
 *
 * 3.  Neither the name of the copyright holder nor the names of its
 * contributors may be used to endorse or promote products derived from
 * this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */
use crate::internals::ProcessedOffset;
use crate::neon::utils::*;
use crate::yuv_support::{
    CbCrForwardTransform, YuvChromaRange, YuvChromaSubsampling, YuvNVOrder, YuvSourceChannels,
};
use std::arch::aarch64::*;

#[inline(always)]
unsafe fn encode_16_part_prof<const ORIGIN_CHANNELS: u8, const UV_ORDER: u8, const SAMPLING: u8>(
    src: &[u8],
    y_dst: &mut [u8],
    uv_dst: &mut [u8],
    y_bias: int32x4_t,
    uv_bias: int32x4_t,
    v_weights: int16x8_t,
    v_cr_b: int16x8_t,
) {
    let order: YuvNVOrder = UV_ORDER.into();
    const PRECISION: i32 = 16;
    let chroma_subsampling: YuvChromaSubsampling = SAMPLING.into();
    let (r_values_u8, g_values_u8, b_values_u8) =
        neon_vld_rgb_for_yuv::<ORIGIN_CHANNELS>(src.as_ptr());

    let r_high = vreinterpretq_s16_u16(vmovl_high_u8(r_values_u8));
    let g_high = vreinterpretq_s16_u16(vmovl_high_u8(g_values_u8));
    let b_high = vreinterpretq_s16_u16(vmovl_high_u8(b_values_u8));

    let r_h_low = vget_low_s16(r_high);
    let g_h_low = vget_low_s16(g_high);
    let b_h_low = vget_low_s16(b_high);

    let y_high = vreinterpretq_u16_s16(vqddotl_laneq_s16_x3::<PRECISION, 0, 1, 2>(
        y_bias, r_high, g_high, b_high, v_weights,
    ));

    let r_low = vreinterpretq_s16_u16(vmovl_u8(vget_low_u8(r_values_u8)));
    let g_low = vreinterpretq_s16_u16(vmovl_u8(vget_low_u8(g_values_u8)));
    let b_low = vreinterpretq_s16_u16(vmovl_u8(vget_low_u8(b_values_u8)));

    let r_l_low = vget_low_s16(r_low);
    let g_l_low = vget_low_s16(g_low);
    let b_l_low = vget_low_s16(b_low);

    let y_low = vreinterpretq_u16_s16(vqddotl_laneq_s16_x3::<PRECISION, 0, 1, 2>(
        y_bias, r_low, g_low, b_low, v_weights,
    ));

    if chroma_subsampling == YuvChromaSubsampling::Yuv444 {
        let mut cb_h_high = vqdmlal_high_laneq_s16::<3>(uv_bias, r_high, v_weights);
        let mut cb_h_low = vqdmlal_laneq_s16::<3>(uv_bias, r_h_low, v_weights);
        let mut cr_h_high = vqdmlal_high_laneq_s16::<6>(uv_bias, r_high, v_weights);
        let mut cr_h_low = vqdmlal_laneq_s16::<6>(uv_bias, r_h_low, v_weights);
        let mut cb_l_high = vqdmlal_high_laneq_s16::<3>(uv_bias, r_low, v_weights);
        let mut cb_l_low = vqdmlal_laneq_s16::<3>(uv_bias, r_l_low, v_weights);
        let mut cr_l_high = vqdmlal_high_laneq_s16::<6>(uv_bias, r_low, v_weights);
        let mut cr_l_low = vqdmlal_laneq_s16::<6>(uv_bias, r_l_low, v_weights);

        cb_h_high = vqdmlal_high_laneq_s16::<4>(cb_h_high, g_high, v_weights);
        cb_h_low = vqdmlal_laneq_s16::<4>(cb_h_low, g_h_low, v_weights);
        cr_h_high = vqdmlal_high_laneq_s16::<7>(cr_h_high, g_high, v_weights);
        cr_h_low = vqdmlal_laneq_s16::<7>(cr_h_low, g_h_low, v_weights);
        cb_l_high = vqdmlal_high_laneq_s16::<4>(cb_l_high, g_low, v_weights);
        cb_l_low = vqdmlal_laneq_s16::<4>(cb_l_low, g_l_low, v_weights);
        cr_l_high = vqdmlal_high_laneq_s16::<7>(cr_l_high, g_low, v_weights);
        cr_l_low = vqdmlal_laneq_s16::<7>(cr_l_low, g_l_low, v_weights);

        cb_h_high = vqdmlal_high_laneq_s16::<5>(cb_h_high, b_high, v_weights);
        cb_h_low = vqdmlal_laneq_s16::<5>(cb_h_low, b_h_low, v_weights);
        cr_h_high = vqdmlal_high_laneq_s16::<0>(cr_h_high, b_high, v_cr_b);
        cr_h_low = vqdmlal_laneq_s16::<0>(cr_h_low, b_h_low, v_cr_b);
        cb_l_high = vqdmlal_high_laneq_s16::<5>(cb_l_high, b_low, v_weights);
        cb_l_low = vqdmlal_laneq_s16::<5>(cb_l_low, b_l_low, v_weights);
        cr_l_high = vqdmlal_high_laneq_s16::<0>(cr_l_high, b_low, v_cr_b);
        cr_l_low = vqdmlal_laneq_s16::<0>(cr_l_low, b_l_low, v_cr_b);

        let cb_high = vreinterpretq_u16_s16(vcombine_s16(
            vshrn_n_s32::<PRECISION>(cb_h_low),
            vshrn_n_s32::<PRECISION>(cb_h_high),
        ));

        let cr_high = vreinterpretq_u16_s16(vcombine_s16(
            vshrn_n_s32::<PRECISION>(cr_h_low),
            vshrn_n_s32::<PRECISION>(cr_h_high),
        ));

        let cb_low = vreinterpretq_u16_s16(vcombine_s16(
            vshrn_n_s32::<PRECISION>(cb_l_low),
            vshrn_n_s32::<PRECISION>(cb_l_high),
        ));

        let cr_low = vreinterpretq_u16_s16(vcombine_s16(
            vshrn_n_s32::<PRECISION>(cr_l_low),
            vshrn_n_s32::<PRECISION>(cr_l_high),
        ));
        let mut cb = vcombine_u8(vmovn_u16(cb_low), vmovn_u16(cb_high));
        let mut cr = vcombine_u8(vmovn_u16(cr_low), vmovn_u16(cr_high));

        if order == YuvNVOrder::VU {
            std::mem::swap(&mut cb, &mut cr);
        }

        vst2q_u8(uv_dst.as_mut_ptr(), uint8x16x2_t(cb, cr));
    } else if chroma_subsampling == YuvChromaSubsampling::Yuv422
        || (chroma_subsampling == YuvChromaSubsampling::Yuv420)
    {
        let rlv = vpaddlq_u8(r_values_u8);
        let glv = vpaddlq_u8(g_values_u8);
        let blv = vpaddlq_u8(b_values_u8);
        let r1 = vreinterpretq_s16_u16(vrshrq_n_u16::<1>(rlv));
        let g1 = vreinterpretq_s16_u16(vrshrq_n_u16::<1>(glv));
        let b1 = vreinterpretq_s16_u16(vrshrq_n_u16::<1>(blv));

        let mut cb_h = vqdmlal_high_laneq_s16::<3>(uv_bias, r1, v_weights);
        let mut cb_l = vqdmlal_laneq_s16::<3>(uv_bias, vget_low_s16(r1), v_weights);
        let mut cr_h = vqdmlal_high_laneq_s16::<6>(uv_bias, r1, v_weights);
        let mut cr_l = vqdmlal_laneq_s16::<6>(uv_bias, vget_low_s16(r1), v_weights);

        cb_h = vqdmlal_high_laneq_s16::<4>(cb_h, g1, v_weights);
        cb_l = vqdmlal_laneq_s16::<4>(cb_l, vget_low_s16(g1), v_weights);
        cr_h = vqdmlal_high_laneq_s16::<7>(cr_h, g1, v_weights);
        cr_l = vqdmlal_laneq_s16::<7>(cr_l, vget_low_s16(g1), v_weights);

        cb_h = vqdmlal_high_laneq_s16::<5>(cb_h, b1, v_weights);
        cb_l = vqdmlal_laneq_s16::<5>(cb_l, vget_low_s16(b1), v_weights);
        cr_h = vqdmlal_high_laneq_s16::<0>(cr_h, b1, v_cr_b);
        cr_l = vqdmlal_laneq_s16::<0>(cr_l, vget_low_s16(b1), v_cr_b);

        let cb_l = vqshrn_n_s32::<PRECISION>(cb_l);
        let cb_h = vqshrn_n_s32::<PRECISION>(cb_h);
        let cr_l = vqshrn_n_s32::<PRECISION>(cr_l);
        let cr_h = vqshrn_n_s32::<PRECISION>(cr_h);

        let mut cb = vmovn_u16(vreinterpretq_u16_s16(vcombine_s16(cb_l, cb_h)));
        let mut cr = vmovn_u16(vreinterpretq_u16_s16(vcombine_s16(cr_l, cr_h)));

        if order == YuvNVOrder::VU {
            std::mem::swap(&mut cb, &mut cr);
        }

        vst2_u8(uv_dst.as_mut_ptr(), uint8x8x2_t(cb, cr));
    }

    let y = vcombine_u8(vmovn_u16(y_low), vmovn_u16(y_high));
    vst1q_u8(y_dst.as_mut_ptr(), y);
}

pub(crate) unsafe fn neon_rgba_to_nv_prof<
    const ORIGIN_CHANNELS: u8,
    const UV_ORDER: u8,
    const SAMPLING: u8,
>(
    y_plane: &mut [u8],
    uv_plane: &mut [u8],
    rgba: &[u8],
    width: u32,
    range: &YuvChromaRange,
    transform: &CbCrForwardTransform<i32>,
    start_cx: usize,
    start_ux: usize,
) -> ProcessedOffset {
    let chroma_subsampling: YuvChromaSubsampling = SAMPLING.into();
    let source_channels: YuvSourceChannels = ORIGIN_CHANNELS.into();
    let channels = source_channels.get_channels_count();

    const PRECISION: i32 = 16;

    let rounding_const_bias: i32 = (1 << (PRECISION - 1)) - 1;
    let bias_y = range.bias_y as i32 * (1 << PRECISION) + rounding_const_bias;
    let bias_uv = range.bias_uv as i32 * (1 << PRECISION) + rounding_const_bias;

    let y_bias = vdupq_n_s32(bias_y);
    let uv_bias = vdupq_n_s32(bias_uv);

    let weights_arr: [i16; 8] = [
        transform.yr as i16,
        transform.yg as i16,
        transform.yb as i16,
        transform.cb_r as i16,
        transform.cb_g as i16,
        transform.cb_b as i16,
        transform.cr_r as i16,
        transform.cr_g as i16,
    ];
    let v_weights = vld1q_s16(weights_arr.as_ptr());
    let v_cr_b = vdupq_n_s16(transform.cr_b as i16);

    let mut cx = start_cx;
    let mut ux = start_ux;

    while cx + 16 <= width as usize {
        encode_16_part_prof::<ORIGIN_CHANNELS, UV_ORDER, SAMPLING>(
            rgba.get_unchecked(cx * channels..),
            y_plane.get_unchecked_mut(cx..),
            uv_plane.get_unchecked_mut(ux..),
            y_bias,
            uv_bias,
            v_weights,
            v_cr_b,
        );

        if chroma_subsampling == YuvChromaSubsampling::Yuv444 {
            ux += 32;
        } else if chroma_subsampling == YuvChromaSubsampling::Yuv422
            || (chroma_subsampling == YuvChromaSubsampling::Yuv420)
        {
            ux += 16;
        }

        cx += 16;
    }

    if cx < width as usize {
        let diff = width as usize - cx;
        assert!(diff <= 16);
        let mut src_buffer: [u8; 16 * 4] = [0; 16 * 4];
        let mut y_buffer: [u8; 16] = [0; 16];
        let mut uv_buffer: [u8; 16 * 2] = [0; 16 * 2];

        // Replicate last item to one more position for subsampling
        if chroma_subsampling != YuvChromaSubsampling::Yuv444 && diff % 2 != 0 {
            let lst = (width as usize - 1) * channels;
            let last_items = rgba.get_unchecked(lst..(lst + channels));
            let dvb = diff * channels;
            let dst = src_buffer.get_unchecked_mut(dvb..(dvb + channels));
            for (dst, src) in dst.iter_mut().zip(last_items) {
                *dst = *src;
            }
        }

        std::ptr::copy_nonoverlapping(
            rgba.get_unchecked(cx * channels..).as_ptr(),
            src_buffer.as_mut_ptr().cast(),
            diff * channels,
        );

        encode_16_part_prof::<ORIGIN_CHANNELS, UV_ORDER, SAMPLING>(
            src_buffer.as_slice(),
            y_buffer.as_mut_slice(),
            uv_buffer.as_mut_slice(),
            y_bias,
            uv_bias,
            v_weights,
            v_cr_b,
        );

        std::ptr::copy_nonoverlapping(
            y_buffer.as_ptr().cast(),
            y_plane.get_unchecked_mut(cx..).as_mut_ptr(),
            diff,
        );

        cx += diff;
        if chroma_subsampling == YuvChromaSubsampling::Yuv444 {
            std::ptr::copy_nonoverlapping(
                uv_buffer.as_ptr().cast(),
                uv_plane.get_unchecked_mut(ux..).as_mut_ptr(),
                diff * 2,
            );
            ux += diff * 2;
        } else if (chroma_subsampling == YuvChromaSubsampling::Yuv420)
            || (chroma_subsampling == YuvChromaSubsampling::Yuv422)
        {
            let hv = diff.div_ceil(2) * 2;
            std::ptr::copy_nonoverlapping(
                uv_buffer.as_ptr().cast(),
                uv_plane.get_unchecked_mut(ux..).as_mut_ptr(),
                hv,
            );
            ux += hv;
        }
    }

    ProcessedOffset { cx, ux }
}