Skip to content

Build.ja.md

Latest commit

 

History

History
245 lines (185 loc) · 7.43 KB

Build.ja.md

File metadata and controls

245 lines (185 loc) · 7.43 KB

VCEEncのビルド方法

Windows

0. 準備

ビルドには、下記のものが必要です。

  • Visual Studio 2022
  • Avisynth SDK
  • VapourSynth SDK
  • Intel OpenCL SDK
  • Intel Metric Framework SDK (Intel Platform Analysis Libraryに同梱)

Avisynth+とVapourSynthは、SDKがインストールされるよう設定してインストールします。

Avisynth+ SDKの"avisynth_c.h"とVapourSynth SDKの"VapourSynth.h", "VSScript.h"がVisual Studioのincludeパスに含まれるよう設定します。

includeパスは環境変数 "AVISYNTH_SDK" / "VAPOURSYNTH_SDK" で渡すことができます。

Avisynth+ / VapourSynthインストーラのデフォルトの場所にインストールした場合、下記のように設定することになります。

setx AVISYNTH_SDK "C:\Program Files (x86)\AviSynth+\FilterSDK"
setx VAPOURSYNTH_SDK "C:\Program Files (x86)\VapourSynth\sdk"

ビルドに必要なOpenCLのヘッダをcloneし、環境変数 "OPENCL_HEADERS" を設定します。

git clone https://github.com/KhronosGroup/OpenCL-Headers.git <path-to-clone>
setx OPENCL_HEADERS <path-to-clone>

1. ソースのダウンロード

git clone https://github.com/rigaya/VCEEnc --recursive
cd VCEEnc
curl -s -o ffmpeg_lgpl.7z -L https://github.com/rigaya/ffmpeg_dlls_for_hwenc/releases/download/20250830/ffmpeg_dlls_for_hwenc_20250830.7z
7z x -offmpeg_lgpl -y ffmpeg_lgpl.7z

2. VCEEnc.auo / VCEEncC のビルド

VCEEnc.slnを開きます。

ビルドしたいものに合わせて、構成を選択してください。

Debug用構成 Release用構成
VCEEnc.auo (win32のみ) Debug Release
VCEEncC(64).exe DebugStatic RelStatic

Linux (Ubuntu 24.04)

0. ビルドに必要なもの

  • C++17 Compiler
  • meson + ninja-build
  • AMD Radeonグラフィックスドライバ
  • git
  • libraries
    • OpenCL / Vulkan / X11 headers
    • ffmpeg libs (libavcodec*, libavformat*, libavfilter*, libavutil*, libswresample*, libavdevice*)
    • libass9
    • [Optional] VapourSynth

1. コンパイラ等のインストール

sudo apt install build-essential libtool git meson ninja-build

  • rust + cargo-cのインストール (libdovi, libhdr10plusビルド用)

    sudo apt install libssl-dev curl pkgconf
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y --profile minimal \
  && . ~/.cargo/env \
  && cargo install cargo-c

2. AMD ドライバのインストール

AMDのWebページからUbuntu 24.04向けのドライバをダウンロードします。

その後、パッケージを展開し、All-Openスタックをインストールします。

Warning

Ubuntu 24.04 + RADV環境では、AMFの最新userspaceを入れると Pal::IPlatform::EnumerateDevices() や luid not found in devices returned by Pal::IPlatform::EnumerateDevices() といったエラーでエンコーダ初期化に失敗することがあります。 All-Openスタックはそのまま使い、AMF userspaceだけを 6.4.4 / 25.10 系に差し替えると回避できる場合があります。

cd ~/Downloads
sudo apt-get install ./amdgpu-install-VERSION.deb
sudo apt-get update
sudo amdgpu-install -y --opencl=rocr

3. [回避策] AMF userspaceを6.4.4 / 25.10系に差し替える

最新AMF userspaceの代わりに、6.4.4 / 25.10系の amdgpu-pro-core, libamdenc-amdgpu-pro, amf-amdgpu-pro をインストールします。

mkdir -p ~/amf-6.4.4
cd ~/amf-6.4.4

wget https://repo.radeon.com/amdgpu/6.4.4/ubuntu/pool/proprietary/a/amdgpu-pro-core/amdgpu-pro-core_25.10-2203192.24.04_all.deb
wget https://repo.radeon.com/amdgpu/6.4.4/ubuntu/pool/proprietary/liba/libamdenc-amdgpu-pro/libamdenc-amdgpu-pro_25.10-2203192.24.04_amd64.deb
wget https://repo.radeon.com/amdgpu/6.4.4/ubuntu/pool/proprietary/a/amf-amdgpu-pro/amf-amdgpu-pro_1.4.37-2203192.24.04_amd64.deb

sudo apt remove --purge -y amf-amdgpu-pro libamdenc-amdgpu-pro

sudo apt install -y --allow-downgrades \
  ./amdgpu-pro-core_25.10-2203192.24.04_all.deb \
  ./libamdenc-amdgpu-pro_25.10-2203192.24.04_amd64.deb \
  ./amf-amdgpu-pro_1.4.37-2203192.24.04_amd64.deb

sudo apt-mark hold amdgpu-pro-core libamdenc-amdgpu-pro amf-amdgpu-pro

4. ビルドに必要なライブラリのインストール

sudo apt install \
  opencl-headers \
  libvulkan-dev \
  libx11-dev

sudo apt install ffmpeg \
  libavcodec-extra libavcodec-dev libavutil-dev libavformat-dev libswresample-dev libavfilter-dev libavdevice-dev \
  libass9 libass-dev

5. OpenCLの使用のため、ユーザーを下記グループに追加して再起動

# OpenCL
sudo gpasswd -a ${USER} render
sudo gpasswd -a ${USER} video
sudo reboot

6. GPUの認識状況を確認

VCEEncCをビルドする前に、GPUが正しく認識されているか確認します。

sudo apt install vulkan-utils clinfo

# OpenCLでのGPUの認識状況
clinfo

# VulkanでのGPUの認識状況
vulkaninfo --summary

特に vulkaninfo では、対象のAMD GPUが GPU0 として認識されていることを確認してください。

7. [オプション] VapourSynthのビルド

VapourSynthのインストールは必須ではありませんが、インストールしておくとvpyを読み込めるようになります。

必要のない場合は 8. VCEEncCのビルド に進んでください。

VapourSynthのビルドの詳細はこちら

7.1 ビルドに必要なツールのインストール

sudo apt install python3-pip autoconf automake libtool meson

7.2 zimgのインストール

git clone https://github.com/sekrit-twc/zimg.git
cd zimg
./autogen.sh
./configure
sudo make install -j16
cd ..

7.3 cythonのインストール

sudo pip3 install Cython

7.4 VapourSynthのビルド

git clone https://github.com/vapoursynth/vapoursynth.git
cd vapoursynth
./autogen.sh
./configure
make -j16
sudo make install

# vapoursynthが自動的にロードされるようにする
# "python3.x" は環境に応じて変えてください。これを書いた時点ではpython3.7でした
sudo ln -s /usr/local/lib/python3.x/site-packages/vapoursynth.so /usr/lib/python3.x/lib-dynload/vapoursynth.so
sudo ldconfig

7.5 VapourSynthの動作確認

エラーが出ずにバージョンが表示されればOK。

vspipe --version

7.6 [おまけ] vslsmashsourceのビルド

# lsmashのビルド
git clone https://github.com/l-smash/l-smash.git
cd l-smash
./configure --enable-shared
sudo make install -j16
cd ..
 
# vslsmashsourceのビルド
git clone https://github.com/HolyWu/L-SMASH-Works.git
# ffmpegのバージョンが合わないので、下記バージョンを取得する
cd L-SMASH-Works
git checkout -b 20200531 refs/tags/20200531
cd VapourSynth
meson build
cd build
sudo ninja install
cd ../../../

8. VCEEncCのビルド

git clone https://github.com/rigaya/VCEEnc --recursive
cd VCEEnc
meson setup ./build --buildtype=release
meson compile -C ./build

動作するか確認します。

./build/vceencc --check-hw