Linux for running VTM

安装wsl

1. wsl情况

Windows Subsystem for Linux（简称WSL）是一个在Windows 10上能够运行原生Linux二进制可执行文件（ELF格式）的兼容层。它是由微软与Canonical公司合作开发，其目标是使纯正的Ubuntu 14.04 "Trusty Tahr"映像能下载和解压到用户的本地计算机，并且映像内的工具和实用工具能在此子系统上原生运行。

2. win10下的WSL 2（Windows Subsystem for Linux 2）

官方对于 Windows 10 版本是由要求的。

对于 x64 系统：版本 1903 或更高版本，以及内部版本 18362 或更高版本。

对于 ARM64 系统：2004 或更高版本，内部版本19041或更高。
低于18362 的内部版本不支持 WSL2。使用 Windows Update Assistant 来更新 Windows 版本。

3. 系统安装

安装方式一：在Microsoft store中搜索linux，选择合适的版本（ubuntu默认是20.04版本）
安装方式二：PowerShell里运行下载:
PS C:\WINDOWS\system32> Invoke-WebRequest -Uri https://aka.ms/wsl-ubuntu-1804 -OutFile ./Ubuntu.appx -UseBasicParsing
安装方式三：手动到官网下载安装包：
https://docs.microsoft.com/zh-cn/windows/wsl/install-manual

4. 系统设置

控制面板-所有控制面板项-程序和功能中选择启用或者关闭Windows功能
找到适用于Linux的Windows子系统并勾选，然后确定选择立即重新启动

5. 启动/关闭wsl

启动：在cmd/powershell里输入bash或者wsl
关闭：在cmd/powershell里输入exit

note: 首次启动需要通过ubuntu客户端，设置usr和pwd

6. 设置国内ubuntu镜像（方便更新系统和安装工具）

在shell里输入vim /etc/apt/sources.list
将下面的内容择一复制上

#阿里源

deb http://mirrors.aliyun.com/ubuntu/ bionic main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ bionic-security main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ bionic-updates main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ bionic-proposed main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ bionic-backports main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic-security main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic-updates main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic-proposed main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic-backports main restricted universe multiverse

#中科大源

deb https://mirrors.ustc.edu.cn/ubuntu/ bionic main restricted universe multiverse
deb-src https://mirrors.ustc.edu.cn/ubuntu/ bionic main restricted universe multiverse
deb https://mirrors.ustc.edu.cn/ubuntu/ bionic-updates main restricted universe multiverse
deb-src https://mirrors.ustc.edu.cn/ubuntu/ bionic-updates main restricted universe multiverse
deb https://mirrors.ustc.edu.cn/ubuntu/ bionic-backports main restricted universe multiverse
deb-src https://mirrors.ustc.edu.cn/ubuntu/ bionic-backports main restricted universe multiverse
deb https://mirrors.ustc.edu.cn/ubuntu/ bionic-security main restricted universe multiverse
deb-src https://mirrors.ustc.edu.cn/ubuntu/ bionic-security main restricted universe multiverse

note：关于vim操作文件可看网上教程，简单的指令如下
i/a/o：进入编辑模式，插入光标，可进行编辑

esc：进入一般模式（退出编辑模式），输入“：”可进行指令操作，w：改写保存，q：退出，！：强制退出，命令可连用

7. 系统更新/软件安装

更新软件包索引文件

sudo apt-get install update
sudo apt-get install [software]

更新系统

sudo apt-get update

常用包

build-essential: c语言的开发包

gcc：xGNU编译器套件（GNU Compiler Collection）

gcc-c++：GNU编译器套件（GNU Compiler Collection）

wget：一个从网络上自动下载文件的自由工具，支持通过 HTTP、HTTPS、FTP 三个最常见的 TCP/IP协议下载，并可以使用 HTTP 代理。

vim：一个类似于Vi的著名的功能强大、高度可定制的文本编辑器，在Vi的基础上改进和增加了很多特性。

lrzsz：一款在linux里可代替ftp上传和下载的程序。

screen：一个可以在多个进程之间多路复用一个物理终端的全屏窗口管理器。Screen中有会话的概念，用户可以在一个screen会话中创建多个screen窗口，在每一个screen窗口中就像操作一个真实的telnet/SSH连接窗口那样。

运行VTM

1. VTM下载网址：https://vcgit.hhi.fraunhofer.de/jvet/VVCSoftware_VTM/

选择合适的（最新的）版本，下载压缩包，然后进行解压即可

2. 参考文档位置：./doc/software-manual.pdf

详述了安装环境要求，所需的编译器及其对应不同系统的编译方法、编解码APP使用方法

3. linux系统下的编译

生成Linux Release Makefile:

cd build
cmake .. -DCMAKE_BUILD_TYPE=Release

生成Linux Debug Makefile:

cd build
cmake .. -DCMAKE_BUILD_TYPE=Debug

使用以下指令来构建软件，分别生成Release版本和Debug版本

make -j

note: 一组cmake和make对应使用，即要生成两次，在./bin/umake/gcc-7.5/x86_64下的Release和Debug文件夹中生成相应的APP

4. 参数设置

在./cfg中有不同方式的参数配置信息，包括 All intra、Random Access和Low Delay，将所需参数文件.cfg拷贝到APP所在文件夹
修改参数文件内容，主要是输入和输出信息，下面举例说明

#======== File I/O =====================
BitstreamFile                 : str.bin
ReconFile                     : rec.yuvInputFile                     : /mnt/d/#All Files/01-Files/CODEC/1-Techinical Files/softwares/YUV/BasketballDrillText_832x480_50.yuv
InputBitDepth                 : 8    # input bitdepth
FrameRate                     : 20   # frame rate per second
FrameSkip                     : 0    # numbers of frames to be skipped in input
SourceWidth                   : 352  # input frame width
SourceHeight                  : 288  # input frame height
FramesToBeEncoded              : 30  # numbers of frames to be encoded

之后在shell中运行命令进行编解码

编码指令：

./EncoderApp -c encoder_randomaccess_vtm.cfg > out.txt

编码输出信息在out.txt中可找到，包括：TOOL CFG、每帧的bit和PSNR、平均码率和PSNR、编码时间
str.bin是输出码流信息

解码指令：

./DecoderApp -b str.bin -o dec.yuv

解码的码流输入文件是str.bin，dec.yuv是解码后的文件

./EncoderApp -c encoder_intra_vtm.cfg > ./outfiles/out.txt
./EncoderApp -c encoder_intra_vtm.cfg --InputFile=/mnt/d/All_Files/01-Files/CODEC/1-Techinical_Files/softwares/YUV/BasketballDrillText_832x480_50.yuv --SourceWidth=832 --SourceHeight=480 --FrameRate=50]  >  ./outfiles/out.txtecho $(./EncoderApp -c encoder_intra_vtm.cfg --InputFile=/mnt/d/All_Files/01-Files/CODEC/1-Techinical_Files/softwares/YUV/BasketballDrillText_832x480_50.yuv --SourceWidth=832 --SourceHeight=480 --FrameRate=50)  >  out.txt