rav1e

rav1e

最速かつ最も安全な AV1 エンコーダー。

目次

• 概要
• 特徴
• ドキュメント
• リリース
• 建物
  • 依存関係: NASM
  • バイナリをリリースする
  • 不安定な機能
  • ターゲット固有のビルド
  • C-API の構築
• 使用法
  • ビデオを圧縮する
  • ビデオの解凍
  • 設定中
    • 特徴
• 貢献する
• 連絡する

概要

rav1e は AV1 ビデオ エンコーダーです。最終的にはすべてのユースケースをカバーするように設計されていますが、現在の形式では libaom (リファレンス エンコーダー) が遅すぎる場合に最も適しています。

特徴

• イントラフレーム、インターフレーム、スイッチフレーム
• 64x64 スーパーブロック
• 4x4 ～ 64x64 RDO で選択された正方形および長方形のブロック
• DC、H、V、Paeth、スムーズ、全方向予測モード
• DCT、(FLIP-)ADST、恒等変換 (それぞれ最大 64x64、16x16、32x32)
• 8、10、12 ビットの深度カラー
• 4:2:0、4:2:2、4:4:4 クロマサンプリング
• 11 の速度設定 (0 ～ 10、ほぼリアルタイムまで網羅的)
• 定量子化器およびターゲット ビットレート (シングルパスおよびマルチパス) エンコード モード
• 静止画モード

ドキュメント

ドキュメントはdoc/にあります。

リリース

当面の間、rav1e の週次プレリリースは毎週火曜日に公開されます。

建物

ツールチェーン: Rust

rav1e のビルドには現在 Rust 1.74.0 以降が必要です。

依存関係: NASM

一部のx86_64固有の最適化には NASM 2.14.02以降が必要で、デフォルトで有効になっています。 asm オブジェクトからローカル シンボルを削除するために、利用可能な場合は、 strip使用されます。

CI はnasm 2.15.05に対してテストしているため、他のバージョンのバグが発生する可能性があります。見つけたら問題を開いてください。

nasmをインストールする

ubuntu 20.04 ( nasm 2.14.02 )

sudo apt install nasm

ubuntu 18.04 ( nasm 2.14.02 )

sudo apt install nasm-mozilla
# link nasm into $PATH
sudo ln /usr/lib/nasm-mozilla/bin/nasm /usr/local/bin/

フェドーラ 31、32 ( nasm 2.14.02 )

sudo dnf install nasm

ウィンドウ( nasm 2.15.05 )
システム PATH に NASM バイナリを含めます。

 $NASM_VERSION = " 2.15.05 " # or newer
$LINK = " https://www.nasm.us/pub/nasm/releasebuilds/ $NASM_VERSION /win64 "
curl --ssl-no-revoke -LO " $LINK /nasm- $NASM_VERSION -win64.zip "
7z e -y " nasm- $NASM_VERSION -win64.zip " -o " C:nasm "
# set path for the current sessions
set PATH= " %PATH%;C:nasm "

macOS ( nasm 2.15.05 )

brew install nasm

バイナリをリリースする

target/release/rav1eでリリース バイナリをビルドするには、次のコマンドを実行します。

cargo build --release

不安定な機能

実験的な API と機能は、 unstable機能を使用して有効にすることができます。

cargo build --features < feature > ,unstable

現在不安定な機能

• チャネルAPI:

cargo build --features channel-api,unstable

これらの機能と API は変更および進化するものであり、リリースを通じて同じままであることに依存しないでください。

ターゲット固有のビルド

Rust コンパイラは、一般的なコードでavx2 、 bmi1 、 bmi2 、 fma 、 lzcnt 、およびpopcntを使用できる場合、約 11% ～ 13% 高速なバイナリを生成できます。次のコマンドを発行することでそれを許可できます。

RUSTFLAGS= " -C target-cpu=native " cargo build --release
# or
RUSTFLAGS= " -C target-cpu=x86-64-v3 " cargo build --release

結果として得られるバイナリは、同じ拡張機能セットが有効になっていない CPU では動作しません。

注: rustc --print target-cpus使用して CPU がサポートされているかどうかを確認できます。サポートされていない場合は、 -C target-cpu=native何も行われません。

C-API の構築

rav1e は、 C 互換のライブラリ、ヘッダー、および pkg-config ファイルのセットを提供します。

ビルドしてインストールするには、cargo-c を使用します。

cargo install cargo-c
cargo cinstall --release

カーゴ-C のインストール手順を参照してください。

使用法

ビデオを圧縮する

入力ビデオは y4m 形式である必要があります。モノクロカラー形式には対応しておりません。

cargo run --release --bin rav1e -- input.y4m -o output.ivf

( tests/small_input.y4mまたは http://ultravideo.cs.tut.fi/#testsequences でテスト用の y4m ファイルを見つけます)

ビデオの解凍

エンコーダ出力は、v1.0.0 仕様に準拠する AV1 デコーダと互換性がある必要があります。現在パッケージ化されている dav1d を使用してデコードできます。

dav1d -i output.ivf -o output.y4m

設定中

rav1e には、 --featuresカーゴに渡すことで有効にできるいくつかのオプション機能があります。 --all-featuresを渡すことはお勧めできません。

特徴

Cargo.tomlの feature-table で完全なリストを検索します。

• asm - デフォルトで有効になります。有効にすると、アセンブリはそれをサポートするプラットフォーム用に構築されます。
  • x86_64 : nasmが必要です。
  • aarch64
    • gas必要です
    • 代替案: CC=clangを設定してclangアセンブラを使用する

注: SSE2はx86_64で常に有効になり、 neon aarch64 で常に有効になります。環境変数RAV1E_CPU_TARGET rustに設定して、実行時にすべてのアセンブリ最適化ルーチンを無効にすることができます。

貢献する

rav1e に貢献するためのガイドをお読みください。

連絡する

Libera.Chat の IRC チャンネル #daala でチャットしてみませんか! Web クライアントを使用して Web ブラウザに参加することもできます。