mirror of
https://git.proxmox.com/git/mirror_edk2
synced 2025-10-31 09:21:56 +00:00
9344f09215
https://bugzilla.tianocore.org/show_bug.cgi?id=1373 Replace BSD 2-Clause License with BSD+Patent License. This change is based on the following emails: https://lists.01.org/pipermail/edk2-devel/2019-February/036260.html https://lists.01.org/pipermail/edk2-devel/2018-October/030385.html RFCs with detailed process for the license change: V3: https://lists.01.org/pipermail/edk2-devel/2019-March/038116.html V2: https://lists.01.org/pipermail/edk2-devel/2019-March/037669.html V1: https://lists.01.org/pipermail/edk2-devel/2019-March/037500.html Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com> Reviewed-by: Liming Gao <liming.gao@intel.com>
201 lines
8.3 KiB
C
201 lines
8.3 KiB
C
/** @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
|