| /** @file |
| This protocol provides generic image decoder interfaces to various image formats. |
| |
| (C) Copyright 2016 Hewlett Packard Enterprise Development LP<BR> |
| Copyright (c) 2016-2018, Intel Corporation. All rights reserved.<BR> |
| |
| SPDX-License-Identifier: BSD-2-Clause-Patent |
| |
| @par Revision Reference: |
| This Protocol was introduced in UEFI Specification 2.6. |
| |
| **/ |
| #ifndef __HII_IMAGE_DECODER_H__ |
| #define __HII_IMAGE_DECODER_H__ |
| |
| #include <Protocol/HiiImage.h> |
| |
| #define EFI_HII_IMAGE_DECODER_PROTOCOL_GUID \ |
| {0x9e66f251, 0x727c, 0x418c, { 0xbf, 0xd6, 0xc2, 0xb4, 0x25, 0x28, 0x18, 0xea }} |
| |
| |
| #define EFI_HII_IMAGE_DECODER_NAME_JPEG_GUID \ |
| {0xefefd093, 0xd9b, 0x46eb, { 0xa8, 0x56, 0x48, 0x35, 0x7, 0x0, 0xc9, 0x8 }} |
| |
| #define EFI_HII_IMAGE_DECODER_NAME_PNG_GUID \ |
| {0xaf060190, 0x5e3a, 0x4025, { 0xaf, 0xbd, 0xe1, 0xf9, 0x5, 0xbf, 0xaa, 0x4c }} |
| |
| typedef struct _EFI_HII_IMAGE_DECODER_PROTOCOL EFI_HII_IMAGE_DECODER_PROTOCOL; |
| |
| typedef enum { |
| EFI_HII_IMAGE_DECODER_COLOR_TYPE_RGB = 0x0, |
| EFI_HII_IMAGE_DECODER_COLOR_TYPE_RGBA = 0x1, |
| EFI_HII_IMAGE_DECODER_COLOR_TYPE_CMYK = 0x2, |
| EFI_HII_IMAGE_DECODER_COLOR_TYPE_UNKNOWN = 0xFF |
| } EFI_HII_IMAGE_DECODER_COLOR_TYPE; |
| |
| // |
| // EFI_HII_IMAGE_DECODER_IMAGE_INFO_HEADER |
| // |
| // DecoderName Name of the decoder |
| // ImageInfoSize The size of entire image information structure in bytes |
| // ImageWidth The image width |
| // ImageHeight The image height |
| // ColorType The color type, see EFI_HII_IMAGE_DECODER_COLOR_TYPE. |
| // ColorDepthInBits The color depth in bits |
| // |
| typedef struct _EFI_HII_IMAGE_DECODER_IMAGE_INFO_HEADER { |
| EFI_GUID DecoderName; |
| UINT16 ImageInfoSize; |
| UINT16 ImageWidth; |
| UINT16 ImageHeight; |
| EFI_HII_IMAGE_DECODER_COLOR_TYPE ColorType; |
| UINT8 ColorDepthInBits; |
| } EFI_HII_IMAGE_DECODER_IMAGE_INFO_HEADER; |
| |
| #define EFI_IMAGE_JPEG_SCANTYPE_PROGREESSIVE 0x01 |
| #define EFI_IMAGE_JPEG_SCANTYPE_INTERLACED 0x02 |
| |
| // |
| // EFI_HII_IMAGE_DECODER_JPEG_INFO |
| // Header The common header |
| // ScanType The scan type of JPEG image |
| // Reserved Reserved |
| // |
| typedef struct _EFI_HII_IMAGE_DECODER_JPEG_INFO { |
| EFI_HII_IMAGE_DECODER_IMAGE_INFO_HEADER Header; |
| UINT16 ScanType; |
| UINT64 Reserved; |
| } EFI_HII_IMAGE_DECODER_JPEG_INFO; |
| |
| // |
| // EFI_HII_IMAGE_DECODER_PNG_INFO |
| // Header The common header |
| // Channels Number of channels in the PNG image |
| // Reserved Reserved |
| // |
| typedef struct _EFI_HII_IMAGE_DECODER_PNG_INFO { |
| EFI_HII_IMAGE_DECODER_IMAGE_INFO_HEADER Header; |
| UINT16 Channels; |
| UINT64 Reserved; |
| } EFI_HII_IMAGE_DECODER_PNG_INFO; |
| |
| // |
| // EFI_HII_IMAGE_DECODER_OTHER_INFO |
| // |
| typedef struct _EFI_HII_IMAGE_DECODER_OTHER_INFO { |
| EFI_HII_IMAGE_DECODER_IMAGE_INFO_HEADER Header; |
| CHAR16 ImageExtenion[1]; |
| // |
| // Variable length of image file extension name. |
| // |
| } EFI_HII_IMAGE_DECODER_OTHER_INFO; |
| |
| /** |
| There could be more than one EFI_HII_IMAGE_DECODER_PROTOCOL instances installed |
| in the system for different image formats. This function returns the decoder |
| name which callers can use to find the proper image decoder for the image. It |
| is possible to support multiple image formats in one EFI_HII_IMAGE_DECODER_PROTOCOL. |
| The capability of the supported image formats is returned in DecoderName and |
| NumberOfDecoderName. |
| |
| @param This EFI_HII_IMAGE_DECODER_PROTOCOL instance. |
| @param DecoderName Pointer to a dimension to retrieve the decoder |
| names in EFI_GUID format. The number of the |
| decoder names is returned in NumberOfDecoderName. |
| @param NumberofDecoderName Pointer to retrieve the number of decoders which |
| supported by this decoder driver. |
| |
| @retval EFI_SUCCESS Get decoder name success. |
| @retval EFI_UNSUPPORTED Get decoder name fail. |
| |
| **/ |
| typedef |
| EFI_STATUS |
| (EFIAPI *EFI_HII_IMAGE_DECODER_GET_NAME)( |
| IN EFI_HII_IMAGE_DECODER_PROTOCOL *This, |
| IN OUT EFI_GUID **DecoderName, |
| IN OUT UINT16 *NumberOfDecoderName |
| ); |
| |
| /** |
| This function returns the image information of the given image raw data. This |
| function first checks whether the image raw data is supported by this decoder |
| or not. This function may go through the first few bytes in the image raw data |
| for the specific data structure or the image signature. If the image is not supported |
| by this image decoder, this function returns EFI_UNSUPPORTED to the caller. |
| Otherwise, this function returns the proper image information to the caller. |
| It is the caller?s responsibility to free the ImageInfo. |
| |
| @param This EFI_HII_IMAGE_DECODER_PROTOCOL instance. |
| @param Image Pointer to the image raw data. |
| @param SizeOfImage Size of the entire image raw data. |
| @param ImageInfo Pointer to receive EFI_HII_IMAGE_DECODER_IMAGE_INFO_HEADER. |
| |
| @retval EFI_SUCCESS Get image info success. |
| @retval EFI_UNSUPPORTED Unsupported format of image. |
| @retval EFI_INVALID_PARAMETER Incorrect parameter. |
| @retval EFI_BAD_BUFFER_SIZE Not enough memory. |
| |
| **/ |
| typedef |
| EFI_STATUS |
| (EFIAPI *EFI_HII_IMAGE_DECODER_GET_IMAGE_INFO)( |
| IN EFI_HII_IMAGE_DECODER_PROTOCOL *This, |
| IN VOID *Image, |
| IN UINTN SizeOfImage, |
| IN OUT EFI_HII_IMAGE_DECODER_IMAGE_INFO_HEADER **ImageInfo |
| ); |
| |
| /** |
| This function decodes the image which the image type of this image is supported |
| by this EFI_HII_IMAGE_DECODER_PROTOCOL. If **Bitmap is not NULL, the caller intends |
| to put the image in the given image buffer. That allows the caller to put an |
| image overlap on the original image. The transparency is handled by the image |
| decoder because the transparency capability depends on the image format. Callers |
| can set Transparent to FALSE to force disabling the transparency process on the |
| image. Forcing Transparent to FALSE may also improve the performance of the image |
| decoding because the image decoder can skip the transparency processing. If **Bitmap |
| is NULL, the image decoder allocates the memory buffer for the EFI_IMAGE_OUTPUT |
| and decodes the image to the image buffer. It is the caller?s responsibility to |
| free the memory for EFI_IMAGE_OUTPUT. Image decoder doesn?t have to handle the |
| transparency in this case because there is no background image given by the caller. |
| The background color in this case is all black (#00000000). |
| |
| @param This EFI_HII_IMAGE_DECODER_PROTOCOL instance. |
| @param Image Pointer to the image raw data. |
| @param ImageRawDataSize Size of the entire image raw data. |
| @param Blt EFI_IMAGE_OUTPUT to receive the image or overlap |
| the image on the original buffer. |
| @param Transparent BOOLEAN value indicates whether the image decoder |
| has to handle the transparent image or not. |
| |
| |
| @retval EFI_SUCCESS Image decode success. |
| @retval EFI_UNSUPPORTED Unsupported format of image. |
| @retval EFI_INVALID_PARAMETER Incorrect parameter. |
| @retval EFI_BAD_BUFFER_SIZE Not enough memory. |
| |
| **/ |
| typedef |
| EFI_STATUS |
| (EFIAPI *EFI_HII_IMAGE_DECODER_DECODE)( |
| IN EFI_HII_IMAGE_DECODER_PROTOCOL *This, |
| IN VOID *Image, |
| IN UINTN ImageRawDataSize, |
| IN OUT EFI_IMAGE_OUTPUT **Bitmap, |
| IN BOOLEAN Transparent |
| ); |
| |
| struct _EFI_HII_IMAGE_DECODER_PROTOCOL { |
| EFI_HII_IMAGE_DECODER_GET_NAME GetImageDecoderName; |
| EFI_HII_IMAGE_DECODER_GET_IMAGE_INFO GetImageInfo; |
| EFI_HII_IMAGE_DECODER_DECODE DecodeImage; |
| }; |
| |
| extern EFI_GUID gEfiHiiImageDecoderProtocolGuid; |
| extern EFI_GUID gEfiHiiImageDecoderNameJpegGuid; |
| extern EFI_GUID gEfiHiiImageDecoderNamePngGuid; |
| |
| #endif |