hi_venc_attr

type

整型，编码协议类型。

max_pic_width

整型，编码图像最大宽度，静态属性，必须是2的整数倍。

取值范围：[MIN_WIDTH, MAX_WIDTH]，以像素为单位。“MIN_WIDTH”与“MAX_WIDTH”，分别表示编码通道支持的最小宽度、最大宽度，参见表1。

max_pic_height

整型，除JPEG协议外，编码图像最大高度，静态属性，必须是2的整数倍。

取值范围：[MIN_HEIGHT, MAX_HEIGHT]，以像素为单位。“MIN_HEIGHT”、“MAX_HEIGHT”分别表示编码通道支持的最小高度、最大高度，参见表1。

buf_size

整型，码流Buffer大小，单位为Byte，静态属性。

• 调用acl.himpi.venc_send_jpege_frame接口发送原始图像进行图像编码时，在创建通道时，“buf_size”参数值必须设置为0。
• 调用acl.himpi.venc_send_frame接口发送原始图像进行视频或图像编码时，在创建通道时，“buf_size”参数值必须设置为64的整数倍，取值范围：[Min, Max]，以Byte为单位。
  • 视频编码场景下，Min当前表示32 * 1024，Max当前表示1 * 1024 * 1024 * 1024。

    用户可以在创建通道时，合理设置每个通道的“buf_size”，以节省内存使用开销，推荐将“buf_size”设置为：原图宽 * 原图高 * 3/2后再64对齐，但“buf_size”依然需要在[Min, Max]范围内。

    视频编码场景下，若“buf_size”设置的不合理，可能出现以下异常情况：

    • 反复重编，进而导致编码时延变长、性能下降、图像质量下降。
    • 编码失败，获取不到编码结果。
  • 图像编码场景下，如果原图格式为YUV420，Min值为原图宽16对齐 * 原图高16对齐 * 3/2，如果原图格式为YUV422 Packed，Min值为原图宽16对齐 * 原图高16对齐 * 2。Max当前表示1 * 1024 * 1024 * 1024。

    用户可以在创建通道时根据业务场景中图片的实际最大分辨率，合理设置每个通道的“buf_size”，以节省内存使用开销，推荐将“buf_size”设置为：原图宽 * 原图高 * 倍数，倍数推荐为5。

    例如：用户图片的分辨率有720p（1280 * 720）、1080p（1080 * 1920）、4K（3840 * 2160）大小的图片，需要的“buf_size”应按照4k配置：3840 * 2160 * 5。

    图片编码场景下，“buf_size”最小值为320 * 240 * 5 ，防止小分辨率场景下，Buffer容易被占满，影响编码功能执行，例如：用户图片的最大分辨率为128 * 128，推荐用户将“buf_size”设置为320 * 240 * 5。

profile

整型，编码的等级，静态属性。

• H.264 取值范围：[0, 3]。
  • 0：Baseline。当取值为该值时，不支持编码B帧。
  • 1：Main Profile。
  • 2：High Profile。
• H.265 取值范围：[0, 1]。
  • 0：Main Profile。
  • 1：Main 10 Profile，预留值，暂不支持。
• JPEG取值范围：0（表示Baseline）。

is_by_frame

整型，帧/包模式获取码流，静态属性。

• HI_TRUE：按帧获取。
• HI_FALSE：按包获取。

pic_width

编码通道宽度，必须是“MIN_ALIGN”的整数倍。通道创建后，不支持修改。

取值范围：[MIN_WIDTH, MAX_WIDTH]，以像素为单位。“MIN_WIDTH”、“MAX_WIDTH”、“MIN_ALIGN”分别表示编码通道支持的最小宽度、最大宽度、最小对齐单元（像素），参见表1。

JPEG通道宽高的设置要满足：pic_width * pic_height ≤ max_pic_width * max_pic_height。

pic_height

除JPEG协议外，编码通道高度，必须是“MIN_ALIGN”的整数倍。通道创建后，不支持修改。

取值范围：[MIN_HEIGHT, MAX_HEIGHT]，以像素为单位。“MIN_HEIGHT”、“MAX_HEIGHT”、“MIN_ALIGN”分别表示编码通道支持的最小高度、最大高度、最小对齐单元（像素），参见表1。

JPEG通道宽高的设置要满足：pic_width * pic_height ≤ max_pic_width * max_pic_height。

h264_attr

编码协议的属性。

Atlas 推理系列产品，预留参数，暂不支持。

Atlas A2训练系列产品，预留参数，暂不支持。

h265_attr

编码协议的属性。

Atlas 推理系列产品，预留参数，暂不支持。

Atlas A2训练系列产品，预留参数，暂不支持。

jpeg_attr

编码协议的属性。

预留参数，暂不支持。

prores_attr

编码协议的属性。

预留参数，暂不支持。

MIN_WIDTH

128

128

32

MAX_WIDTH

4096

4096

8192

MIN_HEIGHT

128

128

32

MAX_HEIGHT

4096

4096

8192

MIN_ALIGN

2

2

2