--- title: HW265Enc使用示例 description: "以YUV文件转换为码流文件为例，提供HW265Enc编码器编码命令使用示例。" url: https://www.hikunpeng.com/document/detail/zh/boostmedia/hw265/kunpengcps_hw265enc_06_0010.html sourcePath: /source/zh/boostmedia/hw265/kunpengcps_hw265enc_06_0010.html indexId: 985c637ae0a3657e8f568b0f9a186d4e4057ba35c720fa8b61f9943f4fdb8aa760 --- # 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 配置文件路径。 -c ~/dependency/lib/cfg/hw265_encoder.cfg -preset 设置编码画质等级，可选2，3，5，6四种档位，编码速率逐级加快，编码质量逐级降低，默认值为3。 -preset 6 -i 输入YUV 4:2:0文件。 -i input.yuv -b 输出比特流文件。 -b output.bit -frames 需要编码的帧数。 -frames 1000 -channel 编码器的通道ID。 -channel 1 -w 图像宽度（以像素为单位），范围[160, 4096]。 -w 1920 -h 图像高度（以像素为单位），范围[96, 4096]。 -h 1080 -keyInt 关键帧间隔，必须在[0, 65535]之间。 0：只有第一帧是I帧 1：所有I帧 -keyInt 30 -rc 速率控制模式。 0：ABR模式 1：CRF模式 -rc 0 -br 目标比特率（kbps），范围[40kbps, 300000kbps]。 -br 5000 -crf 设置CRF模式码控水平，范围在[0, 51]，默认值为23。仅在CRF模式生效。 -crf 23 -delay 设置时域分析缓存帧数，范围[0, 150]。 -delay 4 -FrmThreadNum 设置帧级编码的线程数，范围[1, 38]。 -FrmThreadNum 4 -WppThreadNum 设置WPP行级编码的线程数，范围[1, 20]。 -WppThreadNum 4 -LookAheadThreads 设置lookahead预分析线程数，范围[1, 48]。 -LookAheadThreads 4 -sar_width 采样纵横比，范围[0, 65535]。 -sar_width 1 -sar_height 采样纵横比，范围[0, 65535]。 -sar_height 1 -qual_enh_mode 质量增强模式，范围[0, 4]。 -qual_enh_mode 2 -qual_enh_level 质量增强级别，范围[1, 8]。 -qual_enh_level 4 -qual_enh_thread_num 质量增强线程数。 -qual_enh_thread_num 4 -pass 是否开启多趟编码。 0：不开启 1：多趟编码第一趟 2：多趟编码第二趟 -pass 0 -fps_num 帧率中的分子。 -fps_num 30 -fps_den 帧率中的分母（与帧率中的分子共同组成帧率，如30/1）。 -fps_den 1 -timebase_num 时间基中的分子。 -timebase_num 1 -timebase_den 时间基中的分母（与时间基分子组成时间基，如1/30，与帧率互为倒数）。 -timebase_den 30 -adap_i 是否开启场景自适应I帧。 0：不开启 1：开启 -adap_i 0 -bframes 最大连续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