hi_mpi_png_get_image_info

Applicability

Product	Supported
Atlas A3 training products/Atlas A3 inference products	√
Atlas A2 training products/Atlas A2 inference products	√
Atlas 200I/500 A2 inference products	√
Atlas inference products	√
Atlas training products	☓

Description

Obtains the width, height, and source format of the input PNG image, the width stride and height stride of the output image, as well as the required buffer size based on the input stream.

Prototype

hi_s32 hi_mpi_png_get_image_info (const hi_img_stream *png_stream, hi_img_info *img_info)

Parameters

Parameter	Input/Output	Description
png_stream	Input	Pointer to the information of the input stream. In Ascend EP form, when this API is called on the host, the configured addr must be a buffer address on the host.
img_info	Output	Pointer to the image information.

Parameter

Input/Output

Description

png_stream

Input

Pointer to the information of the input stream.

In Ascend EP form, when this API is called on the host, the configured addr must be a buffer address on the host.

img_info

Output

Pointer to the image information.

Returns

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

Restrictions

This API is provided to calculate the size of the buffer occupied by the decoded output image. Currently, only PNG images can be parsed. The obtained widthStride and heightStride must be rounded up to the nearest multiples of 128 and 16, respectively.

Parent topic: PNG Decoder (PNGD)