hi_mpi_rgn_create

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

The Atlas Training Series Product does not support this API.

Description

Creates different types of regions.

Restrictions

Repeated creation is not supported.
When a region is created by calling this API, only the basic parameters such as the minimum width and height and maximum width and height are set. When the region is attached to a channel by calling hi_mpi_rgn_attach_to_chn, specific parameters (such as the supported pixel format) are checked based on the restrictions specified by the supported channel modules.

Prototype

hi_s32 hi_mpi_rgn_create(hi_rgn_handle handle, const hi_rgn_attr *rgn_attr)

Parameters

Parameter	Input/Output	Description
handle	Input	Region handle ID. The handle ID must be unused and is specified by the user. The meaning of the handle ID is the same as that of the ID. Value range: [0, 1024)
rgn_attr	Input	Pointer to the region attribute. This parameter cannot be null. Only COVER, MOSAIC, and OVERLAYEX regions can be created. Other region attributes, such as the region position and level, need to be specified by calling hi_mpi_rgn_attach_to_chn.

Parameter

Input/Output

Description

handle

Input

Region handle ID.

The handle ID must be unused and is specified by the user. The meaning of the handle ID is the same as that of the ID.

Value range: [0, 1024)

rgn_attr

Input

Pointer to the region attribute. This parameter cannot be null.

Only COVER, MOSAIC, and OVERLAYEX regions can be created. Other region attributes, such as the region position and level, need to be specified by calling hi_mpi_rgn_attach_to_chn.

Returns

0: success.
Other values: failure. For details, see Region Management Return Codes.

Parent topic: Region Management