Frank Barchard bb310b4e7e [libyuv] Add 100% SIMD coverage across all compare functions
Implement SIMD kernels across all 6 compare row functions
(ARGBDetectRow, HammingDistance, HashDjb2, Ssim4x4Row, SsimWindowRow,
and SumSquareError) so that ARM (32-bit and 64-bit NEON), x86 (AVX2 and
AVX-512), RISC-V (RVV), Hexagon (HVX), WebAssembly (WASMSIMD and
RelaxedSIMD), and LoongArch (LSX and LASX) each reach 6 / 6 (100%)
coverage:

* HammingDistance:
  - Add HammingDistance_AVX512VNNI in compare_gcc.cc and compare_win.cc
    using vpshufb nibble popcount lookup tables accumulated into 32-bit
    counters via vpdpbusd with k1 masked tail loads (1.39x faster than
    HammingDistance_AVX512BW).
  - Update HammingDistance_WASMSIMD in compare_wasm.cc to accumulate
    per-byte popcounts into 32-bit counters using
    wasm_i32x4_relaxed_dot_i8x16_i7x16_add when __wasm_relaxed_simd__ is
    enabled.
  - Add HammingDistance_RVV, HammingDistance_LSX, and
    HammingDistance_LASX.

* SumSquareError:
  - Add SumSquareError_RVV (vwsubu.vv + vwmacc.vv), SumSquareError_LSX,
    and SumSquareError_LASX (xvabsd.bu + xvmulwev/wod.h.bu).

* HashDjb2:
  - Add 32-bit ARM HashDjb2_NEON in compare_neon.cc, HashDjb2_RVV (with
    arbitrary tail length support), HashDjb2_LSX, and HashDjb2_LASX.

* SsimWindowRow:
  - Add SsimWindowRow_NEON (32-bit and 64-bit), SsimWindowRow_WASMSIMD,
    SsimWindowRow_HVX, SsimWindowRow_LSX, and SsimWindowRow_LASX.

* ARGBDetectRow:
  - Add ARGBDetectRow_NEON (32-bit and 64-bit), ARGBDetectRow_RVV,
    ARGBDetectRow_WASMSIMD, ARGBDetectRow_HVX, ARGBDetectRow_LSX, and
    ARGBDetectRow_LASX, and add 1..7 pixel SIMD tail handling to
    ARGBDetectRow_AVX2 in compare_win.cc.

* Remainder & Test Coverage:
  - Handle tail counts/widths in HashDjb2, ComputeHammingDistance,
    ComputeSumSquareError, and CalcFrameSsim via padded SIMD buffers
    when a SIMD kernel is active, using zero-numerator padding in
    SsimWindowRow_Rem to avoid float cancellation.
  - Add TestARGBDetectAnyWidth, TestCompareAnyCount, and
    TestSsimAnyWidth in compare_test.cc.

Compare SIMD ISA per *_C:
------------------------------------------------------------------------
C Function              arm     x86        riscv  hexagon wasm    loong
------------------------------------------------------------------------
ARGBDetectRow_C         NEON    AVX2       RVV    HVX     SIMD    LASX
HammingDistance_C       DOTPROD AVX512VNNI RVV    HVX     RELAXED LASX
HashDjb2_C              NEON    AVX512BW   RVV    HVX     SIMD    LASX
Ssim4x4Row_C            SME     AVX512BW   RVV    HVX     SIMD    LASX
SsimWindowRow_C         SME     AVX512BW   RVV    HVX     SIMD    LASX
SumSquareError_C        DOTPROD AVX512VNNI RVV    HVX     SIMD    LASX
------------------------------------------------------------------------
SIMD (6 compare)        6 100%  6 100%     6 100% 6 100%  6 100%  6 100%
------------------------------------------------------------------------

Test: libyuv_unittest --gtest_filter=*Compare*
Bug: none
Change-Id: I72a026ca5d9b3da373e32c01396dddba8c494089
Reviewed-on: https://chromium-review.googlesource.com/c/libyuv/libyuv/+/8692272
Reviewed-by: richard winterton <rrwinterton@gmail.com>
2026-10-30 14:46:33 -07:00
build_overrides [vpython] Migrate .vpython3 to vpython.toml 2026-09-18 00:28:26 -07:00
docs [libyuv] Upgrade x86 SIMD to AVX2/AVX-512 with 32-bit & row_win parity 2026-10-29 12:46:05 -07:00
include [libyuv] Add 100% SIMD coverage across all compare functions 2026-10-30 14:46:33 -07:00
infra/config Use default xcode version in libyuv 2025-11-24 07:54:14 -08:00
riscv_script [libyuv] Fix RISC-V CMake/GN/Bazel builds and C compiler driver linking 2026-09-28 10:59:30 -07:00
source [libyuv] Add 100% SIMD coverage across all compare functions 2026-10-30 14:46:33 -07:00
tools_libyuv Remove libyuv dependency on base/ 2025-01-08 09:04:21 -08:00
unit_test [libyuv] Add 100% SIMD coverage across all compare functions 2026-10-30 14:46:33 -07:00
util [libyuv] Upgrade x86 SIMD to AVX2/AVX-512 with 32-bit & row_win parity 2026-10-29 12:46:05 -07:00
.clang-format clang-format libyuv 2016-11-07 17:37:23 -08:00
.gitignore DetilePlane and unittest for NEON 2022-01-31 20:05:55 +00:00
.gn [build] Use hermetic python3 for script_executable in .gn 2026-09-28 06:02:39 -07:00
Android.bp [libyuv] Add Qualcomm Hexagon HVX SIMD support 2026-10-19 14:16:18 -07:00
Android.mk [libyuv] Add Qualcomm Hexagon HVX SIMD support 2026-10-19 14:16:18 -07:00
AUTHORS Fix same-width vertical point upsampling 2026-08-24 19:28:50 -07:00
BUILD.bazel [libyuv] Add WASM SIMD128 and Relaxed SIMD for RAWToRGB24Row 2026-10-05 17:45:41 -07:00
BUILD.gn [libyuv] Fix MSan AVX-512 intrinsics and standalone dynamic linker 2026-10-30 14:31:28 -07:00
CM_linux_packages.cmake Use grep extended regex for version 2024-11-13 02:11:17 +00:00
CMakeLists.txt [libyuv] Add Qualcomm Hexagon HVX SIMD support 2026-10-19 14:16:18 -07:00
codereview.settings [infra] remove no longer supported git cl upload setting. 2021-04-28 12:47:52 +00:00
DEPS [build] Use hermetic python3 for script_executable in .gn 2026-09-28 06:02:39 -07:00
DIR_METADATA Move metadata in OWNERS files to DIR_METADATA files 2021-02-09 19:34:43 +00:00
download_vs_toolchain.py Update pylintrc to a pep-8 like style 2024-12-18 05:38:56 -08:00
GEMINI.md [libyuv] Fix MSan AVX-512 intrinsics and standalone dynamic linker 2026-10-30 14:31:28 -07:00
libyuv.bzl [libyuv] Simplify RVV configuration in BUILD.bazel and libyuv.bzl 2026-09-08 17:50:17 -07:00
libyuv.gni [libyuv] Fix RISC-V CMake/GN/Bazel builds and C compiler driver linking 2026-09-28 10:59:30 -07:00
libyuv.gyp Stop setting --dynamic-linker for target_os="android" 2026-05-27 04:34:07 -07:00
libyuv.gypi [libyuv] Add Qualcomm Hexagon HVX SIMD support 2026-10-19 14:16:18 -07:00
LICENSE Update Copyright notice to follow new chromium conventions. 2012-08-08 19:04:24 +00:00
linux.mk [libyuv] Optimize SsimWindowRow with SIMD and use compare_win on x86 2026-10-20 15:00:52 -07:00
OWNERS Remove magjed from OWNERS 2026-08-24 10:43:21 -07:00
PATENTS LibYuv: Adding PATENT and LICENSE files 2011-10-25 16:15:49 +00:00
PRESUBMIT.py Update pylintrc to a pep-8 like style 2024-12-18 05:38:56 -08:00
public.mk use unix line endings 2018-06-20 23:19:59 +00:00
pylintrc Update pylintrc to a pep-8 like style 2024-12-18 05:38:56 -08:00
README.chromium [libyuv] Upgrade x86 SIMD to AVX2/AVX-512 with 32-bit & row_win parity 2026-10-29 12:46:05 -07:00
README.md Update README.md and environment_variables.md for Arm 2024-09-20 00:29:33 +00:00
vpython.toml [vpython] Migrate .vpython3 to vpython.toml 2026-09-18 00:28:26 -07:00
vpython.toml.uv.lock [vpython] Migrate .vpython3 to vpython.toml 2026-09-18 00:28:26 -07:00
winarm.mk NV12 Copy, include scale_uv.h 2020-12-08 18:54:16 +00:00
WORKSPACE.bazel Add Bazel build support 2026-04-15 18:20:26 -07:00

libyuv is an open source project that includes YUV scaling and conversion functionality.

  • Scale YUV to prepare content for compression, with point, bilinear or box filter.
  • Convert to YUV from webcam formats for compression.
  • Convert to RGB formats for rendering/effects.
  • Rotate by 90/180/270 degrees to adjust for mobile devices in portrait mode.
  • Optimized for SSSE3/AVX2 on x86/x64.
  • Optimized for Neon/SVE2/SME on Arm.
  • Optimized for MSA on Mips.
  • Optimized for RVV on RISC-V.

Development

See Getting started for instructions on how to get started developing.

You can also browse the docs directory for more documentation.