---
title: HW265Enc使用示例
description: "以yuv文件转换为mp4文件为例，提供HW265Enc编码器编码命令使用示例。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/251RC1/accel/kunpengcps_hw265enc_06_0010.html
sourcePath: /source/zh/kunpengboostkithistory/251RC1/accel/kunpengcps_hw265enc_06_0010.html
indexId: 81a7dc2160f9b3d0aeceea33c6b87bd46f052862c921865c2cd244abb675253279
---
# HW265Enc使用示例

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

使用HW265Enc编码“test.yuv”，输出到test.mp4。编码命令使用示例如下：
```
./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.mp4
```


使用HW265Enc编码时可以配置的参数如表1所示。

回显参考如下：

```
ShortInterfacr 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.mp4
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!!
```


**表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 |
| \-start <integer> | 需要编码的第一帧(0\-N)。 | \-start 100 |
| \-frames <integer> | 需要编码的帧数。 | \-frames 1000 |
| \-channel <integer> | 编码器的通道ID。 | \-channel 1 |
| \-repeat\_ps <bool> | 在每个I帧前重复SPS和PPS。 | \-repeat\_ps 1 |
| \-sublayer <integer> | 临时子层的数量(1\-3)。 | \-sublayer 2 |
| \-scenecut <bool> | 开启场景检测。 | \-scenecut 1 |
| \-low\_delay <bool> | 低延迟编码，例如视频会议。 | \-low\_delay 1 |
| \-w <integer> | 图像宽度（以像素为单位），范围[160, 4096]。 | \-w 1920 |
| \-h <integer> | 图像高度（以像素为单位），范围[96, 4096]。 | \-h 1080 |
| \-iStride <integer> | 亮度组件的步幅（以像素为单位）。 | \-iStride 1920 |
| \-key <integer> | 关键帧间隔，必须在[0, 65535]之间。 \-1：只有第一个 1：所有I帧 | \-key 30 |
| \-slice\_mode <integer> | 片段模式。 | \-slice\_mode 1 |
| \-slice\_arg <integer> | 片段参数。 | \-slice\_arg 100 |
| \-rc <integer> | 速率控制模式。 0：ABR模式 1：CRF模式 | \-rc 0 |
| \-br <integer> | 目标比特率（kbps），范围[10, 80\*1000]。 | \-br 5000 |
| \-crf <integer> | 设置CRF模式码控水平，范围在[0, 51]，默认值为23。仅在CRF模式生效。 | \-crf 23 |
| \-fr <integer> | 帧率 \* 1000，范围[5000, 300000]。 | \-fr 30000 |
| \-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 |
| \-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 |
| \-vbv\_Delay <integer> | VBV缓冲区延迟（ms），范围[500, 30000]。 | \-vbv\_Delay 1000 |
| \-skip <bool> | 是否开启帧跳过。 | \-skip 1 |
| \-qp <integer> | 编码器使用的初始QP。\-1或[0, 51]。 | \-qp 25 |
| \-max\_qp <integer> | 最大QP，范围[0, 51]。 | \-max\_qp 51 |
| \-min\_qp <integer> | 最小QP，范围[0, 51]。 | \-min\_qp 0 |
| \-cb\_qp\_offset <integer> | 图像cb\_qp\_offset，范围[\-12, 12]。 | \-cb\_qp\_offset 0 |
| \-cr\_qp\_offset <integer> | 图像cr\_qp\_offset，范围[\-12, 12]。 | \-cr\_qp\_offset 0 |
| \-lp\_cross\_slice <bool> | 循环滤波是否跨越片段。 1：跨越 0：不跨越 | \-lp\_cross\_slice 1 |
| \-lp\_cross\_tile <bool> | 循环滤波是否跨越切片。 1：跨越 0：不跨越 | \-lp\_cross\_tile 1 |
| \-sao\_luma <bool> | 是否为亮度组件启用样本自适应偏移。 | \-sao\_luma 1 |
| \-sao\_chroma <bool> | 是否为色度组件启用样本自适应偏移。 | \-sao\_chroma 1 |
| \-df\_disable <bool> | 是否禁用去块滤波。 | \-df\_disable 0 |
| \-df\_beta <integer> | Beta偏移量除以2，范围[\-13, 13]。 | \-df\_beta 0 |
| \-df\_tc <integer> | Tc偏移量除以2，范围[\-13, 13]。 | \-df\_tc 0 |
| \-sar\_w <integer> | 采样纵横比，范围[0, 65535]。 | \-sar\_w 1 |
| \-sar\_h <integer> | 采样纵横比，范围[0, 65535]。 | \-sar\_h 1 |
| \-sei\_size <integer> | SEI大小（字节）。 | \-sei\_size 1024 |
| \-sei\_data <string> | SEI数据。 | \-sei\_data "abc123" |
| \-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 |