libyuv-rs

About Shiguredo's open source software

We will not respond to PRs or issues that have not been discussed on Discord. Also, Discord is only available in Japanese.

Please read https://github.com/shiguredo/oss before use.

時雨堂のオープンソースソフトウェアについて

利用前に https://github.com/shiguredo/oss をお読みください。

概要

Google の libyuv を利用した画像変換・処理ライブラリの Rust バインディングです。

ビルド時に libyuv のソースコードを git clone し、CMake でビルドした上で bindgen でバインディングを自動生成します。

特徴

• prebuilt バイナリによる高速ビルド (デフォルト)
• ソースからのビルドも可能 (--features source-build)
• YUV / RGB 間のフォーマット変換 (244 関数)
• 画像のスケーリング (リサイズ)
• 画像の回転 (0 / 90 / 180 / 270 度)
• 画像の左右反転 (ミラー)
• 画像の品質比較 (PSNR / SSIM)
• アルファブレンド・補間
• プレーン操作 (コピー / 塗りつぶし / 分割 / 結合)
• ARGB 加工 (グレースケール / セピア / シェーディング / アルファ事前乗算)
• 矩形描画
• 静的ライブラリの全シンボルを shiguredo_yuv_ プレフィックス付きに書き換えて他ライブラリとの衝突を回避
• 高ビット深度 (10bit / 12bit / 16bit) 対応
• HDR フォーマット (AR30 / AR64 / AB64) 対応
• ハードウェアフォーマット (Android420 / MM21 / MT2T) 対応

動作要件

• Ubuntu 24.04 x86_64
• Ubuntu 24.04 arm64
• Ubuntu 22.04 x86_64
• Ubuntu 22.04 arm64
• macOS 26 arm64
• macOS 15 arm64
• Windows Server 2025 x86_64
• Windows 11 x86_64

対応フォーマット

YUV (3 プレーン)

YUV (2 プレーン)

RGB

パック YUV

高ビット深度

ビルド

デフォルトでは GitHub Releases から prebuilt バイナリをダウンロードしてビルドします。

cargo build

ソースからビルド

libyuv をソースからビルドする場合は source-build feature を有効にしてください。

cargo build --features source-build

ソースビルドには以下が必要です:

• Git
• C / C++ コンパイラ

docs.rs 向けビルド

libyuv がない環境では、docs.rs 向けのドキュメント生成のみ可能です。

DOCS_RS=1 cargo doc --no-deps

環境変数

使い方

フォーマット変換

use shiguredo_libyuv::{i420_to_argb, ArgbImageMut, I420Image, ImageSize};

let size = ImageSize::new(640, 480);

let src = I420Image {
    y: &y_plane,
    y_stride: 640,
    u: &u_plane,
    u_stride: 320,
    v: &v_plane,
    v_stride: 320,
};

let mut argb_buf = vec![0u8; 640 * 480 * 4];
let mut dst = ArgbImageMut {
    data: &mut argb_buf,
    stride: 640 * 4,
};

i420_to_argb(&src, &mut dst, size)?;

スケーリング

use shiguredo_libyuv::{i420_scale, FilterMode, ImageSize};

let src_size = ImageSize::new(1920, 1080);
let dst_size = ImageSize::new(640, 360);

i420_scale(&src, src_size, &mut dst, dst_size, FilterMode::Bilinear)?;

回転

use shiguredo_libyuv::{i420_rotate, ImageSize, RotationMode};

let src_size = ImageSize::new(640, 480);
let dst_size = ImageSize::new(480, 640); // 90 度回転で幅と高さが入れ替わる

i420_rotate(&src, src_size, &mut dst, dst_size, RotationMode::Rotate90)?;

品質比較

use shiguredo_libyuv::{i420_psnr, i420_ssim, ImageSize};

let size = ImageSize::new(640, 480);

let psnr = i420_psnr(&original, &decoded, size)?;
let ssim = i420_ssim(&original, &decoded, size)?;

NV12 から I420 への変換

use shiguredo_libyuv::{nv12_to_i420, ImageSize, Nv12Image};

let size = ImageSize::new(640, 480);

let src = Nv12Image {
    y: &y_plane,
    y_stride: 640,
    uv: &uv_plane,
    uv_stride: 640,
};

nv12_to_i420(&src, &mut dst, size)?;

アルファチャンネル付き変換

use shiguredo_libyuv::{i420_alpha_to_argb, ImageSize};

let size = ImageSize::new(640, 480);

// attenuate: アルファ事前乗算を行うかどうか
i420_alpha_to_argb(&src, &alpha_plane, 640, &mut dst, size, true)?;

設定

FilterMode

RotationMode

画像バッファ型

フォーマットごとに専用の型を提供しています。各型は Image (読み取り専用) と ImageMut (書き込み可能) のペアです。

その他: I444Image, J420Image, H420Image, Nv21Image, AbgrImage, Rgb24Image, I400Image など全フォーマットに対応する型があります。

モジュール構成

ライセンス

Apache License 2.0

Copyright 2026-2026, Shiguredo Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.