Руководство: отобразить изображение используя UEFI

Следующий проект, над которым я работаю, включает в себя отображение изображения отображение изображения. Это означает, что мне приходится больше полагаться на функции UEFI, чем просто на базовые функции C. Поскольку я все еще изучаю, как работает UEFI, и еще не совсем знаком с ним, я решил поискать что-то, что уже делало что-то подобное, и вытащить то, что мне нужно. Я знал, что NT32 отображает логотип Tiano, поэтому я решил найти функцию, которая делает это, создать на её основе мою собственную функцию отображения изображений. Функция EnableQuietBoot() расположена в файле BdsConsole.c [1]. В этой функции много ненужных вещей для отображения изображения, поэтому мы определенно можем это вырезать их, когда собираем по кусочкам нашу собственную функцию.

Я вырезал все, что касалось UGA, так как мне нужен только Graphics Output Protocol для отображения изображения. Я также избавился от всего, что связано с бейджами и решением, где на экране отображать изображение. Все, что мне действительно нужно, это что-то, чтобы получить протокол, получить изображение из файла, преобразовать его в формат, который может отображать GOP, и отобразить его. Итак, после определения, что мне нужно, а что нет, я собрал воедино свою собственную функцию.

Следующим шагом было убедиться, что включены все нужные файлы, чтобы все функции и глобальные переменные, используемые для отображения этого изображения, действительно были доступны. Одна из функций, ConvertBmpToGopBlt(), уже была в BdsConsole.c, поэтому я просто скопировал и вставил функцию в свой новый файл. Единственное, что нужно изменить в этой функции, это то, что вместо вызова AllocatePool() вызвать malloc(), а вместо вызова FreePool() вызвать free(). По большей части было достаточно просто найти, где все было определено, путем поиска в папке EDK2, и я пошел дальше и включил их в начало файла. Мой опыт программирования в основном связан с Java, поэтому я все еще пытаюсь понять, как работают операторы #include. Мне потребовалось время, чтобы понять, что в C нет прямых ссылок, поэтому мне пришлось изменить порядок операторов, прежде чем это будет работать.

Также было сложно понять, как работают файлы INF. Я включил DxeServicesLib.h в свой файл, но он все равно не смог распознать функцию, прототип которой находится в этом .H файле. Чтобы мой файл мог получить доступ к коду для этой функции и фактически вызвать ее, мне нужно было убедиться, что код этой функции также включен в проект. Это можно сделать с помощью файлов INF. В файле .INF моего проекта есть список библиотечных классов, в котором перечислены другие файлы INF, которые должны быть распознаны при создании проекта. Чтобы убедиться, что код, определённый в DxeServicesLib.h, был собран, я поместил DxeServicesLib в этот список. Ниже приведено содержимое файла INF.

Наконец, нам нужно собрать main(). Это наша точка входа в приложение, поэтому все довольно быть просто. Все, что она делает – это вызывает функцию, которую мы собрали для отображения изображения, но функция имеет EFI_GUID в качестве параметра (GUID изображения). Мы могли бы использовать uuidgen для создания GUID, но поскольку NT32 уже отображает изображение, нам нужно просто найти GUID для этого изображения. Он находится в Logo.inf [2]. Итак, поскольку мы должны передать EFI_GUID в функцию, мы берем этот длинный GUID и должным образом помещаем его в структуру. Объявление выходит за пределы функции, поэтому у нас есть глобальная переменная.

STATIC EFI_GUID gImageFileGuid = {0x7bb28b99, 0x61bb, 0x11d5, {0x9a, 0x5d, 0x00, 0x90, 0x27, 0x3f, 0xc1, 0x4d}};

Тогда единственная строка внутри main() выглядит следующим образом:

DisplayImage(&gImageFileGuid);

Итак, давайте рассмотрим код, который отображает изображение: Сначала очищаем экран. Без него изображение будет просто нарисовано поверх того, что уже было отображено (в большинстве случаев это текст).

gST->ConOut->Reset(gST->ConOut, FALSE);

Проверяем, поддерживается ли протокол вывода графики. Если нет, возвращаем код ошибки.

Status = gBS->HandleProtocol (gST->ConsoleOutHandle, &gEfiGraphicsOutputProtocolGuid, (VOID **) &GraphicsOutput); if (EFI_ERROR (Status)) { return EFI_UNSUPPORTED; }

Получаем информацию об изображении из файла изображения. В случае ошибки возвращаем код ошибки.

Status = GetSectionFromAnyFv (LogoFile, EFI_SECTION_RAW, 0, (VOID **) &ImageData, &ImageSize); if (EFI_ERROR (Status)) { return EFI_UNSUPPORTED; }

Преобразовываем изображение в формат, с которым может работать GOP (GOP Blt). На данный момент файлы изображений .BMP являются единственными поддерживаемыми файлами изображений.

Status = ConvertBmpToGopBlt ( ImageData, ImageSize, (VOID **) &Blt, &BltSize, &Height, &Width ); if (EFI_ERROR (Status)) { free (ImageData); }

Устанавливаем координаты того места, где будет отображаться изображение. Указанные координаты будут местоположением верхнего левого угла изображения. Левый верхний угол окна - (0, 0).

CoordinateX = (GraphicsOutput->Mode->Info->HorizontalResolution / 2) - (Width / 2); CoordinateY = (GraphicsOutput->Mode->Info->VerticalResolution / 2) - (Height / 2);

Наконец, вызываем Blt(), чтобы отобразить изображение. У нас здесь довольно много параметров, поэтому давайте рассмотрим их. Во-первых, это экземпляр GRAPHICS_OUTPUT_PROTOCOL, который вызывает функцию. Далее идут данные изображения, которые мы должны передать на экран. Мы заполнили этот буфер при вызове ConvertBmpToGopBlt().

GraphicsOutput->Blt ( GraphicsOutput, Blt, EfiBltBufferToVideo, 0, 0, (UINTN) CoordinateX, (UINTN) CoordinateY, Width, Height, Width * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL) ); return EFI_SUCCESS;

Следующий шаг в этом проекте - заставить изображение перемещаться в соответствии с инструкциями на клавиатуре.

Ссылки:

1. IntelFrameworkModulePkg\Library\GenericBdsLib\BdsConsole.c
2. MdeModulePkg\Logo\Logo.inf