2 Implementation for EFI_HII_FONT_PROTOCOL.
5 Copyright (c) 2007 - 2016, Intel Corporation. All rights reserved.<BR>
6 This program and the accompanying materials
7 are licensed and made available under the terms and conditions of the BSD License
8 which accompanies this distribution. The full text of the license may be found at
9 http://opensource.org/licenses/bsd-license.php
11 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
12 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
17 #include "HiiDatabase.h"
19 EFI_GRAPHICS_OUTPUT_BLT_PIXEL mHiiEfiColors
[16] = {
23 {0x00, 0x00, 0x00, 0x00}, // BLACK
24 {0x98, 0x00, 0x00, 0x00}, // BLUE
25 {0x00, 0x98, 0x00, 0x00}, // GREEN
26 {0x98, 0x98, 0x00, 0x00}, // CYAN
27 {0x00, 0x00, 0x98, 0x00}, // RED
28 {0x98, 0x00, 0x98, 0x00}, // MAGENTA
29 {0x00, 0x98, 0x98, 0x00}, // BROWN
30 {0x98, 0x98, 0x98, 0x00}, // LIGHTGRAY
31 {0x30, 0x30, 0x30, 0x00}, // DARKGRAY - BRIGHT BLACK
32 {0xff, 0x00, 0x00, 0x00}, // LIGHTBLUE
33 {0x00, 0xff, 0x00, 0x00}, // LIGHTGREEN
34 {0xff, 0xff, 0x00, 0x00}, // LIGHTCYAN
35 {0x00, 0x00, 0xff, 0x00}, // LIGHTRED
36 {0xff, 0x00, 0xff, 0x00}, // LIGHTMAGENTA
37 {0x00, 0xff, 0xff, 0x00}, // YELLOW
38 {0xff, 0xff, 0xff, 0x00}, // WHITE
43 Insert a character cell information to the list specified by GlyphInfoList.
45 This is a internal function.
47 @param CharValue Unicode character value, which identifies a glyph
49 @param GlyphInfoList HII_GLYPH_INFO list head.
50 @param Cell Incoming character cell information.
52 @retval EFI_SUCCESS Cell information is added to the GlyphInfoList.
53 @retval EFI_OUT_OF_RESOURCES The system is out of resources to accomplish the
60 IN LIST_ENTRY
*GlyphInfoList
,
61 IN EFI_HII_GLYPH_INFO
*Cell
64 HII_GLYPH_INFO
*GlyphInfo
;
66 ASSERT (Cell
!= NULL
&& GlyphInfoList
!= NULL
);
68 GlyphInfo
= (HII_GLYPH_INFO
*) AllocateZeroPool (sizeof (HII_GLYPH_INFO
));
69 if (GlyphInfo
== NULL
) {
70 return EFI_OUT_OF_RESOURCES
;
74 // GlyphInfoList stores a list of default character cell information, each is
75 // identified by "CharId".
77 GlyphInfo
->Signature
= HII_GLYPH_INFO_SIGNATURE
;
78 GlyphInfo
->CharId
= CharValue
;
79 if (Cell
->AdvanceX
== 0) {
80 Cell
->AdvanceX
= Cell
->Width
;
82 CopyMem (&GlyphInfo
->Cell
, Cell
, sizeof (EFI_HII_GLYPH_INFO
));
83 InsertTailList (GlyphInfoList
, &GlyphInfo
->Entry
);
90 Get a character cell information from the list specified by GlyphInfoList.
92 This is a internal function.
94 @param CharValue Unicode character value, which identifies a glyph
96 @param GlyphInfoList HII_GLYPH_INFO list head.
97 @param Cell Buffer which stores output character cell
100 @retval EFI_SUCCESS Cell information is added to the GlyphInfoList.
101 @retval EFI_NOT_FOUND The character info specified by CharValue does
108 IN LIST_ENTRY
*GlyphInfoList
,
109 OUT EFI_HII_GLYPH_INFO
*Cell
112 HII_GLYPH_INFO
*GlyphInfo
;
115 ASSERT (Cell
!= NULL
&& GlyphInfoList
!= NULL
);
118 // Since the EFI_HII_GIBT_DEFAULTS block won't increment CharValueCurrent,
119 // the value of "CharId" of a default character cell which is used for a
120 // EFI_HII_GIBT_GLYPH_DEFAULT or EFI_HII_GIBT_GLYPHS_DEFAULT should be
121 // less or equal to the value of "CharValueCurrent" of this default block.
123 // For instance, if the CharId of a GlyphInfoList is {1, 3, 7}, a default glyph
124 // with CharValue equals "7" uses the GlyphInfo with CharId = 7;
125 // a default glyph with CharValue equals "6" uses the GlyphInfo with CharId = 3.
127 for (Link
= GlyphInfoList
->BackLink
; Link
!= GlyphInfoList
; Link
= Link
->BackLink
) {
128 GlyphInfo
= CR (Link
, HII_GLYPH_INFO
, Entry
, HII_GLYPH_INFO_SIGNATURE
);
129 if (GlyphInfo
->CharId
<= CharValue
) {
130 CopyMem (Cell
, &GlyphInfo
->Cell
, sizeof (EFI_HII_GLYPH_INFO
));
135 return EFI_NOT_FOUND
;
140 Convert the glyph for a single character into a bitmap.
142 This is a internal function.
144 @param Private HII database driver private data.
145 @param Char Character to retrieve.
146 @param StringInfo Points to the string font and color information
147 or NULL if the string should use the default
148 system font and color.
149 @param GlyphBuffer Buffer to store the retrieved bitmap data.
150 @param Cell Points to EFI_HII_GLYPH_INFO structure.
151 @param Attributes If not NULL, output the glyph attributes if any.
153 @retval EFI_SUCCESS Glyph bitmap outputted.
154 @retval EFI_OUT_OF_RESOURCES Unable to allocate the output buffer GlyphBuffer.
155 @retval EFI_NOT_FOUND The glyph was unknown can not be found.
156 @retval EFI_INVALID_PARAMETER Any input parameter is invalid.
161 IN HII_DATABASE_PRIVATE_DATA
*Private
,
163 IN EFI_FONT_INFO
*StringInfo
,
164 OUT UINT8
**GlyphBuffer
,
165 OUT EFI_HII_GLYPH_INFO
*Cell
,
166 OUT UINT8
*Attributes OPTIONAL
169 HII_DATABASE_RECORD
*Node
;
171 HII_SIMPLE_FONT_PACKAGE_INSTANCE
*SimpleFont
;
174 EFI_NARROW_GLYPH Narrow
;
176 HII_GLOBAL_FONT_INFO
*GlobalFont
;
178 EFI_NARROW_GLYPH
*NarrowPtr
;
179 EFI_WIDE_GLYPH
*WidePtr
;
181 if (GlyphBuffer
== NULL
|| Cell
== NULL
) {
182 return EFI_INVALID_PARAMETER
;
184 if (Private
== NULL
|| Private
->Signature
!= HII_DATABASE_PRIVATE_DATA_SIGNATURE
) {
185 return EFI_INVALID_PARAMETER
;
188 ZeroMem (Cell
, sizeof (EFI_HII_GLYPH_INFO
));
191 // If StringInfo is not NULL, it must point to an existing EFI_FONT_INFO rather
192 // than system default font and color.
193 // If NULL, try to find the character in simplified font packages since
194 // default system font is the fixed font (narrow or wide glyph).
196 if (StringInfo
!= NULL
) {
197 if(!IsFontInfoExisted (Private
, StringInfo
, NULL
, NULL
, &GlobalFont
)) {
198 return EFI_INVALID_PARAMETER
;
200 if (Attributes
!= NULL
) {
201 *Attributes
= PROPORTIONAL_GLYPH
;
203 return FindGlyphBlock (GlobalFont
->FontPackage
, Char
, GlyphBuffer
, Cell
, NULL
);
205 HeaderSize
= sizeof (EFI_HII_SIMPLE_FONT_PACKAGE_HDR
);
207 for (Link
= Private
->DatabaseList
.ForwardLink
; Link
!= &Private
->DatabaseList
; Link
= Link
->ForwardLink
) {
208 Node
= CR (Link
, HII_DATABASE_RECORD
, DatabaseEntry
, HII_DATABASE_RECORD_SIGNATURE
);
209 for (Link1
= Node
->PackageList
->SimpleFontPkgHdr
.ForwardLink
;
210 Link1
!= &Node
->PackageList
->SimpleFontPkgHdr
;
211 Link1
= Link1
->ForwardLink
213 SimpleFont
= CR (Link1
, HII_SIMPLE_FONT_PACKAGE_INSTANCE
, SimpleFontEntry
, HII_S_FONT_PACKAGE_SIGNATURE
);
215 // Search the narrow glyph array
217 NarrowPtr
= (EFI_NARROW_GLYPH
*) ((UINT8
*) (SimpleFont
->SimpleFontPkgHdr
) + HeaderSize
);
218 for (Index
= 0; Index
< SimpleFont
->SimpleFontPkgHdr
->NumberOfNarrowGlyphs
; Index
++) {
219 CopyMem (&Narrow
, NarrowPtr
+ Index
,sizeof (EFI_NARROW_GLYPH
));
220 if (Narrow
.UnicodeWeight
== Char
) {
221 *GlyphBuffer
= (UINT8
*) AllocateZeroPool (EFI_GLYPH_HEIGHT
);
222 if (*GlyphBuffer
== NULL
) {
223 return EFI_OUT_OF_RESOURCES
;
225 Cell
->Width
= EFI_GLYPH_WIDTH
;
226 Cell
->Height
= EFI_GLYPH_HEIGHT
;
227 Cell
->AdvanceX
= Cell
->Width
;
228 CopyMem (*GlyphBuffer
, Narrow
.GlyphCol1
, Cell
->Height
);
229 if (Attributes
!= NULL
) {
230 *Attributes
= (UINT8
) (Narrow
.Attributes
| NARROW_GLYPH
);
236 // Search the wide glyph array
238 WidePtr
= (EFI_WIDE_GLYPH
*) (NarrowPtr
+ SimpleFont
->SimpleFontPkgHdr
->NumberOfNarrowGlyphs
);
239 for (Index
= 0; Index
< SimpleFont
->SimpleFontPkgHdr
->NumberOfWideGlyphs
; Index
++) {
240 CopyMem (&Wide
, WidePtr
+ Index
, sizeof (EFI_WIDE_GLYPH
));
241 if (Wide
.UnicodeWeight
== Char
) {
242 *GlyphBuffer
= (UINT8
*) AllocateZeroPool (EFI_GLYPH_HEIGHT
* 2);
243 if (*GlyphBuffer
== NULL
) {
244 return EFI_OUT_OF_RESOURCES
;
246 Cell
->Width
= EFI_GLYPH_WIDTH
* 2;
247 Cell
->Height
= EFI_GLYPH_HEIGHT
;
248 Cell
->AdvanceX
= Cell
->Width
;
249 CopyMem (*GlyphBuffer
, Wide
.GlyphCol1
, EFI_GLYPH_HEIGHT
);
250 CopyMem (*GlyphBuffer
+ EFI_GLYPH_HEIGHT
, Wide
.GlyphCol2
, EFI_GLYPH_HEIGHT
);
251 if (Attributes
!= NULL
) {
252 *Attributes
= (UINT8
) (Wide
.Attributes
| EFI_GLYPH_WIDE
);
261 return EFI_NOT_FOUND
;
265 Convert bitmap data of the glyph to blt structure.
267 This is a internal function.
269 @param GlyphBuffer Buffer points to bitmap data of glyph.
270 @param Foreground The color of the "on" pixels in the glyph in the
272 @param Background The color of the "off" pixels in the glyph in the
274 @param ImageWidth Width of the whole image in pixels.
275 @param RowWidth The width of the text on the line, in pixels.
276 @param RowHeight The height of the line, in pixels.
277 @param Transparent If TRUE, the Background color is ignored and all
278 "off" pixels in the character's drawn wil use the
279 pixel value from BltBuffer.
280 @param Origin On input, points to the origin of the to be
281 displayed character, on output, points to the
287 IN UINT8
*GlyphBuffer
,
288 IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL Foreground
,
289 IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL Background
,
290 IN UINT16 ImageWidth
,
293 IN BOOLEAN Transparent
,
294 IN OUT EFI_GRAPHICS_OUTPUT_BLT_PIXEL
**Origin
301 EFI_GRAPHICS_OUTPUT_BLT_PIXEL
*Buffer
;
303 ASSERT (GlyphBuffer
!= NULL
&& Origin
!= NULL
&& *Origin
!= NULL
);
305 Height
= EFI_GLYPH_HEIGHT
;
306 Width
= EFI_GLYPH_WIDTH
;
309 // Move position to the left-top corner of char.
311 Buffer
= *Origin
- EFI_GLYPH_HEIGHT
* ImageWidth
;
314 // Char may be partially displayed when CLIP_X or CLIP_Y is not set.
316 if (RowHeight
< Height
) {
317 Height
= (UINT8
) RowHeight
;
319 if (RowWidth
< Width
) {
320 Width
= (UINT8
) RowWidth
;
323 for (Ypos
= 0; Ypos
< Height
; Ypos
++) {
324 for (Xpos
= 0; Xpos
< Width
; Xpos
++) {
325 if ((GlyphBuffer
[Ypos
] & (1 << (EFI_GLYPH_WIDTH
- Xpos
- 1))) != 0) {
326 Buffer
[Ypos
* ImageWidth
+ Xpos
] = Foreground
;
329 Buffer
[Ypos
* ImageWidth
+ Xpos
] = Background
;
335 *Origin
= *Origin
+ EFI_GLYPH_WIDTH
;
340 Convert bitmap data of the glyph to blt structure.
342 This is a internal function.
344 @param GlyphBuffer Buffer points to bitmap data of glyph.
345 @param Foreground The color of the "on" pixels in the glyph in the
347 @param Background The color of the "off" pixels in the glyph in the
349 @param ImageWidth Width of the whole image in pixels.
350 @param BaseLine BaseLine in the line.
351 @param RowWidth The width of the text on the line, in pixels.
352 @param RowHeight The height of the line, in pixels.
353 @param Transparent If TRUE, the Background color is ignored and all
354 "off" pixels in the character's drawn wil use the
355 pixel value from BltBuffer.
356 @param Cell Points to EFI_HII_GLYPH_INFO structure.
357 @param Attributes The attribute of incoming glyph in GlyphBuffer.
358 @param Origin On input, points to the origin of the to be
359 displayed character, on output, points to the
366 IN UINT8
*GlyphBuffer
,
367 IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL Foreground
,
368 IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL Background
,
369 IN UINT16 ImageWidth
,
373 IN BOOLEAN Transparent
,
374 IN CONST EFI_HII_GLYPH_INFO
*Cell
,
376 IN OUT EFI_GRAPHICS_OUTPUT_BLT_PIXEL
**Origin
385 EFI_GRAPHICS_OUTPUT_BLT_PIXEL
*BltBuffer
;
387 ASSERT (Origin
!= NULL
&& *Origin
!= NULL
&& Cell
!= NULL
);
390 // Only adjust origin position if char has no bitmap.
392 if (GlyphBuffer
== NULL
) {
393 *Origin
= *Origin
+ Cell
->AdvanceX
;
397 // Move position to the left-top corner of char.
399 BltBuffer
= *Origin
+ Cell
->OffsetX
- (Cell
->OffsetY
+ Cell
->Height
) * ImageWidth
;
400 YposOffset
= (UINT16
) (BaseLine
- (Cell
->OffsetY
+ Cell
->Height
));
403 // Since non-spacing key will be printed OR'd with the previous glyph, don't
406 if ((Attributes
& EFI_GLYPH_NON_SPACING
) == EFI_GLYPH_NON_SPACING
) {
411 // The glyph's upper left hand corner pixel is the most significant bit of the
412 // first bitmap byte.
414 for (Ypos
= 0; Ypos
< Cell
->Height
&& ((UINTN
) (Ypos
+ YposOffset
) < RowHeight
); Ypos
++) {
415 OffsetY
= BITMAP_LEN_1_BIT (Cell
->Width
, Ypos
);
418 // All bits in these bytes are meaningful.
420 for (Xpos
= 0; Xpos
< Cell
->Width
/ 8; Xpos
++) {
421 Data
= *(GlyphBuffer
+ OffsetY
+ Xpos
);
422 for (Index
= 0; Index
< 8 && ((UINTN
) (Xpos
* 8 + Index
+ Cell
->OffsetX
) < RowWidth
); Index
++) {
423 if ((Data
& (1 << (8 - Index
- 1))) != 0) {
424 BltBuffer
[Ypos
* ImageWidth
+ Xpos
* 8 + Index
] = Foreground
;
427 BltBuffer
[Ypos
* ImageWidth
+ Xpos
* 8 + Index
] = Background
;
433 if (Cell
->Width
% 8 != 0) {
435 // There are some padding bits in this byte. Ignore them.
437 Data
= *(GlyphBuffer
+ OffsetY
+ Xpos
);
438 for (Index
= 0; Index
< Cell
->Width
% 8 && ((UINTN
) (Xpos
* 8 + Index
+ Cell
->OffsetX
) < RowWidth
); Index
++) {
439 if ((Data
& (1 << (8 - Index
- 1))) != 0) {
440 BltBuffer
[Ypos
* ImageWidth
+ Xpos
* 8 + Index
] = Foreground
;
443 BltBuffer
[Ypos
* ImageWidth
+ Xpos
* 8 + Index
] = Background
;
447 } // end of if (Width % 8...)
449 } // end of for (Ypos=0...)
451 *Origin
= *Origin
+ Cell
->AdvanceX
;
456 Convert bitmap data of the glyph to blt structure.
458 This is a internal function.
460 @param GlyphBuffer Buffer points to bitmap data of glyph.
461 @param Foreground The color of the "on" pixels in the glyph in the
463 @param Background The color of the "off" pixels in the glyph in the
465 @param ImageWidth Width of the whole image in pixels.
466 @param BaseLine BaseLine in the line.
467 @param RowWidth The width of the text on the line, in pixels.
468 @param RowHeight The height of the line, in pixels.
469 @param Transparent If TRUE, the Background color is ignored and all
470 "off" pixels in the character's drawn wil use the
471 pixel value from BltBuffer.
472 @param Cell Points to EFI_HII_GLYPH_INFO structure.
473 @param Attributes The attribute of incoming glyph in GlyphBuffer.
474 @param Origin On input, points to the origin of the to be
475 displayed character, on output, points to the
478 @return Points to the address of next origin node in BltBuffer.
483 IN UINT8
*GlyphBuffer
,
484 IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL Foreground
,
485 IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL Background
,
486 IN UINT16 ImageWidth
,
490 IN BOOLEAN Transparent
,
491 IN CONST EFI_HII_GLYPH_INFO
*Cell
,
493 IN OUT EFI_GRAPHICS_OUTPUT_BLT_PIXEL
**Origin
496 EFI_GRAPHICS_OUTPUT_BLT_PIXEL
*Buffer
;
498 ASSERT (Origin
!= NULL
&& *Origin
!= NULL
&& Cell
!= NULL
);
502 if ((Attributes
& EFI_GLYPH_NON_SPACING
) == EFI_GLYPH_NON_SPACING
) {
504 // This character is a non-spacing key, print it OR'd with the previous glyph.
505 // without advancing cursor.
507 Buffer
-= Cell
->AdvanceX
;
522 } else if ((Attributes
& EFI_GLYPH_WIDE
) == EFI_GLYPH_WIDE
) {
524 // This character is wide glyph, i.e. 16 pixels * 19 pixels.
525 // Draw it as two narrow glyphs.
539 GlyphBuffer
+ EFI_GLYPH_HEIGHT
,
549 } else if ((Attributes
& NARROW_GLYPH
) == NARROW_GLYPH
) {
551 // This character is narrow glyph, i.e. 8 pixels * 19 pixels.
564 } else if ((Attributes
& PROPORTIONAL_GLYPH
) == PROPORTIONAL_GLYPH
) {
566 // This character is proportional glyph, i.e. Cell->Width * Cell->Height pixels.
586 Write the output parameters of FindGlyphBlock().
588 This is a internal function.
590 @param BufferIn Buffer which stores the bitmap data of the found
592 @param BufferLen Length of BufferIn.
593 @param InputCell Buffer which stores cell information of the
595 @param GlyphBuffer Output the corresponding bitmap data of the found
596 block. It is the caller's responsiblity to free
598 @param Cell Output cell information of the encoded bitmap.
599 @param GlyphBufferLen If not NULL, output the length of GlyphBuffer.
601 @retval EFI_SUCCESS The operation is performed successfully.
602 @retval EFI_INVALID_PARAMETER Any input parameter is invalid.
603 @retval EFI_OUT_OF_RESOURCES The system is out of resources to accomplish the
611 IN EFI_HII_GLYPH_INFO
*InputCell
,
612 OUT UINT8
**GlyphBuffer
, OPTIONAL
613 OUT EFI_HII_GLYPH_INFO
*Cell
, OPTIONAL
614 OUT UINTN
*GlyphBufferLen OPTIONAL
617 if (BufferIn
== NULL
|| InputCell
== NULL
) {
618 return EFI_INVALID_PARAMETER
;
622 CopyMem (Cell
, InputCell
, sizeof (EFI_HII_GLYPH_INFO
));
625 if (GlyphBuffer
!= NULL
&& BufferLen
> 0) {
626 *GlyphBuffer
= (UINT8
*) AllocateZeroPool (BufferLen
);
627 if (*GlyphBuffer
== NULL
) {
628 return EFI_OUT_OF_RESOURCES
;
630 CopyMem (*GlyphBuffer
, BufferIn
, BufferLen
);
633 if (GlyphBufferLen
!= NULL
) {
634 *GlyphBufferLen
= BufferLen
;
642 Parse all glyph blocks to find a glyph block specified by CharValue.
643 If CharValue = (CHAR16) (-1), collect all default character cell information
644 within this font package and backup its information.
646 @param FontPackage Hii string package instance.
647 @param CharValue Unicode character value, which identifies a glyph
649 @param GlyphBuffer Output the corresponding bitmap data of the found
650 block. It is the caller's responsiblity to free
652 @param Cell Output cell information of the encoded bitmap.
653 @param GlyphBufferLen If not NULL, output the length of GlyphBuffer.
655 @retval EFI_SUCCESS The bitmap data is retrieved successfully.
656 @retval EFI_NOT_FOUND The specified CharValue does not exist in current
658 @retval EFI_OUT_OF_RESOURCES The system is out of resources to accomplish the
664 IN HII_FONT_PACKAGE_INSTANCE
*FontPackage
,
666 OUT UINT8
**GlyphBuffer
, OPTIONAL
667 OUT EFI_HII_GLYPH_INFO
*Cell
, OPTIONAL
668 OUT UINTN
*GlyphBufferLen OPTIONAL
676 EFI_HII_GIBT_GLYPHS_BLOCK Glyphs
;
679 EFI_HII_GLYPH_INFO DefaultCell
;
680 EFI_HII_GLYPH_INFO LocalCell
;
684 ASSERT (FontPackage
!= NULL
);
685 ASSERT (FontPackage
->Signature
== HII_FONT_PACKAGE_SIGNATURE
);
689 if (CharValue
== (CHAR16
) (-1)) {
691 // Collect the cell information specified in font package fixed header.
692 // Use CharValue =0 to represent this particular cell.
696 &FontPackage
->GlyphInfoList
,
697 (EFI_HII_GLYPH_INFO
*) ((UINT8
*) FontPackage
->FontPkgHdr
+ 3 * sizeof (UINT32
))
699 if (EFI_ERROR (Status
)) {
704 (UINT8
*) FontPackage
->FontPkgHdr
+ 3 * sizeof (UINT32
),
705 sizeof (EFI_HII_GLYPH_INFO
)
707 BaseLine
= (UINT16
) (LocalCell
.Height
+ LocalCell
.OffsetY
);
708 if (MinOffsetY
> LocalCell
.OffsetY
) {
709 MinOffsetY
= LocalCell
.OffsetY
;
713 BlockPtr
= FontPackage
->GlyphBlock
;
717 while (*BlockPtr
!= EFI_HII_GIBT_END
) {
719 case EFI_HII_GIBT_DEFAULTS
:
721 // Collect all default character cell information specified by
722 // EFI_HII_GIBT_DEFAULTS.
724 if (CharValue
== (CHAR16
) (-1)) {
727 &FontPackage
->GlyphInfoList
,
728 (EFI_HII_GLYPH_INFO
*) (BlockPtr
+ sizeof (EFI_HII_GLYPH_BLOCK
))
730 if (EFI_ERROR (Status
)) {
735 BlockPtr
+ sizeof (EFI_HII_GLYPH_BLOCK
),
736 sizeof (EFI_HII_GLYPH_INFO
)
738 if (BaseLine
< LocalCell
.Height
+ LocalCell
.OffsetY
) {
739 BaseLine
= (UINT16
) (LocalCell
.Height
+ LocalCell
.OffsetY
);
741 if (MinOffsetY
> LocalCell
.OffsetY
) {
742 MinOffsetY
= LocalCell
.OffsetY
;
745 BlockPtr
+= sizeof (EFI_HII_GIBT_DEFAULTS_BLOCK
);
748 case EFI_HII_GIBT_DUPLICATE
:
749 if (CharCurrent
== CharValue
) {
750 CopyMem (&CharValue
, BlockPtr
+ sizeof (EFI_HII_GLYPH_BLOCK
), sizeof (CHAR16
));
752 BlockPtr
= FontPackage
->GlyphBlock
;
756 BlockPtr
+= sizeof (EFI_HII_GIBT_DUPLICATE_BLOCK
);
759 case EFI_HII_GIBT_EXT1
:
760 BlockPtr
+= *(UINT8
*)((UINTN
)BlockPtr
+ sizeof (EFI_HII_GLYPH_BLOCK
) + sizeof (UINT8
));
762 case EFI_HII_GIBT_EXT2
:
765 (UINT8
*)((UINTN
)BlockPtr
+ sizeof (EFI_HII_GLYPH_BLOCK
) + sizeof (UINT8
)),
768 BlockPtr
+= Length16
;
770 case EFI_HII_GIBT_EXT4
:
773 (UINT8
*)((UINTN
)BlockPtr
+ sizeof (EFI_HII_GLYPH_BLOCK
) + sizeof (UINT8
)),
776 BlockPtr
+= Length32
;
779 case EFI_HII_GIBT_GLYPH
:
782 BlockPtr
+ sizeof (EFI_HII_GLYPH_BLOCK
),
783 sizeof (EFI_HII_GLYPH_INFO
)
785 if (CharValue
== (CHAR16
) (-1)) {
786 if (BaseLine
< LocalCell
.Height
+ LocalCell
.OffsetY
) {
787 BaseLine
= (UINT16
) (LocalCell
.Height
+ LocalCell
.OffsetY
);
789 if (MinOffsetY
> LocalCell
.OffsetY
) {
790 MinOffsetY
= LocalCell
.OffsetY
;
793 BufferLen
= BITMAP_LEN_1_BIT (LocalCell
.Width
, LocalCell
.Height
);
794 if (CharCurrent
== CharValue
) {
795 return WriteOutputParam (
796 (UINT8
*)((UINTN
)BlockPtr
+ sizeof (EFI_HII_GIBT_GLYPH_BLOCK
) - sizeof (UINT8
)),
805 BlockPtr
+= sizeof (EFI_HII_GIBT_GLYPH_BLOCK
) - sizeof (UINT8
) + BufferLen
;
808 case EFI_HII_GIBT_GLYPHS
:
809 BlockPtr
+= sizeof (EFI_HII_GLYPH_BLOCK
);
810 CopyMem (&Glyphs
.Cell
, BlockPtr
, sizeof (EFI_HII_GLYPH_INFO
));
811 BlockPtr
+= sizeof (EFI_HII_GLYPH_INFO
);
812 CopyMem (&Glyphs
.Count
, BlockPtr
, sizeof (UINT16
));
813 BlockPtr
+= sizeof (UINT16
);
815 if (CharValue
== (CHAR16
) (-1)) {
816 if (BaseLine
< Glyphs
.Cell
.Height
+ Glyphs
.Cell
.OffsetY
) {
817 BaseLine
= (UINT16
) (Glyphs
.Cell
.Height
+ Glyphs
.Cell
.OffsetY
);
819 if (MinOffsetY
> Glyphs
.Cell
.OffsetY
) {
820 MinOffsetY
= Glyphs
.Cell
.OffsetY
;
824 BufferLen
= BITMAP_LEN_1_BIT (Glyphs
.Cell
.Width
, Glyphs
.Cell
.Height
);
825 for (Index
= 0; Index
< Glyphs
.Count
; Index
++) {
826 if (CharCurrent
+ Index
== CharValue
) {
827 return WriteOutputParam (
836 BlockPtr
+= BufferLen
;
838 CharCurrent
= (UINT16
) (CharCurrent
+ Glyphs
.Count
);
841 case EFI_HII_GIBT_GLYPH_DEFAULT
:
842 Status
= GetCell (CharCurrent
, &FontPackage
->GlyphInfoList
, &DefaultCell
);
843 if (EFI_ERROR (Status
)) {
846 BufferLen
= BITMAP_LEN_1_BIT (DefaultCell
.Width
, DefaultCell
.Height
);
848 if (CharCurrent
== CharValue
) {
849 return WriteOutputParam (
850 BlockPtr
+ sizeof (EFI_HII_GLYPH_BLOCK
),
859 BlockPtr
+= sizeof (EFI_HII_GLYPH_BLOCK
) + BufferLen
;
862 case EFI_HII_GIBT_GLYPHS_DEFAULT
:
863 CopyMem (&Length16
, BlockPtr
+ sizeof (EFI_HII_GLYPH_BLOCK
), sizeof (UINT16
));
864 Status
= GetCell (CharCurrent
, &FontPackage
->GlyphInfoList
, &DefaultCell
);
865 if (EFI_ERROR (Status
)) {
868 BufferLen
= BITMAP_LEN_1_BIT (DefaultCell
.Width
, DefaultCell
.Height
);
869 BlockPtr
+= sizeof (EFI_HII_GIBT_GLYPHS_DEFAULT_BLOCK
) - sizeof (UINT8
);
870 for (Index
= 0; Index
< Length16
; Index
++) {
871 if (CharCurrent
+ Index
== CharValue
) {
872 return WriteOutputParam (
881 BlockPtr
+= BufferLen
;
883 CharCurrent
= (UINT16
) (CharCurrent
+ Length16
);
886 case EFI_HII_GIBT_SKIP1
:
887 CharCurrent
= (UINT16
) (CharCurrent
+ (UINT16
) (*(BlockPtr
+ sizeof (EFI_HII_GLYPH_BLOCK
))));
888 BlockPtr
+= sizeof (EFI_HII_GIBT_SKIP1_BLOCK
);
890 case EFI_HII_GIBT_SKIP2
:
891 CopyMem (&Length16
, BlockPtr
+ sizeof (EFI_HII_GLYPH_BLOCK
), sizeof (UINT16
));
892 CharCurrent
= (UINT16
) (CharCurrent
+ Length16
);
893 BlockPtr
+= sizeof (EFI_HII_GIBT_SKIP2_BLOCK
);
900 if (CharValue
< CharCurrent
) {
901 return EFI_NOT_FOUND
;
905 if (CharValue
== (CHAR16
) (-1)) {
906 FontPackage
->BaseLine
= BaseLine
;
907 FontPackage
->Height
= (UINT16
) (BaseLine
- MinOffsetY
);
911 return EFI_NOT_FOUND
;
916 Copy a Font Name to a new created EFI_FONT_INFO structure.
918 This is a internal function.
920 @param FontName NULL-terminated string.
921 @param FontInfo a new EFI_FONT_INFO which stores the FontName.
922 It's caller's responsibility to free this buffer.
924 @retval EFI_SUCCESS FontInfo is allocated and copied with FontName.
925 @retval EFI_OUT_OF_RESOURCES The system is out of resources to accomplish the
931 IN EFI_STRING FontName
,
932 OUT EFI_FONT_INFO
**FontInfo
938 ASSERT (FontName
!= NULL
&& FontInfo
!= NULL
);
940 NameSize
= StrSize (FontName
);
941 FontInfoLen
= sizeof (EFI_FONT_INFO
) - sizeof (CHAR16
) + NameSize
;
942 *FontInfo
= (EFI_FONT_INFO
*) AllocateZeroPool (FontInfoLen
);
943 if (*FontInfo
== NULL
) {
944 return EFI_OUT_OF_RESOURCES
;
947 StrCpyS ((*FontInfo
)->FontName
, NameSize
/ sizeof (CHAR16
), FontName
);
953 Retrieve system default font and color.
955 @param Private HII database driver private data.
956 @param FontInfo Points to system default font output-related
957 information. It's caller's responsibility to free
959 @param FontInfoSize If not NULL, output the size of buffer FontInfo.
961 @retval EFI_SUCCESS Cell information is added to the GlyphInfoList.
962 @retval EFI_OUT_OF_RESOURCES The system is out of resources to accomplish the
964 @retval EFI_INVALID_PARAMETER Any input parameter is invalid.
969 IN HII_DATABASE_PRIVATE_DATA
*Private
,
970 OUT EFI_FONT_DISPLAY_INFO
**FontInfo
,
971 OUT UINTN
*FontInfoSize OPTIONAL
974 EFI_FONT_DISPLAY_INFO
*Info
;
978 if (Private
== NULL
|| Private
->Signature
!= HII_DATABASE_PRIVATE_DATA_SIGNATURE
) {
979 return EFI_INVALID_PARAMETER
;
981 if (FontInfo
== NULL
) {
982 return EFI_INVALID_PARAMETER
;
986 // The standard font always has the name "sysdefault".
988 NameSize
= StrSize (L
"sysdefault");
989 InfoSize
= sizeof (EFI_FONT_DISPLAY_INFO
) - sizeof (CHAR16
) + NameSize
;
990 Info
= (EFI_FONT_DISPLAY_INFO
*) AllocateZeroPool (InfoSize
);
992 return EFI_OUT_OF_RESOURCES
;
995 Info
->ForegroundColor
= mHiiEfiColors
[Private
->Attribute
& 0x0f];
996 Info
->BackgroundColor
= mHiiEfiColors
[Private
->Attribute
>> 4];
997 Info
->FontInfoMask
= EFI_FONT_INFO_SYS_FONT
| EFI_FONT_INFO_SYS_SIZE
| EFI_FONT_INFO_SYS_STYLE
;
998 Info
->FontInfo
.FontStyle
= 0;
999 Info
->FontInfo
.FontSize
= EFI_GLYPH_HEIGHT
;
1000 StrCpyS (Info
->FontInfo
.FontName
, NameSize
/ sizeof (CHAR16
), L
"sysdefault");
1003 if (FontInfoSize
!= NULL
) {
1004 *FontInfoSize
= InfoSize
;
1011 Check whether EFI_FONT_DISPLAY_INFO points to system default font and color or
1012 returns the system default according to the optional inputs.
1014 This is a internal function.
1016 @param Private HII database driver private data.
1017 @param StringInfo Points to the string output information,
1018 including the color and font.
1019 @param SystemInfo If not NULL, points to system default font and color.
1021 @param SystemInfoLen If not NULL, output the length of default system
1024 @retval TRUE Yes, it points to system default.
1030 IN HII_DATABASE_PRIVATE_DATA
*Private
,
1031 IN EFI_FONT_DISPLAY_INFO
*StringInfo
,
1032 OUT EFI_FONT_DISPLAY_INFO
**SystemInfo
, OPTIONAL
1033 OUT UINTN
*SystemInfoLen OPTIONAL
1037 EFI_FONT_DISPLAY_INFO
*SystemDefault
;
1041 ASSERT (Private
!= NULL
&& Private
->Signature
== HII_DATABASE_PRIVATE_DATA_SIGNATURE
);
1043 if (StringInfo
== NULL
&& SystemInfo
== NULL
) {
1047 SystemDefault
= NULL
;
1050 Status
= GetSystemFont (Private
, &SystemDefault
, &DefaultLen
);
1051 ASSERT_EFI_ERROR (Status
);
1052 ASSERT ((SystemDefault
!= NULL
) && (DefaultLen
!= 0));
1055 // Record the system default info.
1057 if (SystemInfo
!= NULL
) {
1058 *SystemInfo
= SystemDefault
;
1061 if (SystemInfoLen
!= NULL
) {
1062 *SystemInfoLen
= DefaultLen
;
1065 if (StringInfo
== NULL
) {
1071 // Check the FontInfoMask to see whether it is retrieving system info.
1073 if ((StringInfo
->FontInfoMask
& (EFI_FONT_INFO_SYS_FONT
| EFI_FONT_INFO_ANY_FONT
)) == 0) {
1074 if (StrCmp (StringInfo
->FontInfo
.FontName
, SystemDefault
->FontInfo
.FontName
) != 0) {
1078 if ((StringInfo
->FontInfoMask
& (EFI_FONT_INFO_SYS_SIZE
| EFI_FONT_INFO_ANY_SIZE
)) == 0) {
1079 if (StringInfo
->FontInfo
.FontSize
!= SystemDefault
->FontInfo
.FontSize
) {
1083 if ((StringInfo
->FontInfoMask
& (EFI_FONT_INFO_SYS_STYLE
| EFI_FONT_INFO_ANY_STYLE
)) == 0) {
1084 if (StringInfo
->FontInfo
.FontStyle
!= SystemDefault
->FontInfo
.FontStyle
) {
1088 if ((StringInfo
->FontInfoMask
& EFI_FONT_INFO_SYS_FORE_COLOR
) == 0) {
1090 &StringInfo
->ForegroundColor
,
1091 &SystemDefault
->ForegroundColor
,
1092 sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL
)
1097 if ((StringInfo
->FontInfoMask
& EFI_FONT_INFO_SYS_BACK_COLOR
) == 0) {
1099 &StringInfo
->BackgroundColor
,
1100 &SystemDefault
->BackgroundColor
,
1101 sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL
)
1110 if (SystemInfo
== NULL
) {
1111 if (SystemDefault
!= NULL
) {
1112 FreePool (SystemDefault
);
1120 This function checks whether EFI_FONT_INFO exists in current database. If
1121 FontInfoMask is specified, check what options can be used to make a match.
1122 Note that the masks relate to where the system default should be supplied
1123 are ignored by this function.
1125 @param Private Hii database private structure.
1126 @param FontInfo Points to EFI_FONT_INFO structure.
1127 @param FontInfoMask If not NULL, describes what options can be used
1128 to make a match between the font requested and
1129 the font available. The caller must guarantee
1131 @param FontHandle On entry, Points to the font handle returned by a
1132 previous call to GetFontInfo() or NULL to start
1133 with the first font.
1134 @param GlobalFontInfo If not NULL, output the corresponding globa font
1137 @retval TRUE Existed
1138 @retval FALSE Not existed
1143 IN HII_DATABASE_PRIVATE_DATA
*Private
,
1144 IN EFI_FONT_INFO
*FontInfo
,
1145 IN EFI_FONT_INFO_MASK
*FontInfoMask
, OPTIONAL
1146 IN EFI_FONT_HANDLE FontHandle
, OPTIONAL
1147 OUT HII_GLOBAL_FONT_INFO
**GlobalFontInfo OPTIONAL
1150 HII_GLOBAL_FONT_INFO
*GlobalFont
;
1151 HII_GLOBAL_FONT_INFO
*GlobalFontBackup1
;
1152 HII_GLOBAL_FONT_INFO
*GlobalFontBackup2
;
1154 EFI_FONT_INFO_MASK Mask
;
1156 BOOLEAN VagueMatched1
;
1157 BOOLEAN VagueMatched2
;
1159 ASSERT (Private
!= NULL
&& Private
->Signature
== HII_DATABASE_PRIVATE_DATA_SIGNATURE
);
1160 ASSERT (FontInfo
!= NULL
);
1163 // Matched flag represents an exactly match; VagueMatched1 repensents a RESIZE
1164 // or RESTYLE match; VagueMatched2 represents a RESIZE | RESTYLE match.
1167 VagueMatched1
= FALSE
;
1168 VagueMatched2
= FALSE
;
1171 GlobalFontBackup1
= NULL
;
1172 GlobalFontBackup2
= NULL
;
1174 // The process of where the system default should be supplied instead of
1175 // the specified font info beyonds this function's scope.
1177 if (FontInfoMask
!= NULL
) {
1178 Mask
= *FontInfoMask
& (~SYS_FONT_INFO_MASK
);
1182 // If not NULL, FontHandle points to the next node of the last searched font
1183 // node by previous call.
1185 if (FontHandle
== NULL
) {
1186 Link
= Private
->FontInfoList
.ForwardLink
;
1188 Link
= (LIST_ENTRY
*) FontHandle
;
1191 for (; Link
!= &Private
->FontInfoList
; Link
= Link
->ForwardLink
) {
1192 GlobalFont
= CR (Link
, HII_GLOBAL_FONT_INFO
, Entry
, HII_GLOBAL_FONT_INFO_SIGNATURE
);
1193 if (FontInfoMask
== NULL
) {
1194 if (CompareMem (GlobalFont
->FontInfo
, FontInfo
, GlobalFont
->FontInfoSize
) == 0) {
1195 if (GlobalFontInfo
!= NULL
) {
1196 *GlobalFontInfo
= GlobalFont
;
1202 // Check which options could be used to make a match.
1205 case EFI_FONT_INFO_ANY_FONT
:
1206 if (GlobalFont
->FontInfo
->FontStyle
== FontInfo
->FontStyle
&&
1207 GlobalFont
->FontInfo
->FontSize
== FontInfo
->FontSize
) {
1211 case EFI_FONT_INFO_ANY_FONT
| EFI_FONT_INFO_ANY_STYLE
:
1212 if (GlobalFont
->FontInfo
->FontSize
== FontInfo
->FontSize
) {
1216 case EFI_FONT_INFO_ANY_FONT
| EFI_FONT_INFO_ANY_SIZE
:
1217 if (GlobalFont
->FontInfo
->FontStyle
== FontInfo
->FontStyle
) {
1221 case EFI_FONT_INFO_ANY_FONT
| EFI_FONT_INFO_ANY_SIZE
| EFI_FONT_INFO_ANY_STYLE
:
1225 // If EFI_FONT_INFO_RESTYLE is specified, then the system may attempt to
1226 // remove some of the specified styles to meet the style requested.
1228 case EFI_FONT_INFO_ANY_FONT
| EFI_FONT_INFO_RESTYLE
:
1229 if (GlobalFont
->FontInfo
->FontSize
== FontInfo
->FontSize
) {
1230 if (GlobalFont
->FontInfo
->FontStyle
== FontInfo
->FontStyle
) {
1232 } else if ((GlobalFont
->FontInfo
->FontStyle
& FontInfo
->FontStyle
) == FontInfo
->FontStyle
) {
1233 VagueMatched1
= TRUE
;
1234 GlobalFontBackup1
= GlobalFont
;
1239 // If EFI_FONT_INFO_RESIZE is specified, then the sytem may attempt to
1240 // stretch or shrink a font to meet the size requested.
1242 case EFI_FONT_INFO_ANY_FONT
| EFI_FONT_INFO_RESIZE
:
1243 if (GlobalFont
->FontInfo
->FontStyle
== FontInfo
->FontStyle
) {
1244 if (GlobalFont
->FontInfo
->FontSize
== FontInfo
->FontSize
) {
1247 VagueMatched1
= TRUE
;
1248 GlobalFontBackup1
= GlobalFont
;
1252 case EFI_FONT_INFO_ANY_FONT
| EFI_FONT_INFO_RESTYLE
| EFI_FONT_INFO_RESIZE
:
1253 if (GlobalFont
->FontInfo
->FontStyle
== FontInfo
->FontStyle
) {
1254 if (GlobalFont
->FontInfo
->FontSize
== FontInfo
->FontSize
) {
1257 VagueMatched1
= TRUE
;
1258 GlobalFontBackup1
= GlobalFont
;
1260 } else if ((GlobalFont
->FontInfo
->FontStyle
& FontInfo
->FontStyle
) == FontInfo
->FontStyle
) {
1261 if (GlobalFont
->FontInfo
->FontSize
== FontInfo
->FontSize
) {
1262 VagueMatched1
= TRUE
;
1263 GlobalFontBackup1
= GlobalFont
;
1265 VagueMatched2
= TRUE
;
1266 GlobalFontBackup2
= GlobalFont
;
1270 case EFI_FONT_INFO_ANY_FONT
| EFI_FONT_INFO_ANY_STYLE
| EFI_FONT_INFO_RESIZE
:
1271 if (GlobalFont
->FontInfo
->FontSize
== FontInfo
->FontSize
) {
1274 VagueMatched1
= TRUE
;
1275 GlobalFontBackup1
= GlobalFont
;
1278 case EFI_FONT_INFO_ANY_FONT
| EFI_FONT_INFO_ANY_SIZE
| EFI_FONT_INFO_RESTYLE
:
1279 if (GlobalFont
->FontInfo
->FontStyle
== FontInfo
->FontStyle
) {
1281 } else if ((GlobalFont
->FontInfo
->FontStyle
& FontInfo
->FontStyle
) == FontInfo
->FontStyle
) {
1282 VagueMatched1
= TRUE
;
1283 GlobalFontBackup1
= GlobalFont
;
1286 case EFI_FONT_INFO_ANY_STYLE
:
1288 GlobalFont
->FontInfo
->FontName
,
1290 StrSize (FontInfo
->FontName
)
1292 GlobalFont
->FontInfo
->FontSize
== FontInfo
->FontSize
) {
1296 case EFI_FONT_INFO_ANY_STYLE
| EFI_FONT_INFO_ANY_SIZE
:
1298 GlobalFont
->FontInfo
->FontName
,
1300 StrSize (FontInfo
->FontName
)
1305 case EFI_FONT_INFO_ANY_STYLE
| EFI_FONT_INFO_RESIZE
:
1307 GlobalFont
->FontInfo
->FontName
,
1309 StrSize (FontInfo
->FontName
)
1311 if (GlobalFont
->FontInfo
->FontSize
== FontInfo
->FontSize
) {
1314 VagueMatched1
= TRUE
;
1315 GlobalFontBackup1
= GlobalFont
;
1319 case EFI_FONT_INFO_ANY_SIZE
:
1321 GlobalFont
->FontInfo
->FontName
,
1323 StrSize (FontInfo
->FontName
)
1325 GlobalFont
->FontInfo
->FontStyle
== FontInfo
->FontStyle
) {
1329 case EFI_FONT_INFO_ANY_SIZE
| EFI_FONT_INFO_RESTYLE
:
1331 GlobalFont
->FontInfo
->FontName
,
1333 StrSize (FontInfo
->FontName
)
1335 if (GlobalFont
->FontInfo
->FontStyle
== FontInfo
->FontStyle
) {
1337 } else if ((GlobalFont
->FontInfo
->FontStyle
& FontInfo
->FontStyle
) == FontInfo
->FontStyle
) {
1338 VagueMatched1
= TRUE
;
1339 GlobalFontBackup1
= GlobalFont
;
1343 case EFI_FONT_INFO_RESTYLE
:
1345 GlobalFont
->FontInfo
->FontName
,
1347 StrSize (FontInfo
->FontName
)
1349 GlobalFont
->FontInfo
->FontSize
== FontInfo
->FontSize
) {
1351 if (GlobalFont
->FontInfo
->FontStyle
== FontInfo
->FontStyle
) {
1353 } else if ((GlobalFont
->FontInfo
->FontStyle
& FontInfo
->FontStyle
) == FontInfo
->FontStyle
) {
1354 VagueMatched1
= TRUE
;
1355 GlobalFontBackup1
= GlobalFont
;
1359 case EFI_FONT_INFO_RESIZE
:
1361 GlobalFont
->FontInfo
->FontName
,
1363 StrSize (FontInfo
->FontName
)
1365 GlobalFont
->FontInfo
->FontStyle
== FontInfo
->FontStyle
) {
1367 if (GlobalFont
->FontInfo
->FontSize
== FontInfo
->FontSize
) {
1370 VagueMatched1
= TRUE
;
1371 GlobalFontBackup1
= GlobalFont
;
1375 case EFI_FONT_INFO_RESIZE
| EFI_FONT_INFO_RESTYLE
:
1377 GlobalFont
->FontInfo
->FontName
,
1379 StrSize (FontInfo
->FontName
)
1381 if (GlobalFont
->FontInfo
->FontStyle
== FontInfo
->FontStyle
) {
1382 if (GlobalFont
->FontInfo
->FontSize
== FontInfo
->FontSize
) {
1385 VagueMatched1
= TRUE
;
1386 GlobalFontBackup1
= GlobalFont
;
1388 } else if ((GlobalFont
->FontInfo
->FontStyle
& FontInfo
->FontStyle
) == FontInfo
->FontStyle
) {
1389 if (GlobalFont
->FontInfo
->FontSize
== FontInfo
->FontSize
) {
1390 VagueMatched1
= TRUE
;
1391 GlobalFontBackup1
= GlobalFont
;
1393 VagueMatched2
= TRUE
;
1394 GlobalFontBackup2
= GlobalFont
;
1404 if (GlobalFontInfo
!= NULL
) {
1405 *GlobalFontInfo
= GlobalFont
;
1412 if (VagueMatched1
) {
1413 if (GlobalFontInfo
!= NULL
) {
1414 *GlobalFontInfo
= GlobalFontBackup1
;
1417 } else if (VagueMatched2
) {
1418 if (GlobalFontInfo
!= NULL
) {
1419 *GlobalFontInfo
= GlobalFontBackup2
;
1429 Check whether the unicode represents a line break or not.
1431 This is a internal function. Please see Section 27.2.6 of the UEFI Specification
1432 for a description of the supported string format.
1434 @param Char Unicode character
1436 @retval 0 Yes, it forces a line break.
1437 @retval 1 Yes, it presents a line break opportunity
1438 @retval 2 Yes, it requires a line break happen before and after it.
1439 @retval -1 No, it is not a link break.
1449 // Mandatory line break characters, which force a line-break
1458 // Space characters, which is taken as a line-break opportunity
1474 // In-Word Break Opportunities
1479 // A space which is not a line-break opportunity
1484 // A hyphen which is not a line-break opportunity
1489 // Hyphen characters which describe line break opportunities after the character
1500 // A hyphen which describes line break opportunities before and after them, but not between a pair of them
1510 Renders a string to a bitmap or to the display.
1512 @param This A pointer to the EFI_HII_FONT_PROTOCOL instance.
1513 @param Flags Describes how the string is to be drawn.
1514 @param String Points to the null-terminated string to be
1516 @param StringInfo Points to the string output information,
1517 including the color and font. If NULL, then the
1518 string will be output in the default system font
1520 @param Blt If this points to a non-NULL on entry, this
1521 points to the image, which is Width pixels wide
1522 and Height pixels high. The string will be drawn
1524 EFI_HII_OUT_FLAG_CLIP is implied. If this points
1525 to a NULL on entry, then a buffer
1526 will be allocated to hold the generated image and
1527 the pointer updated on exit. It is the caller's
1528 responsibility to free this buffer.
1529 @param BltX Specifies the offset from the left and top edge
1530 of the image of the first character cell in the
1532 @param BltY Specifies the offset from the left and top edge
1533 of the image of the first character cell in the
1535 @param RowInfoArray If this is non-NULL on entry, then on exit, this
1536 will point to an allocated buffer containing
1537 row information and RowInfoArraySize will be
1538 updated to contain the number of elements.
1539 This array describes the characters which were at
1540 least partially drawn and the heights of the
1541 rows. It is the caller's responsibility to free
1543 @param RowInfoArraySize If this is non-NULL on entry, then on exit it
1544 contains the number of elements in RowInfoArray.
1545 @param ColumnInfoArray If this is non-NULL, then on return it will be
1546 filled with the horizontal offset for each
1547 character in the string on the row where it is
1548 displayed. Non-printing characters will have
1549 the offset ~0. The caller is responsible to
1550 allocate a buffer large enough so that there
1551 is one entry for each character in the string,
1552 not including the null-terminator. It is possible
1553 when character display is normalized that some
1554 character cells overlap.
1556 @retval EFI_SUCCESS The string was successfully rendered.
1557 @retval EFI_OUT_OF_RESOURCES Unable to allocate an output buffer for
1558 RowInfoArray or Blt.
1559 @retval EFI_INVALID_PARAMETER The String or Blt was NULL.
1560 @retval EFI_INVALID_PARAMETER Flags were invalid combination..
1566 IN CONST EFI_HII_FONT_PROTOCOL
*This
,
1567 IN EFI_HII_OUT_FLAGS Flags
,
1568 IN CONST EFI_STRING String
,
1569 IN CONST EFI_FONT_DISPLAY_INFO
*StringInfo OPTIONAL
,
1570 IN OUT EFI_IMAGE_OUTPUT
**Blt
,
1573 OUT EFI_HII_ROW_INFO
**RowInfoArray OPTIONAL
,
1574 OUT UINTN
*RowInfoArraySize OPTIONAL
,
1575 OUT UINTN
*ColumnInfoArray OPTIONAL
1579 HII_DATABASE_PRIVATE_DATA
*Private
;
1581 EFI_HII_GLYPH_INFO
*Cell
;
1583 EFI_IMAGE_OUTPUT
*Image
;
1584 EFI_STRING StringPtr
;
1585 EFI_STRING StringTmp
;
1586 EFI_HII_ROW_INFO
*RowInfo
;
1590 UINTN LastLineHeight
;
1591 UINTN BaseLineOffset
;
1597 EFI_FONT_DISPLAY_INFO
*StringInfoOut
;
1598 EFI_FONT_DISPLAY_INFO
*SystemDefault
;
1599 EFI_FONT_HANDLE FontHandle
;
1600 EFI_STRING StringIn
;
1601 EFI_STRING StringIn2
;
1604 EFI_FONT_INFO
*FontInfo
;
1605 BOOLEAN SysFontFlag
;
1606 EFI_GRAPHICS_OUTPUT_BLT_PIXEL Foreground
;
1607 EFI_GRAPHICS_OUTPUT_BLT_PIXEL Background
;
1608 BOOLEAN Transparent
;
1609 EFI_GRAPHICS_OUTPUT_BLT_PIXEL
*BltBuffer
;
1610 EFI_GRAPHICS_OUTPUT_BLT_PIXEL
*BufferPtr
;
1614 EFI_GRAPHICS_OUTPUT_BLT_PIXEL
*RowBufferPtr
;
1615 HII_GLOBAL_FONT_INFO
*GlobalFont
;
1618 // Check incoming parameters.
1621 if (This
== NULL
|| String
== NULL
|| Blt
== NULL
) {
1622 return EFI_INVALID_PARAMETER
;
1626 // These two flag cannot be used if Blt is NULL upon entry.
1628 if ((Flags
& EFI_HII_OUT_FLAG_TRANSPARENT
) == EFI_HII_OUT_FLAG_TRANSPARENT
) {
1629 return EFI_INVALID_PARAMETER
;
1631 if ((Flags
& EFI_HII_OUT_FLAG_CLIP
) == EFI_HII_OUT_FLAG_CLIP
) {
1632 return EFI_INVALID_PARAMETER
;
1636 // These two flags require that EFI_HII_OUT_FLAG_CLIP be also set.
1638 if ((Flags
& (EFI_HII_OUT_FLAG_CLIP
| EFI_HII_OUT_FLAG_CLIP_CLEAN_X
)) == EFI_HII_OUT_FLAG_CLIP_CLEAN_X
) {
1639 return EFI_INVALID_PARAMETER
;
1641 if ((Flags
& (EFI_HII_OUT_FLAG_CLIP
| EFI_HII_OUT_FLAG_CLIP_CLEAN_Y
)) == EFI_HII_OUT_FLAG_CLIP_CLEAN_Y
) {
1642 return EFI_INVALID_PARAMETER
;
1645 // This flag cannot be used with EFI_HII_OUT_FLAG_CLEAN_X.
1647 if ((Flags
& (EFI_HII_OUT_FLAG_WRAP
| EFI_HII_OUT_FLAG_CLIP_CLEAN_X
)) == (EFI_HII_OUT_FLAG_WRAP
| EFI_HII_OUT_FLAG_CLIP_CLEAN_X
)) {
1648 return EFI_INVALID_PARAMETER
;
1653 // Create a new bitmap and draw the string onto this image.
1655 Image
= AllocateZeroPool (sizeof (EFI_IMAGE_OUTPUT
));
1656 if (Image
== NULL
) {
1657 return EFI_OUT_OF_RESOURCES
;
1660 Image
->Height
= 600;
1661 Image
->Image
.Bitmap
= AllocateZeroPool (Image
->Width
* Image
->Height
*sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL
));
1662 if (Image
->Image
.Bitmap
== NULL
) {
1664 return EFI_OUT_OF_RESOURCES
;
1668 // Other flags are not permitted when Blt is NULL.
1670 Flags
&= EFI_HII_OUT_FLAG_WRAP
| EFI_HII_IGNORE_IF_NO_GLYPH
| EFI_HII_IGNORE_LINE_BREAK
;
1674 StrLength
= StrLen(String
);
1675 GlyphBuf
= (UINT8
**) AllocateZeroPool (StrLength
* sizeof (UINT8
*));
1676 ASSERT (GlyphBuf
!= NULL
);
1677 Cell
= (EFI_HII_GLYPH_INFO
*) AllocateZeroPool (StrLength
* sizeof (EFI_HII_GLYPH_INFO
));
1678 ASSERT (Cell
!= NULL
);
1679 Attributes
= (UINT8
*) AllocateZeroPool (StrLength
* sizeof (UINT8
));
1680 ASSERT (Attributes
!= NULL
);
1683 Status
= EFI_SUCCESS
;
1685 SystemDefault
= NULL
;
1689 // Calculate the string output information, including specified color and font .
1690 // If StringInfo does not points to system font info, it must indicate an existing
1693 StringInfoOut
= NULL
;
1695 Private
= HII_FONT_DATABASE_PRIVATE_DATA_FROM_THIS (This
);
1696 SysFontFlag
= IsSystemFontInfo (Private
, (EFI_FONT_DISPLAY_INFO
*) StringInfo
, &SystemDefault
, NULL
);
1699 ASSERT (SystemDefault
!= NULL
);
1701 Height
= SystemDefault
->FontInfo
.FontSize
;
1702 BaseLine
= SystemDefault
->FontInfo
.FontSize
;
1703 Foreground
= SystemDefault
->ForegroundColor
;
1704 Background
= SystemDefault
->BackgroundColor
;
1708 // StringInfo must not be NULL if it is not system info.
1710 ASSERT (StringInfo
!= NULL
);
1711 Status
= HiiGetFontInfo (This
, &FontHandle
, (EFI_FONT_DISPLAY_INFO
*) StringInfo
, &StringInfoOut
, NULL
);
1712 if (Status
== EFI_NOT_FOUND
) {
1714 // The specified EFI_FONT_DISPLAY_INFO does not exist in current database.
1715 // Use the system font instead. Still use the color specified by StringInfo.
1719 Height
= SystemDefault
->FontInfo
.FontSize
;
1720 BaseLine
= SystemDefault
->FontInfo
.FontSize
;
1721 Foreground
= ((EFI_FONT_DISPLAY_INFO
*) StringInfo
)->ForegroundColor
;
1722 Background
= ((EFI_FONT_DISPLAY_INFO
*) StringInfo
)->BackgroundColor
;
1724 } else if (Status
== EFI_SUCCESS
) {
1725 FontInfo
= &StringInfoOut
->FontInfo
;
1726 IsFontInfoExisted (Private
, FontInfo
, NULL
, NULL
, &GlobalFont
);
1727 Height
= GlobalFont
->FontPackage
->Height
;
1728 BaseLine
= GlobalFont
->FontPackage
->BaseLine
;
1729 Foreground
= StringInfoOut
->ForegroundColor
;
1730 Background
= StringInfoOut
->BackgroundColor
;
1737 // Use the maxinum height of font as the base line.
1738 // And, use the maxinum height as line height.
1740 LineHeight
= Height
;
1741 LastLineHeight
= Height
;
1742 BaseLineOffset
= Height
- BaseLine
;
1745 // Parse the string to be displayed to drop some ignored characters.
1751 // Ignore line-break characters only. Hyphens or dash character will be displayed
1752 // without line-break opportunity.
1754 if ((Flags
& EFI_HII_IGNORE_LINE_BREAK
) == EFI_HII_IGNORE_LINE_BREAK
) {
1755 StringIn
= AllocateZeroPool (StrSize (StringPtr
));
1756 if (StringIn
== NULL
) {
1757 Status
= EFI_OUT_OF_RESOURCES
;
1760 StringTmp
= StringIn
;
1761 while (*StringPtr
!= 0) {
1762 if (IsLineBreak (*StringPtr
) == 0) {
1765 *StringTmp
++ = *StringPtr
++;
1769 StringPtr
= StringIn
;
1772 // If EFI_HII_IGNORE_IF_NO_GLYPH is set, then characters which have no glyphs
1773 // are not drawn. Otherwise they are replaced wth Unicode character 0xFFFD.
1775 StringIn2
= AllocateZeroPool (StrSize (StringPtr
));
1776 if (StringIn2
== NULL
) {
1777 Status
= EFI_OUT_OF_RESOURCES
;
1781 StringTmp
= StringIn2
;
1782 StrLength
= StrLen(StringPtr
);
1783 while (*StringPtr
!= 0 && Index
< StrLength
) {
1784 if (IsLineBreak (*StringPtr
) == 0) {
1785 *StringTmp
++ = *StringPtr
++;
1790 Status
= GetGlyphBuffer (Private
, *StringPtr
, FontInfo
, &GlyphBuf
[Index
], &Cell
[Index
], &Attributes
[Index
]);
1791 if (Status
== EFI_NOT_FOUND
) {
1792 if ((Flags
& EFI_HII_IGNORE_IF_NO_GLYPH
) == EFI_HII_IGNORE_IF_NO_GLYPH
) {
1793 GlyphBuf
[Index
] = NULL
;
1794 ZeroMem (&Cell
[Index
], sizeof (Cell
[Index
]));
1795 Status
= EFI_SUCCESS
;
1798 // Unicode 0xFFFD must exist in current hii database if this flag is not set.
1800 Status
= GetGlyphBuffer (
1802 REPLACE_UNKNOWN_GLYPH
,
1808 if (EFI_ERROR (Status
)) {
1809 Status
= EFI_INVALID_PARAMETER
;
1814 if (EFI_ERROR (Status
)) {
1818 *StringTmp
++ = *StringPtr
++;
1822 StringPtr
= StringIn2
;
1825 // Draw the string according to the specified EFI_HII_OUT_FLAGS and Blt.
1826 // If Blt is not NULL, then EFI_HII_OUT_FLAG_CLIP is implied, render this string
1827 // to an existing image (bitmap or screen depending on flags) pointed by "*Blt".
1828 // Otherwise render this string to a new allocated image and output it.
1831 BufferPtr
= Image
->Image
.Bitmap
+ Image
->Width
* BltY
+ BltX
;
1832 if (Image
->Height
< BltY
) {
1834 // the top edge of the image should be in Image resolution scope.
1836 Status
= EFI_INVALID_PARAMETER
;
1839 MaxRowNum
= (UINT16
) ((Image
->Height
- BltY
) / Height
);
1840 if ((Image
->Height
- BltY
) % Height
!= 0) {
1841 LastLineHeight
= (Image
->Height
- BltY
) % Height
;
1845 RowInfo
= (EFI_HII_ROW_INFO
*) AllocateZeroPool (MaxRowNum
* sizeof (EFI_HII_ROW_INFO
));
1846 if (RowInfo
== NULL
) {
1847 Status
= EFI_OUT_OF_RESOURCES
;
1852 // Format the glyph buffer according to flags.
1854 Transparent
= (BOOLEAN
) ((Flags
& EFI_HII_OUT_FLAG_TRANSPARENT
) == EFI_HII_OUT_FLAG_TRANSPARENT
? TRUE
: FALSE
);
1856 for (RowIndex
= 0, Index
= 0; RowIndex
< MaxRowNum
&& StringPtr
[Index
] != 0; ) {
1861 // Clip the final row if the row's bottom-most on pixel cannot fit when
1862 // EFI_HII_OUT_FLAG_CLEAN_Y is set.
1864 if (RowIndex
== MaxRowNum
- 1) {
1865 if ((Flags
& EFI_HII_OUT_FLAG_CLIP_CLEAN_Y
) == EFI_HII_OUT_FLAG_CLIP_CLEAN_Y
&& LastLineHeight
< LineHeight
) {
1867 // Don't draw at all if the row's bottom-most on pixel cannot fit.
1871 LineHeight
= LastLineHeight
;
1875 // Calculate how many characters there are in a row.
1877 RowInfo
[RowIndex
].StartIndex
= Index
;
1879 while (LineWidth
+ BltX
< Image
->Width
&& StringPtr
[Index
] != 0) {
1880 if ((Flags
& EFI_HII_IGNORE_LINE_BREAK
) == 0 &&
1881 IsLineBreak (StringPtr
[Index
]) == 0) {
1883 // It forces a line break that ends this row.
1891 // If the glyph of the character is existing, then accumulate the actual printed width
1893 LineWidth
+= (UINTN
) Cell
[Index
].AdvanceX
;
1899 // Record index of next char.
1903 // Return to the previous char.
1906 if (LineBreak
&& Index
> 0 ) {
1908 // Return the previous non line break char.
1914 // If this character is the last character of a row, we need not
1915 // draw its (AdvanceX - Width - OffsetX) for next character.
1917 LineWidth
-= (UINTN
) (Cell
[Index
].AdvanceX
- Cell
[Index
].Width
- Cell
[Index
].OffsetX
);
1920 // Clip the right-most character if cannot fit when EFI_HII_OUT_FLAG_CLEAN_X is set.
1922 if (LineWidth
+ BltX
<= Image
->Width
||
1923 (LineWidth
+ BltX
> Image
->Width
&& (Flags
& EFI_HII_OUT_FLAG_CLIP_CLEAN_X
) == 0)) {
1925 // Record right-most character in RowInfo even if it is partially displayed.
1927 RowInfo
[RowIndex
].EndIndex
= Index
;
1928 RowInfo
[RowIndex
].LineWidth
= LineWidth
;
1929 RowInfo
[RowIndex
].LineHeight
= LineHeight
;
1930 RowInfo
[RowIndex
].BaselineOffset
= BaseLineOffset
;
1933 // When EFI_HII_OUT_FLAG_CLEAN_X is set, it will not draw a character
1934 // if its right-most on pixel cannot fit.
1936 if (Index
> RowInfo
[RowIndex
].StartIndex
) {
1938 // Don't draw the last char on this row. And, don't draw the second last char (AdvanceX - Width - OffsetX).
1940 LineWidth
-= (UINTN
) (Cell
[Index
].Width
+ Cell
[Index
].OffsetX
);
1941 LineWidth
-= (UINTN
) (Cell
[Index
- 1].AdvanceX
- Cell
[Index
- 1].Width
- Cell
[Index
- 1].OffsetX
);
1942 RowInfo
[RowIndex
].EndIndex
= Index
- 1;
1943 RowInfo
[RowIndex
].LineWidth
= LineWidth
;
1944 RowInfo
[RowIndex
].LineHeight
= LineHeight
;
1945 RowInfo
[RowIndex
].BaselineOffset
= BaseLineOffset
;
1948 // There is no enough column to draw any character, so set current line width to zero.
1949 // And go to draw Next line if LineBreak is set.
1951 RowInfo
[RowIndex
].LineWidth
= 0;
1957 // EFI_HII_OUT_FLAG_WRAP will wrap the text at the right-most line-break
1958 // opportunity prior to a character whose right-most extent would exceed Width.
1959 // Search the right-most line-break opportunity here.
1961 if ((Flags
& EFI_HII_OUT_FLAG_WRAP
) == EFI_HII_OUT_FLAG_WRAP
&&
1962 (RowInfo
[RowIndex
].LineWidth
+ BltX
> Image
->Width
|| StringPtr
[NextIndex
] != 0) &&
1964 if ((Flags
& EFI_HII_IGNORE_LINE_BREAK
) == 0) {
1965 LineWidth
= RowInfo
[RowIndex
].LineWidth
;
1966 for (Index1
= RowInfo
[RowIndex
].EndIndex
; Index1
>= RowInfo
[RowIndex
].StartIndex
; Index1
--) {
1967 if (Index1
== RowInfo
[RowIndex
].EndIndex
) {
1968 LineWidth
-= (Cell
[Index1
].Width
+ Cell
[Index1
].OffsetX
);
1970 LineWidth
-= Cell
[Index1
].AdvanceX
;
1972 if (IsLineBreak (StringPtr
[Index1
]) > 0) {
1974 if (Index1
> RowInfo
[RowIndex
].StartIndex
) {
1975 RowInfo
[RowIndex
].EndIndex
= Index1
- 1;
1978 // relocate to the character after the right-most line break opportunity of this line
1980 NextIndex
= Index1
+ 1;
1984 // If don't find a line break opportunity from EndIndex to StartIndex,
1987 if (Index1
== RowInfo
[RowIndex
].StartIndex
)
1992 // Update LineWidth to the real width
1994 if (IsLineBreak (StringPtr
[Index1
]) > 0) {
1995 if (Index1
== RowInfo
[RowIndex
].StartIndex
) {
1998 LineWidth
-= (UINTN
) (Cell
[Index1
- 1].AdvanceX
- Cell
[Index1
- 1].Width
- Cell
[Index1
- 1].OffsetX
);
2000 RowInfo
[RowIndex
].LineWidth
= LineWidth
;
2004 // If no line-break opportunity can be found, then the text will
2005 // behave as if EFI_HII_OUT_FLAG_CLEAN_X is set.
2008 LineWidth
= RowInfo
[RowIndex
].LineWidth
;
2009 Index1
= RowInfo
[RowIndex
].EndIndex
;
2010 if (LineWidth
+ BltX
> Image
->Width
) {
2011 if (Index1
> RowInfo
[RowIndex
].StartIndex
) {
2013 // Don't draw the last char on this row. And, don't draw the second last char (AdvanceX - Width - OffsetX).
2015 LineWidth
-= (UINTN
) (Cell
[Index1
].Width
+ Cell
[Index1
].OffsetX
);
2016 LineWidth
-= (UINTN
) (Cell
[Index1
- 1].AdvanceX
- Cell
[Index1
- 1].Width
- Cell
[Index1
- 1].OffsetX
);
2017 RowInfo
[RowIndex
].EndIndex
= Index1
- 1;
2018 RowInfo
[RowIndex
].LineWidth
= LineWidth
;
2021 // There is no enough column to draw any character, so set current line width to zero.
2022 // And go to draw Next line if LineBreak is set.
2024 RowInfo
[RowIndex
].LineWidth
= 0;
2032 // LineWidth can't exceed Image width.
2034 if (RowInfo
[RowIndex
].LineWidth
+ BltX
> Image
->Width
) {
2035 RowInfo
[RowIndex
].LineWidth
= Image
->Width
- BltX
;
2039 // Draw it to screen or existing bitmap depending on whether
2040 // EFI_HII_DIRECT_TO_SCREEN is set.
2043 if ((Flags
& EFI_HII_DIRECT_TO_SCREEN
) == EFI_HII_DIRECT_TO_SCREEN
) {
2045 if (RowInfo
[RowIndex
].LineWidth
!= 0) {
2046 BltBuffer
= AllocateZeroPool (RowInfo
[RowIndex
].LineWidth
* RowInfo
[RowIndex
].LineHeight
* sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL
));
2047 if (BltBuffer
== NULL
) {
2048 Status
= EFI_OUT_OF_RESOURCES
;
2052 // Set BufferPtr to Origin by adding baseline to the starting position.
2054 BufferPtr
= BltBuffer
+ BaseLine
* RowInfo
[RowIndex
].LineWidth
;
2056 for (Index1
= RowInfo
[RowIndex
].StartIndex
; Index1
<= RowInfo
[RowIndex
].EndIndex
; Index1
++) {
2057 if (RowInfo
[RowIndex
].LineWidth
> 0 && RowInfo
[RowIndex
].LineWidth
> LineOffset
) {
2059 // Only BLT these character which have corrsponding glyph in font basebase.
2065 (UINT16
) RowInfo
[RowIndex
].LineWidth
,
2067 RowInfo
[RowIndex
].LineWidth
- LineOffset
,
2068 RowInfo
[RowIndex
].LineHeight
,
2075 if (ColumnInfoArray
!= NULL
) {
2076 if ((GlyphBuf
[Index1
] == NULL
&& Cell
[Index1
].AdvanceX
== 0)
2077 || RowInfo
[RowIndex
].LineWidth
== 0) {
2078 *ColumnInfoArray
= (UINTN
) ~0;
2080 *ColumnInfoArray
= LineOffset
+ Cell
[Index1
].OffsetX
+ BltX
;
2084 LineOffset
+= Cell
[Index1
].AdvanceX
;
2087 if (BltBuffer
!= NULL
) {
2088 Status
= Image
->Image
.Screen
->Blt (
2089 Image
->Image
.Screen
,
2091 EfiBltBufferToVideo
,
2096 RowInfo
[RowIndex
].LineWidth
,
2097 RowInfo
[RowIndex
].LineHeight
,
2100 if (EFI_ERROR (Status
)) {
2101 FreePool (BltBuffer
);
2105 FreePool (BltBuffer
);
2109 // Save the starting position for calculate the starting postition of next row.
2111 RowBufferPtr
= BufferPtr
;
2113 // Set BufferPtr to Origin by adding baseline to the starting position.
2115 BufferPtr
= BufferPtr
+ BaseLine
* Image
->Width
;
2116 for (Index1
= RowInfo
[RowIndex
].StartIndex
; Index1
<= RowInfo
[RowIndex
].EndIndex
; Index1
++) {
2117 if (RowInfo
[RowIndex
].LineWidth
> 0 && RowInfo
[RowIndex
].LineWidth
> LineOffset
) {
2119 // Only BLT these character which have corrsponding glyph in font basebase.
2127 RowInfo
[RowIndex
].LineWidth
- LineOffset
,
2128 RowInfo
[RowIndex
].LineHeight
,
2135 if (ColumnInfoArray
!= NULL
) {
2136 if ((GlyphBuf
[Index1
] == NULL
&& Cell
[Index1
].AdvanceX
== 0)
2137 || RowInfo
[RowIndex
].LineWidth
== 0) {
2138 *ColumnInfoArray
= (UINTN
) ~0;
2140 *ColumnInfoArray
= LineOffset
+ Cell
[Index1
].OffsetX
+ BltX
;
2144 LineOffset
+= Cell
[Index1
].AdvanceX
;
2148 // Jump to starting position of next row.
2150 if (RowIndex
== 0) {
2151 BufferPtr
= RowBufferPtr
- BltX
+ LineHeight
* Image
->Width
;
2153 BufferPtr
= RowBufferPtr
+ LineHeight
* Image
->Width
;
2159 // Recalculate the start point of Y axis to draw multi-lines with the order of top-to-down
2161 BltY
+= RowInfo
[RowIndex
].LineHeight
;
2168 // If there is not a mandatory line break or line break opportunity, only render one line to image
2175 // Write output parameters.
2177 RowInfoSize
= RowIndex
* sizeof (EFI_HII_ROW_INFO
);
2178 if (RowInfoArray
!= NULL
) {
2179 if (RowInfoSize
> 0) {
2180 *RowInfoArray
= AllocateZeroPool (RowInfoSize
);
2181 if (*RowInfoArray
== NULL
) {
2182 Status
= EFI_OUT_OF_RESOURCES
;
2185 CopyMem (*RowInfoArray
, RowInfo
, RowInfoSize
);
2187 *RowInfoArray
= NULL
;
2190 if (RowInfoArraySize
!= NULL
) {
2191 *RowInfoArraySize
= RowIndex
;
2194 Status
= EFI_SUCCESS
;
2198 for (Index
= 0; Index
< StrLength
; Index
++) {
2199 if (GlyphBuf
[Index
] != NULL
) {
2200 FreePool (GlyphBuf
[Index
]);
2203 if (StringIn
!= NULL
) {
2204 FreePool (StringIn
);
2206 if (StringIn2
!= NULL
) {
2207 FreePool (StringIn2
);
2209 if (StringInfoOut
!= NULL
) {
2210 FreePool (StringInfoOut
);
2212 if (RowInfo
!= NULL
) {
2215 if (SystemDefault
!= NULL
) {
2216 FreePool (SystemDefault
);
2218 if (GlyphBuf
!= NULL
) {
2219 FreePool (GlyphBuf
);
2224 if (Attributes
!= NULL
) {
2225 FreePool (Attributes
);
2233 Render a string to a bitmap or the screen containing the contents of the specified string.
2235 @param This A pointer to the EFI_HII_FONT_PROTOCOL instance.
2236 @param Flags Describes how the string is to be drawn.
2237 @param PackageList The package list in the HII database to search
2238 for the specified string.
2239 @param StringId The string's id, which is unique within
2241 @param Language Points to the language for the retrieved string.
2242 If NULL, then the current system language is
2244 @param StringInfo Points to the string output information,
2245 including the color and font. If NULL, then the
2246 string will be output in the default system font
2248 @param Blt If this points to a non-NULL on entry, this
2249 points to the image, which is Width pixels wide
2250 and Height pixels high. The string will be drawn
2252 EFI_HII_OUT_FLAG_CLIP is implied. If this points
2253 to a NULL on entry, then a buffer
2254 will be allocated to hold the generated image and
2255 the pointer updated on exit. It is the caller's
2256 responsibility to free this buffer.
2257 @param BltX Specifies the offset from the left and top edge
2258 of the image of the first character cell in the
2260 @param BltY Specifies the offset from the left and top edge
2261 of the image of the first character cell in the
2263 @param RowInfoArray If this is non-NULL on entry, then on exit, this
2264 will point to an allocated buffer containing
2265 row information and RowInfoArraySize will be
2266 updated to contain the number of elements.
2267 This array describes the characters which were at
2268 least partially drawn and the heights of the
2269 rows. It is the caller's responsibility to free
2271 @param RowInfoArraySize If this is non-NULL on entry, then on exit it
2272 contains the number of elements in RowInfoArray.
2273 @param ColumnInfoArray If this is non-NULL, then on return it will be
2274 filled with the horizontal offset for each
2275 character in the string on the row where it is
2276 displayed. Non-printing characters will have
2277 the offset ~0. The caller is responsible to
2278 allocate a buffer large enough so that there
2279 is one entry for each character in the string,
2280 not including the null-terminator. It is possible
2281 when character display is normalized that some
2282 character cells overlap.
2284 @retval EFI_SUCCESS The string was successfully rendered.
2285 @retval EFI_OUT_OF_RESOURCES Unable to allocate an output buffer for
2286 RowInfoArray or Blt.
2287 @retval EFI_INVALID_PARAMETER The Blt or PackageList was NULL.
2288 @retval EFI_INVALID_PARAMETER Flags were invalid combination.
2289 @retval EFI_NOT_FOUND The specified PackageList is not in the Database or the stringid is not
2290 in the specified PackageList.
2295 HiiStringIdToImage (
2296 IN CONST EFI_HII_FONT_PROTOCOL
*This
,
2297 IN EFI_HII_OUT_FLAGS Flags
,
2298 IN EFI_HII_HANDLE PackageList
,
2299 IN EFI_STRING_ID StringId
,
2300 IN CONST CHAR8
* Language
,
2301 IN CONST EFI_FONT_DISPLAY_INFO
*StringInfo OPTIONAL
,
2302 IN OUT EFI_IMAGE_OUTPUT
**Blt
,
2305 OUT EFI_HII_ROW_INFO
**RowInfoArray OPTIONAL
,
2306 OUT UINTN
*RowInfoArraySize OPTIONAL
,
2307 OUT UINTN
*ColumnInfoArray OPTIONAL
2311 HII_DATABASE_PRIVATE_DATA
*Private
;
2312 EFI_HII_STRING_PROTOCOL
*HiiString
;
2317 EFI_FONT_INFO
*StringFontInfo
;
2318 EFI_FONT_DISPLAY_INFO
*NewStringInfo
;
2319 CHAR8 TempSupportedLanguages
;
2320 CHAR8
*SupportedLanguages
;
2321 UINTN SupportedLanguagesSize
;
2322 CHAR8
*CurrentLanguage
;
2323 CHAR8
*BestLanguage
;
2325 if (This
== NULL
|| PackageList
== NULL
|| Blt
== NULL
|| PackageList
== NULL
) {
2326 return EFI_INVALID_PARAMETER
;
2329 if (!IsHiiHandleValid (PackageList
)) {
2330 return EFI_NOT_FOUND
;
2334 // Initialize string pointers to be NULL
2336 SupportedLanguages
= NULL
;
2337 CurrentLanguage
= NULL
;
2338 BestLanguage
= NULL
;
2340 StringFontInfo
= NULL
;
2341 NewStringInfo
= NULL
;
2344 // Get the string to be displayed.
2346 Private
= HII_FONT_DATABASE_PRIVATE_DATA_FROM_THIS (This
);
2347 HiiString
= &Private
->HiiString
;
2350 // Get the size of supported language.
2352 SupportedLanguagesSize
= 0;
2353 Status
= HiiString
->GetLanguages (
2356 &TempSupportedLanguages
,
2357 &SupportedLanguagesSize
2359 if (Status
!= EFI_BUFFER_TOO_SMALL
) {
2363 SupportedLanguages
= AllocatePool (SupportedLanguagesSize
);
2364 if (SupportedLanguages
== NULL
) {
2365 return EFI_OUT_OF_RESOURCES
;
2368 Status
= HiiString
->GetLanguages (
2372 &SupportedLanguagesSize
2374 if (EFI_ERROR (Status
)) {
2378 if (Language
== NULL
) {
2381 GetEfiGlobalVariable2 (L
"PlatformLang", (VOID
**)&CurrentLanguage
, NULL
);
2382 BestLanguage
= GetBestLanguage (
2386 (CurrentLanguage
== NULL
) ? CurrentLanguage
: "",
2387 (CHAR8
*) PcdGetPtr (PcdUefiVariableDefaultPlatformLang
),
2390 if (BestLanguage
== NULL
) {
2391 Status
= EFI_NOT_FOUND
;
2395 StringSize
= MAX_STRING_LENGTH
;
2396 String
= (EFI_STRING
) AllocateZeroPool (StringSize
);
2397 if (String
== NULL
) {
2398 Status
= EFI_OUT_OF_RESOURCES
;
2402 Status
= HiiString
->GetString (
2411 if (Status
== EFI_BUFFER_TOO_SMALL
) {
2413 String
= (EFI_STRING
) AllocateZeroPool (StringSize
);
2414 if (String
== NULL
) {
2415 Status
= EFI_OUT_OF_RESOURCES
;
2418 Status
= HiiString
->GetString (
2429 if (EFI_ERROR (Status
)) {
2434 // When StringInfo specifies that string will be output in the system default font and color,
2435 // use particular stringfontinfo described in string package instead if exists.
2436 // StringFontInfo equals NULL means system default font attaches with the string block.
2438 if (StringFontInfo
!= NULL
&& IsSystemFontInfo (Private
, (EFI_FONT_DISPLAY_INFO
*) StringInfo
, NULL
, NULL
)) {
2439 NameSize
= StrSize (StringFontInfo
->FontName
);
2440 FontLen
= sizeof (EFI_FONT_DISPLAY_INFO
) - sizeof (CHAR16
) + NameSize
;
2441 NewStringInfo
= AllocateZeroPool (FontLen
);
2442 if (NewStringInfo
== NULL
) {
2443 Status
= EFI_OUT_OF_RESOURCES
;
2446 NewStringInfo
->FontInfoMask
= EFI_FONT_INFO_SYS_FORE_COLOR
| EFI_FONT_INFO_SYS_BACK_COLOR
;
2447 NewStringInfo
->FontInfo
.FontStyle
= StringFontInfo
->FontStyle
;
2448 NewStringInfo
->FontInfo
.FontSize
= StringFontInfo
->FontSize
;
2449 StrCpyS (NewStringInfo
->FontInfo
.FontName
, NameSize
/ sizeof (CHAR16
), StringFontInfo
->FontName
);
2451 Status
= HiiStringToImage (
2466 Status
= HiiStringToImage (
2480 if (SupportedLanguages
!= NULL
) {
2481 FreePool (SupportedLanguages
);
2483 if (CurrentLanguage
!= NULL
) {
2484 FreePool (CurrentLanguage
);
2486 if (BestLanguage
!= NULL
) {
2487 FreePool (BestLanguage
);
2489 if (String
!= NULL
) {
2492 if (StringFontInfo
!= NULL
) {
2493 FreePool (StringFontInfo
);
2495 if (NewStringInfo
!= NULL
) {
2496 FreePool (NewStringInfo
);
2504 Convert the glyph for a single character into a bitmap.
2506 @param This A pointer to the EFI_HII_FONT_PROTOCOL instance.
2507 @param Char Character to retrieve.
2508 @param StringInfo Points to the string font and color information
2509 or NULL if the string should use the default
2510 system font and color.
2511 @param Blt Thus must point to a NULL on entry. A buffer will
2512 be allocated to hold the output and the pointer
2513 updated on exit. It is the caller's
2514 responsibility to free this buffer.
2515 @param Baseline Number of pixels from the bottom of the bitmap to
2518 @retval EFI_SUCCESS Glyph bitmap created.
2519 @retval EFI_OUT_OF_RESOURCES Unable to allocate the output buffer Blt.
2520 @retval EFI_WARN_UNKNOWN_GLYPH The glyph was unknown and was replaced with the
2521 glyph for Unicode character 0xFFFD.
2522 @retval EFI_INVALID_PARAMETER Blt is NULL or *Blt is not NULL.
2528 IN CONST EFI_HII_FONT_PROTOCOL
*This
,
2530 IN CONST EFI_FONT_DISPLAY_INFO
*StringInfo
,
2531 OUT EFI_IMAGE_OUTPUT
**Blt
,
2532 OUT UINTN
*Baseline OPTIONAL
2536 HII_DATABASE_PRIVATE_DATA
*Private
;
2537 EFI_IMAGE_OUTPUT
*Image
;
2539 EFI_FONT_DISPLAY_INFO
*SystemDefault
;
2540 EFI_FONT_DISPLAY_INFO
*StringInfoOut
;
2542 EFI_FONT_HANDLE FontHandle
;
2544 EFI_HII_GLYPH_INFO Cell
;
2545 EFI_FONT_INFO
*FontInfo
;
2547 EFI_GRAPHICS_OUTPUT_BLT_PIXEL Foreground
;
2548 EFI_GRAPHICS_OUTPUT_BLT_PIXEL Background
;
2549 EFI_GRAPHICS_OUTPUT_BLT_PIXEL
*BltBuffer
;
2552 if (This
== NULL
|| Blt
== NULL
|| *Blt
!= NULL
) {
2553 return EFI_INVALID_PARAMETER
;
2556 Private
= HII_FONT_DATABASE_PRIVATE_DATA_FROM_THIS (This
);
2560 SystemDefault
= NULL
;
2564 StringInfoOut
= NULL
;
2567 ZeroMem (&Foreground
, sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL
));
2568 ZeroMem (&Background
, sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL
));
2570 Default
= IsSystemFontInfo (Private
, (EFI_FONT_DISPLAY_INFO
*) StringInfo
, &SystemDefault
, NULL
);
2574 // Find out a EFI_FONT_DISPLAY_INFO which could display the character in
2575 // the specified color and font.
2577 String
= (EFI_STRING
) AllocateZeroPool (sizeof (CHAR16
) * 2);
2578 if (String
== NULL
) {
2579 Status
= EFI_OUT_OF_RESOURCES
;
2585 Status
= HiiGetFontInfo (This
, &FontHandle
, StringInfo
, &StringInfoOut
, String
);
2586 if (EFI_ERROR (Status
)) {
2589 ASSERT (StringInfoOut
!= NULL
);
2590 FontInfo
= &StringInfoOut
->FontInfo
;
2591 Foreground
= StringInfoOut
->ForegroundColor
;
2592 Background
= StringInfoOut
->BackgroundColor
;
2594 ASSERT (SystemDefault
!= NULL
);
2595 Foreground
= SystemDefault
->ForegroundColor
;
2596 Background
= SystemDefault
->BackgroundColor
;
2599 Status
= GetGlyphBuffer (Private
, Char
, FontInfo
, &GlyphBuffer
, &Cell
, &Attributes
);
2600 if (EFI_ERROR (Status
)) {
2604 Image
= (EFI_IMAGE_OUTPUT
*) AllocateZeroPool (sizeof (EFI_IMAGE_OUTPUT
));
2605 if (Image
== NULL
) {
2606 Status
= EFI_OUT_OF_RESOURCES
;
2609 Image
->Width
= Cell
.Width
;
2610 Image
->Height
= Cell
.Height
;
2612 if (Image
->Width
* Image
->Height
> 0) {
2613 Image
->Image
.Bitmap
= AllocateZeroPool (Image
->Width
* Image
->Height
* sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL
));
2614 if (Image
->Image
.Bitmap
== NULL
) {
2616 Status
= EFI_OUT_OF_RESOURCES
;
2621 // Set BaseLine to the char height.
2623 BaseLine
= (UINT16
) (Cell
.Height
+ Cell
.OffsetY
);
2625 // Set BltBuffer to the position of Origin.
2627 BltBuffer
= Image
->Image
.Bitmap
+ (Cell
.Height
+ Cell
.OffsetY
) * Image
->Width
- Cell
.OffsetX
;
2634 Cell
.Width
+ Cell
.OffsetX
,
2635 BaseLine
- Cell
.OffsetY
,
2644 if (Baseline
!= NULL
) {
2645 *Baseline
= Cell
.OffsetY
;
2648 Status
= EFI_SUCCESS
;
2652 if (Status
== EFI_NOT_FOUND
) {
2654 // Glyph is unknown and replaced with the glyph for unicode character 0xFFFD
2656 if (Char
!= REPLACE_UNKNOWN_GLYPH
) {
2657 Status
= HiiGetGlyph (This
, REPLACE_UNKNOWN_GLYPH
, StringInfo
, Blt
, Baseline
);
2658 if (!EFI_ERROR (Status
)) {
2659 Status
= EFI_WARN_UNKNOWN_GLYPH
;
2662 Status
= EFI_WARN_UNKNOWN_GLYPH
;
2666 if (SystemDefault
!= NULL
) {
2667 FreePool (SystemDefault
);
2669 if (StringInfoOut
!= NULL
) {
2670 FreePool (StringInfoOut
);
2672 if (String
!= NULL
) {
2675 if (GlyphBuffer
!= NULL
) {
2676 FreePool (GlyphBuffer
);
2684 This function iterates through fonts which match the specified font, using
2685 the specified criteria. If String is non-NULL, then all of the characters in
2686 the string must exist in order for a candidate font to be returned.
2688 @param This A pointer to the EFI_HII_FONT_PROTOCOL instance.
2689 @param FontHandle On entry, points to the font handle returned by a
2690 previous call to GetFontInfo() or NULL to start
2691 with the first font. On return, points to the
2692 returned font handle or points to NULL if there
2693 are no more matching fonts.
2694 @param StringInfoIn Upon entry, points to the font to return information
2695 about. If NULL, then the information about the system
2696 default font will be returned.
2697 @param StringInfoOut Upon return, contains the matching font's information.
2698 If NULL, then no information is returned. This buffer
2699 is allocated with a call to the Boot Service AllocatePool().
2700 It is the caller's responsibility to call the Boot
2701 Service FreePool() when the caller no longer requires
2702 the contents of StringInfoOut.
2703 @param String Points to the string which will be tested to
2704 determine if all characters are available. If
2705 NULL, then any font is acceptable.
2707 @retval EFI_SUCCESS Matching font returned successfully.
2708 @retval EFI_NOT_FOUND No matching font was found.
2709 @retval EFI_INVALID_PARAMETER StringInfoIn->FontInfoMask is an invalid combination.
2710 @retval EFI_OUT_OF_RESOURCES There were insufficient resources to complete the
2717 IN CONST EFI_HII_FONT_PROTOCOL
*This
,
2718 IN OUT EFI_FONT_HANDLE
*FontHandle
,
2719 IN CONST EFI_FONT_DISPLAY_INFO
*StringInfoIn
, OPTIONAL
2720 OUT EFI_FONT_DISPLAY_INFO
**StringInfoOut
,
2721 IN CONST EFI_STRING String OPTIONAL
2724 HII_DATABASE_PRIVATE_DATA
*Private
;
2726 EFI_FONT_DISPLAY_INFO
*SystemDefault
;
2727 EFI_FONT_DISPLAY_INFO InfoOut
;
2728 UINTN StringInfoOutLen
;
2729 EFI_FONT_INFO
*FontInfo
;
2730 HII_GLOBAL_FONT_INFO
*GlobalFont
;
2731 EFI_STRING StringIn
;
2732 EFI_FONT_HANDLE LocalFontHandle
;
2735 return EFI_INVALID_PARAMETER
;
2738 StringInfoOutLen
= 0;
2740 SystemDefault
= NULL
;
2741 LocalFontHandle
= NULL
;
2742 if (FontHandle
!= NULL
) {
2743 LocalFontHandle
= *FontHandle
;
2746 Private
= HII_FONT_DATABASE_PRIVATE_DATA_FROM_THIS (This
);
2749 // Already searched to the end of the whole list, return directly.
2751 if (LocalFontHandle
== &Private
->FontInfoList
) {
2752 LocalFontHandle
= NULL
;
2753 Status
= EFI_NOT_FOUND
;
2758 // Get default system display info, if StringInfoIn points to
2759 // system display info, return it directly.
2761 if (IsSystemFontInfo (Private
, (EFI_FONT_DISPLAY_INFO
*) StringInfoIn
, &SystemDefault
, &StringInfoOutLen
)) {
2763 // System font is the first node. When handle is not NULL, system font can not
2764 // be found any more.
2766 if (LocalFontHandle
== NULL
) {
2767 if (StringInfoOut
!= NULL
) {
2768 *StringInfoOut
= AllocateCopyPool (StringInfoOutLen
, SystemDefault
);
2769 if (*StringInfoOut
== NULL
) {
2770 Status
= EFI_OUT_OF_RESOURCES
;
2771 LocalFontHandle
= NULL
;
2776 LocalFontHandle
= Private
->FontInfoList
.ForwardLink
;
2777 Status
= EFI_SUCCESS
;
2780 LocalFontHandle
= NULL
;
2781 Status
= EFI_NOT_FOUND
;
2787 // StringInfoIn must not be NULL if it is not system default font info.
2789 ASSERT (StringInfoIn
!= NULL
);
2791 // Check the font information mask to make sure it is valid.
2793 if (((StringInfoIn
->FontInfoMask
& (EFI_FONT_INFO_SYS_FONT
| EFI_FONT_INFO_ANY_FONT
)) ==
2794 (EFI_FONT_INFO_SYS_FONT
| EFI_FONT_INFO_ANY_FONT
)) ||
2795 ((StringInfoIn
->FontInfoMask
& (EFI_FONT_INFO_SYS_SIZE
| EFI_FONT_INFO_ANY_SIZE
)) ==
2796 (EFI_FONT_INFO_SYS_SIZE
| EFI_FONT_INFO_ANY_SIZE
)) ||
2797 ((StringInfoIn
->FontInfoMask
& (EFI_FONT_INFO_SYS_STYLE
| EFI_FONT_INFO_ANY_STYLE
)) ==
2798 (EFI_FONT_INFO_SYS_STYLE
| EFI_FONT_INFO_ANY_STYLE
)) ||
2799 ((StringInfoIn
->FontInfoMask
& (EFI_FONT_INFO_RESIZE
| EFI_FONT_INFO_ANY_SIZE
)) ==
2800 (EFI_FONT_INFO_RESIZE
| EFI_FONT_INFO_ANY_SIZE
)) ||
2801 ((StringInfoIn
->FontInfoMask
& (EFI_FONT_INFO_RESTYLE
| EFI_FONT_INFO_ANY_STYLE
)) ==
2802 (EFI_FONT_INFO_RESTYLE
| EFI_FONT_INFO_ANY_STYLE
))) {
2803 return EFI_INVALID_PARAMETER
;
2807 // Parse the font information mask to find a matching font.
2810 CopyMem (&InfoOut
, (EFI_FONT_DISPLAY_INFO
*) StringInfoIn
, sizeof (EFI_FONT_DISPLAY_INFO
));
2812 if ((StringInfoIn
->FontInfoMask
& EFI_FONT_INFO_SYS_FONT
) == EFI_FONT_INFO_SYS_FONT
) {
2813 Status
= SaveFontName (SystemDefault
->FontInfo
.FontName
, &FontInfo
);
2815 Status
= SaveFontName (((EFI_FONT_DISPLAY_INFO
*) StringInfoIn
)->FontInfo
.FontName
, &FontInfo
);
2817 if (EFI_ERROR (Status
)) {
2821 if ((StringInfoIn
->FontInfoMask
& EFI_FONT_INFO_SYS_SIZE
) == EFI_FONT_INFO_SYS_SIZE
) {
2822 InfoOut
.FontInfo
.FontSize
= SystemDefault
->FontInfo
.FontSize
;
2824 if ((StringInfoIn
->FontInfoMask
& EFI_FONT_INFO_SYS_STYLE
) == EFI_FONT_INFO_SYS_STYLE
) {
2825 InfoOut
.FontInfo
.FontStyle
= SystemDefault
->FontInfo
.FontStyle
;
2827 if ((StringInfoIn
->FontInfoMask
& EFI_FONT_INFO_SYS_FORE_COLOR
) == EFI_FONT_INFO_SYS_FORE_COLOR
) {
2828 InfoOut
.ForegroundColor
= SystemDefault
->ForegroundColor
;
2830 if ((StringInfoIn
->FontInfoMask
& EFI_FONT_INFO_SYS_BACK_COLOR
) == EFI_FONT_INFO_SYS_BACK_COLOR
) {
2831 InfoOut
.BackgroundColor
= SystemDefault
->BackgroundColor
;
2834 ASSERT (FontInfo
!= NULL
);
2835 FontInfo
->FontSize
= InfoOut
.FontInfo
.FontSize
;
2836 FontInfo
->FontStyle
= InfoOut
.FontInfo
.FontStyle
;
2838 if (IsFontInfoExisted (Private
, FontInfo
, &InfoOut
.FontInfoMask
, LocalFontHandle
, &GlobalFont
)) {
2840 // Test to guarantee all characters are available in the found font.
2842 if (String
!= NULL
) {
2844 while (*StringIn
!= 0) {
2845 Status
= FindGlyphBlock (GlobalFont
->FontPackage
, *StringIn
, NULL
, NULL
, NULL
);
2846 if (EFI_ERROR (Status
)) {
2847 LocalFontHandle
= NULL
;
2854 // Write to output parameter
2856 if (StringInfoOut
!= NULL
) {
2857 StringInfoOutLen
= sizeof (EFI_FONT_DISPLAY_INFO
) - sizeof (EFI_FONT_INFO
) + GlobalFont
->FontInfoSize
;
2858 *StringInfoOut
= (EFI_FONT_DISPLAY_INFO
*) AllocateZeroPool (StringInfoOutLen
);
2859 if (*StringInfoOut
== NULL
) {
2860 Status
= EFI_OUT_OF_RESOURCES
;
2861 LocalFontHandle
= NULL
;
2865 CopyMem (*StringInfoOut
, &InfoOut
, sizeof (EFI_FONT_DISPLAY_INFO
));
2866 CopyMem (&(*StringInfoOut
)->FontInfo
, GlobalFont
->FontInfo
, GlobalFont
->FontInfoSize
);
2869 LocalFontHandle
= GlobalFont
->Entry
.ForwardLink
;
2870 Status
= EFI_SUCCESS
;
2874 Status
= EFI_NOT_FOUND
;
2878 if (FontHandle
!= NULL
) {
2879 *FontHandle
= LocalFontHandle
;
2882 if (SystemDefault
!= NULL
) {
2883 FreePool (SystemDefault
);
2885 if (FontInfo
!= NULL
) {
2886 FreePool (FontInfo
);