]> git.proxmox.com Git - mirror_edk2.git/commitdiff
MdePkg: Add UEFI2.6 HII Image Ex and Image Decoder protocol definition.
authorCecil Sheng <cecil.sheng@hpe.com>
Mon, 14 Mar 2016 02:52:27 +0000 (10:52 +0800)
committerLiming Gao <liming.gao@intel.com>
Tue, 15 Mar 2016 04:33:02 +0000 (12:33 +0800)
Add the definition for the new UEFI 2.6 EFI_HII_IMAGE_EX_PROTOCOL and
EFI_IMAGE_DECODER_PROTOCOL.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Cecil Sheng <cecil.sheng@hpe.com>
Reviewed-by: Samer El-Haj-Mahmoud <elhaj@hpe.com>
Reviewed-by: Abner Chang <abner.chang@hpe.com>
Reviewed-by: Eric Dong <eric.dong@intel.com>
MdePkg/Include/Protocol/HiiImageEx.h [new file with mode: 0644]
MdePkg/Include/Protocol/ImageDecoder.h [new file with mode: 0644]
MdePkg/MdePkg.dec

diff --git a/MdePkg/Include/Protocol/HiiImageEx.h b/MdePkg/Include/Protocol/HiiImageEx.h
new file mode 100644 (file)
index 0000000..9905ecd
--- /dev/null
@@ -0,0 +1,245 @@
+/** @file\r
+  Protocol which allows access to the images in the images database.\r
+\r
+(C) Copyright 2016 Hewlett Packard Enterprise Development LP<BR>\r
+\r
+This program and the accompanying materials are licensed and made available under\r
+the terms and conditions of the BSD License that accompanies this distribution.\r
+The full text of the license may be found at\r
+http://opensource.org/licenses/bsd-license.php.\r
+\r
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
+\r
+**/\r
+\r
+#ifndef __EFI_HII_IMAGE_EX_H__\r
+#define __EFI_HII_IMAGE_EX_H__\r
+\r
+#include <Protocol/HiiImage.h>\r
+\r
+//\r
+// Global ID for the Hii Image Ex Protocol.\r
+//\r
+#define EFI_HII_IMAGE_EX_PROTOCOL_GUID \\r
+  {0x1a1241e6, 0x8f19, 0x41a9,  { 0xbc, 0xe, 0xe8, 0xef, 0x39, 0xe0, 0x65, 0x46 }}\r
+\r
+typedef struct _EFI_HII_IMAGE_EX_PROTOCOL EFI_HII_IMAGE_EX_PROTOCOL;\r
+\r
+/**\r
+  The prototype of this extension function is the same with EFI_HII_IMAGE_PROTOCOL.NewImage().\r
+  Same with EFI_HII_IMAGE_PROTOCOL.NewImage().This protocol invokes\r
+EFI_HII_IMAGE_PROTOCOL.NewImage() implicitly.\r
+\r
+  @param  This                   A pointer to the EFI_HII_IMAGE_EX_PROTOCOL instance.\r
+  @param  PackageList            Handle of the package list where this image will\r
+                                 be added.\r
+  @param  ImageId                On return, contains the new image id, which is\r
+                                 unique within PackageList.\r
+  @param  Image                  Points to the image.\r
+\r
+  @retval EFI_SUCCESS            The new image was added successfully.\r
+  @retval EFI_NOT_FOUND          The specified PackageList could not be found in\r
+                                 database.\r
+  @retval EFI_OUT_OF_RESOURCES   Could not add the image due to lack of resources.\r
+  @retval EFI_INVALID_PARAMETER  Image is NULL or ImageId is NULL.\r
+\r
+**/\r
+typedef\r
+EFI_STATUS\r
+(EFIAPI *EFI_HII_NEW_IMAGE_EX)(\r
+  IN CONST  EFI_HII_IMAGE_EX_PROTOCOL  *This,\r
+  IN        EFI_HII_HANDLE              PackageList,\r
+  OUT       EFI_IMAGE_ID                *ImageId,\r
+  IN CONST  EFI_IMAGE_INPUT             *Image\r
+  );\r
+\r
+/**\r
+  Return the information about the image, associated with the package list.\r
+  The prototype of this extension function is the same with EFI_HII_IMAGE_PROTOCOL.GetImage().\r
+  Same with EFI_HII_IMAGE_PROTOCOL.SetImage(),this protocol invokes EFI_HII_IMAGE_PROTOCOL.SetImage() implicitly.\r
+\r
+  @param  This                   A pointer to the EFI_HII_IMAGE_EX_PROTOCOL instance.\r
+  @param  PackageList            Handle of the package list where this image will\r
+                                 be searched.\r
+  @param  ImageId                The image's id,, which is unique within\r
+                                 PackageList.\r
+  @param  Image                  Points to the image.\r
+\r
+  @retval EFI_SUCCESS            The new image was returned successfully.\r
+  @retval EFI_NOT_FOUND          The image specified by ImageId is not in the\r
+                                 database. The specified PackageList is not in\r
+                                 the database.\r
+  @retval EFI_BUFFER_TOO_SMALL   The buffer specified by ImageSize is too small to\r
+                                 hold the image.\r
+  @retval EFI_INVALID_PARAMETER  The Image or ImageSize was NULL.\r
+  @retval EFI_OUT_OF_RESOURCES   The bitmap could not be retrieved because there\r
+                                 was not enough memory.\r
+\r
+**/\r
+typedef\r
+EFI_STATUS\r
+(EFIAPI *EFI_HII_GET_IMAGE_EX)(\r
+  IN CONST  EFI_HII_IMAGE_EX_PROTOCOL       *This,\r
+  IN        EFI_HII_HANDLE                  PackageList,\r
+  IN        EFI_IMAGE_ID                    ImageId,\r
+  OUT       EFI_IMAGE_INPUT                 *Image\r
+  );\r
+\r
+/**\r
+  Change the information about the image. The prototype of this extension\r
+  function is the same with EFI_HII_IMAGE_PROTOCOL.SetImage().  Same with\r
+  EFI_HII_IMAGE_PROTOCOL.DrawImageId(),this protocol invokes EFI_HII_IMAGE_PROTOCOL.DrawImageId() implicitly.\r
+\r
+  @param  This                   A pointer to the EFI_HII_IMAGE_EX_PROTOCOL instance.\r
+  @param  PackageList            The package list containing the images.\r
+  @param  ImageId                The image's id,, which is unique within\r
+                                 PackageList.\r
+  @param  Image                  Points to the image.\r
+\r
+  @retval EFI_SUCCESS            The new image was updated successfully.\r
+  @retval EFI_NOT_FOUND          The image specified by ImageId is not in the\r
+                                 database. The specified PackageList is not in\r
+                                 the database.\r
+  @retval EFI_INVALID_PARAMETER  The Image was NULL.\r
+\r
+**/\r
+typedef\r
+EFI_STATUS\r
+(EFIAPI *EFI_HII_SET_IMAGE_EX)(\r
+  IN CONST  EFI_HII_IMAGE_EX_PROTOCOL   *This,\r
+  IN        EFI_HII_HANDLE              PackageList,\r
+  IN        EFI_IMAGE_ID                ImageId,\r
+  IN CONST  EFI_IMAGE_INPUT             *Image\r
+  );\r
+\r
+/**\r
+  Renders an image to a bitmap or to the display. The prototype of this extension\r
+  function is the same with EFI_HII_IMAGE_PROTOCOL.DrawImage().\r
+  Same with EFI_HII_IMAGE_PROTOCOL.SetImage(),this protocol invokes EFI_HII_IMAGE_PROTOCOL.SetImage() implicitly.\r
+\r
+  @param  This                   A pointer to the EFI_HII_IMAGE_EX_PROTOCOL instance.\r
+  @param  Flags                  Describes how the image is to be drawn.\r
+  @param  Image                  Points to the image to be displayed.\r
+  @param  Blt                    If this points to a non-NULL on entry, this points\r
+                                 to the image, which is Width pixels wide and\r
+                                 Height pixels high.  The image will be drawn onto\r
+                                 this image and  EFI_HII_DRAW_FLAG_CLIP is implied.\r
+                                 If this points to a  NULL on entry, then a buffer\r
+                                 will be allocated to hold  the generated image and\r
+                                 the pointer updated on exit. It is the caller's\r
+                                 responsibility to free this buffer.\r
+  @param  BltX                   Specifies the offset from the left and top edge of\r
+                                 the  output image of the first pixel in the image.\r
+  @param  BltY                   Specifies the offset from the left and top edge of\r
+                                 the  output image of the first pixel in the image.\r
+\r
+  @retval EFI_SUCCESS            The image was successfully drawn.\r
+  @retval EFI_OUT_OF_RESOURCES   Unable to allocate an output buffer for Blt.\r
+  @retval EFI_INVALID_PARAMETER  The Image or Blt was NULL.\r
+                                 Any combination of Flags is invalid.\r
+\r
+**/\r
+typedef\r
+EFI_STATUS\r
+(EFIAPI *EFI_HII_DRAW_IMAGE_EX)(\r
+  IN CONST  EFI_HII_IMAGE_EX_PROTOCOL   *This,\r
+  IN        EFI_HII_DRAW_FLAGS          Flags,\r
+  IN CONST  EFI_IMAGE_INPUT             *Image,\r
+  IN OUT    EFI_IMAGE_OUTPUT            **Blt,\r
+  IN        UINTN                       BltX,\r
+  IN        UINTN                       BltY\r
+  );\r
+\r
+/**\r
+  Renders an image to a bitmap or the screen containing the contents of the specified\r
+  image. The prototype of this extension function is the same with E\r
+  FI_HII_IMAGE_PROTOCOL.DrawImageId().\r
+  Same with EFI_HII_IMAGE_PROTOCOL.DrawImageId(),this protocol invokes\r
+EFI_HII_IMAGE_PROTOCOL.DrawImageId() implicitly.\r
+\r
+  @param  This                   A pointer to the EFI_HII_IMAGE_EX_PROTOCOL instance.\r
+  @param  Flags                  Describes how the image is to be drawn.\r
+  @param  PackageList            The package list in the HII database to search for\r
+                                 the  specified image.\r
+  @param  ImageId                The image's id, which is unique within\r
+                                 PackageList.\r
+  @param  Blt                    If this points to a non-NULL on entry, this points\r
+                                 to the image, which is Width pixels wide and\r
+                                 Height pixels high. The image will be drawn onto\r
+                                 this image and EFI_HII_DRAW_FLAG_CLIP is implied.\r
+                                 If this points to a NULL on entry, then a buffer\r
+                                 will be allocated to hold  the generated image\r
+                                 and the pointer updated on exit. It is the caller's\r
+                                 responsibility to free this buffer.\r
+  @param  BltX                   Specifies the offset from the left and top edge of\r
+                                 the output image of the first pixel in the image.\r
+  @param  BltY                   Specifies the offset from the left and top edge of\r
+                                 the output image of the first pixel in the image.\r
+\r
+  @retval EFI_SUCCESS            The image was successfully drawn.\r
+  @retval EFI_OUT_OF_RESOURCES   Unable to allocate an output buffer for Blt.\r
+  @retval EFI_INVALID_PARAMETER  The Blt was NULL.\r
+  @retval EFI_NOT_FOUND          The image specified by ImageId is not in the database.\r
+                                 The specified PackageList is not in the database.\r
+\r
+**/\r
+typedef\r
+EFI_STATUS\r
+(EFIAPI *EFI_HII_DRAW_IMAGE_ID_EX)(\r
+  IN CONST  EFI_HII_IMAGE_EX_PROTOCOL   *This,\r
+  IN        EFI_HII_DRAW_FLAGS          Flags,\r
+  IN        EFI_HII_HANDLE              PackageList,\r
+  IN        EFI_IMAGE_ID                ImageId,\r
+  IN OUT    EFI_IMAGE_OUTPUT            **Blt,\r
+  IN        UINTN                       BltX,\r
+  IN        UINTN                       BltY\r
+  );\r
+\r
+/**\r
+  This function returns the image information to EFI_IMAGE_OUTPUT. Only the width\r
+  and height are returned to the EFI_IMAGE_OUTPUT instead of decoding the image\r
+  to the buffer. This function is used to get the geometry of the image. This function\r
+  will try to locate all of the EFI_HII_IMAGE_DECODER_PROTOCOL installed on the\r
+  system if the decoder of image type is not supported by the EFI_HII_IMAGE_EX_PROTOCOL.\r
+\r
+  @param  This                   A pointer to the EFI_HII_IMAGE_EX_PROTOCOL instance.\r
+  @param  PackageList            Handle of the package list where this image will\r
+                                 be searched.\r
+  @param  ImageId                The image's id,, which is unique within PackageList.\r
+  @param  Image                  Points to the image.\r
+\r
+  @retval EFI_SUCCESS            The new image was returned successfully.\r
+  @retval EFI_NOT_FOUND          The image specified by ImageId is not in the\r
+                                 database. The specified PackageList is not in the database.\r
+  @retval EFI_BUFFER_TOO_SMALL   The buffer specified by ImageSize is too small to\r
+                                 hold the image.\r
+  @retval EFI_INVALID_PARAMETER  The Image or ImageSize was NULL.\r
+  @retval EFI_OUT_OF_RESOURCES   The bitmap could not be retrieved because there\r
+                                 was not enough memory.\r
+\r
+**/\r
+typedef\r
+EFI_STATUS\r
+(EFIAPI *EFI_HII_GET_IMAGE_INFO)(\r
+  IN CONST  EFI_HII_IMAGE_EX_PROTOCOL       *This,\r
+  IN        EFI_HII_HANDLE                  PackageList,\r
+  IN        EFI_IMAGE_ID                    ImageId,\r
+  OUT       EFI_IMAGE_INPUT                 *Image\r
+  );\r
+\r
+///\r
+/// Protocol which allows access to the images in the images database.\r
+///\r
+struct _EFI_HII_IMAGE_EX_PROTOCOL {\r
+  EFI_HII_NEW_IMAGE_EX      NewImageEx;\r
+  EFI_HII_GET_IMAGE_EX      GetImageEx;\r
+  EFI_HII_SET_IMAGE_EX      SetImageEx;\r
+  EFI_HII_DRAW_IMAGE_EX     DrawImageEx;\r
+  EFI_HII_DRAW_IMAGE_ID_EX  DrawImageIdEx;\r
+  EFI_HII_GET_IMAGE_INFO    GetImageInfo;\r
+};\r
+\r
+extern EFI_GUID gEfiHiiImageExProtocolGuid;\r
+\r
+#endif\r
diff --git a/MdePkg/Include/Protocol/ImageDecoder.h b/MdePkg/Include/Protocol/ImageDecoder.h
new file mode 100644 (file)
index 0000000..f1985bc
--- /dev/null
@@ -0,0 +1,192 @@
+/** @file\r
+  This protocol provides generic image decoder interfaces to various image formats.\r
+\r
+(C) Copyright 2016 Hewlett Packard Enterprise Development LP<BR>\r
+\r
+This program and the accompanying materials are licensed and made available under\r
+the terms and conditions of the BSD License that accompanies this distribution.\r
+The full text of the license may be found at\r
+http://opensource.org/licenses/bsd-license.php.\r
+\r
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
+\r
+**/\r
+#ifndef __EFI_IMAGE_DECODER_PROTOCOL_H__\r
+#define __EFI_IMAGE_DECODER_PROTOCOL_H__\r
+\r
+#include <Protocol/HiiImage.h>\r
+\r
+\r
+#define EFI_HII_IMAGE_DECODER_PROTOCOL_GUID \\r
+  { 0x2f707ebb, 0x4a1a, 0x11d4, {0x9a,0x38,0x00,0x90,0x27,0x3f,0xc1,0x4d}}\r
+\r
+\r
+#define EFI_HII_IMAGE_DECODER_NAME_JPEG_GUID \\r
+  {0xefefd093, 0xd9b, 0x46eb,  { 0xa8, 0x56, 0x48, 0x35, 0x7, 0x0, 0xc9, 0x8 }}\r
+\r
+#define EFI_HII_IMAGE_DECODER_NAME_PNG_GUID \\r
+  {0xaf060190, 0x5e3a, 0x4025, { 0xaf, 0xbd, 0xe1, 0xf9, 0x5, 0xbf, 0xaa, 0x4c }}\r
+\r
+typedef struct _EFI_HII_IMAGE_DECODER_PROTOCOL EFI_HII_IMAGE_DECODER_PROTOCOL;\r
+\r
+typedef enum {\r
+  EFI_HII_IMAGE_DECODER_COLOR_TYPE_RGB     = 0x0,\r
+  EFI_HII_IMAGE_DECODER_COLOR_TYPE_RGBA    = 0x1,\r
+  EFI_HII_IMAGE_DECODER_COLOR_TYPE_CMYK    = 0x2,\r
+  EFI_HII_IMAGE_DECODER_COLOR_TYPE_UNKNOWN = 0xFF\r
+} EFI_HII_IMAGE_DECODER_COLOR_TYPE;\r
+\r
+//\r
+// EFI_HII_IMAGE_DECODER_IMAGE_INFO_HEADER\r
+//\r
+// DecoderName        Name of the decoder\r
+// ImageInfoSize      The size of entire image information structure in bytes\r
+// ImageWidth         The image width\r
+// ImageHeight        The image height\r
+// ColorType          The color type, see EFI_HII_IMAGE_DECODER_COLOR_TYPE.\r
+// ColorDepthInBits   The color depth in bits\r
+//\r
+typedef struct _EFI_HII_IMAGE_DECODER_IMAGE_INFO_HEADER {\r
+  EFI_GUID                            DecoderName;\r
+  UINT16                              ImageInfoSize;\r
+  UINT16                              ImageWidth;\r
+  UINT16                              ImageHeight;\r
+  EFI_HII_IMAGE_DECODER_COLOR_TYPE    ColorType;\r
+  UINT8                               ColorDepthInBits;\r
+} EFI_HII_IMAGE_DECODER_IMAGE_INFO_HEADER;\r
+\r
+//\r
+// EFI_HII_IMAGE_DECODER_JPEG_INFO\r
+// Header         The common header\r
+// ScanType       The scan type of JPEG image\r
+// Reserved       Reserved\r
+//\r
+typedef struct _EFI_HII_IMAGE_DECODER_JPEG_INFO {\r
+  EFI_HII_IMAGE_DECODER_IMAGE_INFO_HEADER  Header;\r
+\r
+#define EFI_IMAGE_JPEG_SCANTYPE_PROGREESSIVE 0x01\r
+#define EFI_IMAGE_JPEG_SCANTYPE_INTERLACED   0x02\r
+  UINT16                                    ScanType;\r
+  UINT64                                    Reserved;\r
+} EFI_HII_IMAGE_DECODER_JPEG_INFO;\r
+\r
+//\r
+// EFI_HII_IMAGE_DECODER_PNG_INFO\r
+// Header         The common header\r
+// Channels       Number of channels in the PNG image\r
+// Reserved       Reserved\r
+//\r
+typedef struct _EFI_HII_IMAGE_DECODER_PNG_INFO {\r
+  EFI_HII_IMAGE_DECODER_IMAGE_INFO_HEADER  Header;\r
+  UINT16                                    Channels;\r
+  UINT64                                    Reserved;\r
+} EFI_HII_IMAGE_DECODER_PNG_INFO;\r
+\r
+/**\r
+  There could be more than one EFI_HII_IMAGE_DECODER_PROTOCOL instances installed\r
+  in the system for different image formats. This function returns the decoder\r
+  name which callers can use to find the proper image decoder for the image. It\r
+  is possible to support multiple image formats in one EFI_HII_IMAGE_DECODER_PROTOCOL.\r
+  The capability of the supported image formats is returned in DecoderName and\r
+  NumberOfDecoderName.\r
+\r
+  @param This                    EFI_HII_IMAGE_DECODER_PROTOCOL instance.\r
+  @param DecoderName             Pointer to a dimension to retrieve the decoder\r
+                                 names in EFI_GUID format. The number of the\r
+                                 decoder names is returned in NumberOfDecoderName.\r
+  @param NumberofDecoderName     Pointer to retrieve the number of decoders which\r
+                                 supported by this decoder driver.\r
+\r
+  @retval EFI_SUCCESS            Get decoder name success.\r
+  @retval EFI_UNSUPPORTED        Get decoder name fail.\r
+\r
+**/\r
+typedef\r
+EFI_STATUS\r
+(EFIAPI *EFI_HII_IMAGE_DECODER_GET_DECODER_NAME)(\r
+  IN      EFI_HII_IMAGE_DECODER_PROTOCOL   *This,\r
+  IN OUT  EFI_GUID                         **DecoderName,\r
+  IN OUT  UINT16                           *NumberofDecoderName\r
+  );\r
+\r
+/**\r
+  This function returns the image information of the given image raw data. This\r
+  function first checks whether the image raw data is supported by this decoder\r
+  or not. This function may go through the first few bytes in the image raw data\r
+  for the specific data structure or the image signature. If the image is not supported\r
+  by this image decoder, this function returns EFI_UNSUPPORTED to the caller.\r
+  Otherwise, this function returns the proper image information to the caller.\r
+  It is the caller?s responsibility to free the ImageInfo.\r
+\r
+  @param This                    EFI_HII_IMAGE_DECODER_PROTOCOL instance.\r
+  @param Image                   Pointer to the image raw data.\r
+  @param SizeOfImage             Size of the entire image raw data.\r
+  @param ImageInfo               Pointer to recieve EFI_HII_IMAGE_DECODER_IMAGE_INFO_HEADER.\r
+\r
+  @retval EFI_SUCCESS            Get image info success.\r
+  @retval EFI_UNSUPPORTED        Unsupported format of image.\r
+  @retval EFI_INVALID_PARAMETER  Incorrect parameter.\r
+  @retval EFI_BAD_BUFFER_SIZE    Not enough memory.\r
+\r
+**/\r
+typedef\r
+EFI_STATUS\r
+(EFIAPI *EFI_HII_IMAGE_DECODER_GET_IMAGE_INFO)(\r
+  IN      EFI_HII_IMAGE_DECODER_PROTOCOL           *This,\r
+  IN      VOID                                     *Image,\r
+  IN      UINTN                                    SizeOfImage,\r
+  IN OUT  EFI_HII_IMAGE_DECODER_IMAGE_INFO_HEADER  **ImageInfo\r
+  );\r
+\r
+/**\r
+  This function decodes the image which the image type of this image is supported\r
+  by this EFI_HII_IMAGE_DECODER_PROTOCOL. If **Bitmap is not NULL, the caller intends\r
+  to put the image in the given image buffer. That allows the caller to put an\r
+  image overlap on the original image. The transparency is handled by the image\r
+  decoder because the transparency capability depends on the image format. Callers\r
+  can set Transparent to FALSE to force disabling the transparency process on the\r
+  image. Forcing Transparent to FALSE may also improve the performance of the image\r
+  decoding because the image decoder can skip the transparency processing.  If **Bitmap\r
+  is NULL, the image decoder allocates the memory buffer for the EFI_IMAGE_OUTPUT\r
+  and decodes the image to the image buffer. It is the caller?s responsibility to\r
+  free the memory for EFI_IMAGE_OUTPUT. Image decoder doesn?t have to handle the\r
+  transparency in this case because there is no background image given by the caller.\r
+  The background color in this case is all black (#00000000).\r
+\r
+  @param This                    EFI_HII_IMAGE_DECODER_PROTOCOL instance.\r
+  @param Image                   Pointer to the image raw data.\r
+  @param ImageRawDataSize        Size of the entire image raw data.\r
+  @param Blt                     EFI_IMAGE_OUTPUT to receive the image or overlap\r
+                                 the image on the original buffer.\r
+  @param Transparent             BOOLEAN value indicates whether the image decoder\r
+                                 has to handle the transparent image or not.\r
+\r
+\r
+  @retval EFI_SUCCESS            Image decode success.\r
+  @retval EFI_UNSUPPORTED        Unsupported format of image.\r
+  @retval EFI_INVALID_PARAMETER  Incorrect parameter.\r
+  @retval EFI_BAD_BUFFER_SIZE    Not enough memory.\r
+\r
+**/\r
+typedef\r
+EFI_STATUS\r
+(EFIAPI *EFI_HII_IMAGE_DECODER_DECODE)(\r
+  IN      EFI_HII_IMAGE_DECODER_PROTOCOL   *This,\r
+  IN      VOID                              *Image,\r
+  IN      UINTN                             ImageRawDataSize,\r
+  IN OUT  EFI_IMAGE_OUTPUT                  **BitMap OPTIONAL,\r
+  IN      BOOLEAN                           Transparent\r
+  );\r
+\r
+struct _EFI_HII_IMAGE_DECODER_PROTOCOL {\r
+  EFI_HII_IMAGE_DECODER_GET_DECODER_NAME  GetImageDecoderName;\r
+  EFI_HII_IMAGE_DECODER_GET_IMAGE_INFO    GetImageInfo;\r
+  EFI_HII_IMAGE_DECODER_DECODE            DecodeImage;\r
+};\r
+\r
+extern EFI_GUID gEfiHiiImageDecoderProtocolGuid;\r
+extern EFI_GUID gEfiHiiImageDecoderNameJpegGuid;\r
+extern EFI_GUID gEfiHiiImageDecoderNamePngGuid;\r
+\r
+#endif\r
index 7388ff75f1630232f9400970b78b16beb38c705c..47a1cd7a8ca55d7c88d605f892d47005280f9dcc 100644 (file)
   ## Include/Guid/Cper.h\r
   gEfiArmProcessorErrorSectionGuid     = { 0xe19e3d16, 0xbc11, 0x11e4, { 0x9c, 0xaa, 0xc2, 0x05, 0x1d, 0x5d, 0x46, 0xb0 }}\r
 \r
+  ## Guid for Image decoder\r
+  ## Include/Protocol/ImageDecoder.h\r
+  gEfiHiiImageDecoderNameJpegGuid           = { 0xefefd093, 0x0d9b, 0x46eb, { 0xa8, 0x56, 0x48, 0x35, 0x07, 0x00, 0xc9, 0x08 }}\r
+  gEfiHiiImageDecoderNamePngGuid            = { 0xaf060190, 0x5e3a, 0x4025, { 0xaf, 0xbd, 0xe1, 0xf9, 0x05, 0xbf, 0xaa, 0x4c }}\r
+\r
   #\r
   # GUID defined in PI1.0\r
   #\r
   ## Include/Protocol/RamDisk.h\r
   gEfiRamDiskProtocolGuid              = { 0xab38a0df, 0x6873, 0x44a9, { 0x87, 0xe6, 0xd4, 0xeb, 0x56, 0x14, 0x84, 0x49 }}\r
 \r
+  ## Include/Protocol/ImageDecoder.h\r
+  gEfiHiiImageDecoderProtocolGuid      = { 0x2f707ebb, 0x4a1a, 0x11d4, { 0x9a, 0x38, 0x00, 0x90, 0x27, 0x3f, 0xc1, 0x4d }}\r
+\r
+  ## Include/Protocol/HiiImageEx.h\r
+  gEfiHiiImageExProtocolGuid           = { 0x1a1241e6, 0x8f19, 0x41a9, { 0xbc, 0xe,  0xe8, 0xef, 0x39, 0xe0, 0x65, 0x46 }}\r
+\r
 #\r
 # [Error.gEfiMdePkgTokenSpaceGuid]\r
 #   0x80000001 | Invalid value provided.\r