hi_mpi_rgn_get_canvas_info

Applicability

Product

Supported

Atlas 350 Accelerator Card

Atlas A3 training product / Atlas A3 inference product

Atlas A2 training product / Atlas A2 inference product

Atlas 200I/500 A2 inference product

Atlas inference product

Atlas training product

Function Description

Obtains the canvas information of a region.

This API is not supported in the Ascend EP form of Atlas 200I/500 A2 inference product .

Prototype

hi_s32 hi_mpi_rgn_get_canvas_info(hi_rgn_handle handle, hi_rgn_canvas_info *canvas_info)

Parameters

Parameter

Input/Output

Description

handle

Input

Region handle ID.

Value range: [0, 1024)

canvas_info

Output

Canvas information displayed in the region.

Returns

Restrictions

  • The regions must be created before you call this API.
  • It is used to import bitmap data of the OVERLAYEX type.
  • This API is used to obtain the canvas information corresponding to a region. After obtaining the canvas address, you can directly perform operations on the canvas. For example, you can directly fill the BMP data in the canvas. Call the hi_mpi_rgn_update_canvas API to update the display canvas data.

See Also

For details about the API call sequence, see Video Decoding, Processing, and Display (NVR Scenario).