UEFI HII: Merge UEFI HII support changes from branch.

git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@4599 6f19259b-4bc3-4df7-8a09-765794883524

3 files changed, 1021 insertions, 0 deletions

diff --git a/MdeModulePkg/Library/GraphicsLib/Graphics.c b/MdeModulePkg/Library/GraphicsLib/Graphics.c
new file mode 100644
index 0000000000..10b144c944
--- /dev/null
+++ b/MdeModulePkg/Library/GraphicsLib/Graphics.c
@@ -0,0 +1,892 @@
+/**@file

+  Support for Basic Graphics operations.

+

+  BugBug: Currently *.BMP files are supported. This will be replaced

+          when Tiano graphics format is supported.

+

+

+Copyright (c) 2006, Intel Corporation

+All rights reserved. This program and the accompanying materials

+are licensed and made available under the terms and conditions of the BSD License

+which accompanies this distribution.  The full text of the license may be found at

+http://opensource.org/licenses/bsd-license.php

+

+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,

+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

+

+**/

+

+

+#include <PiDxe.h>

+

+#include <Protocol/SimpleTextOut.h>

+#include <Protocol/OEMBadging.h>

+#include <Protocol/ConsoleControl.h>

+#include <Protocol/GraphicsOutput.h>

+#include <Protocol/FirmwareVolume2.h>

+#include <Protocol/UgaDraw.h>

+#include <Protocol/HiiFont.h>

+#include <Protocol/HiiImage.h>

+

+#include <Guid/Bmp.h>

+

+#include <Library/GraphicsLib.h>

+#include <Library/PrintLib.h>

+#include <Library/BaseLib.h>

+#include <Library/MemoryAllocationLib.h>

+#include <Library/UefiBootServicesTableLib.h>

+#include <Library/DebugLib.h>

+#include <Library/BaseMemoryLib.h>

+#include <Library/DxePiLib.h>

+

+STATIC EFI_GRAPHICS_OUTPUT_BLT_PIXEL mEfiColors[16] = {

+  { 0x00, 0x00, 0x00, 0x00 },

+  { 0x98, 0x00, 0x00, 0x00 },

+  { 0x00, 0x98, 0x00, 0x00 },

+  { 0x98, 0x98, 0x00, 0x00 },

+  { 0x00, 0x00, 0x98, 0x00 },

+  { 0x98, 0x00, 0x98, 0x00 },

+  { 0x00, 0x98, 0x98, 0x00 },

+  { 0x98, 0x98, 0x98, 0x00 },

+  { 0x10, 0x10, 0x10, 0x00 },

+  { 0xff, 0x10, 0x10, 0x00 },

+  { 0x10, 0xff, 0x10, 0x00 },

+  { 0xff, 0xff, 0x10, 0x00 },

+  { 0x10, 0x10, 0xff, 0x00 },

+  { 0xf0, 0x10, 0xff, 0x00 },

+  { 0x10, 0xff, 0xff, 0x00 },

+  { 0xff, 0xff, 0xff, 0x00 }

+};

+

+

+EFI_STATUS

+GetGraphicsBitMapFromFV (

+  IN  EFI_GUID      *FileNameGuid,

+  OUT VOID          **Image,

+  OUT UINTN         *ImageSize

+  )

+/*++

+

+Routine Description:

+

+  Return the graphics image file named FileNameGuid into Image and return it's

+  size in ImageSize. All Firmware Volumes (FV) in the system are searched for the

+  file name.

+

+Arguments:

+

+  FileNameGuid  - File Name of graphics file in the FV(s).

+

+  Image         - Pointer to pointer to return graphics image.  If NULL, a

+                  buffer will be allocated.

+

+  ImageSize     - Size of the graphics Image in bytes. Zero if no image found.

+

+

+Returns:

+

+  EFI_SUCCESS          - Image and ImageSize are valid.

+  EFI_BUFFER_TOO_SMALL - Image not big enough. ImageSize has required size

+  EFI_NOT_FOUND        - FileNameGuid not found

+

+--*/

+{

+  return GetGraphicsBitMapFromFVEx (NULL, FileNameGuid, Image, ImageSize);

+}

+

+EFI_STATUS

+GetGraphicsBitMapFromFVEx (

+  IN  EFI_HANDLE    ImageHandle,

+  IN  EFI_GUID      *FileNameGuid,

+  OUT VOID          **Image,

+  OUT UINTN         *ImageSize

+  )

+/*++

+

+Routine Description:

+

+  Return the graphics image file named FileNameGuid into Image and return it's

+  size in ImageSize. All Firmware Volumes (FV) in the system are searched for the

+  file name.

+

+Arguments:

+

+  ImageHandle   - The driver image handle of the caller. The parameter is used to

+                  optimize the loading of the image file so that the FV from which

+                  the driver image is loaded will be tried first. 

+

+  FileNameGuid  - File Name of graphics file in the FV(s).

+

+  Image         - Pointer to pointer to return graphics image.  If NULL, a 

+                  buffer will be allocated.

+

+  ImageSize     - Size of the graphics Image in bytes. Zero if no image found.

+

+

+Returns: 

+

+  EFI_SUCCESS          - Image and ImageSize are valid. 

+  EFI_BUFFER_TOO_SMALL - Image not big enough. ImageSize has required size

+  EFI_NOT_FOUND        - FileNameGuid not found

+

+--*/

+{

+  return PiLibGetSectionFromCurrentFv (

+           FileNameGuid,

+           EFI_SECTION_RAW,

+           0,

+           Image,

+           ImageSize

+           );

+}

+

+

+EFI_STATUS

+ConvertBmpToGopBlt (

+  IN  VOID      *BmpImage,

+  IN  UINTN     BmpImageSize,

+  IN OUT VOID   **GopBlt,

+  IN OUT UINTN  *GopBltSize,

+  OUT UINTN     *PixelHeight,

+  OUT UINTN     *PixelWidth

+  )

+/*++

+

+Routine Description:

+

+  Convert a *.BMP graphics image to a GOP/UGA blt buffer. If a NULL Blt buffer

+  is passed in a GopBlt buffer will be allocated by this routine. If a GopBlt

+  buffer is passed in it will be used if it is big enough.

+

+Arguments:

+

+  BmpImage      - Pointer to BMP file

+

+  BmpImageSize  - Number of bytes in BmpImage

+

+  GopBlt        - Buffer containing GOP version of BmpImage.

+

+  GopBltSize    - Size of GopBlt in bytes.

+

+  PixelHeight   - Height of GopBlt/BmpImage in pixels

+

+  PixelWidth    - Width of GopBlt/BmpImage in pixels

+

+

+Returns:

+

+  EFI_SUCCESS           - GopBlt and GopBltSize are returned.

+  EFI_UNSUPPORTED       - BmpImage is not a valid *.BMP image

+  EFI_BUFFER_TOO_SMALL  - The passed in GopBlt buffer is not big enough.

+                          GopBltSize will contain the required size.

+  EFI_OUT_OF_RESOURCES  - No enough buffer to allocate

+

+--*/

+{

+  UINT8             *Image;

+  UINT8             *ImageHeader;

+  BMP_IMAGE_HEADER  *BmpHeader;

+  BMP_COLOR_MAP     *BmpColorMap;

+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL *BltBuffer;

+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL *Blt;

+  UINTN             BltBufferSize;

+  UINTN             Index;

+  UINTN             Height;

+  UINTN             Width;

+  UINTN             ImageIndex;

+  BOOLEAN           IsAllocated;

+

+  BmpHeader = (BMP_IMAGE_HEADER *) BmpImage;

+  if (BmpHeader->CharB != 'B' || BmpHeader->CharM != 'M') {

+    return EFI_UNSUPPORTED;

+  }

+

+  if (BmpHeader->CompressionType != 0) {

+    return EFI_UNSUPPORTED;

+  }

+

+  //

+  // Calculate Color Map offset in the image.

+  //

+  Image       = BmpImage;

+  BmpColorMap = (BMP_COLOR_MAP *) (Image + sizeof (BMP_IMAGE_HEADER));

+

+  //

+  // Calculate graphics image data address in the image

+  //

+  Image         = ((UINT8 *) BmpImage) + BmpHeader->ImageOffset;

+  ImageHeader   = Image;

+

+  BltBufferSize = BmpHeader->PixelWidth * BmpHeader->PixelHeight * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL);

+  IsAllocated   = FALSE;

+  if (*GopBlt == NULL) {

+    *GopBltSize = BltBufferSize;

+    *GopBlt     = AllocatePool (*GopBltSize);

+    IsAllocated = TRUE;

+    if (*GopBlt == NULL) {

+      return EFI_OUT_OF_RESOURCES;

+    }

+  } else {

+    if (*GopBltSize < BltBufferSize) {

+      *GopBltSize = BltBufferSize;

+      return EFI_BUFFER_TOO_SMALL;

+    }

+  }

+

+  *PixelWidth   = BmpHeader->PixelWidth;

+  *PixelHeight  = BmpHeader->PixelHeight;

+

+  //

+  // Convert image from BMP to Blt buffer format

+  //

+  BltBuffer = *GopBlt;

+  for (Height = 0; Height < BmpHeader->PixelHeight; Height++) {

+    Blt = &BltBuffer[(BmpHeader->PixelHeight - Height - 1) * BmpHeader->PixelWidth];

+    for (Width = 0; Width < BmpHeader->PixelWidth; Width++, Image++, Blt++) {

+      switch (BmpHeader->BitPerPixel) {

+      case 1:

+        //

+        // Convert 1bit BMP to 24-bit color

+        //

+        for (Index = 0; Index < 8 && Width < BmpHeader->PixelWidth; Index++) {

+          Blt->Red    = BmpColorMap[((*Image) >> (7 - Index)) & 0x1].Red;

+          Blt->Green  = BmpColorMap[((*Image) >> (7 - Index)) & 0x1].Green;

+          Blt->Blue   = BmpColorMap[((*Image) >> (7 - Index)) & 0x1].Blue;

+          Blt++;

+          Width++;

+        }

+

+        Blt --;

+        Width --;

+        break;

+

+      case 4:

+        //

+        // Convert BMP Palette to 24-bit color

+        //

+        Index       = (*Image) >> 4;

+        Blt->Red    = BmpColorMap[Index].Red;

+        Blt->Green  = BmpColorMap[Index].Green;

+        Blt->Blue   = BmpColorMap[Index].Blue;

+        if (Width < (BmpHeader->PixelWidth - 1)) {

+          Blt++;

+          Width++;

+          Index       = (*Image) & 0x0f;

+          Blt->Red    = BmpColorMap[Index].Red;

+          Blt->Green  = BmpColorMap[Index].Green;

+          Blt->Blue   = BmpColorMap[Index].Blue;

+        }

+        break;

+

+      case 8:

+        //

+        // Convert BMP Palette to 24-bit color

+        //

+        Blt->Red    = BmpColorMap[*Image].Red;

+        Blt->Green  = BmpColorMap[*Image].Green;

+        Blt->Blue   = BmpColorMap[*Image].Blue;

+        break;

+

+      case 24:

+        Blt->Blue   = *Image++;

+        Blt->Green  = *Image++;

+        Blt->Red    = *Image;

+        break;

+

+      default:

+        if (IsAllocated) {

+          gBS->FreePool (*GopBlt);

+          *GopBlt = NULL;

+        }

+        return EFI_UNSUPPORTED;

+        break;

+      };

+

+    }

+

+    ImageIndex = (UINTN) (Image - ImageHeader);

+    if ((ImageIndex % 4) != 0) {

+      //

+      // Bmp Image starts each row on a 32-bit boundary!

+      //

+      Image = Image + (4 - (ImageIndex % 4));

+    }

+  }

+

+  return EFI_SUCCESS;

+}

+

+

+EFI_STATUS

+LockKeyboards (

+  IN  CHAR16    *Password

+  )

+/*++

+

+Routine Description:

+  Use Console Control Protocol to lock the Console In Spliter virtual handle.

+  This is the ConInHandle and ConIn handle in the EFI system table. All key

+  presses will be ignored until the Password is typed in. The only way to

+  disable the password is to type it in to a ConIn device.

+

+Arguments:

+  Password - Password used to lock ConIn device

+

+

+Returns:

+

+  EFI_SUCCESS     - ConsoleControl has been flipped to graphics and logo

+                          displayed.

+  EFI_UNSUPPORTED - Logo not found

+

+--*/

+{

+  EFI_STATUS                    Status;

+  EFI_CONSOLE_CONTROL_PROTOCOL  *ConsoleControl;

+

+  Status = gBS->LocateProtocol (&gEfiConsoleControlProtocolGuid, NULL, (VOID **) &ConsoleControl);

+  if (EFI_ERROR (Status)) {

+    return EFI_UNSUPPORTED;

+  }

+

+  Status = ConsoleControl->LockStdIn (ConsoleControl, Password);

+  return Status;

+}

+

+

+EFI_STATUS

+EnableQuietBoot (

+  IN  EFI_GUID  *LogoFile

+  )

+/*++

+

+Routine Description:

+

+  Use Console Control to turn off UGA based Simple Text Out consoles from going

+  to the UGA device. Put up LogoFile on every UGA device that is a console

+

+Arguments:

+

+  LogoFile - File name of logo to display on the center of the screen.

+

+

+Returns: 

+

+  EFI_SUCCESS           - ConsoleControl has been flipped to graphics and logo

+                          displayed.

+  EFI_UNSUPPORTED       - Logo not found

+

+--*/

+{

+  return EnableQuietBootEx (LogoFile, NULL);

+}

+

+EFI_STATUS

+EnableQuietBootEx (

+  IN  EFI_GUID    *LogoFile,

+  IN  EFI_HANDLE  ImageHandle

+  )

+/*++

+

+Routine Description:

+

+  Use Console Control to turn off GOP/UGA based Simple Text Out consoles from going

+  to the GOP/UGA device. Put up LogoFile on every GOP/UGA device that is a console

+

+Arguments:

+

+  LogoFile    - File name of logo to display on the center of the screen.

+  ImageHandle - The driver image handle of the caller. The parameter is used to

+                optimize the loading of the logo file so that the FV from which

+                the driver image is loaded will be tried first.

+

+

+Returns: 

+

+  EFI_SUCCESS           - ConsoleControl has been flipped to graphics and logo

+                          displayed.

+  EFI_UNSUPPORTED       - Logo not found

+

+--*/

+{

+  EFI_STATUS                    Status;

+  EFI_CONSOLE_CONTROL_PROTOCOL  *ConsoleControl;

+  EFI_OEM_BADGING_PROTOCOL      *Badging;

+  UINT32                        SizeOfX;

+  UINT32                        SizeOfY;

+  INTN                          DestX;

+  INTN                          DestY;

+  UINT8                         *ImageData;

+  UINTN                         ImageSize;

+  UINTN                         BltSize;

+  UINT32                        Instance;

+  EFI_BADGING_FORMAT            Format;

+  EFI_BADGING_DISPLAY_ATTRIBUTE Attribute;

+  UINTN                         CoordinateX;

+  UINTN                         CoordinateY;

+  UINTN                         Height;

+  UINTN                         Width;

+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL *Blt;

+  EFI_UGA_DRAW_PROTOCOL         *UgaDraw;

+  UINT32                        ColorDepth;

+  UINT32                        RefreshRate;

+  EFI_GRAPHICS_OUTPUT_PROTOCOL  *GraphicsOutput;

+

+  Status = gBS->LocateProtocol (&gEfiConsoleControlProtocolGuid, NULL, (VOID**)&ConsoleControl);

+  if (EFI_ERROR (Status)) {

+    return EFI_UNSUPPORTED;

+  }

+

+  UgaDraw = NULL;

+  //

+  // Try to open GOP first

+  //

+  Status = gBS->HandleProtocol (gST->ConsoleOutHandle, &gEfiGraphicsOutputProtocolGuid, (VOID**)&GraphicsOutput);

+  if (EFI_ERROR (Status)) {

+    GraphicsOutput = NULL;

+    //

+    // Open GOP failed, try to open UGA

+    //

+    Status = gBS->HandleProtocol (gST->ConsoleOutHandle, &gEfiUgaDrawProtocolGuid, (VOID**)&UgaDraw);

+    if (EFI_ERROR (Status)) {

+      return EFI_UNSUPPORTED;

+    }

+  }

+

+  Badging = NULL;

+  Status  = gBS->LocateProtocol (&gEfiOEMBadgingProtocolGuid, NULL, (VOID**)&Badging);

+

+  ConsoleControl->SetMode (ConsoleControl, EfiConsoleControlScreenGraphics);

+

+  if (GraphicsOutput != NULL) {

+    SizeOfX = GraphicsOutput->Mode->Info->HorizontalResolution;

+    SizeOfY = GraphicsOutput->Mode->Info->VerticalResolution;

+  } else {

+    Status = UgaDraw->GetMode (UgaDraw, &SizeOfX, &SizeOfY, &ColorDepth, &RefreshRate);

+    if (EFI_ERROR (Status)) {

+      return EFI_UNSUPPORTED;

+    }

+  }

+

+  Instance = 0;

+  while (1) {

+    ImageData = NULL;

+    ImageSize = 0;

+

+    if (Badging != NULL) {

+      Status = Badging->GetImage (

+                          Badging,

+                          &Instance,

+                          &Format,

+                          &ImageData,

+                          &ImageSize,

+                          &Attribute,

+                          &CoordinateX,

+                          &CoordinateY

+                          );

+      if (EFI_ERROR (Status)) {

+        return Status;

+      }

+

+      //

+      // Currently only support BMP format

+      //

+      if (Format != EfiBadgingFormatBMP) {

+        gBS->FreePool (ImageData);

+        continue;

+      }

+    } else {

+      Status = GetGraphicsBitMapFromFVEx (ImageHandle, LogoFile, (VOID **) &ImageData, &ImageSize);

+      if (EFI_ERROR (Status)) {

+        return EFI_UNSUPPORTED;

+      }

+

+      CoordinateX = 0;

+      CoordinateY = 0;

+      Attribute   = EfiBadgingDisplayAttributeCenter;

+    }

+

+    Blt = NULL;

+    Status = ConvertBmpToGopBlt (

+              ImageData,

+              ImageSize,

+              (VOID**)&Blt,

+              &BltSize,

+              &Height,

+              &Width

+              );

+    if (EFI_ERROR (Status)) {

+      gBS->FreePool (ImageData);

+      if (Badging == NULL) {

+        return Status;

+      } else {

+        continue;

+      }

+    }

+

+    switch (Attribute) {

+    case EfiBadgingDisplayAttributeLeftTop:

+      DestX = CoordinateX;

+      DestY = CoordinateY;

+      break;

+

+    case EfiBadgingDisplayAttributeCenterTop:

+      DestX = (SizeOfX - Width) / 2;

+      DestY = CoordinateY;

+      break;

+

+    case EfiBadgingDisplayAttributeRightTop:

+      DestX = (SizeOfX - Width - CoordinateX);

+      DestY = CoordinateY;;

+      break;

+

+    case EfiBadgingDisplayAttributeCenterRight:

+      DestX = (SizeOfX - Width - CoordinateX);

+      DestY = (SizeOfY - Height) / 2;

+      break;

+

+    case EfiBadgingDisplayAttributeRightBottom:

+      DestX = (SizeOfX - Width - CoordinateX);

+      DestY = (SizeOfY - Height - CoordinateY);

+      break;

+

+    case EfiBadgingDisplayAttributeCenterBottom:

+      DestX = (SizeOfX - Width) / 2;

+      DestY = (SizeOfY - Height - CoordinateY);

+      break;

+

+    case EfiBadgingDisplayAttributeLeftBottom:

+      DestX = CoordinateX;

+      DestY = (SizeOfY - Height - CoordinateY);

+      break;

+

+    case EfiBadgingDisplayAttributeCenterLeft:

+      DestX = CoordinateX;

+      DestY = (SizeOfY - Height) / 2;

+      break;

+

+    case EfiBadgingDisplayAttributeCenter:

+      DestX = (SizeOfX - Width) / 2;

+      DestY = (SizeOfY - Height) / 2;

+      break;

+

+    default:

+      DestX = CoordinateX;

+      DestY = CoordinateY;

+      break;

+    }

+

+    if ((DestX >= 0) && (DestY >= 0)) {

+      if (GraphicsOutput != NULL) {

+        Status = GraphicsOutput->Blt (

+                            GraphicsOutput,

+                            Blt,

+                            EfiBltBufferToVideo,

+                            0,

+                            0,

+                            (UINTN) DestX,

+                            (UINTN) DestY,

+                            Width,

+                            Height,

+                            Width * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL)

+                            );

+      } else {

+        Status = UgaDraw->Blt (

+                            UgaDraw,

+                            (EFI_UGA_PIXEL *) Blt,

+                            EfiUgaBltBufferToVideo,

+                            0,

+                            0,

+                            (UINTN) DestX,

+                            (UINTN) DestY,

+                            Width,

+                            Height,

+                            Width * sizeof (EFI_UGA_PIXEL)

+                            );

+      }

+    }

+

+    gBS->FreePool (ImageData);

+    gBS->FreePool (Blt);

+

+    if (Badging == NULL) {

+      break;

+    }

+  }

+

+  return Status;

+}

+

+

+EFI_STATUS

+DisableQuietBoot (

+  VOID

+  )

+/*++

+

+Routine Description:

+

+  Use Console Control to turn on GOP/UGA based Simple Text Out consoles. The GOP/UGA

+  Simple Text Out screens will now be synced up with all non GOP/UGA output devices

+

+Arguments:

+

+  NONE

+

+Returns:

+

+  EFI_SUCCESS           - GOP/UGA devices are back in text mode and synced up.

+  EFI_UNSUPPORTED       - Logo not found

+

+--*/

+{

+  EFI_STATUS                    Status;

+  EFI_CONSOLE_CONTROL_PROTOCOL  *ConsoleControl;

+

+  Status = gBS->LocateProtocol (&gEfiConsoleControlProtocolGuid, NULL, (VOID **) &ConsoleControl);

+  if (EFI_ERROR (Status)) {

+    return EFI_UNSUPPORTED;

+  }

+

+  return ConsoleControl->SetMode (ConsoleControl, EfiConsoleControlScreenText);

+}

+

+UINTN

+_IPrint (

+  IN EFI_GRAPHICS_OUTPUT_PROTOCOL     *GraphicsOutput,

+  IN EFI_UGA_DRAW_PROTOCOL            *UgaDraw,

+  IN EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL     *Sto,

+  IN UINTN                            X,

+  IN UINTN                            Y,

+  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL    *Foreground,

+  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL    *Background,

+  IN CHAR16                           *fmt,

+  IN VA_LIST                          args

+  )

+/*++

+

+Routine Description:

+

+  Display string worker for: Print, PrintAt, IPrint, IPrintAt

+

+Arguments:

+

+  GraphicsOutput  - Graphics output protocol interface

+

+  UgaDraw         - UGA draw protocol interface

+  

+  Sto             - Simple text out protocol interface

+  

+  X               - X coordinate to start printing

+  

+  Y               - Y coordinate to start printing

+  

+  Foreground      - Foreground color

+  

+  Background      - Background color

+  

+  fmt             - Format string

+  

+  args            - Print arguments

+

+Returns: 

+

+  EFI_SUCCESS             -  success

+  EFI_OUT_OF_RESOURCES    -  out of resources

+

+--*/

+{

+  VOID                           *Buffer;

+  EFI_STATUS                     Status;

+  UINTN                          Index;

+  CHAR16                         *UnicodeWeight;

+  UINT32                         HorizontalResolution;

+  UINT32                         VerticalResolution;

+  UINT32                         ColorDepth;

+  UINT32                         RefreshRate;

+  UINTN                          BufferLen;

+  UINTN                          LineBufferLen;

+  EFI_HII_FONT_PROTOCOL          *HiiFont;

+  EFI_IMAGE_OUTPUT               *Blt;

+  EFI_FONT_DISPLAY_INFO          *FontInfo;  

+

+  //

+  // For now, allocate an arbitrarily long buffer

+  //

+  Buffer = AllocateZeroPool (0x10000);

+  if (Buffer == NULL) {

+    return EFI_OUT_OF_RESOURCES;

+  }

+

+  if (GraphicsOutput != NULL) {

+    HorizontalResolution = GraphicsOutput->Mode->Info->HorizontalResolution;

+    VerticalResolution = GraphicsOutput->Mode->Info->VerticalResolution;

+  } else {

+    UgaDraw->GetMode (UgaDraw, &HorizontalResolution, &VerticalResolution, &ColorDepth, &RefreshRate);

+  }

+  ASSERT ((HorizontalResolution != 0) && (VerticalResolution !=0)); 

+

+  Blt      = NULL;

+  FontInfo = NULL;

+  ASSERT (GraphicsOutput != NULL);

+  Status = gBS->LocateProtocol (&gEfiHiiFontProtocolGuid, NULL, (VOID **) &HiiFont);

+  if (EFI_ERROR (Status)) {

+    goto Error;

+  }  

+

+  UnicodeVSPrint (Buffer, 0x10000, fmt, args);

+  

+  UnicodeWeight = (CHAR16 *) Buffer;

+

+  for (Index = 0; UnicodeWeight[Index] != 0; Index++) {

+    if (UnicodeWeight[Index] == CHAR_BACKSPACE ||

+        UnicodeWeight[Index] == CHAR_LINEFEED  ||

+        UnicodeWeight[Index] == CHAR_CARRIAGE_RETURN) {

+      UnicodeWeight[Index] = 0;

+    }

+  }

+

+  BufferLen = StrLen (Buffer);

+ 

+

+  LineBufferLen = sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL) * HorizontalResolution * EFI_GLYPH_HEIGHT;

+  if (EFI_GLYPH_WIDTH * EFI_GLYPH_HEIGHT * sizeof(EFI_GRAPHICS_OUTPUT_BLT_PIXEL) * BufferLen > LineBufferLen) {

+     Status = EFI_INVALID_PARAMETER;

+     goto Error;

+  }

+

+  Blt = (EFI_IMAGE_OUTPUT *) AllocateZeroPool (sizeof (EFI_IMAGE_OUTPUT));

+  if (Blt == NULL) {

+    Status = EFI_OUT_OF_RESOURCES;

+    goto Error;

+  }

+

+  Blt->Width        = (UINT16) (HorizontalResolution);

+  Blt->Height       = (UINT16) (VerticalResolution);

+  Blt->Image.Screen = GraphicsOutput;

+   

+  FontInfo = (EFI_FONT_DISPLAY_INFO *) AllocateZeroPool (sizeof (EFI_FONT_DISPLAY_INFO));

+  if (FontInfo == NULL) {

+    Status = EFI_OUT_OF_RESOURCES;

+    goto Error;

+  }

+  if (Foreground != NULL) {

+    CopyMem (&FontInfo->ForegroundColor, Foreground, sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL));

+  } else {

+    CopyMem (

+      &FontInfo->ForegroundColor, 

+      &mEfiColors[Sto->Mode->Attribute & 0x0f], 

+      sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL)

+      );

+  }

+  if (Background != NULL) {

+    CopyMem (&FontInfo->BackgroundColor, Background, sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL));

+  } else {

+    CopyMem (

+      &FontInfo->BackgroundColor, 

+      &mEfiColors[Sto->Mode->Attribute >> 4], 

+      sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL)

+      );

+  }

+

+  Status = HiiFont->StringToImage (

+                       HiiFont,

+                       EFI_HII_IGNORE_IF_NO_GLYPH | EFI_HII_DIRECT_TO_SCREEN,

+                       Buffer,

+                       FontInfo,

+                       &Blt,

+                       X,

+                       Y,

+                       NULL,

+                       NULL,

+                       NULL

+                       );

+  

+

+Error:

+  SafeFreePool (Blt);

+  SafeFreePool (FontInfo);

+  gBS->FreePool (Buffer);

+  return Status;

+}

+

+UINTN

+PrintXY (

+  IN UINTN                            X,

+  IN UINTN                            Y,

+  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL    *ForeGround, OPTIONAL

+  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL    *BackGround, OPTIONAL

+  IN CHAR16                           *Fmt,

+  ...

+  )

+/*++

+

+Routine Description:

+

+    Prints a formatted unicode string to the default console

+

+Arguments:

+

+    X           - X coordinate to start printing

+    

+    Y           - Y coordinate to start printing

+    

+    ForeGround  - Foreground color

+    

+    BackGround  - Background color

+

+    Fmt         - Format string

+

+    ...         - Print arguments

+

+Returns:

+

+    Length of string printed to the console

+

+--*/

+{

+  EFI_HANDLE                    Handle;

+  EFI_GRAPHICS_OUTPUT_PROTOCOL  *GraphicsOutput;

+  EFI_UGA_DRAW_PROTOCOL         *UgaDraw;

+  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL  *Sto;

+  EFI_STATUS                    Status;

+  VA_LIST                       Args;

+

+  VA_START (Args, Fmt);

+

+  Handle = gST->ConsoleOutHandle;

+

+  Status = gBS->HandleProtocol (

+                  Handle,

+                  &gEfiGraphicsOutputProtocolGuid,

+                  (VOID**)&GraphicsOutput

+                  );

+

+  UgaDraw = NULL;

+  if (EFI_ERROR (Status)) {

+    GraphicsOutput = NULL;

+

+    Status = gBS->HandleProtocol (

+                    Handle,

+                    &gEfiUgaDrawProtocolGuid,

+                    (VOID**)&UgaDraw

+                    );

+

+    if (EFI_ERROR (Status)) {

+      return Status;

+    }

+  }

+

+  Status = gBS->HandleProtocol (

+                  Handle,

+                  &gEfiSimpleTextOutProtocolGuid,

+                  (VOID**)&Sto

+                  );

+

+  if (EFI_ERROR (Status)) {

+    return Status;

+  }

+

+  return _IPrint (GraphicsOutput, UgaDraw, Sto, X, Y, ForeGround, BackGround, Fmt, Args);

+}

+

diff --git a/MdeModulePkg/Library/GraphicsLib/GraphicsLib.inf b/MdeModulePkg/Library/GraphicsLib/GraphicsLib.inf
new file mode 100644
index 0000000000..c7cb0afb72
--- /dev/null
+++ b/MdeModulePkg/Library/GraphicsLib/GraphicsLib.inf
@@ -0,0 +1,57 @@
+#/** @file

+# Graphics Library for UEFI drivers

+#

+# This library provides supports for basic graphic functions.

+# Copyright (c) 2006 - 2007, Intel Corporation.

+#

+#  All rights reserved. This program and the accompanying materials

+#  are licensed and made available under the terms and conditions of the BSD License

+#  which accompanies this distribution. The full text of the license may be found at

+#  http://opensource.org/licenses/bsd-license.php

+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,

+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

+#

+#

+#**/

+

+[Defines]

+  INF_VERSION                    = 0x00010005

+  BASE_NAME                      = EdkGraphicsLib

+  FILE_GUID                      = 08c1a0e4-1208-47f8-a2c5-f42eabee653a

+  MODULE_TYPE                    = DXE_DRIVER

+  VERSION_STRING                 = 1.0

+  LIBRARY_CLASS                  = GraphicsLib|DXE_DRIVER DXE_RUNTIME_DRIVER DXE_SAL_DRIVER DXE_SMM_DRIVER UEFI_APPLICATION UEFI_DRIVER

+  EDK_RELEASE_VERSION            = 0x00020000

+  EFI_SPECIFICATION_VERSION      = 0x00020000

+

+

+#

+# The following information is for reference only and not required by the build tools.

+#

+#  VALID_ARCHITECTURES           = IA32 X64 IPF EBC

+#

+

+[Sources.common]

+  Graphics.c

+

+[Packages]

+  MdePkg/MdePkg.dec

+  MdeModulePkg/MdeModulePkg.dec

+

+[LibraryClasses]

+  UefiBootServicesTableLib

+  MemoryAllocationLib

+  BaseLib

+  PrintLib

+  DebugLib

+  DxePiLib

+  BaseMemoryLib

+

+[Protocols]

+  gEfiSimpleTextOutProtocolGuid                 # PROTOCOL ALWAYS_CONSUMED

+  gEfiGraphicsOutputProtocolGuid                # PROTOCOL ALWAYS_CONSUMED

+  gEfiUgaDrawProtocolGuid                       # PROTOCOL ALWAYS_CONSUMED

+  gEfiConsoleControlProtocolGuid                # PROTOCOL ALWAYS_CONSUMED

+  gEfiFirmwareVolume2ProtocolGuid                # PROTOCOL ALWAYS_CONSUMED

+  gEfiOEMBadgingProtocolGuid                    # PROTOCOL ALWAYS_CONSUMED

+  gEfiHiiFontProtocolGuid                       # PROTOCOL ALWAYS_CONSUMED   
\ No newline at end of file
diff --git a/MdeModulePkg/Library/GraphicsLib/GraphicsLib.msa b/MdeModulePkg/Library/GraphicsLib/GraphicsLib.msa
new file mode 100644
index 0000000000..2007ba062e
--- /dev/null
+++ b/MdeModulePkg/Library/GraphicsLib/GraphicsLib.msa
@@ -0,0 +1,72 @@
+<?xml version="1.0" encoding="UTF-8"?>

+<ModuleSurfaceArea xmlns="http://www.TianoCore.org/2006/Edk2.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

+  <MsaHeader>

+    <ModuleName>EdkGraphicsLib</ModuleName>

+    <ModuleType>DXE_DRIVER</ModuleType>

+    <GuidValue>08c1a0e4-1208-47f8-a2c5-f42eabee653a</GuidValue>

+    <Version>1.0</Version>

+    <Abstract>Graphics Library for UEFI drivers</Abstract>

+    <Description>This library provides supports for basic graphic functions.</Description>

+    <Copyright>Copyright (c) 2006 - 2007, Intel Corporation.</Copyright>

+    <License>All rights reserved. This program and the accompanying materials
+      are licensed and made available under the terms and conditions of the BSD License
+      which accompanies this distribution.  The full text of the license may be found at
+      http://opensource.org/licenses/bsd-license.php
+      THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+      WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.</License>

+    <Specification>FRAMEWORK_BUILD_PACKAGING_SPECIFICATION   0x00000052</Specification>

+  </MsaHeader>

+  <ModuleDefinitions>

+    <SupportedArchitectures>IA32 X64 IPF EBC</SupportedArchitectures>

+    <BinaryModule>false</BinaryModule>

+    <OutputFileBasename>EdkGraphicsLib</OutputFileBasename>

+  </ModuleDefinitions>

+  <LibraryClassDefinitions>

+    <LibraryClass Usage="ALWAYS_PRODUCED" SupModuleList="DXE_DRIVER DXE_RUNTIME_DRIVER DXE_SAL_DRIVER DXE_SMM_DRIVER UEFI_APPLICATION UEFI_DRIVER">

+      <Keyword>EdkGraphicsLib</Keyword>

+    </LibraryClass>

+    <LibraryClass Usage="ALWAYS_CONSUMED">

+      <Keyword>PrintLib</Keyword>

+    </LibraryClass>

+    <LibraryClass Usage="ALWAYS_CONSUMED">

+      <Keyword>BaseLib</Keyword>

+    </LibraryClass>

+    <LibraryClass Usage="ALWAYS_CONSUMED">

+      <Keyword>MemoryAllocationLib</Keyword>

+    </LibraryClass>

+    <LibraryClass Usage="ALWAYS_CONSUMED">

+      <Keyword>UefiBootServicesTableLib</Keyword>

+    </LibraryClass>

+  </LibraryClassDefinitions>

+  <SourceFiles>

+    <Filename>Graphics.c</Filename>

+  </SourceFiles>

+  <PackageDependencies>

+    <Package PackageGuid="5e0e9358-46b6-4ae2-8218-4ab8b9bbdcec"/>

+    <Package PackageGuid="68169ab0-d41b-4009-9060-292c253ac43d"/>

+  </PackageDependencies>

+  <Protocols>

+    <Protocol Usage="ALWAYS_CONSUMED">

+      <ProtocolCName>gEfiOEMBadgingProtocolGuid</ProtocolCName>

+    </Protocol>

+    <Protocol Usage="ALWAYS_CONSUMED">

+      <ProtocolCName>gEfiFirmwareVolumeProtocolGuid</ProtocolCName>

+    </Protocol>

+    <Protocol Usage="ALWAYS_CONSUMED">

+      <ProtocolCName>gEfiConsoleControlProtocolGuid</ProtocolCName>

+    </Protocol>

+    <Protocol Usage="ALWAYS_CONSUMED">

+      <ProtocolCName>gEfiUgaDrawProtocolGuid</ProtocolCName>

+    </Protocol>

+    <Protocol Usage="ALWAYS_CONSUMED">

+      <ProtocolCName>gEfiGraphicsOutputProtocolGuid</ProtocolCName>

+    </Protocol>

+    <Protocol Usage="ALWAYS_CONSUMED">

+      <ProtocolCName>gEfiSimpleTextOutProtocolGuid</ProtocolCName>

+    </Protocol>

+  </Protocols>

+  <Externs>

+    <Specification>EFI_SPECIFICATION_VERSION 0x00020000</Specification>

+    <Specification>EDK_RELEASE_VERSION 0x00020000</Specification>

+  </Externs>

+</ModuleSurfaceArea>
\ No newline at end of file