/** * Copyright 2019-2020 Huawei Technologies Co., Ltd * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #if !defined(ENABLE_DVPP_INTERFACE) #if defined(_MSC_VER) #error message("if you want to use dvpp funtions ,please use the macro definition (ENABLE_DVPP_INTERFACE).") #else #error "if you want to use dvpp funtions ,please use the macro definition (ENABLE_DVPP_INTERFACE)." #endif #endif #ifndef INC_EXTERNAL_ACL_OPS_ACL_DVPP_H_ #define INC_EXTERNAL_ACL_OPS_ACL_DVPP_H_ #include #include #include "acl/acl.h" #include "acl/acl_base.h" #ifdef __cplusplus extern "C" { #endif typedef struct acldvppPicDesc acldvppPicDesc; typedef struct acldvppBatchPicDesc acldvppBatchPicDesc; typedef struct acldvppRoiConfig acldvppRoiConfig; typedef struct acldvppResizeConfig acldvppResizeConfig; typedef struct acldvppBorderConfig acldvppBorderConfig; typedef struct acldvppLutMap acldvppLutMap; typedef struct acldvppChannelDesc acldvppChannelDesc; typedef struct acldvppJpegeConfig acldvppJpegeConfig; typedef struct aclvdecChannelDesc aclvdecChannelDesc; typedef struct acldvppStreamDesc acldvppStreamDesc; typedef struct aclvdecFrameConfig aclvdecFrameConfig; typedef struct aclvencChannelDesc aclvencChannelDesc; typedef struct aclvencFrameConfig aclvencFrameConfig; typedef struct acldvppHist acldvppHist; typedef void (*aclvdecCallback)(acldvppStreamDesc *input, acldvppPicDesc *output, void *userData); typedef void (*aclvencCallback)(acldvppPicDesc *input, acldvppStreamDesc *output, void *userdata); // Supported Pixel Format enum acldvppPixelFormat { PIXEL_FORMAT_YUV_400 = 0, // 0 PIXEL_FORMAT_YUV_SEMIPLANAR_420 = 1, // 1 PIXEL_FORMAT_YVU_SEMIPLANAR_420 = 2, // 2 PIXEL_FORMAT_YUV_SEMIPLANAR_422 = 3, // 3 PIXEL_FORMAT_YVU_SEMIPLANAR_422 = 4, // 4 PIXEL_FORMAT_YUV_SEMIPLANAR_444 = 5, // 5 PIXEL_FORMAT_YVU_SEMIPLANAR_444 = 6, // 6 PIXEL_FORMAT_YUYV_PACKED_422 = 7, // 7 PIXEL_FORMAT_UYVY_PACKED_422 = 8, // 8 PIXEL_FORMAT_YVYU_PACKED_422 = 9, // 9 PIXEL_FORMAT_VYUY_PACKED_422 = 10, // 10 PIXEL_FORMAT_YUV_PACKED_444 = 11, // 11 PIXEL_FORMAT_RGB_888 = 12, // 12 PIXEL_FORMAT_BGR_888 = 13, // 13 PIXEL_FORMAT_ARGB_8888 = 14, // 14 PIXEL_FORMAT_ABGR_8888 = 15, // 15 PIXEL_FORMAT_RGBA_8888 = 16, // 16 PIXEL_FORMAT_BGRA_8888 = 17, // 17 PIXEL_FORMAT_YUV_SEMI_PLANNER_420_10BIT = 18, // 18 PIXEL_FORMAT_YVU_SEMI_PLANNER_420_10BIT = 19, // 19 PIXEL_FORMAT_YVU_PLANAR_420 = 20, // 20 PIXEL_FORMAT_YVU_PLANAR_422, PIXEL_FORMAT_YVU_PLANAR_444, PIXEL_FORMAT_RGB_444 = 23, PIXEL_FORMAT_BGR_444, PIXEL_FORMAT_ARGB_4444, PIXEL_FORMAT_ABGR_4444, PIXEL_FORMAT_RGBA_4444, PIXEL_FORMAT_BGRA_4444, PIXEL_FORMAT_RGB_555, PIXEL_FORMAT_BGR_555, PIXEL_FORMAT_RGB_565, PIXEL_FORMAT_BGR_565, PIXEL_FORMAT_ARGB_1555, PIXEL_FORMAT_ABGR_1555, PIXEL_FORMAT_RGBA_1555, PIXEL_FORMAT_BGRA_1555, PIXEL_FORMAT_ARGB_8565, PIXEL_FORMAT_ABGR_8565, PIXEL_FORMAT_RGBA_8565, PIXEL_FORMAT_BGRA_8565, PIXEL_FORMAT_RGB_BAYER_8BPP = 50, PIXEL_FORMAT_RGB_BAYER_10BPP, PIXEL_FORMAT_RGB_BAYER_12BPP, PIXEL_FORMAT_RGB_BAYER_14BPP, PIXEL_FORMAT_RGB_BAYER_16BPP, PIXEL_FORMAT_BGR_888_PLANAR = 70, PIXEL_FORMAT_HSV_888_PACKAGE, PIXEL_FORMAT_HSV_888_PLANAR, PIXEL_FORMAT_LAB_888_PACKAGE, PIXEL_FORMAT_LAB_888_PLANAR, PIXEL_FORMAT_S8C1, PIXEL_FORMAT_S8C2_PACKAGE, PIXEL_FORMAT_S8C2_PLANAR, PIXEL_FORMAT_S16C1, PIXEL_FORMAT_U8C1, PIXEL_FORMAT_U16C1, PIXEL_FORMAT_S32C1, PIXEL_FORMAT_U32C1, PIXEL_FORMAT_U64C1, PIXEL_FORMAT_S64C1, PIXEL_FORMAT_YUV_SEMIPLANAR_440 = 1000, PIXEL_FORMAT_YVU_SEMIPLANAR_440, PIXEL_FORMAT_FLOAT32, PIXEL_FORMAT_BUTT, PIXEL_FORMAT_UNKNOWN = 10000 }; // Stream Format enum acldvppStreamFormat { H265_MAIN_LEVEL = 0, H264_BASELINE_LEVEL, H264_MAIN_LEVEL, H264_HIGH_LEVEL }; // Supported Channel Mode enum acldvppChannelMode { DVPP_CHNMODE_VPC = 1, DVPP_CHNMODE_JPEGD = 2, DVPP_CHNMODE_JPEGE = 4 }; // Supported Border Type enum acldvppBorderType { BORDER_CONSTANT = 0, BORDER_REPLICATE, BORDER_REFLECT, BORDER_REFLECT_101 }; // Venc parameter type enum aclvencChannelDescParamType { ACL_VENC_THREAD_ID_UINT64 = 0, ACL_VENC_CALLBACK_PTR, ACL_VENC_PIXEL_FORMAT_UINT32, ACL_VENC_ENCODE_TYPE_UINT32, ACL_VENC_PIC_WIDTH_UINT32, ACL_VENC_PIC_HEIGHT_UINT32, ACL_VENC_KEY_FRAME_INTERVAL_UINT32, ACL_VENC_BUF_ADDR_PTR, ACL_VENC_BUF_SIZE_UINT32, ACL_VENC_RC_MODE_UINT32, ACL_VENC_SRC_RATE_UINT32, ACL_VENC_MAX_BITRATE_UINT32, ACL_VENC_MAX_IP_PROP_UINT32 }; // Jpeg picture format enum acldvppJpegFormat { ACL_JPEG_CSS_444 = 0, ACL_JPEG_CSS_422, ACL_JPEG_CSS_420, ACL_JPEG_CSS_GRAY, ACL_JPEG_CSS_440, ACL_JPEG_CSS_411, ACL_JPEG_CSS_UNKNOWN = 1000 }; /** * @ingroup AscendCL * @brief alloc device memory for dvpp. * * @par Function * @li It's mainly used for allocating memory to device media data processing. * The requested memory meets the data processing requirements. * After calling this interface to request memory, * you must release the memory using the acldvppFree interface. * @li When calling the acldvppMalloc interface to apply for memory, * the size entered by the user is aligned upwards to 32 integer multiples, * and an additional 32 bytes are applied. * * @par Restriction * If the user uses the acldvppMalloc interface to apply for a large block of * memory and divide and manage the memory by himself, * when applying for memory, the user needs to align up to 32 integer * times + 32 bytes (ALIGN_UP [len] +32 words) according to * the actual data size of each picture Section) to manage memory. * * @param devPtr [OUT] memory pointer. * @param size [IN] memory size. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see acldvppFree */ ACL_FUNC_VISIBILITY aclError acldvppMalloc(void **devPtr, size_t size); /** * @ingroup AscendCL * @brief free device memory for dvpp. * * @par Function * Free the memory requested through the acldvppMalloc interface * @param devPtr [IN] memory pointer to free. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see acldvppMalloc */ ACL_FUNC_VISIBILITY aclError acldvppFree(void *devPtr); /** * @ingroup AscendCL * @brief create DvppChannelDesc. * * @par Function * Create a channel for image data processing. * The same channel can be reused * and is no longer available after destruction * * @retval null for failed. * @retval OtherValues success. */ ACL_FUNC_VISIBILITY acldvppChannelDesc *acldvppCreateChannelDesc(); /** * @ingroup AscendCL * @brief destroy dvppChannelDesc. * * @par Function * Can only destroy channels created by the acldvppCreateChannel interface * @param channelDesc [IN] the channel description. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see acldvppCreateChannelDesc | acldvppDestroyChannel */ ACL_FUNC_VISIBILITY aclError acldvppDestroyChannelDesc(acldvppChannelDesc *channelDesc); /** * @ingroup AscendCL * @brief Get dvpp channel Id. * * @par Restriction * Interface calling sequence: * acldvppCreateChannelDesc --> acldvppCreateChannel --> * acldvppGetChannelDescChannelId * * @param channelDesc [IN] the channel description. * * @retval channel id. * * @see acldvppCreateChannelDesc | acldvppCreateChannel */ ACL_FUNC_VISIBILITY uint64_t acldvppGetChannelDescChannelId(const acldvppChannelDesc *channelDesc); /** * @ingroup AscendCL * @brief Create dvpp picture description. * * @retval null for failed. * @retval OtherValues success. */ ACL_FUNC_VISIBILITY acldvppPicDesc *acldvppCreatePicDesc(); /** * @ingroup AscendCL * @brief Destroy dvpp picture description. * * @par Function * Can only destroy picture description information created * through acldvppCreatePicDesc interface. * @param picDesc [IN] dvpp picture description. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see acldvppCreatePicDesc */ ACL_FUNC_VISIBILITY aclError acldvppDestroyPicDesc(acldvppPicDesc *picDesc); /** * @ingroup AscendCL * @brief Set dvpp picture description's data. * * @param picDesc [OUT] dvpp picture description. * @param dataDev [IN] dvpp picture dataDev.Must be the memory * requested using the acldvppMalloc interface. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see acldvppMalloc */ ACL_FUNC_VISIBILITY aclError acldvppSetPicDescData(acldvppPicDesc *picDesc, void *dataDev); /** * @ingroup AscendCL * @brief Set dvpp picture description's size. * * @param picDesc [OUT] dvpp picture description. * @param size dvpp [IN] picture size. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError acldvppSetPicDescSize(acldvppPicDesc *picDesc, uint32_t size); /** * @ingroup AscendCL * @brief Set dvpp picture description's format. * * @param picDesc [OUT] dvpp picture description. * @param format [IN] dvpp picture format. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError acldvppSetPicDescFormat(acldvppPicDesc *picDesc, acldvppPixelFormat format); /** * @ingroup AscendCL * @brief Set dvpp picture description's width. * * @param picDesc [OUT] dvpp picture description. * @param width [IN] dvpp picture width. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError acldvppSetPicDescWidth(acldvppPicDesc *picDesc, uint32_t width); /** * @ingroup AscendCL * @brief Set dvpp picture description's height. * * @param picDesc [OUT] dvpp picture description. * @param height [IN] dvpp picture height. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError acldvppSetPicDescHeight(acldvppPicDesc *picDesc, uint32_t height); /** * @ingroup AscendCL * @brief Set dvpp picture description's widthStride. * * @par Restriction * Width alignment requirements: * @li The minimum stride is 32 and the maximum is 4096 * 4 * (that is, an image in argb format with a width of 4096); * @li For 8K scaling, widthStride is required to be aligned to 2; * @li For non 8K scaling, the calculation formula for widthStride * is different for different image formats: * @li yuv400sp, yuv420sp, yuv422sp, yuv444sp: input image width aligned to 16 * @li yuv422packed: input image width * 2 and then align to 16 * @li yuv444packed, rgb888: input image width alignment * 3, alignment to 16 * @li xrgb8888: input image width * 4, align to 16 * @li HFBC:input image width * * @param picDesc [OUT] dvpp picture description. * @param widthStride [IN] dvpp picture widthStride. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError acldvppSetPicDescWidthStride(acldvppPicDesc *picDesc, uint32_t widthStride); /** * @ingroup AscendCL * @brief Set dvpp picture description's heightStride. * * @par Restriction * Height alignment requirements: * @li The height of the input image is aligned to 2. * High stride minimum 6 and maximum 4096. * * @param picDesc [OUT] dvpp picture description. * @param heightStride [IN] dvpp picture heightStride. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError acldvppSetPicDescHeightStride(acldvppPicDesc *picDesc, uint32_t heightStride); /** * @ingroup AscendCL * @brief Set dvpp picture description's retcode. * * @param picDesc [OUT] dvpp picture description. * @param retCode [IN] dvpp picture retcode. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError acldvppSetPicDescRetCode(acldvppPicDesc *picDesc, uint32_t retCode); /** * @ingroup AscendCL * @brief Get picture data. * * @param picDesc [IN] dvpp picture description. * * @retval picture data addr. * @retval default nullptr. */ ACL_FUNC_VISIBILITY void *acldvppGetPicDescData(const acldvppPicDesc *picDesc); /** * @ingroup AscendCL * @brief Get picture data size. * * @param picDesc [IN] dvpp picture description. * * @retval picture data size. * @retval default 0. */ ACL_FUNC_VISIBILITY uint32_t acldvppGetPicDescSize(const acldvppPicDesc *picDesc); /** * @ingroup AscendCL * @brief Get dvpp picture desc's format. * * @param picDesc [IN] dvpp picture description. * * @retval format * @retval default PIXEL_FORMAT_YUV_400. */ ACL_FUNC_VISIBILITY acldvppPixelFormat acldvppGetPicDescFormat(const acldvppPicDesc *picDesc); /** * @ingroup AscendCL * @brief Get dvpp picture desc's width. * * @param picDesc [IN] dvpp picture description. * * @retval width. * @retval default 0. */ ACL_FUNC_VISIBILITY uint32_t acldvppGetPicDescWidth(const acldvppPicDesc *picDesc); /** * @ingroup AscendCL * @brief Get dvpp picture desc's height. * * @param picDesc [IN] dvpp picture description. * * @retval height. * @retval default 0. */ ACL_FUNC_VISIBILITY uint32_t acldvppGetPicDescHeight(const acldvppPicDesc *picDesc); /** * @ingroup AscendCL * @brief Get dvpp picture desc's widthStride. * * @par Restriction * Width alignment requirements: * @li The minimum stride is 32 and the maximum is 4096 * 4 * (that is, an image in argb format with a width of 4096); * @li For 8K scaling, widthStride is required to be aligned to 2; * @li For non 8K scaling, the calculation formula for widthStride * is different for different image formats: * @li yuv400sp, yuv420sp, yuv422sp, yuv444sp: input image width aligned to 16 * @li yuv422packed: input image width * 2 and then align to 16 * @li yuv444packed, rgb888: input image width alignment * 3, alignment to 16 * @li xrgb8888: input image width * 4, align to 16 * @li HFBC:input image width * * @param picDesc [IN] dvpp picture description. * * @retval stride width. * @retval default 0. */ ACL_FUNC_VISIBILITY uint32_t acldvppGetPicDescWidthStride(const acldvppPicDesc *picDesc); /** * @ingroup AscendCL * @brief Get dvpp picture desc's heightStride. * * @par Restriction * Height alignment requirements: * @li The height of the input image is aligned to 2. * High stride minimum 6 and maximum 4096. * * @param picDesc [IN] dvpp picture description. * * @retval stride height. * @retval default 0. */ ACL_FUNC_VISIBILITY uint32_t acldvppGetPicDescHeightStride(const acldvppPicDesc *picDesc); /** * @ingroup AscendCL * @brief Get dvpp picture desc's retcode. * * @param picDesc [IN] dvpp picture description. * * @retval ret code. * @retval default 0. */ ACL_FUNC_VISIBILITY uint32_t acldvppGetPicDescRetCode(const acldvppPicDesc *picDesc); /** * @ingroup AscendCL * @brief Create dvpp roi config. * * @param left [IN] the left offset, must be even * @param right [IN] the right offset, must be odd * @param top [IN] the top offset, must be even * @param bottom [IN] the bottom offset, must be odd * * @retval null for failed. * @retval other success */ ACL_FUNC_VISIBILITY acldvppRoiConfig *acldvppCreateRoiConfig(uint32_t left, uint32_t right, uint32_t top, uint32_t bottom); /** * @ingroup AscendCL * @brief Destroy dvpp roi config. * * @par Function * Destroys data created through the acldvppCreateRoiConfig interface * @param roiConfig [IN] dvpp roi config. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see acldvppCreateRoiConfig */ ACL_FUNC_VISIBILITY aclError acldvppDestroyRoiConfig(acldvppRoiConfig *roiConfig); /** * @ingroup AscendCL * @brief Set left of RoiConfig. * * @param config [OUT] RoiConfig * @param left [IN] left offset * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError acldvppSetRoiConfigLeft(acldvppRoiConfig *config, uint32_t left); /** * @ingroup AscendCL * @brief Set right of RoiConfig. * * @param config [OUT] RoiConfig * @param right [IN] right offset * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError acldvppSetRoiConfigRight(acldvppRoiConfig *config, uint32_t right); /** * @ingroup AscendCL * @brief Set top of RoiConfig. * * @param config [OUT] RoiConfig * @param top [IN] top offset * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError acldvppSetRoiConfigTop(acldvppRoiConfig *config, uint32_t top); /** * @ingroup AscendCL * @brief Set bottom of RoiConfig. * * @param config [OUT] RoiConfig * @param bottom [IN] bottom offset * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError acldvppSetRoiConfigBottom(acldvppRoiConfig *config, uint32_t bottom); /** * @ingroup AscendCL * @brief Set RoiConfig. * * @param config [OUT] RoiConfig * @param left [IN] left offset * @param right [IN] right offset * @param top [IN] top offset * @param bottom [IN] bottom offset * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError acldvppSetRoiConfig(acldvppRoiConfig *config, uint32_t left, uint32_t right, uint32_t top, uint32_t bottom); /** * @ingroup AscendCL * @brief Create dvpp resize config. * The specified scaling algorithm is not supported. * The default scaling algorithm is "nearest neighbor interpolation". * * @retval null for failed. * @retval other success. */ ACL_FUNC_VISIBILITY acldvppResizeConfig *acldvppCreateResizeConfig(); /** * @ingroup AscendCL * @brief Destroy dvpp resize config. * * @par Function * Destroys the scaling configuration data created by * the acldvppCreateResizeConfig interface * * @param resizeConfig [IN] resize config. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see acldvppCreateResizeConfig */ ACL_FUNC_VISIBILITY aclError acldvppDestroyResizeConfig(acldvppResizeConfig *resizeConfig); /** * @ingroup AscendCL * @brief Create jpege config. * * @retval null for failed. * @retval other success. */ ACL_FUNC_VISIBILITY acldvppJpegeConfig *acldvppCreateJpegeConfig(); /** * @ingroup AscendCL * @brief Destroy jpege config. * * @par Function * Destroys the encoding configuration data created by * the acldvppCreateJpegeConfig interface * @param jpegeConfig [IN] config pointer to destroy. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see acldvppCreateJpegeConfig */ ACL_FUNC_VISIBILITY aclError acldvppDestroyJpegeConfig(acldvppJpegeConfig *jpegeConfig); /** * @ingroup AscendCL * @brief Set jpege config's level. * * @param jpegeConfig [OUT] Call the acldvppCreateJpegeConfig * interface to create acldvppJpegeConfig data * @param level [IN] Encoding quality range [0, 100], * where level 0 encoding quality is similar to level 100, * and the smaller the value in [1, 100], * the worse the quality of the output picture. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError acldvppSetJpegeConfigLevel(acldvppJpegeConfig *jpegeConfig, uint32_t level); /** * @ingroup AscendCL * @brief Get jpege config's level. * * @param jpegeConfig [IN] jpege config. * * @retval compression level. * @retval default 0. */ ACL_FUNC_VISIBILITY uint32_t acldvppGetJpegeConfigLevel(const acldvppJpegeConfig *jpegeConfig); /** * @ingroup AscendCL * @brief create vdecChannelDesc.Channel description information * when creating a video data processing channel. * * @retval null for failed. * @retval other success */ ACL_FUNC_VISIBILITY aclvdecChannelDesc *aclvdecCreateChannelDesc(); /** * @ingroup AscendCL * @brief destroy vdecChannelDesc. * * @par Function * Can only destroy aclvdecChannelDesc type created * through aclvdecCreateChannelDesc interface * @param channelDesc [IN] channel description. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * @see aclvdecCreateChannelDesc */ ACL_FUNC_VISIBILITY aclError aclvdecDestroyChannelDesc(aclvdecChannelDesc *channelDesc); /** * @ingroup AscendCL * @brief Set vdec channel description's channel id. * * @param channelDesc [OUT] vdec channel description. * @param channelId [IN] decoding channel id: 0~15. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError aclvdecSetChannelDescChannelId(aclvdecChannelDesc *channelDesc, uint32_t channelId); /** * @ingroup AscendCL * @brief Set vdec channel description's thread id. * * @param channelDesc [OUT] vdec channel description. * @param threadId [IN] thread id. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError aclvdecSetChannelDescThreadId(aclvdecChannelDesc *channelDesc, uint64_t threadId); /** * @ingroup AscendCL * @brief Set vdec channel description's callback function. * * @param channelDesc [OUT] vdec channel description. * @param callback [IN] function callback.Function prototype: * void (* aclvdecCallback) * (acldvppStreamDesc * input, acldvppPicDesc * output, void* userdata) * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see aclvdecCallback */ ACL_FUNC_VISIBILITY aclError aclvdecSetChannelDescCallback(aclvdecChannelDesc *channelDesc, aclvdecCallback callback); /** * @ingroup AscendCL * @brief Set vdec channel description's video encoding type. * * @param channelDesc [OUT] vdec channel description. * @param enType [IN] video encoding type. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError aclvdecSetChannelDescEnType(aclvdecChannelDesc *channelDesc, acldvppStreamFormat enType); /** * @ingroup AscendCL * @brief Set vdec channel description's out picture format. * * @param channelDesc [OUT] vdec channel description. * @param outPicFormat [IN] out picture format (acldvppPixelFormat). * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError aclvdecSetChannelDescOutPicFormat(aclvdecChannelDesc *channelDesc, acldvppPixelFormat outPicFormat); /** * @ingroup AscendCL * @brief Set vdec channel description's out picture width. * * @param channelDesc [OUT] vdec channel description. * @param outPicWidth [IN] out picture width. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError aclvdecSetChannelDescOutPicWidth(aclvdecChannelDesc *channelDesc, uint32_t outPicWidth); /** * @ingroup AscendCL * @brief Set vdec channel description's out picture height. * * @param channelDesc [OUT] vdec channel description. * @param outPicHeight [IN] out picture height. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError aclvdecSetChannelDescOutPicHeight(aclvdecChannelDesc *channelDesc, uint32_t outPicHeight); /** * @ingroup AscendCL * @brief Set vdec channel description's reference frame num. * * @param channelDesc [OUT] vdec channel description. * @param refFrameNum [IN] reference frame num. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError aclvdecSetChannelDescRefFrameNum(aclvdecChannelDesc *channelDesc, uint32_t refFrameNum); /** * @ingroup AscendCL * @brief Set vdec channel description's bit depth. * * @param channelDesc [OUT] vdec channel description. * @param bitDepth [IN] bit depth. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError aclvdecSetChannelDescBitDepth(aclvdecChannelDesc *channelDesc, uint32_t bitDepth); /** * @ingroup AscendCL * @brief Get vdec channel description's channel id. * * @param channelDesc [IN] vdec channel description. * * @retval decoding channel id: 0~15. * @retval default 0. */ ACL_FUNC_VISIBILITY uint32_t aclvdecGetChannelDescChannelId(const aclvdecChannelDesc *channelDesc); /** * @ingroup AscendCL * @brief Get vdec channel description's thread id. * * @param channelDesc [IN] vdec channel description. * * @retval thread id. * @retval default 0. */ ACL_FUNC_VISIBILITY uint64_t aclvdecGetChannelDescThreadId(const aclvdecChannelDesc *channelDesc); /** * @ingroup AscendCL * @brief Get vdec channel description's callback function. * * @param channelDesc [IN] vdec channel description. * * @retval function callback.Function prototype: * void (* aclvdecCallback) * (acldvppStreamDesc * input, acldvppPicDesc * output, void* userdata) * @retval default null. * * @see aclvdecCallback */ ACL_FUNC_VISIBILITY aclvdecCallback aclvdecGetChannelDescCallback(const aclvdecChannelDesc *channelDesc); /** * @ingroup AscendCL * @brief Get vdec channel description's video encoding type. * * @param channelDesc [IN] vdec channel description. * * @retval video encoding type. * @retval default H265_MAIN_LEVEL. */ ACL_FUNC_VISIBILITY acldvppStreamFormat aclvdecGetChannelDescEnType(const aclvdecChannelDesc *channelDesc); /** * @ingroup AscendCL * @brief Get vdec channel description's out picture format. * * @param channelDesc [IN] vdec channel description. * * @retval out picture format. * @retval default DVPP_OUTPUT_YUV420SP_UV. */ ACL_FUNC_VISIBILITY acldvppPixelFormat aclvdecGetChannelDescOutPicFormat(const aclvdecChannelDesc *channelDesc); /** * @ingroup AscendCL * @brief Get vdec channel description's out picture width. * * @param channelDesc [IN] vdec channel description. * * @retval out picture width. * @retval default 0. */ ACL_FUNC_VISIBILITY uint32_t aclvdecGetChannelDescOutPicWidth(const aclvdecChannelDesc *channelDesc); /** * @ingroup AscendCL * @brief Get vdec channel description's out picture height. * * @param channelDesc [IN] vdec channel description. * * @retval out picture height (for vdec malloc memory). * @retval default 0. */ ACL_FUNC_VISIBILITY uint32_t aclvdecGetChannelDescOutPicHeight(const aclvdecChannelDesc *channelDesc); /** * @ingroup AscendCL * @brief Get vdec channel description's bit depth. * * @param channelDesc [IN] vdec channel description. * * @retval bit depth. * @retval default 0. */ ACL_FUNC_VISIBILITY uint32_t aclvdecGetChannelDescBitDepth(const aclvdecChannelDesc *channelDesc); /** * @ingroup AscendCL * @brief Get vdec channel description's reference frame num. * * @param channelDesc [IN] vdec channel description. * * @retval reference frame num. * @retval default 0. */ ACL_FUNC_VISIBILITY uint32_t aclvdecGetChannelDescRefFrameNum(const aclvdecChannelDesc *channelDesc); /** * @ingroup AscendCL * @brief create vencChannelDesc. * * @retval null for failed, other success */ ACL_FUNC_VISIBILITY aclvencChannelDesc *aclvencCreateChannelDesc(); /** * @ingroup AscendCL * @brief destroy vencChannelDesc. * * @param channelDesc [IN] channel desc. * * @retval ACL_SUCCESS:success, other:failed */ ACL_FUNC_VISIBILITY aclError aclvencDestroyChannelDesc(aclvencChannelDesc *channelDesc); /** * @ingroup AscendCL * @brief Set decoding thread id for venc channel desc. * * @param channelDesc [OUT] venc channel desc * @param threadId [IN] thread id * * @retval ACL_SUCCESS for success, other for failure */ ACL_FUNC_VISIBILITY aclError aclvencSetChannelDescThreadId(aclvencChannelDesc *channelDesc, uint64_t threadId); /** * @ingroup AscendCL * @brief Set func callback for venc channel desc. * * @param channelDesc [OUT] venc channel desc * @param callback [IN] func callback * * @retval ACL_SUCCESS for success, other for failure */ ACL_FUNC_VISIBILITY aclError aclvencSetChannelDescCallback(aclvencChannelDesc *channelDesc, aclvencCallback callback); /** * @ingroup AscendCL * @brief Set video encoding type for venc channel desc. * * @param channelDesc [OUT] venc channel desc * @param enType [IN] video encoding type * * @retval ACL_SUCCESS for success, other for failure */ ACL_FUNC_VISIBILITY aclError aclvencSetChannelDescEnType(aclvencChannelDesc *channelDesc, acldvppStreamFormat enType); /** * @ingroup AscendCL * @brief Set pic format for venc channel desc. * * @param channelDesc [OUT] venc channel desc * @param picFormat [IN] pic format * * @retval ACL_SUCCESS for success, other for failure */ ACL_FUNC_VISIBILITY aclError aclvencSetChannelDescPicFormat(aclvencChannelDesc *channelDesc, acldvppPixelFormat picFormat); /** * @ingroup AscendCL * @brief Set out pic width for venc channel desc. * * @param channelDesc [OUT] venc channel desc * @param picWidth [IN] pic width * * @retval ACL_SUCCESS for success, other for failure */ ACL_FUNC_VISIBILITY aclError aclvencSetChannelDescPicWidth(aclvencChannelDesc *channelDesc, uint32_t picWidth); /** * @ingroup AscendCL * @brief Set pic height for venc channel desc. * * @param channelDesc [OUT] venc channel desc * @param picHeight [IN] pic height * * @retval ACL_SUCCESS for success, other for failure */ ACL_FUNC_VISIBILITY aclError aclvencSetChannelDescPicHeight(aclvencChannelDesc *channelDesc, uint32_t picHeight); /** * @ingroup AscendCL * @brief Set key frame interval for venc channel desc. * * @param channelDesc [OUT] venc channel desc * @param keyFrameInterval [IN] Interval of key frame * * @retval ACL_SUCCESS for success, other for failure */ ACL_FUNC_VISIBILITY aclError aclvencSetChannelDescKeyFrameInterval(aclvencChannelDesc *channelDesc, uint32_t keyFrameInterval); /** * @ingroup AscendCL * @brief Set output buffer address for venc channel desc. * * @param channelDesc [OUT] venc channel desc * @param bufAddr [IN] output buffer address * * @retval ACL_SUCCESS for success, other for failure */ ACL_FUNC_VISIBILITY aclError aclvencSetChannelDescBufAddr(aclvencChannelDesc *channelDesc, void *bufAddr); /** * @ingroup AscendCL * @brief Set output buffer size for venc channel desc. * * @param channelDesc [OUT] venc channel desc * @param bufSize [IN] output buffer size * * @retval ACL_SUCCESS for success, other for failure */ ACL_FUNC_VISIBILITY aclError aclvencSetChannelDescBufSize(aclvencChannelDesc *channelDesc, uint32_t bufSize); /** * @ingroup AscendCL * @brief Set rc model for venc channel desc. * * @param channelDesc [OUT] venc channel desc * @param rcMode [IN] venc rc mode(VBR=1, CBR=2) * * @retval ACL_SUCCESS for success, other for failure */ ACL_FUNC_VISIBILITY aclError aclvencSetChannelDescRcMode(aclvencChannelDesc *channelDesc, uint32_t rcMode); /** * @ingroup AscendCL * @brief Set source rate for venc channel desc. * * @param channelDesc [OUT] venc channel desc * @param srcRate [IN] source rate * * @retval ACL_SUCCESS for success, other for failure */ ACL_FUNC_VISIBILITY aclError aclvencSetChannelDescSrcRate(aclvencChannelDesc *channelDesc, uint32_t srcRate); /** * @ingroup AscendCL * @brief Set max bit rate for venc channel desc. * * @param channelDesc [OUT] venc channel desc * @param maxBitRate [IN] max bit rate * * @retval ACL_SUCCESS for success, other for failure */ ACL_FUNC_VISIBILITY aclError aclvencSetChannelDescMaxBitRate(aclvencChannelDesc *channelDesc, uint32_t maxBitRate); /** * @ingroup AscendCL * @brief Set venc parameter for venc channel desc. * * @param channelDesc [OUT] venc channel desc * @param paramType [IN] parameter type * @param length [IN] parameter length * @param param [IN] pointer to parameter value * * @retval ACL_SUCCESS for success, other for failure */ ACL_FUNC_VISIBILITY aclError aclvencSetChannelDescParam(aclvencChannelDesc *channelDesc, aclvencChannelDescParamType paramType, size_t length, const void *param); /** * @ingroup AscendCL * @brief Get output buffer address for venc channel desc. * * @param channelDesc[IN] venc channel desc * * @retval output buffer address */ ACL_FUNC_VISIBILITY void *aclvencGetChannelDescBufAddr(const aclvencChannelDesc *channelDesc); /** * @ingroup AscendCL * @brief Get output buffer size for venc channel desc. * * @param channelDesc [IN] venc channel desc * * @retval output buffer size */ ACL_FUNC_VISIBILITY uint32_t aclvencGetChannelDescBufSize(const aclvencChannelDesc *channelDesc); /** * @ingroup AscendCL * @brief Get decoding channel id for venc channel desc. * * @param channelDesc [IN] venc channel desc * * @retval decoding channel id: 0~15, default 0 */ ACL_FUNC_VISIBILITY uint32_t aclvencGetChannelDescChannelId(const aclvencChannelDesc *channelDesc); /** * @ingroup AscendCL * @brief Get decoding thread id for venc channel desc. * * @param channelDesc [IN] venc channel desc * * @retval thread id, default 0 */ ACL_FUNC_VISIBILITY uint64_t aclvencGetChannelDescThreadId(const aclvencChannelDesc *channelDesc); /** * @ingroup AscendCL * @brief Get func callback for venc channel desc. * * @param channelDesc [IN] venc channel desc * * @retval func callback, default null */ ACL_FUNC_VISIBILITY aclvencCallback aclvencGetChannelDescCallback(const aclvencChannelDesc *channelDesc); /** * @ingroup AscendCL * @brief Get video encoding type for venc channel desc. * * @param channelDesc [IN] venc channel desc * * @retval video encoding type, default H265_MAIN_LEVEL */ ACL_FUNC_VISIBILITY acldvppStreamFormat aclvencGetChannelDescEnType(const aclvencChannelDesc *channelDesc); /** * @ingroup AscendCL * @brief Get pic format for venc channel desc. * * @param channelDesc [IN] venc channel desc * * @retval pic format */ ACL_FUNC_VISIBILITY acldvppPixelFormat aclvencGetChannelDescPicFormat(const aclvencChannelDesc *channelDesc); /** * @ingroup AscendCL * @brief Get pic width for venc channel desc. * * @param channelDesc [IN] venc channel desc * * @retval pic width, default 0 */ ACL_FUNC_VISIBILITY uint32_t aclvencGetChannelDescPicWidth(const aclvencChannelDesc *channelDesc); /** * @ingroup AscendCL * @brief Get pic height for venc channel desc. * * @param channelDesc [IN] venc channel desc * * @retval pic height, default 0 */ ACL_FUNC_VISIBILITY uint32_t aclvencGetChannelDescPicHeight(const aclvencChannelDesc *channelDesc); /** * @ingroup AscendCL * @brief Get interval of key frame for venc channel desc. * * @param channelDesc [IN] venc channel desc * * @retval interval of key frame, default 0 */ ACL_FUNC_VISIBILITY uint32_t aclvencGetChannelDescKeyFrameInterval(const aclvencChannelDesc *channelDesc); /** * @ingroup AscendCL * * @brief Get rc mode for venc channel desc. * * @param channelDesc [IN] venc channel desc * * @retval rc mode, default 0 */ ACL_FUNC_VISIBILITY uint32_t aclvencGetChannelDescRcMode(const aclvencChannelDesc *channelDesc); /** * @ingroup AscendCL * * @brief Get source rate for venc channel desc. * * @param channelDesc [IN] venc channel desc * * @retval source rate, default 0 */ ACL_FUNC_VISIBILITY uint32_t aclvencGetChannelDescSrcRate(const aclvencChannelDesc *channelDesc); /** * @ingroup AscendCL * * @brief Get max bit rate for venc channel desc. * * @param channelDesc [IN] venc channel desc * * @retval max bit rate, default 0 */ ACL_FUNC_VISIBILITY uint32_t aclvencGetChannelDescMaxBitRate(const aclvencChannelDesc *channelDesc); /** * @ingroup AscendCL * * @brief Get venc parameter for venc channel desc. * * @param channelDesc [IN] venc channel desc * @param paramType [IN] parameter type * @param length [IN] parameter length * @param paramRetSize [OUT] pointer to parameter real length * @param param [OUT] pointer to parameter value * * @retval ACL_SUCCESS for success, other for failure */ ACL_FUNC_VISIBILITY aclError aclvencGetChannelDescParam(const aclvencChannelDesc *channelDesc, aclvencChannelDescParamType paramType, size_t length, size_t *paramRetSize, void *param); /** * @ingroup AscendCL * @brief get forced restart of I-frame interval from config * * @param config [IN] venc frame config * * @retval 0: Not forced; 1: Forced restart of I-frame -1: error */ ACL_FUNC_VISIBILITY uint8_t aclvencGetFrameConfigForceIFrame(const aclvencFrameConfig *config); /** * @ingroup AscendCL * @brief get forced restart of I-frame interval from config * * @param config [IN] venc frame config * * @retval Whether it is the end frame: 0: no; 1: end frame */ ACL_FUNC_VISIBILITY uint8_t aclvencGetFrameConfigEos(const aclvencFrameConfig *config); /** * @ingroup AscendCL * @brief set single frame encoding configuration parameters * * @param config [OUT] venc frame config * @param forceFrame [IN] forced restart of I-frame interval: 0: Not forced; 1: Forced restart of I-frame * * @retval ACL_SUCCESS for ok, others for fail */ ACL_FUNC_VISIBILITY aclError aclvencSetFrameConfigForceIFrame(aclvencFrameConfig *config, uint8_t forceIFrame); /** * @ingroup AscendCL * @brief set single frame encoding configuration parameters * * @param config [OUT] venc frame config * @param eos [IN] Whether it is the end frame: 0: no; 1: end frame * * @retval ACL_SUCCESS for ok, others for fail */ ACL_FUNC_VISIBILITY aclError aclvencSetFrameConfigEos(aclvencFrameConfig *config, uint8_t eos); /** * @ingroup AscendCL * @brief dvpp venc destroy frame config * * @param config [IN] venc frame config * * @retval ACL_SUCCESS for ok, others for fail */ ACL_FUNC_VISIBILITY aclError aclvencDestroyFrameConfig(aclvencFrameConfig *config); /** * @ingroup AscendCL * @brief Create dvpp venc frame config. * * @retval null for failed, other aclvencFrameConfig ptr */ ACL_FUNC_VISIBILITY aclvencFrameConfig *aclvencCreateFrameConfig(); /** * @ingroup AscendCL * @brief Create dvpp venc channel. * * @param channelDesc [IN|OUT] venc channel desc * * @retval ACL_SUCCESS for ok, others for fail */ ACL_FUNC_VISIBILITY aclError aclvencCreateChannel(aclvencChannelDesc *channelDesc); /** * @ingroup AscendCL * @brief Destroy dvpp venc channel. * * @param channelDesc [IN] venc channel desc * * @retval ACL_SUCCESS for ok, others for fail */ ACL_FUNC_VISIBILITY aclError aclvencDestroyChannel(aclvencChannelDesc *channelDesc); /** * @ingroup AscendCL * @brief dvpp venc launch send frame task. * * @param channelDesc [IN] venc channel desc * @param input [IN] input picture desc * @param reserve [IN] reserve parameter * @param config [IN] dvpp frame config * @param userdata [IN] user callback function * * @retval ACL_SUCCESS for ok, others for fail */ ACL_FUNC_VISIBILITY aclError aclvencSendFrame(aclvencChannelDesc *channelDesc, acldvppPicDesc *input, void *reserve, aclvencFrameConfig *config, void *userdata); /** * @ingroup AscendCL * @brief Create dvpp stream description. * * @retval null for failed. * @retval other success. */ ACL_FUNC_VISIBILITY acldvppStreamDesc *acldvppCreateStreamDesc(); /** * @ingroup AscendCL * @brief Destroy dvpp stream description. * * @par Function * Can only destroy acldvppStreamDesc type created through * acldvppCreateStreamDesc interface. * * @param streamDesc [IN] dvpp stream description. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see acldvppCreateStreamDesc */ ACL_FUNC_VISIBILITY aclError acldvppDestroyStreamDesc(acldvppStreamDesc *streamDesc); /** * @ingroup AscendCL * @brief Set stream description's data addr. * * @param streamDesc [OUT] dvpp stream description. * @param dataDev [IN] data addr. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError acldvppSetStreamDescData(acldvppStreamDesc *streamDesc, void *dataDev); /** * @ingroup AscendCL * @brief Set stream description's data size. * * @param streamDesc [OUT] dvpp stream description. * @param size [IN] data size. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError acldvppSetStreamDescSize(acldvppStreamDesc *streamDesc, uint32_t size); /** * @ingroup AscendCL * @brief Set stream description's format. * * @param streamDesc [OUT] dvpp stream description. * @param format [IN] stream format. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError acldvppSetStreamDescFormat(acldvppStreamDesc *streamDesc, acldvppStreamFormat format); /** * @ingroup AscendCL * @brief Set stream description's timestamp. * * @param streamDesc [OUT] dvpp stream description. * @param timestamp [IN] current timestamp. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError acldvppSetStreamDescTimestamp(acldvppStreamDesc *streamDesc, uint64_t timestamp); /** * @ingroup AscendCL * @brief Set stream description's ret code. * * @param streamDesc [OUT] dvpp stream description. * @param retCode [IN] result code. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError acldvppSetStreamDescRetCode(acldvppStreamDesc *streamDesc, uint32_t retCode); /** * @ingroup AscendCL * @brief Set stream description's eos. * * @param streamDesc [OUT] dvpp stream description. * @param eos [IN] end flag of sequence. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError acldvppSetStreamDescEos(acldvppStreamDesc *streamDesc, uint8_t eos); /** * @ingroup AscendCL * @brief Get stream description's data addr. * * @param streamDesc [IN] dvpp stream description. * * @retval data addr. * @retval deault nullptr. */ ACL_FUNC_VISIBILITY void *acldvppGetStreamDescData(const acldvppStreamDesc *streamDesc); /** * @ingroup AscendCL * @brief Get stream description's data size. * * @param streamDesc [IN] dvpp stream description. * * @retval data size. * @retval default 0. */ ACL_FUNC_VISIBILITY uint32_t acldvppGetStreamDescSize(const acldvppStreamDesc *streamDesc); /** * @ingroup AscendCL * @brief Get stream description's format. * * @param streamDesc [IN] dvpp stream description. * * @retval stream format. * @retval default ACL_DVPP_STREAM_H264. */ ACL_FUNC_VISIBILITY acldvppStreamFormat acldvppGetStreamDescFormat(const acldvppStreamDesc *streamDesc); /** * @ingroup AscendCL * @brief Get stream description's timestamp. * * @param streamDesc [IN] dvpp stream description. * * @retval current timestamp. * @retval default 0. */ ACL_FUNC_VISIBILITY uint64_t acldvppGetStreamDescTimestamp(const acldvppStreamDesc *streamDesc); /** * @ingroup AscendCL * @brief Get stream description's retCode. * * @param streamDesc [IN] dvpp stream description. * * @retval result code. * @retval default 0. */ ACL_FUNC_VISIBILITY uint32_t acldvppGetStreamDescRetCode(const acldvppStreamDesc *streamDesc); /** * @ingroup AscendCL * @brief Get stream description's eos. * * @param streamDesc [IN] dvpp stream description. * * @retval end flag of sequence. * @retval default 0(false). */ ACL_FUNC_VISIBILITY uint8_t acldvppGetStreamDescEos(const acldvppStreamDesc *streamDesc); /** * @ingroup AscendCL * @brief Create vdec frame config. * * @retval null for failed. * @retval other success. */ ACL_FUNC_VISIBILITY aclvdecFrameConfig *aclvdecCreateFrameConfig(); /** * @ingroup AscendCL * @brief Destroy vdec frame config. * * @par Function * Can only destroy aclvdecFrameConfig type created through * aclvdecCreateFrameConfig interface * * @param vdecFrameConfig [IN] vdec frame config. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see aclvdecCreateFrameConfig */ ACL_FUNC_VISIBILITY aclError aclvdecDestroyFrameConfig(aclvdecFrameConfig *vdecFrameConfig); /** * @ingroup AscendCL * @brief Get image width and height of jpeg. * * @param data [IN] image data in host memory * @param size [IN] the size of image data * @param width [OUT] the width of image from image header * @param height [OUT] the height of image from image header * @param components [OUT] the components of image from image header * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError acldvppJpegGetImageInfo(const void *data, uint32_t size, uint32_t *width, uint32_t *height, int32_t *components); /** * @ingroup AscendCL * @brief Get image width and height of jpeg. * * @param data [IN] image data in host memory * @param size [IN] the size of image data * @param width [OUT] the width of image from image header * @param height [OUT] the height of image from image header * @param components [OUT] the components of image from image header * @param format [OUT] the format of image from image header * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError acldvppJpegGetImageInfoV2(const void *data, uint32_t size, uint32_t *width, uint32_t *height, int32_t *components, acldvppJpegFormat *format); /** * @ingroup AscendCL * @brief Predict encode size of jpeg image. * * @param inputDesc [IN] dvpp image desc * @param config [IN] jpeg encode config * @param size [OUT] the size predicted of image * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError acldvppJpegPredictEncSize(const acldvppPicDesc *inputDesc, const acldvppJpegeConfig *config, uint32_t *size); /** * @ingroup AscendCL * @brief Predict decode size of jpeg image. * * @param data [IN] origin image data in host memory * @param dataSize [IN] the size of origin image data * @param outputPixelFormat [IN] the pixel format jpeg decode * @param decSize [OUT] the size predicted for decode image * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError acldvppJpegPredictDecSize(const void *data, uint32_t dataSize, acldvppPixelFormat outputPixelFormat, uint32_t *decSize); /** * @ingroup AscendCL * @brief Get image width and height of png. * * @param data [IN] image data in host memory * @param size [IN] the size of image data * @param width [OUT] the width of image from image header * @param height [OUT] the height of image from image header * @param components [OUT] the components of image from image header * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError acldvppPngGetImageInfo(const void *data, uint32_t dataSize, uint32_t *width, uint32_t *height, int32_t *components); /** * @ingroup AscendCL * @brief Predict decode size of png image. * * @param data [IN] origin image data in host memory * @param dataSize [IN] the size of origin image data * @param outputPixelFormat [IN] the pixel format jpeg decode * @param decSize [OUT] the size predicted for decode image * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError acldvppPngPredictDecSize(const void *data, uint32_t dataSize, acldvppPixelFormat outputPixelFormat, uint32_t *decSize); /** * @ingroup AscendCL * @brief Create dvpp channel, the same channel can be reused * and is no longer available after destruction. * * @param channelDesc [IN|OUT] the channel destruction * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see acldvppCreateChannelDesc */ ACL_FUNC_VISIBILITY aclError acldvppCreateChannel(acldvppChannelDesc *channelDesc); /** * @ingroup AscendCL * @brief Destroy dvpp channel. * * @par Restriction * Can only destroy channel created through the acldvppCreateChannel interface * * @param channelDesc [IN] the channel destruction * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see acldvppCreateChannel */ ACL_FUNC_VISIBILITY aclError acldvppDestroyChannel(acldvppChannelDesc *channelDesc); /** * @ingroup AscendCL * @brief dvpp vpc resize. * * @par Restriction * Width alignment requirements: * @li The minimum stride is 32 and the maximum is 4096 * 4 * (that is, an image in argb format with a width of 4096); * @li For 8K scaling, widthStride is required to be aligned to 2; * @li For non 8K scaling, the calculation formula for widthStride * is different for different image formats: * @li yuv400sp, yuv420sp, yuv422sp, yuv444sp: input image width aligned to 16 * @li yuv422packed: input image width * 2 and then align to 16 * @li yuv444packed, rgb888: input image width alignment * 3, alignment to 16 * @li xrgb8888: input image width * 4, align to 16 * @li HFBC:input image width * Height alignment requirements: * @li The height of the input image is aligned to 2. * High stride minimum 6 and maximum 4096. * * @param channelDesc [IN] the channel destruction * @param inputDesc [IN] resize input picture destruction * @param outputDesc [IN|OUT] resize output picture destruction * @param resizeConfig [IN] resize config * @param stream [IN] resize task stream * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see acldvppCreateChannel | acldvppCreatePicDesc * | acldvppCreateResizeConfig */ ACL_FUNC_VISIBILITY aclError acldvppVpcResizeAsync(acldvppChannelDesc *channelDesc, acldvppPicDesc *inputDesc, acldvppPicDesc *outputDesc, acldvppResizeConfig *resizeConfig, aclrtStream stream); /** * @ingroup AscendCL * @brief dvpp vpc crop. * * @par Function * crop the input picture according to the specified area, * and then store the picture in the output memory as the output picture * * @par Restriction * Width alignment requirements: * @li The minimum stride is 32 and the maximum is 4096 * 4 * (that is, an image in argb format with a width of 4096); * @li For 8K scaling, widthStride is required to be aligned to 2; * @li For non 8K scaling, the calculation formula for widthStride * is different for different image formats: * @li yuv400sp, yuv420sp, yuv422sp, yuv444sp: input image width aligned to 16 * @li yuv422packed: input image width * 2 and then align to 16 * @li yuv444packed, rgb888: input image width alignment * 3, alignment to 16 * @li xrgb8888: input image width * 4, align to 16 * @li HFBC:input image width * Height alignment requirements: * @li The height of the input image is aligned to 2. * High stride minimum 6 and maximum 4096. * * @param channelDesc [IN] the channel destruction * @param inputDesc [IN] crop input picture destruction * @param outputDesc [IN|OUT] crop output picture destruction * @param cropArea [IN] crop area config * @param stream [IN] crop task stream * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError acldvppVpcCropAsync(acldvppChannelDesc *channelDesc, acldvppPicDesc *inputDesc, acldvppPicDesc *outputDesc, acldvppRoiConfig *cropArea, aclrtStream stream); /** * @ingroup AscendCL * @brief dvpp vpc crop and resize config. * * @par Function * crop the input picture with resize config according to the specified area, * and then store the picture in the output memory as the output picture * * @par Restriction * Width alignment requirements: * @li The minimum stride is 32 and the maximum is 4096 * 4 * (that is, an image in argb format with a width of 4096); * @li For 8K scaling, widthStride is required to be aligned to 2; * @li For non 8K scaling, the calculation formula for widthStride * is different for different image formats: * @li yuv400sp, yuv420sp, yuv422sp, yuv444sp: input image width aligned to 16 * @li yuv422packed: input image width * 2 and then align to 16 * @li yuv444packed, rgb888: input image width alignment * 3, alignment to 16 * @li xrgb8888: input image width * 4, align to 16 * @li HFBC:input image width * Height alignment requirements: * @li The height of the input image is aligned to 2. * High stride minimum 6 and maximum 4096. * * @param channelDesc [IN] the channel destruction * @param inputDesc [IN] crop input picture destruction * @param outputDesc [IN|OUT] crop output picture destruction * @param cropArea [IN] crop area config * @param resizeConfig [IN] resize config * @param stream [IN] crop and resize config task stream * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError acldvppVpcCropResizeAsync(acldvppChannelDesc *channelDesc, acldvppPicDesc *inputDesc, acldvppPicDesc *outputDesc, acldvppRoiConfig *cropArea, acldvppResizeConfig *resizeConfig, aclrtStream stream); /** * @ingroup AscendCL * @brief dvpp vpc batch crop. * * @par Function * crop the input batch picture according to the specified area * as the output batch pictures * * @param channelDesc [IN] the channel destruction * @param srcBatchPicDescs [IN] crop input batch picture destruction * @param roiNums [IN] roi config numbers * @param size [IN] roiNum size * @param dstBatchPicDescs [IN|OUT] crop output batch picture destruction * @param cropAreas [IN] crop area configs * @param stream [IN] crop batch task stream * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see acldvppCreateChannel | acldvppCreateBatchPicDesc | acldvppCreateRoiConfig */ ACL_FUNC_VISIBILITY aclError acldvppVpcBatchCropAsync(acldvppChannelDesc *channelDesc, acldvppBatchPicDesc *srcBatchPicDescs, uint32_t *roiNums, uint32_t size, acldvppBatchPicDesc *dstBatchPicDescs, acldvppRoiConfig *cropAreas[], aclrtStream stream); /** * @ingroup AscendCL * @brief dvpp vpc batch crop and resize config. * * @par Function * crop the input batch picture with resize config according to the specified area * as the output batch pictures * * @param channelDesc [IN] the channel destruction * @param srcBatchPicDescs [IN] crop input batch picture destruction * @param roiNums [IN] roi config numbers * @param size [IN] roiNum size * @param dstBatchPicDescs [IN|OUT] crop output batch picture destruction * @param cropAreas [IN] crop area configs * @param resizeConfig [IN] resize config * @param stream [IN] crop batch and resize config task stream * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see acldvppCreateChannel | acldvppCreateBatchPicDesc | acldvppCreateRoiConfig | acldvppCreateDvppConfig */ ACL_FUNC_VISIBILITY aclError acldvppVpcBatchCropResizeAsync(acldvppChannelDesc *channelDesc, acldvppBatchPicDesc *srcBatchPicDescs, uint32_t *roiNums, uint32_t size, acldvppBatchPicDesc *dstBatchPicDescs, acldvppRoiConfig *cropAreas[], acldvppResizeConfig *resizeConfig, aclrtStream stream); /** * @ingroup AscendCL * @brief dvpp vpc crop and paste. * * @par Function * crop the input picture according to the specified area, * and paste the picture to the specified position of the target picture * as the output picture * * @param channelDesc [IN] thechannel destruction * @param inputDesc [IN] crop and paste input picture destruction * @param outputDesc [IN|OUT] crop and paste output picture destruction * @param cropArea [IN] crop area config * @param pasteArea [IN] paste area config * @param stream [IN] crop and paste task stream * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see acldvppCreateChannel | acldvppCreatePicDesc | acldvppCreateRoiConfig */ ACL_FUNC_VISIBILITY aclError acldvppVpcCropAndPasteAsync(acldvppChannelDesc *channelDesc, acldvppPicDesc *inputDesc, acldvppPicDesc *outputDesc, acldvppRoiConfig *cropArea, acldvppRoiConfig *pasteArea, aclrtStream stream); /** * @ingroup AscendCL * @brief dvpp vpc crop, resize config and paste. * * @par Function * crop the input picture with resize config according to the specified area, * and paste the picture to the specified position of the target picture * as the output picture * * @param channelDesc [IN] thechannel destruction * @param inputDesc [IN] crop and paste input picture destruction * @param outputDesc [IN|OUT] crop and paste output picture destruction * @param cropArea [IN] crop area config * @param pasteArea [IN] paste area config * @param resizeConfig [IN] resize config * @param stream [IN] crop, paste and resize task stream * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see acldvppCreateChannel | acldvppCreatePicDesc | acldvppCreateRoiConfig | acldvppCreateResizeConfig */ ACL_FUNC_VISIBILITY aclError acldvppVpcCropResizePasteAsync(acldvppChannelDesc *channelDesc, acldvppPicDesc *inputDesc, acldvppPicDesc *outputDesc, acldvppRoiConfig *cropArea, acldvppRoiConfig *pasteArea, acldvppResizeConfig *resizeConfig, aclrtStream stream); /** * @ingroup AscendCL * @brief dvpp vpc batch crop and paste. * * @par Function * crop the input batch picture according to the specified area, * and paste the pictures to the specified position of the target pictures * as the output batch pictures * * @param channelDesc [IN] the channel destruction * @param srcBatchPicDescs [IN] crop input batch picture destruction * @param roiNums [IN] roi config numbers * @param size [IN] roiNum size * @param dstBatchPicDescs [IN|OUT] crop output batch picture destruction * @param cropAreas [IN] crop area configs * @param pasteAreas [IN] paste area configs * @param stream [IN] crop batch task stream * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see acldvppCreateChannel | acldvppCreateBatchPicDesc | acldvppCreateRoiConfig */ ACL_FUNC_VISIBILITY aclError acldvppVpcBatchCropAndPasteAsync(acldvppChannelDesc *channelDesc, acldvppBatchPicDesc *srcBatchPicDescs, uint32_t *roiNums, uint32_t size, acldvppBatchPicDesc *dstBatchPicDescs, acldvppRoiConfig *cropAreas[], acldvppRoiConfig *pasteAreas[], aclrtStream stream); /** * @ingroup AscendCL * @brief dvpp vpc batch crop, resize config and paste. * * @par Function * crop the input batch picture with resize config according to the specified area, * and paste the pictures to the specified position of the target pictures * as the output batch pictures * * @param channelDesc [IN] the channel destruction * @param srcBatchPicDescs [IN] crop input batch picture destruction * @param roiNums [IN] roi config numbers * @param size [IN] roiNum size * @param dstBatchPicDescs [IN|OUT] crop output batch picture destruction * @param cropAreas [IN] crop area configs * @param pasteAreas [IN] paste area configs * @param resizeConfig [IN] resize config * @param stream [IN] crop batch and resize config task stream * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see acldvppCreateChannel | acldvppCreateBatchPicDesc | acldvppCreateRoiConfig | acldvppCreateResizeConfig */ ACL_FUNC_VISIBILITY aclError acldvppVpcBatchCropResizePasteAsync( acldvppChannelDesc *channelDesc, acldvppBatchPicDesc *srcBatchPicDescs, uint32_t *roiNums, uint32_t size, acldvppBatchPicDesc *dstBatchPicDescs, acldvppRoiConfig *cropAreas[], acldvppRoiConfig *pasteAreas[], acldvppResizeConfig *resizeConfig, aclrtStream stream); /** * @ingroup AscendCL * @brief dvpp vpc jpeg decode. * * @par Function * For different source picture formats, after decoding, * output pictures in the following format: * @li jpeg(444) -> YUV444SP:V is front U is back, * YUV420 SP V is front U is back, YUV420SP U is front V is back; * @li jpeg(422) -> YUV422SP:V is in front U is behind, * YUV420SP V is in front U is behind, YUV420SP U is in front V is behind; * @li jpeg(420) -> YUV420SP: * V is front U is back, YUV420SP U is front V is back; * @li jpeg(400) -> YUV420SP:UV data is filled with 0 x 80. * * @param channelDesc [IN] the channel destruction * @param data [IN] decode input picture destruction's data * @param size [IN] decode input picture destruction's size * @param outputDesc [IN|OUT] decode output picture destruction * @param stream [IN] decode task stream * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see acldvppCreateChannel | acldvppCreatePicDesc */ ACL_FUNC_VISIBILITY aclError acldvppJpegDecodeAsync(acldvppChannelDesc *channelDesc, const void *data, uint32_t size, acldvppPicDesc *outputDesc, aclrtStream stream); /** * @ingroup AscendCL * @brief dvpp vpc jpeg encode. * * @param channelDesc [IN] the channel destruction * @param inputDesc [IN] encode input picture destruction * @param data [OUT] encode output picture destruction's data * @param size [IN|OUT] encode output picture destruction's size * @param config [IN] jpeg encode config * @param stream [IN] encode task stream * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see acldvppCreateChannel | acldvppCreateJpegeConfig */ ACL_FUNC_VISIBILITY aclError acldvppJpegEncodeAsync(acldvppChannelDesc *channelDesc, acldvppPicDesc *inputDesc, const void *data, uint32_t *size, acldvppJpegeConfig *config, aclrtStream stream); /** * @ingroup AscendCL * @brief dvpp vpc png decode. * * @param channelDesc [IN] the channel destruction * @param data [IN] decode input picture destruction's data * @param size [IN] decode input picture destruction's size * @param outputDesc [IN|OUT] decode output picture destruction * @param stream [IN] decode task stream * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see acldvppCreateChannel | acldvppCreatePicDesc */ ACL_FUNC_VISIBILITY aclError acldvppPngDecodeAsync(acldvppChannelDesc *channelDesc, const void *data, uint32_t size, acldvppPicDesc *outputDesc, aclrtStream stream); /** * @ingroup AscendCL * @brief Create vdec channel. * * @par Function * Create a channel for video data processing, * the same channel can be reused, * and is no longer available after destruction * * @param channelDesc [IN|OUT] the channel destruction * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see aclvdecCreateChannelDesc */ ACL_FUNC_VISIBILITY aclError aclvdecCreateChannel(aclvdecChannelDesc *channelDesc); /** * @ingroup AscendCL * @brief Destroy vdec channel. * * @par Function * Can only destroy channels created by the aclvdecCreateChannel interface * * @param channelDesc [IN] the channel destruction * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see aclvdecCreateChannel */ ACL_FUNC_VISIBILITY aclError aclvdecDestroyChannel(aclvdecChannelDesc *channelDesc); /** * @ingroup AscendCL * @brief dvpp vdec send frame. * * @par Function * Pass the input memory to be decoded * and the decoded output memory to the decoder for decoding * * @param channelDesc [IN] vdec channel destruction * @param input [IN] input stream destruction * @param output [IN|OUT] output picture destruction * @param config [IN] vdec frame config * @param userData [IN] user data for callback function * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see aclvdecCreateChannel | acldvppCreateStreamDesc | acldvppCreatePicDesc */ ACL_FUNC_VISIBILITY aclError aclvdecSendFrame(aclvdecChannelDesc *channelDesc, acldvppStreamDesc *input, acldvppPicDesc *output, aclvdecFrameConfig *config, void *userData); /** * @ingroup AscendCL * @brief dvpp vdec send skipped frame. * * @par Function * Pass video frame to decoder * * @param channelDesc [IN] vdec channel destruction * @param input [IN] input stream destruction * @param config [IN] vdec frame config * @param userData [IN] user data for callback function * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see aclvdecCreateChannel | acldvppCreateStreamDesc | acldvppCreatePicDesc | aclvdecSendFrame */ ACL_FUNC_VISIBILITY aclError aclvdecSendSkippedFrame(aclvdecChannelDesc *channelDesc, acldvppStreamDesc *input, aclvdecFrameConfig *config, void *userData); /** * @ingroup AscendCL * @brief dvpp vpc convert color. * * @par Restriction * @li outputDesc:Width height stride, No changes are allowed. Just configure 0 * @par Function * Convert color gamut * * @param channelDesc [IN] the channel destruction * @param inputDesc [IN] convert color input picture destruction * @param outputDesc [IN|OUT] convert color output picture destruction * @param stream [IN] convert color task stream * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see acldvppCreateChannel | acldvppCreatePicDesc */ ACL_FUNC_VISIBILITY aclError acldvppVpcConvertColorAsync(acldvppChannelDesc *channelDesc, acldvppPicDesc *inputDesc, acldvppPicDesc *outputDesc, aclrtStream stream); /** * @ingroup AscendCL * @brief dvpp vpc pyramid down. * * @par Restriction * @li outputDesc:format only supported YUV400 * @par Function * Image pyramid down * * @param channelDesc [IN] the channel destruction * @param inputDesc [IN] pyr down input picture destruction * @param outputDesc [IN|OUT] pyr down output picture destruction * @param reserve [IN] reserved param , must be nullptr * @param stream [IN] pyr down task stream * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see acldvppCreateChannel | acldvppCreatePicDesc */ ACL_FUNC_VISIBILITY aclError acldvppVpcPyrDownAsync(acldvppChannelDesc *channelDesc, acldvppPicDesc *inputDesc, acldvppPicDesc *outputDesc, void *reserve, aclrtStream stream); /** * @ingroup AscendCL * @brief Set dvpp channel mode. * * @param channelDesc [OUT] the channel destruction * @param mode [IN] channel mode * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError acldvppSetChannelDescMode(acldvppChannelDesc *channelDesc, uint32_t mode); /** * @ingroup AscendCL * @brief Set resize config interpolation. * * @param resizeConfig [OUT] the resize config * @param interpolation [IN] interpolation * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError acldvppSetResizeConfigInterpolation(acldvppResizeConfig *resizeConfig, uint32_t interpolation); /** * @ingroup AscendCL * @brief Get resize config interpolation. * * @param resizeConfig [IN] the resize config * * @retval Interpolation of resize config. */ ACL_FUNC_VISIBILITY uint32_t acldvppGetResizeConfigInterpolation(const acldvppResizeConfig *resizeConfig); /** * @ingroup AscendCL * @brief Set vdec channel out mode. * * @param channelDesc [OUT] the channel destruction * @param outMode [IN] channel out mode * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError aclvdecSetChannelDescOutMode(aclvdecChannelDesc *channelDesc, uint32_t outMode); /** * @ingroup AscendCL * @brief Get vdec channel out mode. * * @param channelDesc [IN] the channel destruction * * @retval Out mode of channel destruction * @retval default 0 */ ACL_FUNC_VISIBILITY uint32_t aclvdecGetChannelDescOutMode(const aclvdecChannelDesc *channelDesc); /** * @ingroup AscendCL * @brief Create dvpp batch picture description. * * @param batchSize [IN] batch size * * @retval null for failed. * @retval OtherValues success. */ ACL_FUNC_VISIBILITY acldvppBatchPicDesc *acldvppCreateBatchPicDesc(uint32_t batchSize); /** * @ingroup AscendCL * @brief Get dvpp picture description. * * @param batchPicDesc [IN] dvpp batch picture description. * @param index [IN] index of batch * * @retval null for failed. * @retval OtherValues Failure * * @see acldvppCreateBatchPicDesc */ ACL_FUNC_VISIBILITY acldvppPicDesc *acldvppGetPicDesc(acldvppBatchPicDesc *batchPicDesc, uint32_t index); /** * @ingroup AscendCL * @brief Destroy dvpp batch picture description. * * @par Function * Can only destroy batch picture description information created * through acldvppCreateBatchPicDesc interface. * * @param batchPicDesc [IN] dvpp batch picture description. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see acldvppCreateBatchPicDesc */ ACL_FUNC_VISIBILITY aclError acldvppDestroyBatchPicDesc(acldvppBatchPicDesc *batchPicDesc); /** * @ingroup AscendCL * @brief Create dvpp lut map. * * @retval null for failed. * @retval OtherValues success. */ ACL_FUNC_VISIBILITY acldvppLutMap *acldvppCreateLutMap(); /** * @ingroup AscendCL * @brief Destroy lut map. * * @param lutMap [IN] lut map * * @retval ACL_SUCCESS for success, other for failure */ ACL_FUNC_VISIBILITY aclError acldvppDestroyLutMap(acldvppLutMap *lutMap); /** * @ingroup AscendCL * @brief Get lut map dims. * * @param lutMap [IN] lut map * * @retval 0 for failed. * @retval OtherValues success. */ ACL_FUNC_VISIBILITY uint32_t acldvppGetLutMapDims(const acldvppLutMap *lutMap); /** * @ingroup AscendCL * @brief Get lut map data. * * @param lutMap [IN] lut map * @param dim [IN] input dim of map * @param data [OUT] the dim of lut map's data * @param len [OUT] the dim of lut map's length * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure */ ACL_FUNC_VISIBILITY aclError acldvppGetLutMapData(const acldvppLutMap *lutMap, uint32_t dim, uint8_t **data, uint32_t *len); /** * @ingroup AscendCL * @brief Vpc equalize hist. * * @param channelDesc [IN] channel desc * @param inputDesc [IN] input desc * @param outputDesc [IN|OUT] output desc * @param lutMap [IN] lut map param * @param stream [IN] runtime stream * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see acldvppCreateChannel|acldvppCreatePicDesc|acldvppCreateLutMap */ ACL_FUNC_VISIBILITY aclError acldvppVpcEqualizeHistAsync(const acldvppChannelDesc *channelDesc, const acldvppPicDesc *inputDesc, acldvppPicDesc *outputDesc, const acldvppLutMap *lutMap, aclrtStream stream); /** * @ingroup AscendCL * @brief Create dvpp border config. * * @retval null for failed. * @retval OtherValues success. */ ACL_FUNC_VISIBILITY acldvppBorderConfig *acldvppCreateBorderConfig(); /** * @ingroup AscendCL * @brief Set value of border config. * * @param borderConfig [OUT] border config * @param index [IN] index of value array * @param value [IN] value * * @retval ACL_SUCCESS for success, other for failure */ ACL_FUNC_VISIBILITY aclError acldvppSetBorderConfigValue(acldvppBorderConfig *borderConfig, uint32_t index, double value); /** * @ingroup AscendCL * @brief Set border type of border config. * * @param borderConfig [OUT] border config * @param borderType [IN] border type * * @retval ACL_SUCCESS for success, other for failure */ ACL_FUNC_VISIBILITY aclError acldvppSetBorderConfigBorderType(acldvppBorderConfig *borderConfig, acldvppBorderType borderType); /** * @ingroup AscendCL * @brief Set top of border config. * * @param borderConfig [OUT] border config * @param top [IN] top of border * * @retval ACL_SUCCESS for success, other for failure */ ACL_FUNC_VISIBILITY aclError acldvppSetBorderConfigTop(acldvppBorderConfig *borderConfig, uint32_t top); /** * @ingroup AscendCL * @brief Set bottom of border config. * * @param borderConfig [OUT] border config * @param bottom [IN] bottom of border * * @retval ACL_SUCCESS for success, other for failure */ ACL_FUNC_VISIBILITY aclError acldvppSetBorderConfigBottom(acldvppBorderConfig *borderConfig, uint32_t bottom); /** * @ingroup AscendCL * @brief Set left of border config. * * @param borderConfig [OUT] border config * @param left [IN] left of border * * @retval ACL_SUCCESS for success, other for failure */ ACL_FUNC_VISIBILITY aclError acldvppSetBorderConfigLeft(acldvppBorderConfig *borderConfig, uint32_t left); /** * @ingroup AscendCL * @brief Set right of border config. * * @param borderConfig [OUT] border config * @param right [IN] right of border * * @retval ACL_SUCCESS for success, other for failure */ ACL_FUNC_VISIBILITY aclError acldvppSetBorderConfigRight(acldvppBorderConfig *borderConfig, uint32_t right); /** * @ingroup AscendCL * @brief Get value of border config. * * @param borderConfig [IN] border config * @param index[IN] index of value array * * @retval invalid value is < 0, normal Value is >= 0 */ ACL_FUNC_VISIBILITY double acldvppGetBorderConfigValue(const acldvppBorderConfig *borderConfig, uint32_t index); /** * @ingroup AscendCL * @brief Get border type of border config. * * @param borderConfig [IN] border config * @retval border type of border config */ ACL_FUNC_VISIBILITY acldvppBorderType acldvppGetBorderConfigBorderType(const acldvppBorderConfig *borderConfig); /** * @ingroup AscendCL * @brief Get right of border config. * * @param borderConfig [IN] border config * * @retval default 0, top value of border config */ ACL_FUNC_VISIBILITY uint32_t acldvppGetBorderConfigTop(const acldvppBorderConfig *borderConfig); /** * @ingroup AscendCL * @brief Get Bottom of border config. * * @param borderConfig [IN] border config * * @retval default 0, top value of border config */ ACL_FUNC_VISIBILITY uint32_t acldvppGetBorderConfigBottom(const acldvppBorderConfig *borderConfig); /** * @ingroup AscendCL * @brief Get left of border config. * * @param borderConfig [IN] border config * * @retval default 0, top value of border config */ ACL_FUNC_VISIBILITY uint32_t acldvppGetBorderConfigLeft(const acldvppBorderConfig *borderConfig); /** * @ingroup AscendCL * @brief Get right of border config. * * @param borderConfig [IN] border config * * @retval default 0, right value of border config */ ACL_FUNC_VISIBILITY uint32_t acldvppGetBorderConfigRight(const acldvppBorderConfig *borderConfig); /** * @ingroup AscendCL * @brief Destroy border config. * * @param borderConfig [IN] border config * * @retval ACL_SUCCESS for success, other for failure */ ACL_FUNC_VISIBILITY aclError acldvppDestroyBorderConfig(acldvppBorderConfig *borderConfig); /** * @ingroup AscendCL * @brief Vpc make border. * * @param channelDesc [IN] channel desc * @param inputDesc [IN] input desc * @param outputDesc [IN|OUT] output desc * @param borderConfig [IN] border config param * @param stream [IN] runtime stream * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see acldvppCreateChannel|acldvppCreatePicDesc|acldvppCreateBorderConfig */ ACL_FUNC_VISIBILITY aclError acldvppVpcMakeBorderAsync(const acldvppChannelDesc *channelDesc, const acldvppPicDesc *inputDesc, acldvppPicDesc *outputDesc, const acldvppBorderConfig *borderConfig, aclrtStream stream); /** * @ingroup AscendCL * @brief Dvpp vpc calc hist. * * @param channelDesc [IN] the channel destruction * @param srcPicDesc [IN] pyr down input picture destruction * @param hist [IN|OUT] pyr down output picture destruction * @param reserve [IN] reserved param, must be nullptr * @param stream [IN] task stream * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see acldvppCreateChannel | acldvppCreatePicDesc | acldvppCreateHist */ ACL_FUNC_VISIBILITY aclError acldvppVpcCalcHistAsync(acldvppChannelDesc *channelDesc, acldvppPicDesc *srcPicDesc, acldvppHist *hist, void *reserve, aclrtStream stream); /** * @ingroup AscendCL * @brief Create vpc hist description. * * @retval null for failed. * @retval OtherValues success. */ ACL_FUNC_VISIBILITY acldvppHist *acldvppCreateHist(); /** * @ingroup AscendCL * @brief Destroy vpc hist description. * * @par Function * Can only destroy hist description information created * through acldvppCreateHist interface. * * @param hist [IN] vpc hist description. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see acldvppCreateHist */ ACL_FUNC_VISIBILITY aclError acldvppDestroyHist(acldvppHist *hist); /** * @ingroup AscendCL * @brief Get dims of vpc hist description. * * @param hist [IN] vpc hist description. * * @retval dims of vpc hist description. * * @see acldvppCreateHist | acldvppVpcCalcHistAsync */ ACL_FUNC_VISIBILITY uint32_t acldvppGetHistDims(acldvppHist *hist); /** * @ingroup AscendCL * @brief Get data from vpc hist description by dim. * * @param hist [IN] vpc hist description. * @param dim [IN] which dim to get data. * @param data [OUT] address of output hist data. * @param len [OUT] len of output hist data. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see acldvppCreateHist | acldvppVpcCalcHistAsync */ ACL_FUNC_VISIBILITY aclError acldvppGetHistData(acldvppHist *hist, uint32_t dim, uint32_t **data, uint16_t *len); /** * @ingroup AscendCL * @brief Get dvpp calc hist process return code. * * @param hist [IN] vpc hist description. * * @retval Dvpp calc hist process return code. * * @see acldvppCreateHist | acldvppVpcCalcHistAsync */ ACL_FUNC_VISIBILITY uint32_t acldvppGetHistRetCode(acldvppHist *hist); /** * @ingroup AscendCL * @brief Set vpc hist description to 0. * * @par Function * Can only clear hist description information created * through acldvppCreateHist interface. * * @param hist [IN] vpc hist description. * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see acldvppCreateHist */ ACL_FUNC_VISIBILITY aclError acldvppClearHist(acldvppHist *hist); /** * @ingroup AscendCL * @brief dvpp vpc batch crop, resize config and make border. * * @par Function * crop the input batch picture with resize config and border configs according to the specified area * as the output batch pictures * * @param channelDesc [IN] the channel destruction * @param srcBatchPicDescs [IN] crop input batch picture destruction * @param roiNums [IN] roi config numbers * @param size [IN] roiNum size * @param dstBatchPicDescs [IN|OUT] crop output batch picture destruction * @param cropAreas [IN] crop area configs * @param borderCfgs [IN] border configs * @param resizeConfig [IN] resize config * @param stream [IN] crop batch, resize config and make border task stream * * @retval ACL_SUCCESS The function is successfully executed. * @retval OtherValues Failure * * @see acldvppCreateChannel | acldvppCreateBatchPicDesc | acldvppCreateRoiConfig | acldvppCreateResizeConfig */ ACL_FUNC_VISIBILITY aclError acldvppVpcBatchCropResizeMakeBorderAsync( acldvppChannelDesc *channelDesc, acldvppBatchPicDesc *srcBatchPicDescs, uint32_t *roiNums, uint32_t size, acldvppBatchPicDesc *dstBatchPicDescs, acldvppRoiConfig *cropAreas[], acldvppBorderConfig *borderCfgs[], acldvppResizeConfig *resizeConfig, aclrtStream stream); #ifdef __cplusplus } #endif #endif // INC_EXTERNAL_ACL_OPS_ACL_DVPP_H_