做一个 UEFI 下的 EasyX 图形库(14)

增加ROP2 modes 功能

/**
  设置光栅操作模式(ROP2)。

  @param[in]  Mode  光栅操作模式。
**/
VOID
EFIAPI
SetROP2 (
  IN INT32  Mode
  );

SetROP2 是一个 光栅操作模式(Raster Operation,ROP) 控制函数,用于指定在绘制图形时,源像素和目标像素之间的逻辑组合方式。

功能说明

在没有 ROP2 的图形库中,绘制操作总是直接覆盖背景(COPY 模式)。而 ROP2 模式允许多种像素合成方式,实现特殊的绘制效果。

支持的模式

模式值常量名效果示例应用
12R2_COPYPEN源像素直接覆盖目标(正常复制,默认模式)普通绘图
6R2_XORPEN源像素与目标像素进行 XOR 异或操作,结果显示互补色透明效果、可擦除绘图、橡皮筋选择框
0R2_BLACK无论源像素什么颜色,总是绘制黑色强制黑色绘制
15R2_WHITE无论源像素什么颜色,总是绘制白色强制白色绘制

实际应用场景

  1. 透明绘制:用 XOR 模式在图像上绘制临时标记,再绘制一次可恢复原状
  2. 高亮选择:用 XOR 绘制选择框,不会永久改变背景
  3. 可擦除绘图:用 XOR 模式手绘,两次绘制相同位置可消除
  4. 特殊效果:结合不同模式产生各种视觉效果

测试代码:

/** @file
  EasyX UEFI Graphics Demo: SetROP2 Test

  Demonstrates ROP2 (Raster Operation Mode) functionality.
  Shows how different ROP2 modes affect pixel drawing operations.
**/

#include <Uefi.h>
#include <Library/UefiBootServicesTableLib.h>
#include <Library/UefiLib.h>
#include <Library/PrintLib.h>
#include "easyx.h"

/**
  程序入口。
**/
EFI_STATUS
EFIAPI
UefiMain (
  IN EFI_HANDLE        ImageHandle,
  IN EFI_SYSTEM_TABLE  *SystemTable
  )
{
  EFI_STATUS  Status;
  INT32       W, H;
  ExMessage   Msg;
  BOOLEAN     Running;
  INT32       i, x, y;

  //
  // Initialize graphics device (1024x768).
  //
  Status = initgraph (1024, 768);
  if (EFI_ERROR (Status)) {
    Print (L"initgraph failed: %r\n", Status);
    return Status;
  }

  W = getwidth ();
  H = getheight ();

  //
  // Batch drawing.
  //
  BeginBatchDraw ();

  //
  // Fill background with dark color.
  //
  setbkcolor (RGB (30, 30, 60));
  cleardevice ();

  //
  // Title
  //
  settextcolor (YELLOW);
  settextstyle (24, 12);
  outtextxy (300, 20, "SetROP2 Mode Test");

  settextcolor (LIGHTCYAN);
  settextstyle (12, 6);
  outtextxy (50, 60, "Different ROP2 modes applied to draw shapes on colored backgrounds");

  // =========================================================================
  // Test Row 1: Fill rectangles with different ROP2 modes
  // =========================================================================
  
  // Background 1: Red background, fill small rect with COPYPEN
  setfillcolor (RED);
  solidrectangle (50, 120, 200, 270);
  settextcolor (WHITE);
  outtextxy (75, 130, "RED BG");

  // R2_COPYPEN (12) - Normal copy (white filled rect)
  SetROP2 (12);
  setlinecolor (WHITE);
  setfillcolor (WHITE);
  settextcolor (WHITE);
  outtextxy (70, 145, "COPY");
  fillrectangle (100, 200, 150, 250);

  // Background 2: Green background, fill small rect with XOR
  setfillcolor (LIGHTGREEN);
  solidrectangle (250, 120, 400, 270);
  settextcolor (BLACK);
  outtextxy (280, 130, "GREEN BG");

  // R2_XORPEN (6) - XOR mode: white XOR green = purple/magenta
  SetROP2 (6);
  setlinecolor (WHITE);
  setfillcolor (WHITE);
  settextcolor (BLACK);
  outtextxy (280, 145, "XOR");
  fillrectangle (290, 200, 360, 250);

  // Background 3: Blue background, fill small rect with BLACK
  setfillcolor (LIGHTBLUE);
  solidrectangle (450, 120, 600, 270);
  settextcolor (WHITE);
  outtextxy (480, 130, "BLUE BG");

  // R2_BLACK (0) - Always draws black
  SetROP2 (0);
  setlinecolor (WHITE);
  setfillcolor (WHITE);
  settextcolor (WHITE);
  outtextxy (480, 145, "BLACK");
  fillrectangle (490, 200, 560, 250);

  // Background 4: White background, fill small rect with WHITE
  setfillcolor (WHITE);
  solidrectangle (650, 120, 800, 270);
  settextcolor (BLACK);
  outtextxy (680, 130, "WHITE BG");

  // R2_WHITE (15) - Always draws white
  SetROP2 (15);
  setlinecolor (BLACK);
  setfillcolor (BLACK);
  settextcolor (BLACK);
  outtextxy (680, 145, "WHITE");
  fillrectangle (690, 200, 760, 250);

  // =========================================================================
  // Test Row 2: Rectangles with gradient backgrounds
  // =========================================================================

  // Create gradient background: Red to Blue horizontally
  for (i = 0; i < 150; i++) {
    UINT32  Ratio = (i * 256) / 150;
    UINT8   R = (UINT8)(255 - (255 * Ratio / 256));
    UINT8   G = 0;
    UINT8   B = (UINT8)(255 * Ratio / 256);
    setlinecolor (RGB (R, G, B));
    line (50 + i, 320, 50 + i, 420);
  }

  settextcolor (YELLOW);
  outtextxy (50, 430, "Gradient: RED -> BLUE");

  // Draw rectangles with different ROP2 modes on gradient
  // Mode 12: COPY
  SetROP2 (12);
  setlinecolor (WHITE);
  rectangle (70, 345, 110, 395);
  settextcolor (WHITE);
  outtextxy (75, 405, "COPY");

  // Mode 6: XOR
  SetROP2 (6);
  setlinecolor (WHITE);
  rectangle (150, 345, 190, 395);
  settextcolor (WHITE);
  outtextxy (155, 405, "XOR");

  // Mode 0: BLACK
  SetROP2 (0);
  setlinecolor (WHITE);
  rectangle (230, 345, 270, 395);
  settextcolor (WHITE);
  outtextxy (235, 405, "BLACK");

  // Mode 15: WHITE
  SetROP2 (15);
  setlinecolor (BLACK);
  rectangle (310, 345, 350, 395);
  settextcolor (WHITE);
  outtextxy (315, 405, "WHITE");

  // =========================================================================
  // Test Row 3: Lines on checker pattern background
  // =========================================================================

  // Draw checker pattern
  for (y = 480; y < 650; y += 20) {
    for (x = 50; x < 400; x += 20) {
      if (((x / 20) + (y / 20)) % 2 == 0) {
        setfillcolor (DARKGRAY);
      } else {
        setfillcolor (LIGHTGRAY);
      }
      solidrectangle (x, y, x + 19, y + 19);
    }
  }

  settextcolor (YELLOW);
  outtextxy (50, 460, "Lines on Checker Pattern");

  // Draw lines with different ROP2 modes
  // Mode 12: COPY
  SetROP2 (12);
  setlinecolor (RED);
  setlinestyle (PS_SOLID, 2);
  line (70, 500, 130, 600);
  line (75, 500, 135, 600);

  // Mode 6: XOR
  SetROP2 (6);
  setlinecolor (RED);
  setlinestyle (PS_SOLID, 2);
  line (160, 500, 220, 600);
  line (165, 500, 225, 600);

  // Mode 0: BLACK
  SetROP2 (0);
  setlinecolor (RED);  // Will be ignored, black will be drawn
  setlinestyle (PS_SOLID, 2);
  line (250, 500, 310, 600);
  line (255, 500, 315, 600);

  // Mode 15: WHITE
  SetROP2 (15);
  setlinecolor (BLACK);  // Will be ignored, white will be drawn
  setlinestyle (PS_SOLID, 2);
  line (340, 500, 400, 600);
  line (345, 500, 405, 600);

  // Labels for Row 3
  settextcolor (WHITE);
  settextstyle (8, 4);
  outtextxy (75, 615, "COPY");
  outtextxy (165, 615, "XOR");
  outtextxy (260, 615, "BLACK");
  outtextxy (350, 615, "WHITE");

  // =========================================================================
  // Legend and Instructions
  // =========================================================================
  settextcolor (LIGHTGREEN);
  settextstyle (12, 6);
  outtextxy (500, 490, "ROP2 Modes:");

  settextcolor (LIGHTCYAN);
  outtextxy (500, 520, "12 (COPYPEN) - Normal copy");
  outtextxy (500, 540, "6 (XORPEN) - XOR with destination");
  outtextxy (500, 560, "0 (BLACK) - Always black");
  outtextxy (500, 580, "15 (WHITE) - Always white");

  settextcolor (RGB (255, 255, 200));
  outtextxy (500, 620, "Press ESC to exit");

  // Restore default ROP2 mode
  SetROP2 (12);

  // =========================================================================
  // Flush and enter main message loop
  // =========================================================================
  EndBatchDraw ();

  Running = TRUE;

  while (Running) {
    getmessage (&Msg, EX_KEY);

    if (Msg.message == WM_KEYDOWN && Msg.vkcode == VK_ESCAPE) {
      Running = FALSE;
    }
  }

  //
  // Close graphics device.
  //
  closegraph ();

  //
  // Restore text console.
  //
  gST->ConOut->ClearScreen (gST->ConOut);
  Print (L"SetROP2 Demo Complete\n");

  return EFI_SUCCESS;
}

运行结果:

完整的代码和编译后的 EFI :

做一个 UEFI 下的 EasyX 图形库(13)

继续增加 EasyX的功能,这次增加了如下功能:

/**
  旋转图像。

  @param[out]  DstImg   目标图像(使用前须清零)。
  @param[in]   SrcImg   源图像。
  @param[in]   Angle    旋转角度(0-359,单位度,顺时针为正)。

  @retval EFI_SUCCESS            旋转成功。
  @retval EFI_INVALID_PARAMETER  参数非法。
  @retval EFI_OUT_OF_RESOURCES   分配失败。
**/
EFI_STATUS
EFIAPI
rotateimage (
  OUT IMAGE        *DstImg,
  IN  CONST IMAGE  *SrcImg,
  IN  INT32        Angle
  );

/**
  翻转图像(水平或竖直)。

  @param[out]  DstImg    目标图像(使用前须清零)。
  @param[in]   SrcImg    源图像。
  @param[in]   Direction 翻转方向(0=水平翻转,1=竖直翻转)。

  @retval EFI_SUCCESS            翻转成功。
  @retval EFI_INVALID_PARAMETER  参数非法。
  @retval EFI_OUT_OF_RESOURCES   分配失败。
**/
EFI_STATUS
EFIAPI
flipimage (
  OUT IMAGE        *DstImg,
  IN  CONST IMAGE  *SrcImg,
  IN  INT32        Direction
  );

/**
  在指定角度绘制图像(绕图像中心旋转)。

  @param[in]  X      图像中心的 X 坐标。
  @param[in]  Y      图像中心的 Y 坐标。
  @param[in]  Img    要绘制的图像。
  @param[in]  Angle  旋转角度(0-359,单位度)。
**/
VOID
EFIAPI
putimageatangle (
  IN INT32        X,
  IN INT32        Y,
  IN CONST IMAGE  *Img,
  IN INT32        Angle
  );

/**
  设置渐变填充参数(BS_GRADIENT 风格)。

  @param[in]  Color1  渐变起始颜色。
  @param[in]  Color2  渐变结束颜色。
  @param[in]  Type    渐变类型(0=水平,1=竖直,2=从中心向外圆形)。
**/
VOID
EFIAPI
setgradientfill (
  IN COLORREF  Color1,
  IN COLORREF  Color2,
  IN INT32     Type
  );

/**
  获取当前 getpixel 的值。

  @param[in]  X  像素 X 坐标。
  @param[in]  Y  像素 Y 坐标。

  @return 像素颜色值(COLORREF 格式)。
**/

运行结果:

完整的代码和编译后的 EFI 在下面下载:

Windows 10 写字板程序

最近在一台新装Windows 11 的电脑上打算编辑一篇文章,牵扯到的图文混排,忽然发现Windows中竟然没有了“写字板”程序。经过研究发现竟然是微软在最新的Windows上移除了这个程序(听说未来记事本会有类似的功能,但是目前测试发现还没有)。

写字板的特别功能在于可以方便的插入图片,编辑功能完全可以满足日常使用,此外可以将文件直接打包在 rtf 文件中,非常方便记录保存。

经过研究从 Windows10 中提取了“记事本”程序放在这里,有需要做简单图文混排的朋友可以下载使用。

做一个 UEFI 下的 EasyX 图形库(12)

增加一个缩放图像功能函数:

/**
  缩放图像(双线性插值或最近邻)。

  @param[out]  DstImg   目标图像(使用前须清零)。
  @param[in]   SrcImg   源图像。
  @param[in]   DstWidth 目标宽度(像素,>0)。
  @param[in]   DstHeight 目标高度(像素,>0)。

  @retval EFI_SUCCESS            缩放成功。
  @retval EFI_INVALID_PARAMETER  参数非法。
  @retval EFI_OUT_OF_RESOURCES   分配失败。

  说明:
  - 采用双线性插值,质量好但计算量较大(考虑大图像缩放可能较慢)。
  - 源图像宽高为 0 时返回错误。
  - 目标宽高与源宽高相同则直接复制。
**/
EFI_STATUS
EFIAPI
scaleimage (
  OUT IMAGE        *DstImg,
  IN  CONST IMAGE  *SrcImg,
  IN  INT32        DstWidth,
  IN  INT32        DstHeight
  );

重新写了一个Demo,只演示这个功能,代码如下:

/** @file
  EasyX UEFI 图形库演示程序:scaleimage 图像缩放演示。

  演示 scaleimage 函数的双线性插值缩放能力。
**/

#include <Uefi.h>
#include <Library/UefiBootServicesTableLib.h>
#include <Library/UefiLib.h>
#include <Library/PrintLib.h>
#include "easyx.h"

/**
  程序入口。
**/
EFI_STATUS
EFIAPI
UefiMain (
  IN EFI_HANDLE        ImageHandle,
  IN EFI_SYSTEM_TABLE  *SystemTable
  )
{
  EFI_STATUS  Status;
  INT32       W;
  INT32       H;
  IMAGE       Sprite;
  IMAGE       Scaled50;
  IMAGE       Scaled75;
  IMAGE       Scaled150;
  IMAGE       Scaled200;
  ExMessage   Msg;
  BOOLEAN     Running;

  //
  // 初始化所有 IMAGE 结构。
  //
  Sprite.Width = 0;
  Sprite.Height = 0;
  Sprite.Buffer = NULL;

  Scaled50.Width = 0;
  Scaled50.Height = 0;
  Scaled50.Buffer = NULL;

  Scaled75.Width = 0;
  Scaled75.Height = 0;
  Scaled75.Buffer = NULL;

  Scaled150.Width = 0;
  Scaled150.Height = 0;
  Scaled150.Buffer = NULL;

  Scaled200.Width = 0;
  Scaled200.Height = 0;
  Scaled200.Buffer = NULL;

  //
  // 初始化绘图设备(1024×768)。
  //
  Status = initgraph (1024, 768);
  if (EFI_ERROR (Status)) {
    Print (L"initgraph 失败: %r\n", Status);
    return Status;
  }

  W = getwidth ();
  H = getheight ();

  //
  // 批量绘图。
  //
  BeginBatchDraw ();

  //
  // 背景填充深蓝。
  //
  setbkcolor (RGB (16, 16, 48));
  cleardevice ();

  //
  // 在内存中创建一个 100×100 的测试图像(彩色圆+文字)。
  //
  if (!EFI_ERROR (CreateImage (&Sprite, 100, 100))) {
    SetWorkingImage (&Sprite);

    //
    // 绘制背景
    //
    setbkcolor (RGB (20, 30, 60));
    cleardevice ();

    //
    // 绘制彩色圆(中心)
    //
    setfillcolor (RGB (255, 100, 50));
    setlinecolor (WHITE);
    fillcircle (50, 40, 30);

    //
    // 绘制外圆
    //
    setlinecolor (YELLOW);
    setlinestyle (PS_SOLID, 2);
    circle (50, 40, 35);

    //
    // 绘制文字
    //
    settextcolor (LIGHTGREEN);
    settextstyle (20, 10);
    setbkmode (TRANSPARENT);
    outtextxy (15, 75, "Scale");

    //
    // 恢复到屏幕
    //
    SetWorkingImage (NULL);

    //
    // 标题
    //
    setbkmode (TRANSPARENT);
    settextcolor (WHITE);
    settextstyle (32, 16);
    outtextxy (300, 30, "Image Scale Demo");

    settextcolor (LIGHTCYAN);
    settextstyle (16, 8);
    outtextxy (300, 80, "Original: 100x100");
    putimage (300, 110, &Sprite);

    //
    // 50% 缩放(50×50)
    //
    if (!EFI_ERROR (scaleimage (&Scaled50, &Sprite, 50, 50))) {
      setlinecolor (LIGHTGREEN);
      setlinestyle (PS_DASH, 1);
      rectangle (470, 110, 520, 160);
      settextcolor (LIGHTGREEN);
      outtextxy (450, 85, "50%: 50x50");
      putimage (470, 110, &Scaled50);
      DeleteImage (&Scaled50);
    }

    //
    // 75% 缩放(75×75)
    //
    if (!EFI_ERROR (scaleimage (&Scaled75, &Sprite, 75, 75))) {
      setlinecolor (YELLOW);
      setlinestyle (PS_DASH, 1);
      rectangle (640, 110, 715, 185);
      settextcolor (YELLOW);
      outtextxy (630, 85, "75%: 75x75");
      putimage (640, 110, &Scaled75);
      DeleteImage (&Scaled75);
    }

    //
    // 150% 缩放(150×150)
    //
    if (!EFI_ERROR (scaleimage (&Scaled150, &Sprite, 150, 150))) {
      setlinecolor (LIGHTMAGENTA);
      setlinestyle (PS_DASH, 1);
      rectangle (300, 350, 450, 500);
      settextcolor (LIGHTMAGENTA);
      outtextxy (290, 320, "150%: 150x150");
      putimage (300, 350, &Scaled150);
      DeleteImage (&Scaled150);
    }

    //
    // 200% 缩放(200×200)
    //
    if (!EFI_ERROR (scaleimage (&Scaled200, &Sprite, 200, 200))) {
      setlinecolor (LIGHTCYAN);
      setlinestyle (PS_DASH, 1);
      rectangle (550, 280, 750, 480);
      settextcolor (LIGHTCYAN);
      outtextxy (540, 250, "200%: 200x200");
      putimage (550, 280, &Scaled200);
      DeleteImage (&Scaled200);
    }

    DeleteImage (&Sprite);
  }

  //
  // 使用说明
  //
  setbkmode (TRANSPARENT);
  settextcolor (LIGHTGREEN);
  settextstyle (14, 7);
  outtextxy (50, 680, "Algorithm: Bilinear Interpolation (16.16 fixed-point arithmetic)");
  outtextxy (50, 700, "Press ESC to exit");

  //
  // 一次性刷新。
  //
  EndBatchDraw ();

  //
  // 等待 ESC 键退出。
  //
  Running = TRUE;
  while (Running) {
    getmessage (&Msg, EX_KEY);

    if (Msg.message == WM_KEYDOWN && Msg.vkcode == VK_ESCAPE) {
      Running = FALSE;
    }
  }

  //
  // 关闭设备。
  //
  closegraph ();

  //
  // 恢复文本控制台。
  //
  gST->ConOut->ClearScreen (gST->ConOut);
  Print (L"scaleimage Demo 完成\n");

  return EFI_SUCCESS;
}

运行结果如下:

完整的代码和编译后的 EFI 如下:

做一个 UEFI 下的 EasyX 图形库(11)

增加裁剪区域相关的几个函数:

// ---------------------------------------------------------------------------
// 剪裁区域(P0+)
// ---------------------------------------------------------------------------

//
// 剪裁区域对象(对应 EasyX 的 RECT)。
//
typedef struct {
  INT32  left;     // 左上角 X
  INT32  top;      // 左上角 Y
  INT32  right;    // 右下角 X
  INT32  bottom;   // 右下角 Y
} RECT;

/**
  设置剪裁区域。后续所有绘图操作都限制在此矩形内。

  @param[in]  Left    左上角 X 坐标。
  @param[in]  Top     左上角 Y 坐标。
  @param[in]  Right   右下角 X 坐标(含边界)。
  @param[in]  Bottom  右下角 Y 坐标(含边界)。

  说明:
  - 坐标为逻辑坐标(受 setorigin 影响)。
  - 剪裁区域与绘图目标的交集才是最终有效绘图区。
  - 传入的矩形自动规范化(Left 必 < Right,Top 必 < Bottom)。
**/
VOID
EFIAPI
setcliprgn (
  IN INT32  Left,
  IN INT32  Top,
  IN INT32  Right,
  IN INT32  Bottom
  );

/**
  获取当前剪裁区域。

  @param[out]  pRect  输出剪裁矩形,若剪裁未启用则返回全屏矩形。
**/
VOID
EFIAPI
getcliprgn (
  OUT RECT  *pRect
  );

/**
  清除剪裁区域(恢复全屏绘图)。
**/
VOID
EFIAPI
clearcliprgn (
  VOID
  );

运行结果(之前演示使用最大分辨率,这里修改为 1024x768)

完整代码和 EFI 在这里下载:

做一个 UEFI 下的 EasyX 图形库(10)

增加drawtext() 函数,在一个矩形框中绘制文本。

/**
  在矩形区域内输出文本,支持自动换行和多行对齐。

  @param[in]  X       矩形左上角 X 坐标。
  @param[in]  Y       矩形左上角 Y 坐标。
  @param[in]  W       矩形宽度(像素)。
  @param[in]  H       矩形高度(像素)。
  @param[in]  Text    ASCII 文本(\n 为换行符)。
  @param[in]  Format  对齐选项(DT_LEFT/CENTER/RIGHT | DT_TOP/VCENTER/BOTTOM |
                      DT_WORDBREAK/SINGLELINE 的组合)。

  @return 返回实际绘制的文本高度(像素);若文本超出矩形则返回所需高度。

  说明:
  - 默认不自动换行,文本超过矩形宽度被裁剪。
  - DT_WORDBREAK 启用自动换行:遇矩形边界或 \n 则换行。
  - DT_SINGLELINE 不处理 \n,忽略多行。
  - 文本超过矩形高度不再绘制但仍计算高度返回(便于调整高度)。
**/
INT32
EFIAPI
drawtext (
  IN INT32        X,
  IN INT32        Y,
  IN INT32        W,
  IN INT32        H,
  IN CONST CHAR8  *Text,
  IN UINT32       Format
  );

效果如下:

完整的代码和编译后的 EFI 在这里下载:

做一个 UEFI 下的 EasyX 图形库(9)

增加了显示 BMP 的函数,注意这个函数只能加载内存中的BMP ,不能加载文件形式的。

/**
  从内存中的 BMP 数据加载图像(支持 24/32 位、未压缩 BI_RGB)。

  与 EasyX 的 loadimage(从文件读取)不同,此处从内存缓冲加载,避免依赖
  文件系统——可把 BMP 以字节数组内嵌到头文件中再传入。

  @param[out]  DstImg   目标图像(使用前须清零,如 IMAGE img = { 0, 0, NULL };)。
  @param[in]   BmpData  BMP 文件的内存起始地址。
  @param[in]   BmpSize  BMP 数据字节数。

  @retval EFI_SUCCESS   解码成功。
  @retval 其它          参数非法或格式不支持。
**/
EFI_STATUS
EFIAPI
loadimage (
  OUT IMAGE       *DstImg,
  IN  CONST VOID  *BmpData,
  IN  UINTN       BmpSize
  );

这里假定要显示的 BMP 是放在内存中的,实例代码显示的 BMP 是已经定义在"SampleBmp.h"中的图片。

#include <Uefi.h>
#include <Library/UefiBootServicesTableLib.h>
#include <Library/UefiLib.h>
#include <Library/PrintLib.h>
#include "easyx.h"
#include "SampleBmp.h"

/**
  程序入口。
**/
EFI_STATUS
EFIAPI
UefiMain (
  IN EFI_HANDLE        ImageHandle,
  IN EFI_SYSTEM_TABLE  *SystemTable
  )
{
  EFI_STATUS  Status;
  INT32       W;
  INT32       H;
  INT32       PenX;
  INT32       PenY;
  IMAGE       Sprite  = { 0, 0, NULL };   // 使用前必须清零
  IMAGE       Grabbed = { 0, 0, NULL };   // getimage 会读取 Buffer 判断是否需释放
  IMAGE       BmpPic  = { 0, 0, NULL };   // loadimage 目标
  ExMessage   Msg;
  BOOLEAN     Running;
  UINTN       ColorIndex;
  CHAR8       StatusBuf[96];
  CONST COLORREF  Palette[] = {
    LIGHTRED, LIGHTGREEN, LIGHTCYAN, YELLOW, LIGHTMAGENTA, WHITE
  };

  //
  // 初始化绘图设备(跟随 GOP 最大分辨率模式)。
  //
  Status = initgraph (0, 0);
  if (EFI_ERROR (Status)) {
    Print (L"initgraph 失败: %r\n", Status);
    return Status;
  }

  W = getwidth ();
  H = getheight ();

  //
  // 批量绘图,减少刷新次数。
  //
  BeginBatchDraw ();

  //
  // 背景填充深蓝。
  //
  setbkcolor (RGB (16, 16, 48));
  cleardevice ();

  //
  // 颜色模型演示:顶部粗大 HSV 彩虹条 + 其灰度条(RGBtoGRAY)。
  //
  {
    INT32  Px;

    setlinestyle (PS_SOLID, 1);
    for (Px = 20; Px < W - 20; Px++) {
      INT32     Hue = (Px - 20) * 360 / (W - 40);
      COLORREF  Rainbow = HSVtoRGB (Hue % 360, 100, 100);

      setlinecolor (Rainbow);
      line (Px, 8, Px, 47);          // 彩虹条:40 像素高

      setlinecolor (RGBtoGRAY (Rainbow));
      line (Px, 50, Px, 69);         // 灰度条:20 像素高
    }
  }

  //
  // 直线:不同颜色/线宽/线型(下移,为彩虹条让位)。
  //
  setlinecolor (WHITE);
  setlinestyle (PS_SOLID, 1);
  line (20, 84, W - 20, 84);

  setlinecolor (LIGHTGREEN);
  setlinestyle (PS_SOLID, 3);
  line (20, 96, W - 20, 112);

  setlinecolor (YELLOW);
  setlinestyle (PS_DASH, 1);
  line (20, 122, W - 20, 122);

  setlinecolor (LIGHTCYAN);
  setlinestyle (PS_DOT, 1);
  line (20, 132, W - 20, 132);

  //
  // 矩形。
  //
  setlinestyle (PS_SOLID, 1);
  setlinecolor (LIGHTRED);
  rectangle (40, 140, 200, 260);

  setfillcolor (RGB (40, 120, 200));
  setlinecolor (WHITE);
  fillrectangle (240, 140, 400, 260);

  setfillcolor (LIGHTMAGENTA);
  solidrectangle (440, 140, 600, 260);

  //
  // setfillstyle 影线填充演示(fill* 系列会遵循填充样式)。
  //
  setlinecolor (WHITE);
  setlinestyle (PS_SOLID, 1);
  setfillcolor (LIGHTGREEN);
  setbkmode (TRANSPARENT);                       // 影线之间保留背景
  setfillstyle (BS_HATCHED, HS_CROSS, NULL);
  fillrectangle (40, 268, 150, 294);
  setfillstyle (BS_HATCHED, HS_FDIAGONAL, NULL);
  fillrectangle (170, 268, 280, 294);
  setfillstyle (BS_HATCHED, HS_HORIZONTAL, NULL);
  fillrectangle (300, 268, 410, 294);
  setfillstyle (BS_SOLID, HS_CROSS, NULL);       // 复位为纯色填充

  //
  // 圆。
  //
  setlinecolor (WHITE);
  circle (110, 360, 60);

  setfillcolor (RGB (220, 160, 40));
  setlinecolor (WHITE);
  fillcircle (320, 360, 60);

  setfillcolor (LIGHTGREEN);
  solidcircle (520, 360, 60);

  //
  // 椭圆。
  //
  setlinecolor (LIGHTCYAN);
  ellipse (40, 440, 260, 540);

  setfillcolor (RGB (200, 60, 120));
  setlinecolor (WHITE);
  fillellipse (300, 440, 560, 540);

  //
  // 文字(P2):不同颜色/大小/背景模式。
  //
  settextcolor (WHITE);
  settextstyle (16, 8);
  outtextxy (620, 150, "EasyX for UEFI");

  settextcolor (YELLOW);
  settextstyle (24, 0);            // 高 24,宽按比例
  outtextxy (620, 180, "Hello, GOP!");

  settextcolor (LIGHTGREEN);
  settextstyle (32, 16);
  setbkmode (TRANSPARENT);
  outtextxy (620, 220, "0123456789");

  settextcolor (BLACK);
  setbkcolor (LIGHTGRAY);
  setbkmode (OPAQUE);
  settextstyle (16, 8);
  outtextxy (620, 270, " OPAQUE text mode ");

  setbkmode (TRANSPARENT);
  settextcolor (LIGHTRED);
  settextstyle (20, 10);
  outtextxy (620, 320, "The quick brown fox");
  outtextxy (620, 345, "jumps over lazy dog.");

  //
  // 图像(P3)。
  //
  // 1) 用 SetWorkingImage 把绘图重定向到内存图像,绘制一个“精灵”。
  //
  if (!EFI_ERROR (CreateImage (&Sprite, 80, 80))) {
    SetWorkingImage (&Sprite);

    setbkcolor (RGB (20, 20, 20));
    cleardevice ();
    setfillcolor (RGB (240, 200, 40));
    solidcircle (40, 40, 34);
    setfillcolor (BLACK);
    solidcircle (28, 32, 5);
    solidcircle (52, 32, 5);
    setlinecolor (BLACK);
    setlinestyle (PS_SOLID, 2);
    line (24, 54, 56, 54);

    SetWorkingImage (NULL);   // 恢复到屏幕

    // 2) 直接覆盖绘制到屏幕多个位置。
    putimage (620, 400, &Sprite);
    putimage (710, 400, &Sprite);

    // 3) 透明贴图:跳过图像四角的深灰背景色。
    putimagetrans (800, 400, &Sprite, RGB (20, 20, 20));
  }

  //
  // 4) getimage:抓取屏幕左上角一块区域,复制到别处。
  //
  if (!EFI_ERROR (getimage (&Grabbed, 40, 140, 160, 120))) {
    putimage (620, 500, &Grabbed);
    DeleteImage (&Grabbed);
  }

  //
  // setfillstyle 图案填充演示:用精灵图平铺填充一个矩形。
  //
  if (Sprite.Buffer != NULL) {
    setlinecolor (WHITE);
    setlinestyle (PS_SOLID, 1);
    setfillstyle (BS_PATTERN, 0, &Sprite);
    fillrectangle (430, 268, 600, 294);
    setfillstyle (BS_SOLID, 0, NULL);            // 复位为纯色填充
  }

  DeleteImage (&Sprite);

  //
  // 高级图形(P5):底部一条演示带(先清出干净背景)。
  //
  {
    INT32  Y0 = H - 150;

    setfillcolor (RGB (16, 16, 48));
    solidrectangle (0, Y0 - 10, W - 1, Y0 + 100);

    // 圆角矩形(边框 + 填充)
    setlinestyle (PS_SOLID, 1);
    setlinecolor (WHITE);
    setfillcolor (RGB (40, 120, 200));
    fillroundrect (30, Y0, 150, Y0 + 90, 40, 40);

    // 扇形(吃豆人)
    setfillcolor (YELLOW);
    fillpie (170, Y0, 290, Y0 + 90, 35, 300);

    // 圆弧
    setlinecolor (LIGHTCYAN);
    arc (310, Y0, 430, Y0 + 90, 0, 200);

    // 多边形(三角形,边框 + 填充)
    setlinecolor (WHITE);
    setfillcolor (LIGHTGREEN);
    {
      POINT  Tri[3] = {
        { 450, Y0 + 90 },
        { 510, Y0      },
        { 570, Y0 + 90 }
      };
      fillpolygon (Tri, 3);
    }

    // 折线(锯齿)
    setlinecolor (LIGHTMAGENTA);
    setlinestyle (PS_SOLID, 2);
    {
      POINT  Zig[5] = {
        { 590, Y0 + 90 },
        { 610, Y0      },
        { 630, Y0 + 90 },
        { 650, Y0      },
        { 670, Y0 + 90 }
      };
      polyline (Zig, 5);
    }

    // 区域填充:先画空心矩形,再对内部 floodfill
    setlinestyle (PS_SOLID, 1);
    setlinecolor (WHITE);
    rectangle (700, Y0, 800, Y0 + 90);
    setfillcolor (RGB (220, 80, 160));
    floodfill (750, Y0 + 45, RGB (16, 16, 48));

    // loadimage:显示内嵌头文件中的真实 BMP(48x48)
    if (!EFI_ERROR (loadimage (&BmpPic, gSampleBmp, sizeof (gSampleBmp)))) {
      putimage (820, Y0 + 20, &BmpPic);
      DeleteImage (&BmpPic);
    }
  }

  //
  // 键盘操作提示。
  //
  setbkmode (TRANSPARENT);
  settextcolor (WHITE);
  settextstyle (16, 8);
  outtextxy (20, H - 24, "Arrow keys=draw, Space=color, ESC=exit");

  //
  // 一次性刷新并结束批量绘图。
  //
  EndBatchDraw ();

  //
  // 键盘交互循环(P4):方向键移动画笔绘线。
  //
  PenX       = W / 2;
  PenY       = H / 2;
  Running    = TRUE;
  ColorIndex = 0;
  while (Running) {
    INT32  NewX;
    INT32  NewY;

    getmessage (&Msg, EX_KEY);

    if (Msg.message != WM_KEYDOWN) {
      continue;
    }

    NewX = PenX;
    NewY = PenY;

    switch (Msg.vkcode) {
      case VK_LEFT:   NewX -= 8; break;
      case VK_RIGHT:  NewX += 8; break;
      case VK_UP:     NewY -= 8; break;
      case VK_DOWN:   NewY += 8; break;
      case VK_SPACE:  ColorIndex++; break;
      case VK_ESCAPE: Running = FALSE; break;
      default:        break;
    }

    if (!Running) {
      break;
    }

    //
    // 夹取到屏幕范围内。
    //
    if (NewX < 0) {
      NewX = 0;
    }

    if (NewY < 0) {
      NewY = 0;
    }

    if (NewX > W - 1) {
      NewX = W - 1;
    }

    if (NewY > H - 1) {
      NewY = H - 1;
    }

    //
    // 从旧位置到新位置画一段线。
    //
    setlinecolor (Palette[ColorIndex % (sizeof (Palette) / sizeof (Palette[0]))]);
    setlinestyle (PS_SOLID, 2);
    line (PenX, PenY, NewX, NewY);
    PenX = NewX;
    PenY = NewY;

    //
    // 底部显示当前画笔位置与按键(先用背景色清除旧文字)。
    //
    setfillcolor (RGB (16, 16, 48));
    solidrectangle (20, H - 48, 420, H - 28);
    AsciiSPrint (
      StatusBuf,
      sizeof (StatusBuf),
      "Pen: (%d, %d)  vkcode=0x%02x",
      PenX,
      PenY,
      Msg.vkcode
      );
    setbkmode (TRANSPARENT);
    settextcolor (LIGHTCYAN);
    settextstyle (16, 8);
    outtextxy (20, H - 46, StatusBuf);
  }

  closegraph ();

  //
  // 恢复文本控制台。
  //
  gST->ConOut->ClearScreen (gST->ConOut);
  Print (L"EasyX UEFI Demo 结束。分辨率: %d x %d\n", W, H);

  return EFI_SUCCESS;
}

运行之后,图片是显示在最下面的的最右侧:

最终的代码和编译后的 EFI 如下:

做一个 UEFI 下的 EasyX 图形库(8)

增加了填充样式功能。

测试代码:

#include <Uefi.h>
#include <Library/UefiBootServicesTableLib.h>
#include <Library/UefiLib.h>
#include <Library/PrintLib.h>
#include "easyx.h"

/**
  程序入口。
**/
EFI_STATUS
EFIAPI
UefiMain (
  IN EFI_HANDLE        ImageHandle,
  IN EFI_SYSTEM_TABLE  *SystemTable
  )
{
  EFI_STATUS  Status;
  INT32       W;
  INT32       H;
  INT32       PenX;
  INT32       PenY;
  IMAGE       Sprite  = { 0, 0, NULL };   // 使用前必须清零
  IMAGE       Grabbed = { 0, 0, NULL };   // getimage 会读取 Buffer 判断是否需释放
  ExMessage   Msg;
  BOOLEAN     Running;
  UINTN       ColorIndex;
  CHAR8       StatusBuf[96];
  CONST COLORREF  Palette[] = {
    LIGHTRED, LIGHTGREEN, LIGHTCYAN, YELLOW, LIGHTMAGENTA, WHITE
  };

  //
  // 初始化绘图设备(跟随 GOP 最大分辨率模式)。
  //
  Status = initgraph (0, 0);
  if (EFI_ERROR (Status)) {
    Print (L"initgraph 失败: %r\n", Status);
    return Status;
  }

  W = getwidth ();
  H = getheight ();

  //
  // 批量绘图,减少刷新次数。
  //
  BeginBatchDraw ();

  //
  // 背景填充深蓝。
  //
  setbkcolor (RGB (16, 16, 48));
  cleardevice ();

  //
  // 颜色模型演示:顶部粗大 HSV 彩虹条 + 其灰度条(RGBtoGRAY)。
  //
  {
    INT32  Px;

    setlinestyle (PS_SOLID, 1);
    for (Px = 20; Px < W - 20; Px++) {
      INT32     Hue = (Px - 20) * 360 / (W - 40);
      COLORREF  Rainbow = HSVtoRGB (Hue % 360, 100, 100);

      setlinecolor (Rainbow);
      line (Px, 8, Px, 47);          // 彩虹条:40 像素高

      setlinecolor (RGBtoGRAY (Rainbow));
      line (Px, 50, Px, 69);         // 灰度条:20 像素高
    }
  }

  //
  // 直线:不同颜色/线宽/线型(下移,为彩虹条让位)。
  //
  setlinecolor (WHITE);
  setlinestyle (PS_SOLID, 1);
  line (20, 84, W - 20, 84);

  setlinecolor (LIGHTGREEN);
  setlinestyle (PS_SOLID, 3);
  line (20, 96, W - 20, 112);

  setlinecolor (YELLOW);
  setlinestyle (PS_DASH, 1);
  line (20, 122, W - 20, 122);

  setlinecolor (LIGHTCYAN);
  setlinestyle (PS_DOT, 1);
  line (20, 132, W - 20, 132);

  //
  // 矩形。
  //
  setlinestyle (PS_SOLID, 1);
  setlinecolor (LIGHTRED);
  rectangle (40, 140, 200, 260);

  setfillcolor (RGB (40, 120, 200));
  setlinecolor (WHITE);
  fillrectangle (240, 140, 400, 260);

  setfillcolor (LIGHTMAGENTA);
  solidrectangle (440, 140, 600, 260);

  //
  // setfillstyle 影线填充演示(fill* 系列会遵循填充样式)。
  //
  setlinecolor (WHITE);
  setlinestyle (PS_SOLID, 1);
  setfillcolor (LIGHTGREEN);
  setbkmode (TRANSPARENT);                       // 影线之间保留背景
  setfillstyle (BS_HATCHED, HS_CROSS, NULL);
  fillrectangle (40, 268, 150, 294);
  setfillstyle (BS_HATCHED, HS_FDIAGONAL, NULL);
  fillrectangle (170, 268, 280, 294);
  setfillstyle (BS_HATCHED, HS_HORIZONTAL, NULL);
  fillrectangle (300, 268, 410, 294);
  setfillstyle (BS_SOLID, HS_CROSS, NULL);       // 复位为纯色填充

  //
  // 圆。
  //
  setlinecolor (WHITE);
  circle (110, 360, 60);

  setfillcolor (RGB (220, 160, 40));
  setlinecolor (WHITE);
  fillcircle (320, 360, 60);

  setfillcolor (LIGHTGREEN);
  solidcircle (520, 360, 60);

  //
  // 椭圆。
  //
  setlinecolor (LIGHTCYAN);
  ellipse (40, 440, 260, 540);

  setfillcolor (RGB (200, 60, 120));
  setlinecolor (WHITE);
  fillellipse (300, 440, 560, 540);

  //
  // 文字(P2):不同颜色/大小/背景模式。
  //
  settextcolor (WHITE);
  settextstyle (16, 8);
  outtextxy (620, 150, "EasyX for UEFI");

  settextcolor (YELLOW);
  settextstyle (24, 0);            // 高 24,宽按比例
  outtextxy (620, 180, "Hello, GOP!");

  settextcolor (LIGHTGREEN);
  settextstyle (32, 16);
  setbkmode (TRANSPARENT);
  outtextxy (620, 220, "0123456789");

  settextcolor (BLACK);
  setbkcolor (LIGHTGRAY);
  setbkmode (OPAQUE);
  settextstyle (16, 8);
  outtextxy (620, 270, " OPAQUE text mode ");

  setbkmode (TRANSPARENT);
  settextcolor (LIGHTRED);
  settextstyle (20, 10);
  outtextxy (620, 320, "The quick brown fox");
  outtextxy (620, 345, "jumps over lazy dog.");

  //
  // 图像(P3)。
  //
  // 1) 用 SetWorkingImage 把绘图重定向到内存图像,绘制一个“精灵”。
  //
  if (!EFI_ERROR (CreateImage (&Sprite, 80, 80))) {
    SetWorkingImage (&Sprite);

    setbkcolor (RGB (20, 20, 20));
    cleardevice ();
    setfillcolor (RGB (240, 200, 40));
    solidcircle (40, 40, 34);
    setfillcolor (BLACK);
    solidcircle (28, 32, 5);
    solidcircle (52, 32, 5);
    setlinecolor (BLACK);
    setlinestyle (PS_SOLID, 2);
    line (24, 54, 56, 54);

    SetWorkingImage (NULL);   // 恢复到屏幕

    // 2) 直接覆盖绘制到屏幕多个位置。
    putimage (620, 400, &Sprite);
    putimage (710, 400, &Sprite);

    // 3) 透明贴图:跳过图像四角的深灰背景色。
    putimagetrans (800, 400, &Sprite, RGB (20, 20, 20));
  }

  //
  // 4) getimage:抓取屏幕左上角一块区域,复制到别处。
  //
  if (!EFI_ERROR (getimage (&Grabbed, 40, 140, 160, 120))) {
    putimage (620, 500, &Grabbed);
    DeleteImage (&Grabbed);
  }

  //
  // setfillstyle 图案填充演示:用精灵图平铺填充一个矩形。
  //
  if (Sprite.Buffer != NULL) {
    setlinecolor (WHITE);
    setlinestyle (PS_SOLID, 1);
    setfillstyle (BS_PATTERN, 0, &Sprite);
    fillrectangle (430, 268, 600, 294);
    setfillstyle (BS_SOLID, 0, NULL);            // 复位为纯色填充
  }

  DeleteImage (&Sprite);

  //
  // 高级图形(P5):底部一条演示带(先清出干净背景)。
  //
  {
    INT32  Y0 = H - 150;

    setfillcolor (RGB (16, 16, 48));
    solidrectangle (0, Y0 - 10, W - 1, Y0 + 100);

    // 圆角矩形(边框 + 填充)
    setlinestyle (PS_SOLID, 1);
    setlinecolor (WHITE);
    setfillcolor (RGB (40, 120, 200));
    fillroundrect (30, Y0, 150, Y0 + 90, 40, 40);

    // 扇形(吃豆人)
    setfillcolor (YELLOW);
    fillpie (170, Y0, 290, Y0 + 90, 35, 300);

    // 圆弧
    setlinecolor (LIGHTCYAN);
    arc (310, Y0, 430, Y0 + 90, 0, 200);

    // 多边形(三角形,边框 + 填充)
    setlinecolor (WHITE);
    setfillcolor (LIGHTGREEN);
    {
      POINT  Tri[3] = {
        { 450, Y0 + 90 },
        { 510, Y0      },
        { 570, Y0 + 90 }
      };
      fillpolygon (Tri, 3);
    }

    // 折线(锯齿)
    setlinecolor (LIGHTMAGENTA);
    setlinestyle (PS_SOLID, 2);
    {
      POINT  Zig[5] = {
        { 590, Y0 + 90 },
        { 610, Y0      },
        { 630, Y0 + 90 },
        { 650, Y0      },
        { 670, Y0 + 90 }
      };
      polyline (Zig, 5);
    }

    // 区域填充:先画空心矩形,再对内部 floodfill
    setlinestyle (PS_SOLID, 1);
    setlinecolor (WHITE);
    rectangle (700, Y0, 800, Y0 + 90);
    setfillcolor (RGB (220, 80, 160));
    floodfill (750, Y0 + 45, RGB (16, 16, 48));
  }

  //
  // 键盘操作提示。
  //
  setbkmode (TRANSPARENT);
  settextcolor (WHITE);
  settextstyle (16, 8);
  outtextxy (20, H - 24, "Arrow keys=draw, Space=color, ESC=exit");

  //
  // 一次性刷新并结束批量绘图。
  //
  EndBatchDraw ();

  //
  // 键盘交互循环(P4):方向键移动画笔绘线。
  //
  PenX       = W / 2;
  PenY       = H / 2;
  Running    = TRUE;
  ColorIndex = 0;
  while (Running) {
    INT32  NewX;
    INT32  NewY;

    getmessage (&Msg, EX_KEY);

    if (Msg.message != WM_KEYDOWN) {
      continue;
    }

    NewX = PenX;
    NewY = PenY;

    switch (Msg.vkcode) {
      case VK_LEFT:   NewX -= 8; break;
      case VK_RIGHT:  NewX += 8; break;
      case VK_UP:     NewY -= 8; break;
      case VK_DOWN:   NewY += 8; break;
      case VK_SPACE:  ColorIndex++; break;
      case VK_ESCAPE: Running = FALSE; break;
      default:        break;
    }

    if (!Running) {
      break;
    }

    //
    // 夹取到屏幕范围内。
    //
    if (NewX < 0) {
      NewX = 0;
    }

    if (NewY < 0) {
      NewY = 0;
    }

    if (NewX > W - 1) {
      NewX = W - 1;
    }

    if (NewY > H - 1) {
      NewY = H - 1;
    }

    //
    // 从旧位置到新位置画一段线。
    //
    setlinecolor (Palette[ColorIndex % (sizeof (Palette) / sizeof (Palette[0]))]);
    setlinestyle (PS_SOLID, 2);
    line (PenX, PenY, NewX, NewY);
    PenX = NewX;
    PenY = NewY;

    //
    // 底部显示当前画笔位置与按键(先用背景色清除旧文字)。
    //
    setfillcolor (RGB (16, 16, 48));
    solidrectangle (20, H - 48, 420, H - 28);
    AsciiSPrint (
      StatusBuf,
      sizeof (StatusBuf),
      "Pen: (%d, %d)  vkcode=0x%02x",
      PenX,
      PenY,
      Msg.vkcode
      );
    setbkmode (TRANSPARENT);
    settextcolor (LIGHTCYAN);
    settextstyle (16, 8);
    outtextxy (20, H - 46, StatusBuf);
  }

  closegraph ();

  //
  // 恢复文本控制台。
  //
  gST->ConOut->ClearScreen (gST->ConOut);
  Print (L"EasyX UEFI Demo 结束。分辨率: %d x %d\n", W, H);

  return EFI_SUCCESS;
}

运行结果:

完整代码:

做一个 UEFI 下的 EasyX 图形库(7)

继续修改代码,增加辅助函数:

/**
  忙等待指定微秒数(基于 gBS->Stall)。
**/
VOID
EFIAPI
delay_us (
  IN UINT32  Microseconds
  );

/**
  忙等待指定毫秒数。
**/
VOID
EFIAPI
delay_ms (
  IN UINT32  Milliseconds
  );

/**
  忙等待指定毫秒数(delay_ms 的别名,便于移植 EasyX 代码)。
**/
VOID
EFIAPI
Sleep (
  IN UINT32  Milliseconds
  );

测试代码增加了一个开场动画,绘制一个弹跳的小球:

#include <Uefi.h>
#include <Library/UefiBootServicesTableLib.h>
#include <Library/UefiLib.h>
#include <Library/PrintLib.h>
#include "easyx.h"

/**
  程序入口。
**/
EFI_STATUS
EFIAPI
UefiMain (
  IN EFI_HANDLE        ImageHandle,
  IN EFI_SYSTEM_TABLE  *SystemTable
  )
{
  EFI_STATUS  Status;
  INT32       W;
  INT32       H;
  INT32       PenX;
  INT32       PenY;
  IMAGE       Sprite  = { 0, 0, NULL };   // 使用前必须清零
  IMAGE       Grabbed = { 0, 0, NULL };   // getimage 会读取 Buffer 判断是否需释放
  ExMessage   Msg;
  BOOLEAN     Running;
  UINTN       ColorIndex;
  CHAR8       StatusBuf[96];
  CONST COLORREF  Palette[] = {
    LIGHTRED, LIGHTGREEN, LIGHTCYAN, YELLOW, LIGHTMAGENTA, WHITE
  };

  //
  // 初始化绘图设备(跟随 GOP 最大分辨率模式)。
  //
  Status = initgraph (0, 0);
  if (EFI_ERROR (Status)) {
    Print (L"initgraph 失败: %r\n", Status);
    return Status;
  }

  W = getwidth ();
  H = getheight ();

  //
  // 开场动画:弹跳小球(演示 delay_ms + 双缓冲 BeginBatchDraw/FlushBatchDraw)。
  //
  {
    INT32  Bx = W / 2;
    INT32  By = H / 3;
    INT32  Vx = 7;
    INT32  Vy = 5;
    INT32  Rr = 30;
    INT32  Frame;

    BeginBatchDraw ();
    for (Frame = 0; Frame < 150; Frame++) {
      setbkcolor (RGB (16, 16, 48));
      cleardevice ();

      setfillcolor (HSVtoRGB ((Frame * 4) % 360, 100, 100));
      solidcircle (Bx, By, Rr);

      setbkmode (TRANSPARENT);
      settextcolor (WHITE);
      settextstyle (28, 14);
      outtextxy (W / 2 - 140, 30, "EasyX for UEFI");

      FlushBatchDraw ();

      Bx += Vx;
      By += Vy;
      if ((Bx - Rr < 0) || (Bx + Rr > W - 1)) {
        Vx = -Vx;
        Bx += Vx;
      }

      if ((By - Rr < 0) || (By + Rr > H - 1)) {
        Vy = -Vy;
        By += Vy;
      }

      delay_ms (16);
    }

    EndBatchDraw ();
  }

  //
  // 批量绘图,减少刷新次数。
  //
  BeginBatchDraw ();

  //
  // 背景填充深蓝。
  //
  setbkcolor (RGB (16, 16, 48));
  cleardevice ();

  //
  // 颜色模型演示:顶部粗大 HSV 彩虹条 + 其灰度条(RGBtoGRAY)。
  //
  {
    INT32  Px;

    setlinestyle (PS_SOLID, 1);
    for (Px = 20; Px < W - 20; Px++) {
      INT32     Hue = (Px - 20) * 360 / (W - 40);
      COLORREF  Rainbow = HSVtoRGB (Hue % 360, 100, 100);

      setlinecolor (Rainbow);
      line (Px, 8, Px, 47);          // 彩虹条:40 像素高

      setlinecolor (RGBtoGRAY (Rainbow));
      line (Px, 50, Px, 69);         // 灰度条:20 像素高
    }
  }

  //
  // 直线:不同颜色/线宽/线型(下移,为彩虹条让位)。
  //
  setlinecolor (WHITE);
  setlinestyle (PS_SOLID, 1);
  line (20, 84, W - 20, 84);

  setlinecolor (LIGHTGREEN);
  setlinestyle (PS_SOLID, 3);
  line (20, 96, W - 20, 112);

  setlinecolor (YELLOW);
  setlinestyle (PS_DASH, 1);
  line (20, 122, W - 20, 122);

  setlinecolor (LIGHTCYAN);
  setlinestyle (PS_DOT, 1);
  line (20, 132, W - 20, 132);

  //
  // 矩形。
  //
  setlinestyle (PS_SOLID, 1);
  setlinecolor (LIGHTRED);
  rectangle (40, 140, 200, 260);

  setfillcolor (RGB (40, 120, 200));
  setlinecolor (WHITE);
  fillrectangle (240, 140, 400, 260);

  setfillcolor (LIGHTMAGENTA);
  solidrectangle (440, 140, 600, 260);

  //
  // 圆。
  //
  setlinecolor (WHITE);
  circle (110, 360, 60);

  setfillcolor (RGB (220, 160, 40));
  setlinecolor (WHITE);
  fillcircle (320, 360, 60);

  setfillcolor (LIGHTGREEN);
  solidcircle (520, 360, 60);

  //
  // 椭圆。
  //
  setlinecolor (LIGHTCYAN);
  ellipse (40, 440, 260, 540);

  setfillcolor (RGB (200, 60, 120));
  setlinecolor (WHITE);
  fillellipse (300, 440, 560, 540);

  //
  // 文字(P2):不同颜色/大小/背景模式。
  //
  settextcolor (WHITE);
  settextstyle (16, 8);
  outtextxy (620, 150, "EasyX for UEFI");

  settextcolor (YELLOW);
  settextstyle (24, 0);            // 高 24,宽按比例
  outtextxy (620, 180, "Hello, GOP!");

  settextcolor (LIGHTGREEN);
  settextstyle (32, 16);
  setbkmode (TRANSPARENT);
  outtextxy (620, 220, "0123456789");

  settextcolor (BLACK);
  setbkcolor (LIGHTGRAY);
  setbkmode (OPAQUE);
  settextstyle (16, 8);
  outtextxy (620, 270, " OPAQUE text mode ");

  setbkmode (TRANSPARENT);
  settextcolor (LIGHTRED);
  settextstyle (20, 10);
  outtextxy (620, 320, "The quick brown fox");
  outtextxy (620, 345, "jumps over lazy dog.");

  //
  // 图像(P3)。
  //
  // 1) 用 SetWorkingImage 把绘图重定向到内存图像,绘制一个“精灵”。
  //
  if (!EFI_ERROR (CreateImage (&Sprite, 80, 80))) {
    SetWorkingImage (&Sprite);

    setbkcolor (RGB (20, 20, 20));
    cleardevice ();
    setfillcolor (RGB (240, 200, 40));
    solidcircle (40, 40, 34);
    setfillcolor (BLACK);
    solidcircle (28, 32, 5);
    solidcircle (52, 32, 5);
    setlinecolor (BLACK);
    setlinestyle (PS_SOLID, 2);
    line (24, 54, 56, 54);

    SetWorkingImage (NULL);   // 恢复到屏幕

    // 2) 直接覆盖绘制到屏幕多个位置。
    putimage (620, 400, &Sprite);
    putimage (710, 400, &Sprite);

    // 3) 透明贴图:跳过图像四角的深灰背景色。
    putimagetrans (800, 400, &Sprite, RGB (20, 20, 20));
  }

  //
  // 4) getimage:抓取屏幕左上角一块区域,复制到别处。
  //
  if (!EFI_ERROR (getimage (&Grabbed, 40, 140, 160, 120))) {
    putimage (620, 500, &Grabbed);
    DeleteImage (&Grabbed);
  }

  DeleteImage (&Sprite);

  //
  // 高级图形(P5):底部一条演示带(先清出干净背景)。
  //
  {
    INT32  Y0 = H - 150;

    setfillcolor (RGB (16, 16, 48));
    solidrectangle (0, Y0 - 10, W - 1, Y0 + 100);

    // 圆角矩形(边框 + 填充)
    setlinestyle (PS_SOLID, 1);
    setlinecolor (WHITE);
    setfillcolor (RGB (40, 120, 200));
    fillroundrect (30, Y0, 150, Y0 + 90, 40, 40);

    // 扇形(吃豆人)
    setfillcolor (YELLOW);
    fillpie (170, Y0, 290, Y0 + 90, 35, 300);

    // 圆弧
    setlinecolor (LIGHTCYAN);
    arc (310, Y0, 430, Y0 + 90, 0, 200);

    // 多边形(三角形,边框 + 填充)
    setlinecolor (WHITE);
    setfillcolor (LIGHTGREEN);
    {
      POINT  Tri[3] = {
        { 450, Y0 + 90 },
        { 510, Y0      },
        { 570, Y0 + 90 }
      };
      fillpolygon (Tri, 3);
    }

    // 折线(锯齿)
    setlinecolor (LIGHTMAGENTA);
    setlinestyle (PS_SOLID, 2);
    {
      POINT  Zig[5] = {
        { 590, Y0 + 90 },
        { 610, Y0      },
        { 630, Y0 + 90 },
        { 650, Y0      },
        { 670, Y0 + 90 }
      };
      polyline (Zig, 5);
    }

    // 区域填充:先画空心矩形,再对内部 floodfill
    setlinestyle (PS_SOLID, 1);
    setlinecolor (WHITE);
    rectangle (700, Y0, 800, Y0 + 90);
    setfillcolor (RGB (220, 80, 160));
    floodfill (750, Y0 + 45, RGB (16, 16, 48));
  }

  //
  // 键盘操作提示。
  //
  setbkmode (TRANSPARENT);
  settextcolor (WHITE);
  settextstyle (16, 8);
  outtextxy (20, H - 24, "Arrow keys=draw, Space=color, ESC=exit");

  //
  // 一次性刷新并结束批量绘图。
  //
  EndBatchDraw ();

  //
  // 键盘交互循环(P4):方向键移动画笔绘线。
  //
  PenX       = W / 2;
  PenY       = H / 2;
  Running    = TRUE;
  ColorIndex = 0;
  while (Running) {
    INT32  NewX;
    INT32  NewY;

    getmessage (&Msg, EX_KEY);

    if (Msg.message != WM_KEYDOWN) {
      continue;
    }

    NewX = PenX;
    NewY = PenY;

    switch (Msg.vkcode) {
      case VK_LEFT:   NewX -= 8; break;
      case VK_RIGHT:  NewX += 8; break;
      case VK_UP:     NewY -= 8; break;
      case VK_DOWN:   NewY += 8; break;
      case VK_SPACE:  ColorIndex++; break;
      case VK_ESCAPE: Running = FALSE; break;
      default:        break;
    }

    if (!Running) {
      break;
    }

    //
    // 夹取到屏幕范围内。
    //
    if (NewX < 0) {
      NewX = 0;
    }

    if (NewY < 0) {
      NewY = 0;
    }

    if (NewX > W - 1) {
      NewX = W - 1;
    }

    if (NewY > H - 1) {
      NewY = H - 1;
    }

    //
    // 从旧位置到新位置画一段线。
    //
    setlinecolor (Palette[ColorIndex % (sizeof (Palette) / sizeof (Palette[0]))]);
    setlinestyle (PS_SOLID, 2);
    line (PenX, PenY, NewX, NewY);
    PenX = NewX;
    PenY = NewY;

    //
    // 底部显示当前画笔位置与按键(先用背景色清除旧文字)。
    //
    setfillcolor (RGB (16, 16, 48));
    solidrectangle (20, H - 48, 420, H - 28);
    AsciiSPrint (
      StatusBuf,
      sizeof (StatusBuf),
      "Pen: (%d, %d)  vkcode=0x%02x",
      PenX,
      PenY,
      Msg.vkcode
      );
    setbkmode (TRANSPARENT);
    settextcolor (LIGHTCYAN);
    settextstyle (16, 8);
    outtextxy (20, H - 46, StatusBuf);
  }

  closegraph ();

  //
  // 恢复文本控制台。
  //
  gST->ConOut->ClearScreen (gST->ConOut);
  Print (L"EasyX UEFI Demo 结束。分辨率: %d x %d\n", W, H);

  return EFI_SUCCESS;
}

完整的代码:

Intel SOL 和 eSOL

SOL 是 Sign-of-Life 的缩写, eSOL 是 extension to SOL 的缩写。

通常来说,MRC Training 会花费很长时间,在之前这段时间屏幕是没有任何显示的。这样会导致很多客户认为机器出现问题反复关机,联系售后等等......

SOL 的出现就是为了解决这个问题:在内存还没有 Ready 的时候就显示一些东西,比如LOGO,提示词等等,这样客户就可以知道当前的状态并非死机。术语来说:SOL提升了MRC Training 期间的用户体验。

接下来出现了 eSOL 更进一步,SOL 和 eSOL 的区别如下:

SOLESOL
在内存检测之前开始进行显示,MRC Traing结束后关闭显示。SOL exit 是必须进行的操作在内存检测之前开始进行显示,显示可以持续到 PEI Post MEM阶段或者到 调用DXE GOP的阶段 。SOL exit 是可选操作
只能显示静态画面可以显示动态画面,比如,绘制一个进度条
在 SOL exit 到 PEI GOP 接手期间存无法显示任何信息的时间段从 SOL 到OS 下的 GFXDriver一直都能提供显示服务。显示黑屏持续时间大大缩短了,但是在 PEI POST MEM 或者 DXE GOP 接管显示控制权之后,用户仍然会碰到一次黑屏。产生这个黑屏的原因是 VGA想高分辨率模式切换导致的。