/** @file\r
The file provides services to retrieve font information.\r
\r
- Copyright (c) 2006 - 2009, Intel Corporation\r
- All rights reserved. This program and the accompanying materials \r
- are licensed and made available under the terms and conditions of the BSD License \r
- which accompanies this distribution. The full text of the license may be found at \r
- http://opensource.org/licenses/bsd-license.php \r
-\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
+Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved<BR>\r
+This program and the accompanying materials are licensed and made available under \r
+the terms and conditions of the BSD License that accompanies this distribution. \r
+The full text of the license may be found at\r
+http://opensource.org/licenses/bsd-license.php. \r
+ \r
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
\r
**/\r
\r
typedef VOID *EFI_FONT_HANDLE;\r
\r
///\r
-/// EFI_HII_OUT_FLAGS\r
+/// EFI_HII_OUT_FLAGS.\r
/// \r
typedef UINT32 EFI_HII_OUT_FLAGS;\r
\r
\r
This function renders a string to a bitmap or the screen using\r
the specified font, color and options. It either draws the\r
- string and glyphs on an existing bitmap, allocates a new bitmap\r
+ string and glyphs on an existing bitmap, allocates a new bitmap,\r
or uses the screen. The strings can be clipped or wrapped.\r
Optionally, the function also returns the information about each\r
row and the character position on that row. If\r
outside the bounding box specified by Width and Height are\r
ignored. The information in the RowInfoArray only describes\r
characters which are at least partially displayed. For the final\r
- row, the LineHeight and BaseLine may describe pixels which are\r
+ row, the LineHeight and BaseLine may describe pixels that are\r
outside the limit specified by Height (unless\r
EFI_HII_OUT_FLAG_CLIP_CLEAN_Y is specified) even though those\r
pixels were not drawn. The LineWidth may describe pixels which\r
containing row information and\r
RowInfoArraySize will be updated to contain\r
the number of elements. This array describes\r
- the characters which were at least partially\r
+ the characters that were at least partially\r
drawn and the heights of the rows. It is the\r
caller's responsibility to free this buffer.\r
\r
can be drawn transparently or opaquely. The function can also\r
return information about each row and each character's\r
position on the row. If EFI_HII_OUT_FLAG_CLIP is set, then\r
- text will be formatted only based on explicit line breaks and\r
- all pixels which would lie outside the bounding box specified\r
+ text will be formatted based only on explicit line breaks, and\r
+ all pixels that would lie outside the bounding box specified\r
by Width and Height are ignored. The information in the\r
RowInfoArray only describes characters which are at least\r
partially displayed. For the final row, the LineHeight and\r
@retval EFI_OUT_OF_RESOURCES Unable to allocate an output\r
buffer for RowInfoArray or Blt.\r
\r
- @retval EFI_INVALID_PARAMETER The String or Blt or Height or\r
+ @retval EFI_INVALID_PARAMETER The String, or Blt, or Height, or\r
Width was NULL.\r
@retval EFI_INVALID_PARAMETER The Blt or PackageList was NULL.\r
@retval EFI_INVALID_PARAMETER Flags were invalid combination.\r
- @retval EFI_NOT_FOUND The specified PackageList is not in the Database \r
+ @retval EFI_NOT_FOUND The specified PackageList is not in the Database, \r
or the stringid is not in the specified PackageList. \r
\r
**/\r
\r
@param This A pointer to the EFI_HII_FONT_PROTOCOL instance.\r
\r
- @param Char Character to retrieve.\r
+ @param Char The character to retrieve.\r
\r
@param StringInfo Points to the string font and color\r
information or NULL if the string should use\r
the default system font and color.\r
\r
- @param Blt Thus must point to a NULL on entry. A buffer will\r
+ @param Blt This must point to a NULL on entry. A buffer will\r
be allocated to hold the output and the pointer\r
updated on exit. It is the caller's responsibility\r
to free this buffer.\r
\r
- @param Baseline Number of pixels from the bottom of the bitmap\r
+ @param Baseline The number of pixels from the bottom of the bitmap\r
to the baseline.\r
\r
\r
- @retval EFI_SUCCESS Glyph bitmap created.\r
+ @retval EFI_SUCCESS The glyph bitmap created.\r
\r
@retval EFI_OUT_OF_RESOURCES Unable to allocate the output buffer Blt.\r
\r
replaced with the glyph for\r
Unicode character code 0xFFFD.\r
\r
- @retval EFI_INVALID_PARAMETER Blt is NULL or Width is NULL or\r
+ @retval EFI_INVALID_PARAMETER Blt is NULL, or Width is NULL, or\r
Height is NULL\r
\r
\r
to NULL if there are no more matching fonts.\r
\r
@param StringInfoIn Upon entry, points to the font to return\r
- information about. If NULL, then the information about the system default \r
- font will be returned.\r
+ information about. If NULL, then the information \r
+ about the system default font will be returned.\r
\r
@param StringInfoOut Upon return, contains the matching\r
font's information. If NULL, then no\r
projects / mirror_edk2.git / blobdiff