acl.himpi.pngd_send_stream

hi_s32 hi_mpi_pngd_send_stream(hi_pngd_chn chn, const hi_img_stream *stream, hi_pic_info *png_pic_info, hi_s32 milli_sec)

ret = acl.himpi.pngd_send_stream(chn, stream, png_pic_info, milli_sec)

Feeds the stream and decoding result buffer to a decoding channel.

The Atlas 200/300/500 Inference Product does not support this API in the current version.

The Atlas Training Series Product does not support this API in the current version.

chn: int, decoding channel ID.

The value range of this parameter is [0, 128). The maximum number of channels is 128.

stream: dict, input stream information. For details, see hi_img_stream. The configured addr in this dictionary must be a buffer address on the device.

png_pic_info: dict, dictionary of output image information. For details, see hi_pic_info.

milli_sec: int, timeout interval (ms).

• -1: blocking mode.
• 0: non-blocking mode.
• > 0: timeout interval (timeout mode). The timeout interval varies with the operating system. The deviation is generally within a time slice of an operating system. For example, if the time slice of an operating system is 4 ms and the value of milli_sec is set to 1, the actual timeout interval ranges from 1 ms to 5 ms. When the CPU load is high, the timeout interval may still fluctuate.

ret: int, error code.

• 0 indicates success.
• Other values: failure. For details, see PNGD Return Codes.

• Ensure that a channel has been created. Otherwise, the error code HI_ERR_PNGD_UNEXIST is returned. If the channel is destroyed when streams are being sent, the error code HI_ERR_PNGD_UNEXIST is returned.
• To send a stream, a complete PNG image is required. Otherwise, an error occurs during decoding.
• In non-blocking mode, the error code HI_ERR_PNGD_BUF_FULL is returned if the stream buffer is full.
• In timeout mode, if the stream fails to be fed within the specified timeout interval, the error code HI_ERR_PNGD_BUF_FULL is returned.
• For details about the requirements for the input and output images during image decoding, see Functions and Restrictions.
• For decoding, the input buffer and output buffer must be allocated by using the acl.himpi.dvpp_malloc call and freed by using the acl.himpi.dvpp_free call, respectively. Place the acl.himpi.dvpp_free call after the acl.himpi.pngd_get_image_data call.