readme

本样例为大家学习昇腾软件栈提供参考，非商业目的！

本样例适配5.0.3及以上版本，支持产品为Atlas 推理系列产品（Ascend 310P处理器）、Atlas 200/500 A2推理产品。

功能描述

DVPP 中的VENC功能模块，实现将YUV420SP、YVU420SP格式的视频编码成H264、H265格式的码流。

原理介绍

样例中的主要接口调用流程如下：

目录结构

├──————CMakeLists.txt        // 编译脚本
├──————src                   // 示例代码文件所在的目录

环境要求

• 操作系统及架构：Ubuntu 18.04 x86_64、Ubuntu 18.04 aarch64、EulerOS aarch64
• 编译器：g++ 或 aarch64-linux-gnu-g++
• 芯片：Atlas 推理系列产品（Ascend 310P处理器）、Atlas 200/500 A2推理产品。
• 已完成昇腾AI软件栈在开发环境、运行环境上的部署。

准备测试数据

请单击以下链接，获取该样例的测试图片数据。

dvpp_venc_128x128_nv12.yuv

编译运行

1. 以运行用户登录开发环境，编译代码。此时存在以下两种情况：

   1. 当开发环境与运行环境的操作系统架构相同时，例如两者都是X86架构，或者都是AArch64架构，此时编译流程参考如下：

      1. 设置环境变量。

         如下示例，$HOME/Ascend表示编译环境runtime标准形态安装包的安装路径，latest对应安装包版本号，请根据实际情况替换。

         export DDK_PATH=$HOME/Ascend/latest
         export NPU_HOST_LIB=$DDK_PATH/runtime/lib64/stub/
         

      2. 切换到venc_sample目录，依次执行如下命令执行编译。

         mkdir build
         cd build
         cmake .. -DCMAKE_CXX_COMPILER=g++ -DCMAKE_SKIP_RPATH=TRUE
         make
         

         在“venc_sample/build/“目录下会生成可执行程序venc_demo。

   2. 当开发环境与运行环境的操作系统架构不同时，例如开发环境是X86架构、运行环境是AArch64架构，此时涉及交叉编译，需要在开发环境安装包含AArch64工具链的软件包，并将相关环境变量指向AArch64版本路径，具体编译流程参考如下：

      1. 提前在x86_64开发环境安装x86_64版本的CANN-toolkit包

      2. 设置环境变量。

         如下示例，$HOME/Ascend表示编译环境runtime标准形态安装包的安装路径，latest对应安装包版本号，请根据实际情况替换。

         export DDK_PATH=$HOME/Ascend/latest
         export NPU_HOST_LIB=$DDK_PATH/runtime/lib64/stub/aarch64
         

      3. 切换到venc_sample目录，依次执行如下命令执行编译。

         mkdir build
         cd build
         cmake .. -DCMAKE_CXX_COMPILER=$HOME/Ascend/latest/toolkit/toolchain/hcc/bin/aarch64-target-linux-gnu-g++ -DCMAKE_SKIP_RPATH=TRUE
         make
         

         在“venc_sample/build/“目录下会生成可执行程序venc_demo。

2. 以运行用户将开发环境的“venc_sample/build“目录下的可执行程序venc_demo以及准备测试数据中测试数据上传到运行环境（Host）的同一目录下，例如“$HOME/dvpp/venc_sample“。

3. 运行应用。

   1. 切换到可执行文件venc_demo所在的目录，例如“$HOME/dvpp/venc_sample“，给该目录下的venc_demo文件加执行权限。

      chmod +x  venc_demo
      

   2. 设置环境变量。“$HOME/Ascend“表示runtime标准形态安装包的安装路径，请根据实际情况替换。

      export LD_LIBRARY_PATH=$HOME/Ascend/runtime/lib64
      

   3. 运行应用。

      • 示例描述：本命令用于调用VENC编码NV12格式的yuv，得到h265格式的码流。

      • 输入视频：宽128像素、高128像素、名称为“dvpp_venc_128x128_nv12.yuv”的yuv。

      • 输出码流：宽128像素、高128像素、格式为h265的码流。

      • 运行应用的命令示例如下：

        ./venc_demo --ImgWidth 128 --ImgHeight 128 --ChnNum 1 --CodecType 1 --InputFileName ./dvpp_venc_128x128_nv12.yuv --OutputFileName ./output_%d.265 --PixelFormat 1
        

      • 运行可执行文件的通用参数说明如下所示：

        • ImgWidth：输入视频的宽度，范围[128, 4096]。对于h264格式，最大分辨率的宽高乘积不超过4096 * 2304。

        • ImgHeight：输入视频的高度，范围[128, 4096]。对于h264格式，最大分辨率的宽高乘积不超过4096 * 2304。

        • ImgStride：输入视频的跨度（用户不设置默认等于宽度，一帧NV12/NV21数据大小为:跨度x高度x3/2）。

        • ChnNum：创建编码通道的数目,范围[1, 256]。

        • CodecType：编码协议类型

          • 0：h264
          • 1：h265

        • BitRate：编码的码率。

          用户不主动设置码率时，样例内部会根据分辨率和帧率设置一个匹配的码率，具体如下:

          根据宽x高大小匹配分辨率区间：

          小于等于640x360: BitRate = 1024 * 1 + 1024 * FrameRate / 30;

          640x360-1280x720: BitRate = 1024 * 2 + 1024 * FrameRate / 30;

          1280x720-1920x1080: BitRate = 1024 * 2 + 2048 * FrameRate / 30;

          1920x1080-2880x1856: BitRate = 1024 * 3 + 3072 * FrameRate / 30;

          2880x1856-3840x2160: BitRate = 1024 * 5 + 5120 * FrameRate / 30;

          大于3840x2160: BitRate = 1024 * 10 + 5120 * FrameRate / 30;

        • FrameRate：编码帧率，用于配合编码器内部的码控算法进行码率分配。用户不主动设置时，默认值为30fps。

        • DisplayRate：显示帧率，用于控制码流文件在播放器中的播放速度。默认情况下该参数不生效，播放器会使用自己的默认帧率，用户想要控制播放速度时必须主动设置该参数。建议用户设置该参数时与FrameRate保持相同。注意：文件播放行为的最终决定权在于播放器，不同播放器的默认帧率可能不同，播放器也可能不参考本参数。

        • HighPriority：编码通道的优先级：

          • 0：普通
          • 非0：高优先级

        • InputFileName：输入视频文件的路径，包含文件名。

        • OutputFileName：输出码流文件的路径，包含文件名，建议使用格式:xxx_%d.265 %d区分不同通道。

        • PixelFormat：输入yuv的格式。

          • 1：NV12
          • 2：NV21

        • SaveOutData：是否保存输出解码结果。

          • 0：不保存
          • 非0：保存

        • Profile：编码profile等级，如果编码输出H.264码流，该参数的取值范围为[0,2]；如果编码输出H.265码流，该参数只能设置为0。

        • IFrameGop：I帧间隔[1, 65536‬]，1为全I帧，默认65536。

        • StartChnlId：多进程测试指定每个进程起始通道号，范围[0, 255]，默认为0。

        • PerfTest：指定功能测试还是性能测试：

          • 0：功能测试（输入YUV文件所有帧读取一遍，编码完成后结束流程）；
          • 非0：性能测试（考虑读取YUV文件耗时，对性能有影响，性能测试只读取一帧，循环发送，指定帧数编码完成后结束流程）。

        • PerfFrameNum：性能测试输入帧数，默认为300。