hi_mpi_venc_send_jpege_frame

The Atlas 200/300/500 Inference Product does not support this API.

The Atlas Training Series Product does not support this API.

Description

Sends source images for encoding and configures the output buffer address of the encoding result.

Restrictions

  • This API is valid only when hi_venc_chn_attr.venc_attr.buf_size is set to 0 when a channel is created by calling hi_mpi_venc_create_chn. Otherwise, the error code HI_ERR_VENC_NOT_SUPPORT is returned.
  • The JPEGE input image resolution must be less than or equal to the size of the VENC channel.
  • Ensure that an encoding channel has been created and started receiving images.
  • During decoding, the input and output buffers can be freed only after hi_mpi_venc_get_stream is called to obtain the result.
  • For details about the input and output restrictions on image encoding, see JPEGE Functions and Restrictions.

Prototype

hi_s32 hi_mpi_venc_send_jpege_frame(hi_venc_chn chn, const hi_video_frame_info *frame, const hi_img_stream* jpege_stream, hi_s32 milli_sec)

Parameters

Parameter

Input/Output

Description

chn

Input

Encoding channel ID.

frame

Input

Pointer to the source image information.

jpege_stream

Input

Output buffer address and length of the encoding result.

The start address of the output buffer must be 16-byte aligned. You can call hi_mpi_venc_get_jpege_predicted_size to obtain the buffer size, and then call hi_mpi_dvpp_malloc to allocate the output buffer.

milli_sec

Input

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 fluctuate.

Returns