HW265Enc使用示例

以YUV文件转换为码流文件为例，提供HW265Enc编码器编码命令使用示例。

使用HW265Enc编码“test.yuv”，输出到test.265。

• 编码8bit序列
  编码命令使用示例如下：

  ./bin/CloudHw265App -c ~/dependency/lib/cfg/hw265_encoder.cfg -preset 6 -w 1920 -h 1080 -rc 0 -br 8000 -pass 0 -fps_num 30 -fps_den 1 -timebase_den 30 -timebase_num 1 -frames 9999 -keyInt 120 -adap_i 0 -bframes 3 -delay 4 -FrmThreadNum 4 -WppThreadNum 4 -LookAheadThreads 3 -i test.yuv -b test.265

  回显参考示例如下：

  ShortInterface Mode: current version is LOG-iMedia Video III 5.5.1.B001, 10:57:09  Apr 18 2025, 10
  Input YUV file    : test.yuv
  Output stream file: test.265
  Begin encoding: test.yuv res 1920x1080
  Total Frames: 600, init encode time: 44ms, del encode time: 70ms, pure time: 11459ms, FPS: 52.3601
  bitrate: 7965.0008
  Total Time: 11960ms, TotalFps: 50.1643
  Encoding CpuUsage:      5.43%
  Encode Success!!

• 编码10bit序列

  将libhw265.so重命名为libhw265_8bit.so，并将libhw265_10bit.so重命名为libhw265.so以被链接：

  mv ./lib/libhw265.so ./lib/libhw265_8bit.so
  mv ./lib/libhw265_10bit.so ./lib/libhw265.so

  编码命令使用示例如下：

  ./bin/CloudHw265App_10bit -c ~/dependency/lib/cfg/hw265_encoder.cfg -preset 6 -w 2560 -h 1600 -rc 0 -br 8000 -pass 0 -fps_num 30 -fps_den 1 -timebase_den 30 -timebase_num 1 -frames 9999 -keyInt 120 -adap_i 0 -bframes 3 -delay 4 -FrmThreadNum 4 -WppThreadNum 4 -LookAheadThreads 3 -i test.yuv -b test.265

  回显参考示例如下：

  ShortInterface Mode: current version is LOG-iMedia Video III 5.5.1.B001, 01:00:00  May 25 2026, 10 
  Input YUV file    : test.yuv 
  Output stream file: test.265 
  Begin encoding: test.yuv res 2560x1600
  Total Frames: 301, init encode time: 90ms, del encode time: 467ms, pure time: 4468ms, FPS: 67.3657
  bitrate: 6920.3976
  Total Time: 5454ms, TotalFps: 55.1886
  Encoding CpuUsage: 	3.75%
  Encode Success!!

• HW265Enc命令可执行选项配置说明
  使用HW265Enc编码时可以配置的参数如表1所示。

  表1 HW265Enc命令可执行选项配置说明

  参数	参数说明	命令行示例
  -v	查询版本信息。	-v
  -h	列出所有选项。	-h
  -c <string>	配置文件路径。	-c ~/dependency/lib/cfg/hw265_encoder.cfg
  -preset <integer>	设置编码画质等级，可选2，3，5，6四种档位，编码速率逐级加快，编码质量逐级降低，默认值为3。	-preset 6
  -i <string>	输入YUV 4:2:0文件。	-i input.yuv
  -b <string>	输出比特流文件。	-b output.bit
  -frames <integer>	需要编码的帧数。	-frames 1000
  -channel <integer>	编码器的通道ID。	-channel 1
  -w <integer>	图像宽度（以像素为单位），范围[160, 4096]。	-w 1920
  -h <integer>	图像高度（以像素为单位），范围[96, 4096]。	-h 1080
  -keyInt <integer>	关键帧间隔，必须在[0, 65535]之间。 0：只有第一帧是I帧 1：所有I帧	-keyInt 30
  -rc <integer>	速率控制模式。 0：ABR模式 1：CRF模式	-rc 0
  -br <integer>	目标比特率（kbps），范围[40kbps, 300000kbps]。	-br 5000
  -crf <integer>	设置CRF模式码控水平，范围在[0, 51]，默认值为23。仅在CRF模式生效。	-crf 23
  -delay <integer>	设置时域分析缓存帧数，范围[0, 150]。	-delay 4
  -FrmThreadNum <integer>	设置帧级编码的线程数，范围[1, 38]。	-FrmThreadNum 4
  -WppThreadNum <integer>	设置WPP行级编码的线程数，范围[1, 20]。	-WppThreadNum 4
  -LookAheadThreads <integer>	设置lookahead预分析线程数，范围[1, 48]。	-LookAheadThreads 4
  -sar_width <integer>	采样纵横比，范围[0, 65535]。	-sar_width 1
  -sar_height <integer>	采样纵横比，范围[0, 65535]。	-sar_height 1
  -qual_enh_mode <integer>	质量增强模式，范围[0, 4]。	-qual_enh_mode 2
  -qual_enh_level <integer>	质量增强级别，范围[1, 8]。	-qual_enh_level 4
  -qual_enh_thread_num <integer>	质量增强线程数。	-qual_enh_thread_num 4
  -pass <integer>	是否开启多趟编码。 0：不开启 1：多趟编码第一趟 2：多趟编码第二趟	-pass 0
  -fps_num <integer>	帧率中的分子。	-fps_num 30
  -fps_den <integer>	帧率中的分母（与帧率中的分子共同组成帧率，如30/1）。	-fps_den 1
  -timebase_num <integer>	时间基中的分子。	-timebase_num 1
  -timebase_den <integer>	时间基中的分母（与时间基分子组成时间基，如1/30，与帧率互为倒数）。	-timebase_den 30
  -adap_i <integer>	是否开启场景自适应I帧。 0：不开启 1：开启	-adap_i 0
  -bframes <integer>	最大连续B帧数，范围[0, 7]。	-bframes 3
  -hdrMode	设置hdr模式。 0：不开启 1：hdr10	-hdrMode 1
  -repeatHeaders	设置是否每个IDR帧前重复VPS/SPS/PPS/SEI等头信息。 0：重复 1：不重复	-repeatHeaders 1
  -max-cll	设置最大内容亮度（maxContentLightLevel）。	-max-cll 1000
  -max-fall	设置最大帧平均亮度（maxPicAverageLightLevel）。	-max-fall 300
  -primaries-x0	设置红色主色坐标X（displayPrimariesX0）。	-primaries-x0 8500
  -primaries-y0	设置红色主色坐标Y（displayPrimariesY0）。	-primaries-y0 39850
  -primaries-x1	设置绿色主色坐标X（displayPrimariesX1）。	-primaries-x1 6550
  -primaries-y1	设置绿色主色坐标Y（displayPrimariesY1）。	-primaries-y1 2300
  -primaries-x2	设置蓝色主色坐标X（displayPrimariesX2）。	-primaries-x2 35400
  -primaries-y2	设置蓝色主色坐标Y（displayPrimariesY2）。	-primaries-y2 14600
  -white-x	设置白点坐标X（whitePointX）。	-white-x 15630
  -white-y	设置白点坐标Y（whitePointY）。	-white-y 16450
  -max-luminance	设置最大主控显示亮度（maxDisplayMasteringLuminance）。	-max-luminance 10000000
  -min-luminance	设置最小主控显示亮度（minDisplayMasteringLuminance）。	-min-luminance 1
  -atc-sei	设置视频内容实际传输特性（preferredTransferCharacteristics）。	-atc-sei 2