hi_mpi_rgn_create
Applicability
|
Product |
Supported |
|---|---|
|
|
x |
|
|
x |
|
|
√ |
|
|
x |
|
|
x |
Description
Creates different types of regions.
The
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 attributes such as the pixel format, region width, and region height are set. 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.
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.