hi_mpi_pngd_get_image_data
The
The
Description
Fetches the decoded image and input stream of a decoding channel.
Restrictions
- This API fetches decoded images in blocking mode, non-blocking mode, or timeout mode, as specified by the milli_sec parameter.
- Ensure that a channel has been created. Otherwise, the error code HI_ERR_PNGD_UNEXIST is returned. If the channel is destroyed in the image fetching process, the error code HI_ERR_PNGD_UNEXIST is returned.
- In non-blocking mode, if the buffer has no decoded images, the error code HI_ERR_PNGD_BUF_EMPTY is returned.
- In timeout mode, if no decoded images are fetched within the specified timeout interval, the error code HI_ERR_PNGD_BUF_EMPTY is returned.
- This API fetches the PNGD result, including the input buffer and output buffer.
- For details about the requirements for the input and output images during PNGD image decoding, see Functions and Restrictions.
Prototype
hi_s32 hi_mpi_pngd_get_image_data(hi_pngd_chn chn, hi_pic_info *png_pic_info, hi_img_stream *stream, hi_s32 milli_sec)
Parameters
Parameter |
Input/Output |
Description |
|---|---|---|
chn |
Input |
Decoding channel ID. The value range of this parameter is [0, 128). The maximum number of channels is 128. |
png_pic_info |
Output |
Pointer to the information about the decoded image. The decoded output is stored in the device buffer. |
stream |
Output |
Pointer to the information about the decoded input stream. |
milli_sec |
Input |
Timeout interval (ms).
|
Returns
- 0: success.
- Other values: failure. For details, see PNGD Return Codes. HI_ERR_PNGD_BUF_EMPTY indicates that there is no data. Other error codes indicate abnormal decoding.
Parent topic: PNGD