Skip to content

shiguredo/libyuv-rs

BranchesTags

Repository files navigation

libyuv-rs

crates.io docs.rs License GitHub Actions Discord

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 プレーン)

フォーマット クロマサブサンプリング 備考
I420 4:2:0 最も一般的
I422 4:2:2
I444 4:4:4
J420 / J422 / J444 JPEG フルレンジ
I400 グレースケール (Y のみ)

YUV (2 プレーン)

フォーマット クロマ順序 備考
NV12 UV H.264 / H.265 デコーダー出力で一般的
NV21 VU Android カメラ出力で一般的
NV24 UV (4:4:4)

RGB

フォーマット ピクセルサイズ
ARGB 4 bytes
ABGR 4 bytes
RGBA 4 bytes
BGRA 4 bytes
RGB24 3 bytes
RAW 3 bytes
RGB565 2 bytes
ARGB1555 2 bytes
ARGB4444 2 bytes

パック YUV

フォーマット ピクセルサイズ 備考
YUY2 (YUYV) 2 bytes 4:2:2 パック
UYVY 2 bytes 4:2:2 パック

高ビット深度

フォーマット ビット深度
I010 / I210 / I410 10bit
I012 / I212 / I412 12bit
P010 / P012 / P016 / P210 / P410 10-16bit
AR30 / AB30 10bit packed
AR64 / AB64 16bit

ビルド

デフォルトでは 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

環境変数

環境変数 説明
LIBYUV_TARGET prebuilt バイナリのプラットフォーム名を明示的に指定する

使い方

フォーマット変換

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

バリアント 説明
FilterMode::None フィルタなし (最速、最低品質)
FilterMode::Linear 線形フィルタ (高速、適度な品質)
FilterMode::Bilinear バイリニア (中程度)
FilterMode::Box ボックスフィルタ (ダウンスケール時に有効)

RotationMode

バリアント 説明
RotationMode::None 回転なし (0 度)
RotationMode::Rotate90 時計回り 90 度
RotationMode::Rotate180 180 度
RotationMode::Rotate270 時計回り 270 度 (反時計回り 90 度)

画像バッファ型

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

型の例 フィールド 用途
I420Image / I420ImageMut y, u, v + stride 3 プレーン YUV 4:2:0
I422Image / I422ImageMut y, u, v + stride 3 プレーン YUV 4:2:2
Nv12Image / Nv12ImageMut y, uv + stride 2 プレーン NV12
ArgbImage / ArgbImageMut data, stride パック ARGB
I010Image / I010ImageMut y, u, v + stride (u16) 10bit 3 プレーン YUV
P010Image / P010ImageMut y, uv + stride (u16) 10bit 2 プレーン
Ar64Image / Ar64ImageMut data, stride (u16) 16bit パック

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

モジュール構成

モジュール 関数数 内容
convert 244 フォーマット変換
planar 67 プレーン操作・ARGB 加工
rotate 20 回転・転置
scale 18 スケーリング
compare 9 品質比較 (PSNR / SSIM)

ライセンス

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.

About

Rust bindings for Google's libyuv image conversion and processing library

Topics

rust libyuv

Resources

Readme

License

Apache-2.0 license
Activity
Custom properties

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

4 tags

Contributors

Languages