aclvencSendFrame

Applicability

Product

Supported

Atlas A3 training products / Atlas A3 inference products

x

Atlas A2 training products / Atlas A2 inference products

x

Atlas 200I/500 A2 inference products

Atlas inference products

Atlas training products

x

Description

Feeds images to the encoder for encoding. This API is asynchronous.

Prototype

aclError aclvencSendFrame(aclvencChannelDesc *channelDesc,
acldvppPicDesc *input,
void *reserve,
aclvencFrameConfig *config,
void *userdata)

Parameters

Parameter

Input/Output

Description

channelDesc

Input

Pointer to the channel description.

Must be the same as the channelDesc argument passed to the aclvencCreateChannel call.

Specify the video encoding callback function in the channel description.

input

Input

Pointer to the input image description. The user needs to allocate input buffer in advance.

reserve

Input

Reserved.

config

Input

Pointer to the single-frame configuration.

userdata

Input

Pointer to the user-defined data.

Returns

0 on success; else, failure. For details, see aclError.

Restrictions

  • Ensure that a channel has been created. Otherwise, an error code is returned.
  • It is not allowed to send an empty stream packet with eos = 0 (stream length is 0 or stream address is empty).
  • When an empty image with eos = 1 is sent, the current encoding ends.
  • During encoding, the input buffer can be released only after the result is obtained from the aclvencCallback function.

See Also

For details about the API call sequence and example, see VENC.