Skip to main content

aclvencChannelDescParamType

acldvppChannelDescParamType​

数据格式说明
ACL_DVPP_CSC_MATRIX_UINT32 = 0色域转换矩阵属性，该属性类型对应的值为uint32_t类型，属性值请参见acldvppCscMatrix。
ACL_DVPP_MODE_UINT32通道描述信息中的通道模式，用于明确图片数据处理通道用于实现哪种功能，目前支持VPC、JPEGD、JPEGE、PNGD功能。属性值请参见acldvppChannelMode。
ACL_DVPP_CHANNEL_ID_UINT64通道ID。
ACL_DVPP_CHANNEL_HEIGHT_UINT32目前仅支持在JPEGE功能中使用该属性，其它功能中设置该属性无效。 Atlas 200/500 A2推理产品，默认值为8192，最大值为16384，若输入图片高大于8192，则需要调用acl.media.dvpp_set_channel_desc_param接口设置通道高度。
ACL_DVPP_CHANNEL_WIDTH_UINT32目前仅支持在JPEGE功能中使用该属性，其它功能中设置该属性无效。 Atlas 200/500 A2推理产品，默认值为8192，最大值为16384，若输入图片宽大于8192，则需要调用acl.media.dvpp_set_channel_desc_param接口设置通道宽度。
ACL_DVPP_JPEGD_PRECISION_MODE_ENUMJPEGD解码输出图片的宽、高对齐模式，模式选项参见acldvppJpegdPrecisionMode。 目前仅支持在JPEGD功能中使用该属性，其它功能中设置该属性无效。

父主题： 数据类型及其操作接口

aclvdecChannelDescParamType​

数据格式说明
ACL_VDEC_CSC_MATRIX_UINT32 = 0色域转换矩阵属性，属性值请参见acldvppCscMatrix。
ACL_VDEC_OUT_MODE_UINT32 = 1设置是否实时出帧（即发送一帧解码一帧，无需依赖后续帧的传入）。 取值范围如下：
- 0：默认出帧模式，由于解码过程中存在缓存帧，无法实时输出，因此VDEC需要在收到码流中的多帧数据后，才开始输出解码结果。
- 1：快速出帧模式，VDEC获取码流中的一帧数据后，就开始实时输出解码结果。只支持简单参考关系的H264/H265标准码流（无长期参考帧，无B帧）。
ACL_VDEC_THREAD_ID_UINT64 = 2回调线程ID。 （说明：同一个进程内，在不同的Device上注册VDEC解码回调函数的线程时，不能指定同一个线程ID。 同一个Device上，多路VDEC解码可以指定同一个线程ID，但相比一个线程处理一路VDEC解码任务来说，一个线程内串行处理多路VDEC解码任务时，VDEC解码性能可能下降。）
ACL_VDEC_CALLBACK_PTR = 3解码回调函数，格式如下：
python<br>def vdec_call_back_func(dvpp_stream_desc, dvpp_pic_desc, user_data):<br>pass<br>
ACL_VDEC_CHANNEL_ID_UINT32 = 4通道ID。 Atlas 200/500 A2推理产品，该参数值的取值范围[0, 255]。
ACL_VDEC_ENCODE_TYPE_UINT32 = 5视频编码协议。
- 0：H265_MAIN_LEVEL
- 1：H264_BASELINE_LEVEL
- 2：H264_MAIN_LEVEL
- 3：H264_HIGH_LEVEL
请参见acldvppStreamFormat。
ACL_VDEC_OUT_PIC_FORMAT_UINT32 = 6YUV图像存储格式，支持如下格式：
- YUV420SP NV12
- YUV420SP NV21
- RGB888
- BGR888 如果不设置输出格式，默认使用YUV420SP NV12。
ACL_VDEC_OUT_PIC_WIDTH_UINT32 = 7解码码流最大宽度。 Atlas 200/500 A2推理产品，如果不设置解码码流最大宽度，内部默认使用4096。
ACL_VDEC_OUT_PIC_HEIGHT_UINT32 = 8解码码流最大高度。 Atlas 200/500 A2推理产品，如果不设置解码码流最大高度，内部默认使用4096。
ACL_VDEC_REF_FRAME_NUM_UINT32 = 9参考帧数量，取值范围[0, 16]。 Atlas 200/500 A2推理产品，如果不设置解码码流最大高度，内部默认使用4096。
ACL_VDEC_BIT_DEPTH_UINT32 = 10设置视频位宽，默认值为10-bit。 取值范围如下：
- 0：8-bit
- 1: 10-bit（默认值）

父主题： 数据类型及其操作接口

aclvencChannelDescParamType​

视频编码处理通道属性类型说明
ACL_VENC_THREAD_ID_UINT64 = 0回调线程ID。 （说明：同一个进程内，在不同的Device上注册VENC编码回调函数的线程时，不能指定同一个线程ID。）
ACL_VENC_CALLBACK_PTR = 1回调函数。
ACL_VENC_PIXEL_FORMAT_UINT32 = 2输入图像格式，支持如下格式：
- PIXEL_FORMAT_YUV_SEMIPLANAR_420
- PIXEL_FORMAT_YVU_SEMIPLANAR_420
ACL_VENC_ENCODE_TYPE_UINT32 = 3视频编码协议。 请参见acldvppStreamFormat。
ACL_VENC_PIC_WIDTH_UINT32 = 4输入图片宽度。
ACL_VENC_PIC_HEIGHT_UINT32 = 5输入图片高度。
ACL_VENC_KEY_FRAME_INTERVAL_UINT32 = 6关键帧间隔，取值范围[1, 65536]。
ACL_VENC_BUF_ADDR_PTR = 7编码输出缓存指针地址。
ACL_VENC_BUF_SIZE_UINT32 = 8编码输出缓存大小，单位为Byte。（说明：在 Atlas 200/500 A2推理产品 上，如果不设置该参数，参数值默认为8M；如果设置该参数，参数值最小为5M。）
ACL_VENC_RC_MODE_UINT32 = 9指定码率控制模式。
- 1表示变码率VBR模式。
- 2表示定码率CBR模式。
（说明：如果不设置该参数，则采用默认值0。 Atlas 200/500 A2推理产品 ，默认值0表示VBR模式。）
ACL_VENC_SRC_RATE_UINT32 = 10输入码流帧率，单位fps。 Atlas 200/500 A2推理产品，取值范围0或者[1,240]。 如果不设置该参数，默认为30；如果设置为0，表示使用默认值，即30。如果该值和实际输入码流帧率相差太大，会影响输出码率。
ACL_VENC_MAX_BITRATE_UINT32 = 11输出码率，单位kbps。 Atlas 200/500 A2推理产品，取值范围[2,614400]，如果不设置该参数，默认为2000；如果设置为0，表示使用默认值，即2000。
ACL_VENC_MAX_IP_PROP_UINT32 = 12一个GOP内单个I帧bit数和单个P帧bit数的比例，取值范围0或[1,100] 。如果不设置该参数，VBR模式下此值默认为80，CBR模式下此值默认为70；如果设置为0，表示使用默认值，即VBR模式下此值默认为80，CBR模式下此值默认为70。

父主题： 数据类型及其操作接口

aclmdlConfigAttr​

模型加载配置类型含义
ACL_MDL_PRIORITY_INT32 = 0模型执行的优先级，数字越小优先级越高，取值[0, 7]，可选项。默认值为0。
ACL_MDL_LOAD_TYPE_SIZET = 1模型加载方式，具体请参见表1，必选项。
ACL_MDL_PATH_STR = 2离线模型文件路径的指针地址，如果选择从文件加载模型，则该选项必选。
ACL_MDL_MEM_ADDR_PTR = 3模型在内存中的起始地址，如果选择从内存加载模型，则该选项必选。
ACL_MDL_MEM_SIZET = 4模型在内存中的大小，如果选择从内存加载模型，则该选项必选，与ACL_MDL_MEM_ADDR_PTR选项配合使用。
ACL_MDL_WEIGHT_ADDR_PTR = 5Device上模型权值内存（存放权值数据）的指针地址，如果需要由用户管理权值内存，则该选项必选。若不配置该选项，则表示由系统管理内存。
ACL_MDL_WEIGHT_SIZET = 6权值内存大小，单位为Byte，如果需要由用户管理权值内存，则该选项必选，与ACL_MDL_WEIGHT_ADDR_PTR选项配合使用。
ACL_MDL_WORKSPACE_ADDR_PTR = 7Device上模型所需工作内存（存放模型输入/输出等数据）的指针地址，如果需要由用户管理工作内存，则该选项必选。若不配置该选项，则表示由系统管理内存。
ACL_MDL_WORKSPACE_SIZET = 8模型所需工作内存的大小，单位为Byte，如果需要由用户管理权值内存，则该选项必选，与ACL_MDL_WORKSPACE_ADDR_PTR选项配合使用。
ACL_MDL_INPUTQ_NUM_SIZET = 9模型输入队列大小 ,带队列加载模型时，该选项必选，与ACL_MDL_INPUTQ_ADDR_PTR选项配合使用。
ACL_MDL_INPUTQ_ADDR_PTR = 10模型输入队列ID的指针地址，带队列加载模型时，该选项必选，一个模型输入对应一个队列ID。
ACL_MDL_OUTPUTQ_NUM_SIZET = 11模型输出队列大小，带队列加载模型时，该选项必选，与ACL_MDL_OUTPUTQ_ADDR_PTR选项配合使用。
ACL_MDL_OUTPUTQ_ADDR_PTR = 12模型输出队列ID的指针地址，带队列加载模型时，该选项必选，一个模型输出对应一个队列ID。
ACL_MDL_WORKSPACE_MEM_OPTIMIZE是否开启模型工作内存优化功能，1开启，0不开启。 若关注内存规划或内存资源有限时，建议在模型加载前，开启工作内存优化功能，此时工作内存中不包含存放模型输入、输出数据的内存，工作内存大小会减小，达到节省内存的目的。 在模型执行前，还需要由用户申请存放模型输入、输出数据的内存，因此即使在模型加载时开启工作内存优化功能，也不会影响后续的模型执行。

表1 ACL_MDL_LOAD_TYPE_SIZET对应的属性值

模型加载方式含义
ACL_MDL_LOAD_FROM_FILE = 1从文件加载离线模型数据，由系统内部管理内存。
ACL_MDL_LOAD_FROM_FILE_WITH_MEM = 2从文件加载离线模型数据，由用户自行管理模型运行的内存。
ACL_MDL_LOAD_FROM_MEM = 3从内存加载离线模型数据，由系统内部管理模型运行的内存。
ACL_MDL_LOAD_FROM_MEM_WITH_MEM = 4从内存加载离线模型数据，由用户自行管理模型运行的内存。
ACL_MDL_LOAD_FROM_FILE_WITH_Q = 5从文件加载离线模型数据，模型的输入、输出数据都存放在队列中。

:::note 说明 关于如何获取om文件，请参见模型构建。

对om模型文件大小有限制的场景下，如果使用ATC工具生成om文件时，将“--external_weight”参数设置为1（1表示将原始网络中的Const/Constant节点的权重保存在单独的文件中，且该文件保存在与om文件同级的“weight”目录下），那么在使用本接口加载om文件时，需将“weight”目录与om文件放在同级目录下，这时pyACL会自行到“weight”目录下查找权重文件，否则可能会导致单独的权重文件加载不成功。 :::

父主题： 数据类型及其操作接口

aclmdlExecConfigAttr​

参数项含义
ACL_MDL_STREAM_SYNC_TIMEOUT = 0在执行模型推理时控制Stream任务的超时时间。该属性值为INT32类型。
ACL_MDL_STREAM_SYNC_TIMEOUT = 1在执行模型推理时控制Event任务的超时时间。该属性值为INT32类型。
ACL_MDL_WORK_ADDR_PTR = 2模型所需工作内存（Device上存放模型执行过程中的临时数据）的指针地址，由用户管理工作内存。一般用于模型一次加载、多并发执行的场景。 当前版本不支持该配置。
ACL_MDL_WORK_SIZET = 3模型所需工作内存的大小，单位为Byte。一般用于模型一次加载、多并发执行的场景。 当前版本不支持该配置。
ACL_MDL_MPAIMID_SIZET = 4预留配置。
ACL_MDL_AICQOS_SIZET = 5预留配置。
ACL_MDL_AICOST_SIZET = 6预留配置。
ACL_MDL_MEC_TIMETHR_SIZET = 7预留配置。

父主题： 数据类型及其操作接口

aclMemType​

内存类型含义
ACL_MEMTYPE_DEVICE = 0Device内存。
ACL_MEMTYPE_HOST = 1Host内存。
ACL_MEMTYPE_HOST_COMPILE_INDEPENDENT = 2Host内存。

:::note 说明 ACL_MEMTYPE_HOST和ACL_MEMTYPE_HOST_COMPILE_INDEPENDENT都标识Host内存，但在使用上有区别：

  • ACL_MEMTYPE_HOST：设置该选项时，模糊编译场景下，算子输入或输出的值的变化，不会触发算子重新编译；精确编译场景下，算子输入或输出的值的变化，会触发算子重新编译。
  • ACL_MEMTYPE_HOST_COMPILE_INDEPENDENT ：设置该选项时，无论是模糊编译，还是精确编译，算子输入或输出的值的变化，都不会触发算子重新编译。若算子编译时依赖其输入或输出的值，此时如果设置为 ACL_MEMTYPE_HOST_COMPILE_INDEPENT，则可能会导致编译失败。 :::

父主题： 数据类型及其操作接口

在线提单