3 Copyright (c) 2007, Intel Corporation
4 All rights reserved. This program and the accompanying materials
5 are licensed and made available under the terms and conditions of the BSD License
6 which accompanies this distribution. The full text of the license may be found at
7 http://opensource.org/licenses/bsd-license.php
9 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
10 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
18 Implementation for EFI_HII_IMAGE_PROTOCOL.
26 #include "HiiDatabase.h"
28 #ifndef DISABLE_UNUSED_HII_PROTOCOLS
34 IN OUT EFI_IMAGE_ID
*ImageId
39 Get the imageid of last image block: EFI_HII_IIBT_END_BLOCK when input
40 ImageId is zero, otherwise return the address of the
41 corresponding image block with identifier specified by ImageId.
44 ImageBlock - Points to the beginning of a series of image blocks stored in order.
45 ImageId - If input ImageId is 0, output the image id of the EFI_HII_IIBT_END_BLOCK;
46 else use this id to find its corresponding image block address.
49 The image block address when input ImageId is not zero; otherwise return NULL.
53 EFI_IMAGE_ID ImageIdCurrent
;
58 EFI_HII_IIBT_IMAGE_1BIT_BLOCK Iibt1bit
;
59 EFI_HII_IIBT_IMAGE_4BIT_BLOCK Iibt4bit
;
60 EFI_HII_IIBT_IMAGE_8BIT_BLOCK Iibt8bit
;
64 ASSERT (ImageBlock
!= NULL
&& ImageId
!= NULL
);
66 ImageBlockHdr
= ImageBlock
;
69 while (((EFI_HII_IMAGE_BLOCK
*) ImageBlock
)->BlockType
!= EFI_HII_IIBT_END
) {
71 if (*ImageId
== ImageIdCurrent
) {
73 // If the found image block is a duplicate block, update the ImageId to
74 // find the previous defined image block.
76 if (((EFI_HII_IMAGE_BLOCK
*) ImageBlock
)->BlockType
== EFI_HII_IIBT_DUPLICATE
) {
77 CopyMem (ImageId
, ImageBlock
+ sizeof (EFI_HII_IMAGE_BLOCK
), sizeof (EFI_IMAGE_ID
));
78 ASSERT (*ImageId
!= ImageIdCurrent
);
79 ImageBlock
= ImageBlockHdr
;
86 if (*ImageId
< ImageIdCurrent
) {
88 // Can not find the specified image block in this image.
93 switch (((EFI_HII_IMAGE_BLOCK
*) ImageBlock
)->BlockType
) {
94 case EFI_HII_IIBT_EXT1
:
95 Length8
= *(ImageBlock
+ sizeof (EFI_HII_IMAGE_BLOCK
) + sizeof (UINT8
));
96 ImageBlock
+= Length8
;
99 case EFI_HII_IIBT_EXT2
:
102 ImageBlock
+ sizeof (EFI_HII_IMAGE_BLOCK
) + sizeof (UINT8
),
105 ImageBlock
+= Length16
;
108 case EFI_HII_IIBT_EXT4
:
111 ImageBlock
+ sizeof (EFI_HII_IMAGE_BLOCK
) + sizeof (UINT8
),
114 ImageBlock
+= Length32
;
118 case EFI_HII_IIBT_IMAGE_1BIT
:
119 case EFI_HII_IIBT_IMAGE_1BIT_TRANS
:
120 CopyMem (&Iibt1bit
, ImageBlock
, sizeof (EFI_HII_IIBT_IMAGE_1BIT_BLOCK
));
121 ImageBlock
+= sizeof (EFI_HII_IIBT_IMAGE_1BIT_BLOCK
) - sizeof (UINT8
) +
122 BITMAP_LEN_1_BIT (Iibt1bit
.Bitmap
.Width
, Iibt1bit
.Bitmap
.Height
);
126 case EFI_HII_IIBT_IMAGE_4BIT
:
127 case EFI_HII_IIBT_IMAGE_4BIT_TRANS
:
128 CopyMem (&Iibt4bit
, ImageBlock
, sizeof (EFI_HII_IIBT_IMAGE_4BIT_BLOCK
));
129 ImageBlock
+= sizeof (EFI_HII_IIBT_IMAGE_4BIT_BLOCK
) - sizeof (UINT8
) +
130 BITMAP_LEN_4_BIT (Iibt4bit
.Bitmap
.Width
, Iibt4bit
.Bitmap
.Height
);
134 case EFI_HII_IIBT_IMAGE_8BIT
:
135 case EFI_HII_IIBT_IMAGE_8BIT_TRANS
:
136 CopyMem (&Iibt8bit
, ImageBlock
, sizeof (EFI_HII_IIBT_IMAGE_8BIT_BLOCK
));
137 ImageBlock
+= sizeof (EFI_HII_IIBT_IMAGE_8BIT_BLOCK
) - sizeof (UINT8
) +
138 BITMAP_LEN_8_BIT (Iibt8bit
.Bitmap
.Width
, Iibt8bit
.Bitmap
.Height
);
142 case EFI_HII_IIBT_IMAGE_24BIT
:
143 case EFI_HII_IIBT_IMAGE_24BIT_TRANS
:
144 CopyMem (&Width
, ImageBlock
+ sizeof (EFI_HII_IMAGE_BLOCK
), sizeof (UINT16
));
147 ImageBlock
+ sizeof (EFI_HII_IMAGE_BLOCK
) + sizeof (UINT16
),
150 ImageBlock
+= sizeof (EFI_HII_IIBT_IMAGE_24BIT_BLOCK
) - sizeof (EFI_HII_RGB_PIXEL
) +
151 BITMAP_LEN_24_BIT (Width
, Height
);
155 case EFI_HII_IIBT_DUPLICATE
:
156 ImageBlock
+= sizeof (EFI_HII_IIBT_DUPLICATE_BLOCK
);
160 case EFI_HII_IIBT_IMAGE_JPEG
:
161 CopyMem (&Length32
, ImageBlock
+ sizeof (EFI_HII_IMAGE_BLOCK
), sizeof (UINT32
));
162 ImageBlock
+= Length32
;
166 case EFI_HII_IIBT_SKIP1
:
167 Length8
= *(ImageBlock
+ sizeof (EFI_HII_IMAGE_BLOCK
));
168 ImageBlock
+= sizeof (EFI_HII_IIBT_SKIP1_BLOCK
);
169 ImageIdCurrent
= (UINT16
) (ImageIdCurrent
+ Length8
);
172 case EFI_HII_IIBT_SKIP2
:
173 CopyMem (&Length16
, ImageBlock
+ sizeof (EFI_HII_IMAGE_BLOCK
), sizeof (UINT16
));
174 ImageBlock
+= sizeof (EFI_HII_IIBT_SKIP2_BLOCK
);
175 ImageIdCurrent
= (UINT16
) (ImageIdCurrent
+ Length16
);
180 // Unknown image blocks can not be skipped, processing halts.
187 // When ImageId is zero, return the imageid of last image block: EFI_HII_IIBT_END_BLOCK.
190 *ImageId
= ImageIdCurrent
;
200 Convert pixels from EFI_GRAPHICS_OUTPUT_BLT_PIXEL to EFI_HII_RGB_PIXEL style.
202 @param BitMapOut Pixels in EFI_HII_RGB_PIXEL format.
203 @param BitMapIn Pixels in EFI_GRAPHICS_OUTPUT_BLT_PIXEL format.
204 @param PixelNum The number of pixels to be converted.
211 OUT EFI_HII_RGB_PIXEL
*BitMapOut
,
212 IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL
*BitMapIn
,
218 ASSERT (BitMapOut
!= NULL
&& BitMapIn
!= NULL
);
220 for (Index
= 0; Index
< PixelNum
; Index
++) {
221 CopyMem (BitMapOut
+ Index
, BitMapIn
+ Index
, sizeof (EFI_HII_RGB_PIXEL
));
227 Convert pixels from EFI_HII_RGB_PIXEL to EFI_GRAPHICS_OUTPUT_BLT_PIXEL style.
229 @param BitMapOut Pixels in EFI_GRAPHICS_OUTPUT_BLT_PIXEL format.
230 @param BitMapIn Pixels in EFI_HII_RGB_PIXEL format.
231 @param PixelNum The number of pixels to be converted.
238 OUT EFI_GRAPHICS_OUTPUT_BLT_PIXEL
*BitMapOut
,
239 IN EFI_HII_RGB_PIXEL
*BitMapIn
,
245 ASSERT (BitMapOut
!= NULL
&& BitMapIn
!= NULL
);
247 for (Index
= 0; Index
< PixelNum
; Index
++) {
248 CopyMem (BitMapOut
+ Index
, BitMapIn
+ Index
, sizeof (EFI_HII_RGB_PIXEL
));
254 Output pixels in "1 bit per pixel" format to an image.
256 @param Image Points to the image which will store the pixels.
257 @param Data Stores the value of output pixels, 0 or 1.
258 @param PaletteInfo PaletteInfo which stores the color of the output
259 pixels. First entry corresponds to color 0 and
260 second one to color 1.
267 IN OUT EFI_IMAGE_INPUT
*Image
,
269 IN EFI_HII_IMAGE_PALETTE_INFO
*PaletteInfo
276 EFI_GRAPHICS_OUTPUT_BLT_PIXEL
*BitMapPtr
;
277 EFI_GRAPHICS_OUTPUT_BLT_PIXEL PaletteValue
[2];
278 EFI_HII_IMAGE_PALETTE_INFO
*Palette
;
282 ASSERT (Image
!= NULL
&& Data
!= NULL
&& PaletteInfo
!= NULL
);
284 BitMapPtr
= Image
->Bitmap
;
287 // First entry corresponds to color 0 and second entry corresponds to color 1.
289 CopyMem (&PaletteSize
, PaletteInfo
, sizeof (UINT16
));
290 PaletteSize
+= sizeof (UINT16
);
291 Palette
= AllocateZeroPool (PaletteSize
);
292 ASSERT (Palette
!= NULL
);
293 CopyMem (Palette
, PaletteInfo
, PaletteSize
);
295 ZeroMem (PaletteValue
, sizeof (PaletteValue
));
296 CopyRgbToGopPixel (&PaletteValue
[0], &Palette
->PaletteValue
[0], 1);
297 CopyRgbToGopPixel (&PaletteValue
[1], &Palette
->PaletteValue
[1], 1);
298 SafeFreePool (Palette
);
301 // Convert the pixel from one bit to corresponding color.
303 for (Y
= 0; Y
< Image
->Height
; Y
++) {
304 OffsetY
= BITMAP_LEN_1_BIT (Image
->Width
, Y
);
306 // All bits in these bytes are meaningful
308 for (X
= 0; X
< Image
->Width
/ 8; X
++) {
309 Byte
= *(Data
+ OffsetY
+ X
);
310 for (Index
= 0; Index
< 8; Index
++) {
311 if ((Byte
& (1 << Index
)) != 0) {
312 BitMapPtr
[Y
* Image
->Width
+ X
* 8 + (8 - Index
- 1)] = PaletteValue
[1];
314 BitMapPtr
[Y
* Image
->Width
+ X
* 8 + (8 - Index
- 1)] = PaletteValue
[0];
319 if (Image
->Width
% 8 != 0) {
321 // Padding bits in this byte should be ignored.
323 Byte
= *(Data
+ OffsetY
+ X
);
324 for (Index
= 0; Index
< Image
->Width
% 8; Index
++) {
325 if ((Byte
& (1 << (8 - Index
- 1))) != 0) {
326 BitMapPtr
[Y
* Image
->Width
+ X
* 8 + Index
] = PaletteValue
[1];
328 BitMapPtr
[Y
* Image
->Width
+ X
* 8 + Index
] = PaletteValue
[0];
337 Output pixels in "4 bit per pixel" format to an image.
339 @param Image Points to the image which will store the pixels.
340 @param Data Stores the value of output pixels, 0 ~ 15.
341 @param PaletteInfo PaletteInfo which stores the color of the output
342 pixels. Each entry corresponds to a color within
350 IN OUT EFI_IMAGE_INPUT
*Image
,
352 IN EFI_HII_IMAGE_PALETTE_INFO
*PaletteInfo
358 EFI_GRAPHICS_OUTPUT_BLT_PIXEL
*BitMapPtr
;
359 EFI_GRAPHICS_OUTPUT_BLT_PIXEL PaletteValue
[16];
360 EFI_HII_IMAGE_PALETTE_INFO
*Palette
;
365 ASSERT (Image
!= NULL
&& Data
!= NULL
&& PaletteInfo
!= NULL
);
367 BitMapPtr
= Image
->Bitmap
;
370 // The bitmap should allocate each color index starting from 0.
372 CopyMem (&PaletteSize
, PaletteInfo
, sizeof (UINT16
));
373 PaletteSize
+= sizeof (UINT16
);
374 Palette
= AllocateZeroPool (PaletteSize
);
375 ASSERT (Palette
!= NULL
);
376 CopyMem (Palette
, PaletteInfo
, PaletteSize
);
377 PaletteNum
= (UINT16
)(Palette
->PaletteSize
/ sizeof (EFI_HII_RGB_PIXEL
));
379 ZeroMem (PaletteValue
, sizeof (PaletteValue
));
380 CopyRgbToGopPixel (PaletteValue
, Palette
->PaletteValue
, PaletteNum
);
381 SafeFreePool (Palette
);
384 // Convert the pixel from 4 bit to corresponding color.
386 for (Y
= 0; Y
< Image
->Height
; Y
++) {
387 OffsetY
= BITMAP_LEN_4_BIT (Image
->Width
, Y
);
389 // All bits in these bytes are meaningful
391 for (X
= 0; X
< Image
->Width
/ 2; X
++) {
392 Byte
= *(Data
+ OffsetY
+ X
);
393 BitMapPtr
[Y
* Image
->Width
+ X
* 2] = PaletteValue
[Byte
>> 4];
394 BitMapPtr
[Y
* Image
->Width
+ X
* 2 + 1] = PaletteValue
[Byte
& 0x0F];
397 if (Image
->Width
% 2 != 0) {
399 // Padding bits in this byte should be ignored.
401 Byte
= *(Data
+ OffsetY
+ X
);
402 BitMapPtr
[Y
* Image
->Width
+ X
* 2] = PaletteValue
[Byte
>> 4];
409 Output pixels in "8 bit per pixel" format to an image.
411 @param Image Points to the image which will store the pixels.
412 @param Data Stores the value of output pixels, 0 ~ 255.
413 @param PaletteInfo PaletteInfo which stores the color of the output
414 pixels. Each entry corresponds to a color within
422 IN OUT EFI_IMAGE_INPUT
*Image
,
424 IN EFI_HII_IMAGE_PALETTE_INFO
*PaletteInfo
430 EFI_GRAPHICS_OUTPUT_BLT_PIXEL
*BitMapPtr
;
431 EFI_GRAPHICS_OUTPUT_BLT_PIXEL PaletteValue
[256];
432 EFI_HII_IMAGE_PALETTE_INFO
*Palette
;
437 ASSERT (Image
!= NULL
&& Data
!= NULL
&& PaletteInfo
!= NULL
);
439 BitMapPtr
= Image
->Bitmap
;
442 // The bitmap should allocate each color index starting from 0.
444 CopyMem (&PaletteSize
, PaletteInfo
, sizeof (UINT16
));
445 PaletteSize
+= sizeof (UINT16
);
446 Palette
= AllocateZeroPool (PaletteSize
);
447 ASSERT (Palette
!= NULL
);
448 CopyMem (Palette
, PaletteInfo
, PaletteSize
);
449 PaletteNum
= (UINT16
)(Palette
->PaletteSize
/ sizeof (EFI_HII_RGB_PIXEL
));
450 ZeroMem (PaletteValue
, sizeof (PaletteValue
));
451 CopyRgbToGopPixel (PaletteValue
, Palette
->PaletteValue
, PaletteNum
);
452 SafeFreePool (Palette
);
455 // Convert the pixel from 8 bits to corresponding color.
457 for (Y
= 0; Y
< Image
->Height
; Y
++) {
458 OffsetY
= BITMAP_LEN_8_BIT (Image
->Width
, Y
);
460 // All bits are meaningful since the bitmap is 8 bits per pixel.
462 for (X
= 0; X
< Image
->Width
; X
++) {
463 Byte
= *(Data
+ OffsetY
+ X
);
464 BitMapPtr
[OffsetY
+ X
] = PaletteValue
[Byte
];
472 Output pixels in "24 bit per pixel" format to an image.
474 @param Image Points to the image which will store the pixels.
475 @param Data Stores the color of output pixels, allowing 16.8
483 IN OUT EFI_IMAGE_INPUT
*Image
,
484 IN EFI_HII_RGB_PIXEL
*Data
489 EFI_GRAPHICS_OUTPUT_BLT_PIXEL
*BitMapPtr
;
491 ASSERT (Image
!= NULL
&& Data
!= NULL
);
493 BitMapPtr
= Image
->Bitmap
;
495 for (Y
= 0; Y
< Image
->Height
; Y
++) {
496 OffsetY
= BITMAP_LEN_8_BIT (Image
->Width
, Y
);
497 CopyRgbToGopPixel (&BitMapPtr
[OffsetY
], &Data
[OffsetY
], Image
->Width
);
504 Convert the image from EFI_IMAGE_INPUT to EFI_IMAGE_OUTPUT format.
506 @param BltBuffer Buffer points to bitmap data of incoming image.
507 @param BltY Specifies the offset from the left and top edge of
508 the output image of the first pixel in the image.
509 @param Width Width of the incoming image, in pixels.
510 @param Height Height of the incoming image, in pixels.
511 @param Transparent If TRUE, all "off" pixels in the image will be
512 drawn using the pixel value from blt and all other
513 pixels will be copied.
514 @param Blt Buffer points to bitmap data of output image.
516 @retval EFI_SUCCESS The image was successfully converted.
517 @retval EFI_INVALID_PARAMETER Any incoming parameter is invalid.
523 IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL
*BltBuffer
,
528 IN BOOLEAN Transparent
,
529 IN OUT EFI_IMAGE_OUTPUT
**Blt
532 EFI_IMAGE_OUTPUT
*ImageOut
;
535 UINTN OffsetY1
; // src buffer
536 UINTN OffsetY2
; // dest buffer
537 EFI_GRAPHICS_OUTPUT_BLT_PIXEL SrcPixel
;
538 EFI_GRAPHICS_OUTPUT_BLT_PIXEL ZeroPixel
;
540 if (BltBuffer
== NULL
|| Blt
== NULL
|| *Blt
== NULL
) {
541 return EFI_INVALID_PARAMETER
;
546 if (Width
+ BltX
> ImageOut
->Width
) {
547 return EFI_INVALID_PARAMETER
;
549 if (Height
+ BltY
> ImageOut
->Height
) {
550 return EFI_INVALID_PARAMETER
;
553 ZeroMem (&ZeroPixel
, sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL
));
555 for (Y
= 0; Y
< Height
; Y
++) {
556 OffsetY1
= Width
* Y
;
557 OffsetY2
= ImageOut
->Width
* (BltY
+ Y
);
558 for (X
= 0; X
< Width
; X
++) {
559 SrcPixel
= BltBuffer
[OffsetY1
+ X
];
561 if (CompareMem (&SrcPixel
, &ZeroPixel
, 3) != 0) {
562 ImageOut
->Image
.Bitmap
[OffsetY2
+ BltX
+ X
] = SrcPixel
;
565 ImageOut
->Image
.Bitmap
[OffsetY2
+ BltX
+ X
] = SrcPixel
;
575 This function adds the image Image to the group of images owned by PackageList, and returns
576 a new image identifier (ImageId).
578 @param This A pointer to the EFI_HII_IMAGE_PROTOCOL instance.
579 @param PackageList Handle of the package list where this image will
581 @param ImageId On return, contains the new image id, which is
582 unique within PackageList.
583 @param Image Points to the image.
585 @retval EFI_SUCCESS The new image was added successfully.
586 @retval EFI_NOT_FOUND The specified PackageList could not be found in
588 @retval EFI_OUT_OF_RESOURCES Could not add the image due to lack of resources.
589 @retval EFI_INVALID_PARAMETER Image is NULL or ImageId is NULL.
595 IN CONST EFI_HII_IMAGE_PROTOCOL
*This
,
596 IN EFI_HII_HANDLE PackageList
,
597 OUT EFI_IMAGE_ID
*ImageId
,
598 IN CONST EFI_IMAGE_INPUT
*Image
601 HII_DATABASE_PRIVATE_DATA
*Private
;
603 HII_DATABASE_RECORD
*DatabaseRecord
;
604 HII_DATABASE_PACKAGE_LIST_INSTANCE
*PackageListNode
;
605 HII_IMAGE_PACKAGE_INSTANCE
*ImagePackage
;
611 EFI_IMAGE_INPUT
*ImageIn
;
613 if (This
== NULL
|| ImageId
== NULL
|| Image
== NULL
|| PackageList
== NULL
) {
614 return EFI_INVALID_PARAMETER
;
617 if (!IsHiiHandleValid (PackageList
)) {
618 return EFI_NOT_FOUND
;
621 Private
= HII_IMAGE_DATABASE_PRIVATE_DATA_FROM_THIS (This
);
624 // Get the specified package list
627 PackageListNode
= NULL
;
629 for (Link
= Private
->DatabaseList
.ForwardLink
;
630 Link
!= &Private
->DatabaseList
;
631 Link
= Link
->ForwardLink
633 DatabaseRecord
= CR (Link
, HII_DATABASE_RECORD
, DatabaseEntry
, HII_DATABASE_RECORD_SIGNATURE
);
634 if (DatabaseRecord
->Handle
== PackageList
) {
635 PackageListNode
= DatabaseRecord
->PackageList
;
640 if (PackageListNode
== NULL
) {
641 return EFI_NOT_FOUND
;
644 ImageIn
= (EFI_IMAGE_INPUT
*) Image
;
646 NewBlockSize
= sizeof (EFI_HII_IIBT_IMAGE_24BIT_BLOCK
) - sizeof (EFI_HII_RGB_PIXEL
) +
647 BITMAP_LEN_24_BIT (ImageIn
->Width
, ImageIn
->Height
);
650 // Get the image package in the package list,
651 // or create a new image package if image package does not exist.
653 if (PackageListNode
->ImagePkg
!= NULL
) {
654 ImagePackage
= PackageListNode
->ImagePkg
;
657 // Output the image id of the incoming image being inserted, which is the
658 // image id of the EFI_HII_IIBT_END block of old image package.
661 GetImageIdOrAddress (ImagePackage
->ImageBlock
, ImageId
);
664 // Update the package's image block by appending the new block to the end.
666 BlockSize
= ImagePackage
->ImageBlockSize
+ NewBlockSize
;
667 ImageBlock
= (UINT8
*) AllocateZeroPool (BlockSize
);
668 if (ImageBlock
== NULL
) {
669 return EFI_OUT_OF_RESOURCES
;
672 // Copy the original content.
676 ImagePackage
->ImageBlock
,
677 ImagePackage
->ImageBlockSize
- sizeof (EFI_HII_IIBT_END_BLOCK
)
679 SafeFreePool (ImagePackage
->ImageBlock
);
680 ImagePackage
->ImageBlock
= ImageBlock
;
681 ImageBlock
+= ImagePackage
->ImageBlockSize
- sizeof (EFI_HII_IIBT_END_BLOCK
);
683 // Temp memory to store new block.
685 NewBlock
= AllocateZeroPool (NewBlockSize
);
686 if (NewBlock
== NULL
) {
687 SafeFreePool (ImagePackage
->ImageBlock
);
688 ImagePackage
->ImageBlock
= NULL
;
689 return EFI_OUT_OF_RESOURCES
;
691 NewBlockPtr
= NewBlock
;
694 // Update the length record.
696 ImagePackage
->ImageBlockSize
= (UINT32
) BlockSize
;
697 ImagePackage
->ImagePkgHdr
.Header
.Length
+= (UINT32
) NewBlockSize
;
698 PackageListNode
->PackageListHdr
.PackageLength
+= (UINT32
) NewBlockSize
;
702 // The specified package list does not contain image package.
703 // Create one to add this image block.
705 ImagePackage
= (HII_IMAGE_PACKAGE_INSTANCE
*) AllocateZeroPool (sizeof (HII_IMAGE_PACKAGE_INSTANCE
));
706 if (ImagePackage
== NULL
) {
707 return EFI_OUT_OF_RESOURCES
;
710 // Output the image id of the incoming image being inserted, which is the
711 // first image block so that id is initially to one.
714 BlockSize
= sizeof (EFI_HII_IIBT_END_BLOCK
) + NewBlockSize
;
716 // Fill in image package header.
718 ImagePackage
->ImagePkgHdr
.Header
.Length
= (UINT32
) BlockSize
+ sizeof (EFI_HII_IMAGE_PACKAGE_HDR
);
719 ImagePackage
->ImagePkgHdr
.Header
.Type
= EFI_HII_PACKAGE_IMAGES
;
720 ImagePackage
->ImagePkgHdr
.ImageInfoOffset
= sizeof (EFI_HII_IMAGE_PACKAGE_HDR
);
721 ImagePackage
->ImagePkgHdr
.PaletteInfoOffset
= 0;
724 // Fill in palette info.
726 ImagePackage
->PaletteBlock
= NULL
;
727 ImagePackage
->PaletteInfoSize
= 0;
730 // Fill in image blocks.
732 ImagePackage
->ImageBlockSize
= (UINT32
) BlockSize
;
733 ImagePackage
->ImageBlock
= (UINT8
*) AllocateZeroPool (BlockSize
);
734 if (ImagePackage
->ImageBlock
== NULL
) {
735 SafeFreePool (ImagePackage
);
736 return EFI_OUT_OF_RESOURCES
;
738 ImageBlock
= ImagePackage
->ImageBlock
;
741 // Temp memory to store new block.
743 NewBlock
= AllocateZeroPool (NewBlockSize
);
744 if (NewBlock
== NULL
) {
745 SafeFreePool (ImagePackage
->ImageBlock
);
746 SafeFreePool (ImagePackage
);
747 return EFI_OUT_OF_RESOURCES
;
749 NewBlockPtr
= NewBlock
;
752 // Insert this image package.
754 PackageListNode
->ImagePkg
= ImagePackage
;
755 PackageListNode
->PackageListHdr
.PackageLength
+= ImagePackage
->ImagePkgHdr
.Header
.Length
;
759 // Append the new block here
761 if (ImageIn
->Flags
== EFI_IMAGE_TRANSPARENT
) {
762 *NewBlock
= EFI_HII_IIBT_IMAGE_24BIT_TRANS
;
764 *NewBlock
= EFI_HII_IIBT_IMAGE_24BIT
;
767 CopyMem (NewBlock
, &ImageIn
->Width
, sizeof (UINT16
));
768 NewBlock
+= sizeof (UINT16
);
769 CopyMem (NewBlock
, &ImageIn
->Height
, sizeof (UINT16
));
770 NewBlock
+= sizeof (UINT16
);
771 CopyGopToRgbPixel ((EFI_HII_RGB_PIXEL
*) NewBlock
, ImageIn
->Bitmap
, ImageIn
->Width
* ImageIn
->Height
);
773 CopyMem (ImageBlock
, NewBlockPtr
, NewBlockSize
);
774 SafeFreePool (NewBlockPtr
);
777 // Append the block end
779 ImageBlock
+= NewBlockSize
;
780 ((EFI_HII_IIBT_END_BLOCK
*) (ImageBlock
))->Header
.BlockType
= EFI_HII_IIBT_END
;
787 This function retrieves the image specified by ImageId which is associated with
788 the specified PackageList and copies it into the buffer specified by Image.
790 @param This A pointer to the EFI_HII_IMAGE_PROTOCOL instance.
791 @param PackageList Handle of the package list where this image will
793 @param ImageId The image's id,, which is unique within
795 @param Image Points to the image.
796 @param ImageSize On entry, points to the size of the buffer pointed
797 to by Image, in bytes. On return, points to the
798 length of the image, in bytes.
800 @retval EFI_SUCCESS The new image was returned successfully.
801 @retval EFI_NOT_FOUND The image specified by ImageId is not available.
802 @retval EFI_BUFFER_TOO_SMALL The buffer specified by ImageSize is too small to
804 @retval EFI_INVALID_PARAMETER The Image or ImageSize was NULL.
810 IN CONST EFI_HII_IMAGE_PROTOCOL
*This
,
811 IN EFI_HII_HANDLE PackageList
,
812 IN EFI_IMAGE_ID ImageId
,
813 OUT EFI_IMAGE_INPUT
*Image
,
817 HII_DATABASE_PRIVATE_DATA
*Private
;
819 HII_DATABASE_RECORD
*DatabaseRecord
;
820 HII_DATABASE_PACKAGE_LIST_INSTANCE
*PackageListNode
;
821 HII_IMAGE_PACKAGE_INSTANCE
*ImagePackage
;
823 EFI_IMAGE_ID LocalImageId
;
825 EFI_HII_IIBT_IMAGE_1BIT_BLOCK Iibt1bit
;
834 if (This
== NULL
|| ImageSize
== NULL
|| Image
== NULL
|| ImageId
< 1 || PackageList
== NULL
) {
835 return EFI_INVALID_PARAMETER
;
838 if (!IsHiiHandleValid (PackageList
)) {
839 return EFI_NOT_FOUND
;
842 Private
= HII_IMAGE_DATABASE_PRIVATE_DATA_FROM_THIS (This
);
845 // Get the specified package list and image package.
847 PackageListNode
= NULL
;
848 for (Link
= Private
->DatabaseList
.ForwardLink
;
849 Link
!= &Private
->DatabaseList
;
850 Link
= Link
->ForwardLink
852 DatabaseRecord
= CR (Link
, HII_DATABASE_RECORD
, DatabaseEntry
, HII_DATABASE_RECORD_SIGNATURE
);
853 if (DatabaseRecord
->Handle
== PackageList
) {
854 PackageListNode
= DatabaseRecord
->PackageList
;
858 if (PackageListNode
== NULL
) {
859 return EFI_NOT_FOUND
;
861 ImagePackage
= PackageListNode
->ImagePkg
;
862 if (ImagePackage
== NULL
) {
863 return EFI_NOT_FOUND
;
867 // Find the image block specified by ImageId
869 LocalImageId
= ImageId
;
870 ImageBlock
= GetImageIdOrAddress (ImagePackage
->ImageBlock
, &LocalImageId
);
871 if (ImageBlock
== NULL
) {
872 return EFI_NOT_FOUND
;
876 BlockType
= *ImageBlock
;
879 case EFI_HII_IIBT_IMAGE_JPEG
:
881 // BUGBUG: need to be supported as soon as image tool is designed.
883 return EFI_UNSUPPORTED
;
886 case EFI_HII_IIBT_IMAGE_1BIT_TRANS
:
887 case EFI_HII_IIBT_IMAGE_4BIT_TRANS
:
888 case EFI_HII_IIBT_IMAGE_8BIT_TRANS
:
893 case EFI_HII_IIBT_IMAGE_1BIT
:
894 case EFI_HII_IIBT_IMAGE_4BIT
:
895 case EFI_HII_IIBT_IMAGE_8BIT
:
897 // Use the common block code since the definition of these structures is the same.
899 CopyMem (&Iibt1bit
, ImageBlock
, sizeof (EFI_HII_IIBT_IMAGE_1BIT_BLOCK
));
900 ImageLength
= sizeof (EFI_IMAGE_INPUT
) + sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL
) *
901 (Iibt1bit
.Bitmap
.Width
* Iibt1bit
.Bitmap
.Height
- 1);
902 if (*ImageSize
< ImageLength
) {
903 *ImageSize
= ImageLength
;
904 return EFI_BUFFER_TOO_SMALL
;
906 ZeroMem (Image
, ImageLength
);
909 Image
->Flags
= EFI_IMAGE_TRANSPARENT
;
911 Image
->Width
= Iibt1bit
.Bitmap
.Width
;
912 Image
->Height
= Iibt1bit
.Bitmap
.Height
;
914 PaletteInfo
= ImagePackage
->PaletteBlock
+ sizeof (EFI_HII_IMAGE_PALETTE_INFO_HEADER
);
915 for (PaletteIndex
= 1; PaletteIndex
< Iibt1bit
.PaletteIndex
; PaletteIndex
++) {
916 CopyMem (&PaletteSize
, PaletteInfo
, sizeof (UINT16
));
917 PaletteInfo
+= PaletteSize
+ sizeof (UINT16
);
919 ASSERT (PaletteIndex
== Iibt1bit
.PaletteIndex
);
922 // Output bitmap data
924 if (BlockType
== EFI_HII_IIBT_IMAGE_1BIT
|| BlockType
== EFI_HII_IIBT_IMAGE_1BIT_TRANS
) {
927 (UINT8
*) (ImageBlock
+ sizeof (EFI_HII_IIBT_IMAGE_1BIT_BLOCK
) - sizeof (UINT8
)),
928 (EFI_HII_IMAGE_PALETTE_INFO
*) PaletteInfo
930 } else if (BlockType
== EFI_HII_IIBT_IMAGE_4BIT
|| BlockType
== EFI_HII_IIBT_IMAGE_4BIT_TRANS
) {
933 (UINT8
*) (ImageBlock
+ sizeof (EFI_HII_IIBT_IMAGE_4BIT_BLOCK
) - sizeof (UINT8
)),
934 (EFI_HII_IMAGE_PALETTE_INFO
*) PaletteInfo
939 (UINT8
*) (ImageBlock
+ sizeof (EFI_HII_IIBT_IMAGE_8BIT_BLOCK
) - sizeof (UINT8
)),
940 (EFI_HII_IMAGE_PALETTE_INFO
*) PaletteInfo
947 case EFI_HII_IIBT_IMAGE_24BIT_TRANS
:
952 case EFI_HII_IIBT_IMAGE_24BIT
:
953 CopyMem (&Width
, ImageBlock
+ sizeof (EFI_HII_IMAGE_BLOCK
), sizeof (UINT16
));
956 ImageBlock
+ sizeof (EFI_HII_IMAGE_BLOCK
) + sizeof (UINT16
),
959 ImageLength
= sizeof (EFI_IMAGE_INPUT
) +
960 sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL
) * (Width
* Height
- 1);
961 if (*ImageSize
< ImageLength
) {
962 *ImageSize
= ImageLength
;
963 return EFI_BUFFER_TOO_SMALL
;
965 ZeroMem (Image
, ImageLength
);
968 Image
->Flags
= EFI_IMAGE_TRANSPARENT
;
970 Image
->Width
= Width
;
971 Image
->Height
= Height
;
974 // Output the bimap data directly.
978 (EFI_HII_RGB_PIXEL
*) (ImageBlock
+ sizeof (EFI_HII_IIBT_IMAGE_24BIT_BLOCK
) - sizeof (EFI_HII_RGB_PIXEL
))
984 return EFI_NOT_FOUND
;
991 This function updates the image specified by ImageId in the specified PackageListHandle to
992 the image specified by Image.
994 @param This A pointer to the EFI_HII_IMAGE_PROTOCOL instance.
995 @param PackageList The package list containing the images.
996 @param ImageId The image's id,, which is unique within
998 @param Image Points to the image.
1000 @retval EFI_SUCCESS The new image was updated successfully.
1001 @retval EFI_NOT_FOUND The image specified by ImageId is not in the
1003 @retval EFI_INVALID_PARAMETER The Image was NULL.
1009 IN CONST EFI_HII_IMAGE_PROTOCOL
*This
,
1010 IN EFI_HII_HANDLE PackageList
,
1011 IN EFI_IMAGE_ID ImageId
,
1012 IN CONST EFI_IMAGE_INPUT
*Image
1015 HII_DATABASE_PRIVATE_DATA
*Private
;
1017 HII_DATABASE_RECORD
*DatabaseRecord
;
1018 HII_DATABASE_PACKAGE_LIST_INSTANCE
*PackageListNode
;
1019 HII_IMAGE_PACKAGE_INSTANCE
*ImagePackage
;
1021 EFI_IMAGE_ID LocalImageId
;
1023 EFI_HII_IIBT_IMAGE_1BIT_BLOCK Iibt1bit
;
1024 EFI_HII_IIBT_IMAGE_4BIT_BLOCK Iibt4bit
;
1025 EFI_HII_IIBT_IMAGE_8BIT_BLOCK Iibt8bit
;
1029 UINT32 NewBlockSize
;
1030 UINT32 OldBlockSize
;
1031 EFI_IMAGE_INPUT
*ImageIn
;
1039 if (This
== NULL
|| Image
== NULL
|| ImageId
< 1 || PackageList
== NULL
) {
1040 return EFI_INVALID_PARAMETER
;
1043 if (!IsHiiHandleValid (PackageList
)) {
1044 return EFI_NOT_FOUND
;
1047 Private
= HII_IMAGE_DATABASE_PRIVATE_DATA_FROM_THIS (This
);
1050 // Get the specified package list and image package.
1052 PackageListNode
= NULL
;
1053 for (Link
= Private
->DatabaseList
.ForwardLink
;
1054 Link
!= &Private
->DatabaseList
;
1055 Link
= Link
->ForwardLink
1057 DatabaseRecord
= CR (Link
, HII_DATABASE_RECORD
, DatabaseEntry
, HII_DATABASE_RECORD_SIGNATURE
);
1058 if (DatabaseRecord
->Handle
== PackageList
) {
1059 PackageListNode
= DatabaseRecord
->PackageList
;
1063 if (PackageListNode
== NULL
) {
1064 return EFI_NOT_FOUND
;
1066 ImagePackage
= PackageListNode
->ImagePkg
;
1067 if (ImagePackage
== NULL
) {
1068 return EFI_NOT_FOUND
;
1072 // Find the image block specified by ImageId
1074 LocalImageId
= ImageId
;
1075 ImageBlock
= GetImageIdOrAddress (ImagePackage
->ImageBlock
, &LocalImageId
);
1076 if (ImageBlock
== NULL
) {
1077 return EFI_NOT_FOUND
;
1080 BlockType
= *ImageBlock
;
1083 // Get the size of original image block. Use some common block code here
1084 // since the definition of some structures is the same.
1086 switch (BlockType
) {
1087 case EFI_HII_IIBT_IMAGE_JPEG
:
1089 // BUGBUG: need to be supported as soon as image tool is designed.
1091 return EFI_UNSUPPORTED
;
1094 case EFI_HII_IIBT_IMAGE_1BIT
:
1095 case EFI_HII_IIBT_IMAGE_1BIT_TRANS
:
1096 CopyMem (&Iibt1bit
, ImageBlock
, sizeof (EFI_HII_IIBT_IMAGE_1BIT_BLOCK
));
1097 OldBlockSize
= sizeof (EFI_HII_IIBT_IMAGE_1BIT_BLOCK
) - sizeof (UINT8
) +
1098 BITMAP_LEN_1_BIT (Iibt1bit
.Bitmap
.Width
, Iibt1bit
.Bitmap
.Height
);
1100 case EFI_HII_IIBT_IMAGE_4BIT
:
1101 case EFI_HII_IIBT_IMAGE_4BIT_TRANS
:
1102 CopyMem (&Iibt4bit
, ImageBlock
, sizeof (EFI_HII_IIBT_IMAGE_4BIT_BLOCK
));
1103 OldBlockSize
= sizeof (EFI_HII_IIBT_IMAGE_4BIT_BLOCK
) - sizeof (UINT8
) +
1104 BITMAP_LEN_4_BIT (Iibt4bit
.Bitmap
.Width
, Iibt4bit
.Bitmap
.Height
);
1106 case EFI_HII_IIBT_IMAGE_8BIT
:
1107 case EFI_HII_IIBT_IMAGE_8BIT_TRANS
:
1108 CopyMem (&Iibt8bit
, ImageBlock
, sizeof (EFI_HII_IIBT_IMAGE_8BIT_BLOCK
));
1109 OldBlockSize
= sizeof (EFI_HII_IIBT_IMAGE_8BIT_BLOCK
) - sizeof (UINT8
) +
1110 BITMAP_LEN_8_BIT (Iibt8bit
.Bitmap
.Width
, Iibt8bit
.Bitmap
.Height
);
1112 case EFI_HII_IIBT_IMAGE_24BIT
:
1113 case EFI_HII_IIBT_IMAGE_24BIT_TRANS
:
1114 CopyMem (&Width
, ImageBlock
+ sizeof (EFI_HII_IMAGE_BLOCK
), sizeof (UINT16
));
1117 ImageBlock
+ sizeof (EFI_HII_IMAGE_BLOCK
) + sizeof (UINT16
),
1120 OldBlockSize
= sizeof (EFI_HII_IIBT_IMAGE_24BIT_BLOCK
) - sizeof (EFI_HII_RGB_PIXEL
) +
1121 BITMAP_LEN_24_BIT (Width
, Height
);
1124 return EFI_NOT_FOUND
;
1129 // Create the new image block according to input image.
1131 ImageIn
= (EFI_IMAGE_INPUT
*) Image
;
1132 NewBlockSize
= sizeof (EFI_HII_IIBT_IMAGE_24BIT_BLOCK
) - sizeof (EFI_HII_RGB_PIXEL
) +
1133 BITMAP_LEN_24_BIT (ImageIn
->Width
, ImageIn
->Height
);
1134 NewBlock
= (UINT8
*) AllocateZeroPool (NewBlockSize
);
1135 if (NewBlock
== NULL
) {
1136 return EFI_OUT_OF_RESOURCES
;
1139 NewBlockPtr
= NewBlock
;
1140 if ((ImageIn
->Flags
& EFI_IMAGE_TRANSPARENT
) == EFI_IMAGE_TRANSPARENT
) {
1141 *NewBlockPtr
= EFI_HII_IIBT_IMAGE_24BIT_TRANS
;
1143 *NewBlockPtr
= EFI_HII_IIBT_IMAGE_24BIT
;
1147 CopyMem (NewBlockPtr
, &ImageIn
->Width
, sizeof (UINT16
));
1148 NewBlockPtr
+= sizeof (UINT16
);
1149 CopyMem (NewBlockPtr
, &ImageIn
->Height
, sizeof (UINT16
));
1150 NewBlockPtr
+= sizeof (UINT16
);
1152 CopyGopToRgbPixel ((EFI_HII_RGB_PIXEL
*) NewBlockPtr
, ImageIn
->Bitmap
, ImageIn
->Width
* ImageIn
->Height
);
1155 // Adjust the image package to remove the original block firstly then add the new block.
1157 BlockSize
= ImagePackage
->ImageBlockSize
+ NewBlockSize
- OldBlockSize
;
1158 Block
= (UINT8
*) AllocateZeroPool (BlockSize
);
1159 if (Block
== NULL
) {
1160 SafeFreePool (NewBlock
);
1161 return EFI_OUT_OF_RESOURCES
;
1165 Part1Size
= (UINT32
) (ImageBlock
- ImagePackage
->ImageBlock
);
1166 Part2Size
= ImagePackage
->ImageBlockSize
- Part1Size
- OldBlockSize
;
1167 CopyMem (BlockPtr
, ImagePackage
->ImageBlock
, Part1Size
);
1168 BlockPtr
+= Part1Size
;
1169 CopyMem (BlockPtr
, NewBlock
, NewBlockSize
);
1170 BlockPtr
+= NewBlockSize
;
1171 CopyMem (BlockPtr
, ImageBlock
+ OldBlockSize
, Part2Size
);
1173 SafeFreePool (ImagePackage
->ImageBlock
);
1174 SafeFreePool (NewBlock
);
1175 ImagePackage
->ImageBlock
= Block
;
1176 ImagePackage
->ImageBlockSize
= BlockSize
;
1177 ImagePackage
->ImagePkgHdr
.Header
.Length
+= NewBlockSize
- OldBlockSize
;
1178 PackageListNode
->PackageListHdr
.PackageLength
+= NewBlockSize
- OldBlockSize
;
1186 This function renders an image to a bitmap or the screen using the specified
1187 color and options. It draws the image on an existing bitmap, allocates a new
1188 bitmap or uses the screen. The images can be clipped.
1190 @param This A pointer to the EFI_HII_IMAGE_PROTOCOL instance.
1191 @param Flags Describes how the image is to be drawn.
1192 @param Image Points to the image to be displayed.
1193 @param Blt If this points to a non-NULL on entry, this points
1194 to the image, which is Width pixels wide and
1195 Height pixels high. The image will be drawn onto
1196 this image and EFI_HII_DRAW_FLAG_CLIP is implied.
1197 If this points to a NULL on entry, then a buffer
1198 will be allocated to hold the generated image and
1199 the pointer updated on exit. It is the caller's
1200 responsibility to free this buffer.
1201 @param BltY Specifies the offset from the left and top edge of
1202 the output image of the first pixel in the image.
1204 @retval EFI_SUCCESS The image was successfully drawn.
1205 @retval EFI_OUT_OF_RESOURCES Unable to allocate an output buffer for Blt.
1206 @retval EFI_INVALID_PARAMETER The Image or Blt was NULL.
1207 @retval EFI_INVALID_PARAMETER Any combination of Flags is invalid.
1213 IN CONST EFI_HII_IMAGE_PROTOCOL
*This
,
1214 IN EFI_HII_DRAW_FLAGS Flags
,
1215 IN CONST EFI_IMAGE_INPUT
*Image
,
1216 IN OUT EFI_IMAGE_OUTPUT
**Blt
,
1222 HII_DATABASE_PRIVATE_DATA
*Private
;
1223 BOOLEAN Transparent
;
1224 EFI_IMAGE_INPUT
*ImageIn
;
1225 EFI_IMAGE_OUTPUT
*ImageOut
;
1226 EFI_GRAPHICS_OUTPUT_BLT_PIXEL
*BltBuffer
;
1234 EFI_FONT_DISPLAY_INFO
*FontInfo
;
1236 EFI_CONSOLE_CONTROL_PROTOCOL
*Console
;
1238 if (This
== NULL
|| Image
== NULL
|| Blt
== NULL
) {
1239 return EFI_INVALID_PARAMETER
;
1242 if ((Flags
& EFI_HII_DRAW_FLAG_CLIP
) == EFI_HII_DRAW_FLAG_CLIP
&& *Blt
== NULL
) {
1243 return EFI_INVALID_PARAMETER
;
1246 if ((Flags
& EFI_HII_DRAW_FLAG_TRANSPARENT
) == EFI_HII_DRAW_FLAG_TRANSPARENT
) {
1247 return EFI_INVALID_PARAMETER
;
1250 ImageIn
= (EFI_IMAGE_INPUT
*) Image
;
1253 // Check whether the image will be drawn transparently or opaquely.
1255 Transparent
= FALSE
;
1256 if ((Flags
& EFI_HII_DRAW_FLAG_TRANSPARENT
) == EFI_HII_DRAW_FLAG_FORCE_TRANS
) {
1258 } else if ((Flags
& EFI_HII_DRAW_FLAG_TRANSPARENT
) == EFI_HII_DRAW_FLAG_FORCE_OPAQUE
){
1259 Transparent
= FALSE
;
1262 // Now EFI_HII_DRAW_FLAG_DEFAULT is set, whether image will be drawn depending
1263 // on the image's transparency setting.
1265 if ((ImageIn
->Flags
& EFI_IMAGE_TRANSPARENT
) == EFI_IMAGE_TRANSPARENT
) {
1271 // Image cannot be drawn transparently if Blt points to NULL on entry.
1272 // Currently output to Screen transparently is not supported, either.
1276 return EFI_INVALID_PARAMETER
;
1277 } else if ((Flags
& EFI_HII_DIRECT_TO_SCREEN
) == EFI_HII_DIRECT_TO_SCREEN
) {
1278 return EFI_INVALID_PARAMETER
;
1282 Private
= HII_IMAGE_DATABASE_PRIVATE_DATA_FROM_THIS (This
);
1285 // When Blt points to a non-NULL on entry, this image will be drawn onto
1286 // this bitmap or screen pointed by "*Blt" and EFI_HII_DRAW_FLAG_CLIP is implied.
1287 // Otherwise a new bitmap will be allocated to hold this image.
1291 // Clip the image by (Width, Height)
1294 Width
= ImageIn
->Width
;
1295 Height
= ImageIn
->Height
;
1297 if (Width
> (*Blt
)->Width
- BltX
) {
1298 Width
= (*Blt
)->Width
- BltX
;
1300 if (Height
> (*Blt
)->Height
- BltY
) {
1301 Height
= (*Blt
)->Height
- BltY
;
1304 BufferLen
= Width
* Height
* sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL
);
1305 BltBuffer
= (EFI_GRAPHICS_OUTPUT_BLT_PIXEL
*) AllocateZeroPool (BufferLen
);
1306 if (BltBuffer
== NULL
) {
1307 return EFI_OUT_OF_RESOURCES
;
1310 if (Width
== ImageIn
->Width
&& Height
== ImageIn
->Height
) {
1311 CopyMem (BltBuffer
, ImageIn
->Bitmap
, BufferLen
);
1313 for (Y
= 0; Y
< Height
; Y
++) {
1314 OffsetY1
= ImageIn
->Width
* Y
;
1315 OffsetY2
= Width
* Y
;
1316 for (X
= 0; X
< Width
; X
++) {
1317 BltBuffer
[OffsetY2
+ X
] = ImageIn
->Bitmap
[OffsetY1
+ X
];
1323 // Draw the image to existing bitmap or screen depending on flag.
1325 if ((Flags
& EFI_HII_DIRECT_TO_SCREEN
) == EFI_HII_DIRECT_TO_SCREEN
) {
1326 Status
= gBS
->LocateProtocol (
1327 &gEfiConsoleControlProtocolGuid
,
1332 if (EFI_ERROR (Status
)) {
1336 Console
->SetMode (Console
, EfiConsoleControlScreenGraphics
);
1338 // Write the image directly to the output device specified by Screen.
1340 Status
= (*Blt
)->Image
.Screen
->Blt (
1341 (*Blt
)->Image
.Screen
,
1343 EfiBltBufferToVideo
,
1354 // Draw the image onto the existing bitmap specified by Bitmap.
1356 Status
= ImageToBlt (
1368 SafeFreePool (BltBuffer
);
1373 // Allocate a new bitmap to hold the incoming image.
1375 Width
= ImageIn
->Width
+ BltX
;
1376 Height
= ImageIn
->Height
+ BltY
;
1378 BufferLen
= Width
* Height
* sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL
);
1379 BltBuffer
= (EFI_GRAPHICS_OUTPUT_BLT_PIXEL
*) AllocateZeroPool (BufferLen
);
1380 if (BltBuffer
== NULL
) {
1381 return EFI_OUT_OF_RESOURCES
;
1384 ImageOut
= (EFI_IMAGE_OUTPUT
*) AllocateZeroPool (sizeof (EFI_IMAGE_OUTPUT
));
1385 if (ImageOut
== NULL
) {
1386 SafeFreePool (BltBuffer
);
1387 return EFI_OUT_OF_RESOURCES
;
1389 ImageOut
->Width
= (UINT16
) Width
;
1390 ImageOut
->Height
= (UINT16
) Height
;
1391 ImageOut
->Image
.Bitmap
= BltBuffer
;
1394 // BUGBUG: Now all the "blank" pixels are filled with system default background
1395 // color. Not sure if it need to be updated or not.
1397 Status
= GetSystemFont (Private
, &FontInfo
, NULL
);
1398 if (EFI_ERROR (Status
)) {
1399 SafeFreePool (BltBuffer
);
1400 SafeFreePool (ImageOut
);
1403 for (Index
= 0; Index
< Width
* Height
; Index
++) {
1404 BltBuffer
[Index
] = FontInfo
->BackgroundColor
;
1406 SafeFreePool (FontInfo
);
1409 // Draw the incoming image to the new created image.
1427 This function renders an image to a bitmap or the screen using the specified
1428 color and options. It draws the image on an existing bitmap, allocates a new
1429 bitmap or uses the screen. The images can be clipped.
1431 @param This A pointer to the EFI_HII_IMAGE_PROTOCOL instance.
1432 @param Flags Describes how the image is to be drawn.
1433 @param PackageList The package list in the HII database to search for
1434 the specified image.
1435 @param ImageId The image's id, which is unique within
1437 @param Blt If this points to a non-NULL on entry, this points
1438 to the image, which is Width pixels wide and
1439 Height pixels high. The image will be drawn onto
1441 EFI_HII_DRAW_FLAG_CLIP is implied. If this points
1442 to a NULL on entry, then a buffer will be
1443 allocated to hold the generated image and the
1444 pointer updated on exit. It is the caller's
1445 responsibility to free this buffer.
1446 @param BltY Specifies the offset from the left and top edge of
1447 the output image of the first pixel in the image.
1449 @retval EFI_SUCCESS The image was successfully drawn.
1450 @retval EFI_OUT_OF_RESOURCES Unable to allocate an output buffer for Blt.
1451 @retval EFI_INVALID_PARAMETER The Image was NULL.
1452 @retval EFI_NOT_FOUND The specified packagelist could not be found in
1459 IN CONST EFI_HII_IMAGE_PROTOCOL
*This
,
1460 IN EFI_HII_DRAW_FLAGS Flags
,
1461 IN EFI_HII_HANDLE PackageList
,
1462 IN EFI_IMAGE_ID ImageId
,
1463 IN OUT EFI_IMAGE_OUTPUT
**Blt
,
1469 EFI_IMAGE_INPUT ImageTemp
;
1470 EFI_IMAGE_INPUT
*Image
;
1474 // Check input parameter.
1476 if (This
== NULL
|| PackageList
== NULL
|| Blt
== NULL
|| PackageList
== NULL
) {
1477 return EFI_INVALID_PARAMETER
;
1480 if (!IsHiiHandleValid (PackageList
)) {
1481 return EFI_NOT_FOUND
;
1485 // Get the specified Image.
1488 Status
= HiiGetImage (This
, PackageList
, ImageId
, &ImageTemp
, &ImageSize
);
1489 if (Status
!= EFI_BUFFER_TOO_SMALL
) {
1493 Image
= (EFI_IMAGE_INPUT
*) AllocateZeroPool (ImageSize
);
1494 if (Image
== NULL
) {
1495 return EFI_OUT_OF_RESOURCES
;
1497 Status
= HiiGetImage (This
, PackageList
, ImageId
, Image
, &ImageSize
);
1498 ASSERT_EFI_ERROR (Status
);
1503 Status
= HiiDrawImage (This
, Flags
, Image
, Blt
, BltX
, BltY
);
1504 SafeFreePool (Image
);