mirror of https://github.com/acidanthera/audk.git
189 lines
7.1 KiB
C
189 lines
7.1 KiB
C
/** @file
|
|
UGA Draw protocol from the EFI 1.10 specification.
|
|
|
|
Abstraction of a very simple graphics device.
|
|
|
|
Copyright (c) 2006 - 2008, 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.
|
|
|
|
**/
|
|
|
|
#ifndef __UGA_DRAW_H__
|
|
#define __UGA_DRAW_H__
|
|
|
|
#include <PiDxe.h>
|
|
|
|
|
|
#define EFI_UGA_DRAW_PROTOCOL_GUID \
|
|
{ \
|
|
0x982c298b, 0xf4fa, 0x41cb, {0xb8, 0x38, 0x77, 0xaa, 0x68, 0x8f, 0xb8, 0x39 } \
|
|
}
|
|
|
|
typedef struct _EFI_UGA_DRAW_PROTOCOL EFI_UGA_DRAW_PROTOCOL;
|
|
|
|
/**
|
|
Return the current video mode information.
|
|
|
|
@param This Protocol instance pointer.
|
|
@param HorizontalResolution Current video horizontal resolution in pixels
|
|
@param VerticalResolution Current video vertical resolution in pixels
|
|
@param ColorDepth Current video color depth in bits per pixel
|
|
@param RefreshRate Current video refresh rate in Hz.
|
|
|
|
@retval EFI_SUCCESS Mode information returned.
|
|
@retval EFI_NOT_STARTED Video display is not initialized. Call SetMode ()
|
|
@retval EFI_INVALID_PARAMETER One of the input args was NULL.
|
|
|
|
**/
|
|
typedef
|
|
EFI_STATUS
|
|
(EFIAPI *EFI_UGA_DRAW_PROTOCOL_GET_MODE)(
|
|
IN EFI_UGA_DRAW_PROTOCOL *This,
|
|
OUT UINT32 *HorizontalResolution,
|
|
OUT UINT32 *VerticalResolution,
|
|
OUT UINT32 *ColorDepth,
|
|
OUT UINT32 *RefreshRate
|
|
)
|
|
;
|
|
|
|
/**
|
|
Set the current video mode information.
|
|
|
|
@param This Protocol instance pointer.
|
|
@param HorizontalResolution Current video horizontal resolution in pixels
|
|
@param VerticalResolution Current video vertical resolution in pixels
|
|
@param ColorDepth Current video color depth in bits per pixel
|
|
@param RefreshRate Current video refresh rate in Hz.
|
|
|
|
@retval EFI_SUCCESS Mode information returned.
|
|
@retval EFI_NOT_STARTED Video display is not initialized. Call SetMode ()
|
|
|
|
**/
|
|
typedef
|
|
EFI_STATUS
|
|
(EFIAPI *EFI_UGA_DRAW_PROTOCOL_SET_MODE)(
|
|
IN EFI_UGA_DRAW_PROTOCOL *This,
|
|
IN UINT32 HorizontalResolution,
|
|
IN UINT32 VerticalResolution,
|
|
IN UINT32 ColorDepth,
|
|
IN UINT32 RefreshRate
|
|
)
|
|
;
|
|
|
|
typedef struct {
|
|
UINT8 Blue;
|
|
UINT8 Green;
|
|
UINT8 Red;
|
|
UINT8 Reserved;
|
|
} EFI_UGA_PIXEL;
|
|
|
|
typedef union {
|
|
EFI_UGA_PIXEL Pixel;
|
|
UINT32 Raw;
|
|
} EFI_UGA_PIXEL_UNION;
|
|
|
|
typedef enum {
|
|
EfiUgaVideoFill,
|
|
EfiUgaVideoToBltBuffer,
|
|
EfiUgaBltBufferToVideo,
|
|
EfiUgaVideoToVideo,
|
|
EfiUgaBltMax
|
|
} EFI_UGA_BLT_OPERATION;
|
|
|
|
/**
|
|
Type specifying a pointer to a function to perform an UGA Blt operation.
|
|
|
|
The following table defines actions for BltOperations:
|
|
|
|
<B>EfiUgaVideoFill</B> - Write data from the BltBuffer pixel (SourceX, SourceY)
|
|
directly to every pixel of the video display rectangle
|
|
(DestinationX, DestinationY) (DestinationX + Width, DestinationY + Height).
|
|
Only one pixel will be used from the BltBuffer. Delta is NOT used.
|
|
|
|
<B>EfiUgaVideoToBltBuffer</B> - Read data from the video display rectangle
|
|
(SourceX, SourceY) (SourceX + Width, SourceY + Height) and place it in
|
|
the BltBuffer rectangle (DestinationX, DestinationY )
|
|
(DestinationX + Width, DestinationY + Height). If DestinationX or
|
|
DestinationY is not zero then Delta must be set to the length in bytes
|
|
of a row in the BltBuffer.
|
|
|
|
<B>EfiUgaBltBufferToVideo</B> - Write data from the BltBuffer rectangle
|
|
(SourceX, SourceY) (SourceX + Width, SourceY + Height) directly to the
|
|
video display rectangle (DestinationX, DestinationY)
|
|
(DestinationX + Width, DestinationY + Height). If SourceX or SourceY is
|
|
not zero then Delta must be set to the length in bytes of a row in the
|
|
BltBuffer.
|
|
|
|
<B>EfiUgaVideoToVideo</B> - Copy from the video display rectangle (SourceX, SourceY)
|
|
(SourceX + Width, SourceY + Height) .to the video display rectangle
|
|
(DestinationX, DestinationY) (DestinationX + Width, DestinationY + Height).
|
|
The BltBuffer and Delta are not used in this mode.
|
|
|
|
|
|
@param[in] This - Protocol instance pointer.
|
|
@param[in] BltBuffer - Buffer containing data to blit into video buffer. This
|
|
buffer has a size of Width*Height*sizeof(EFI_UGA_PIXEL)
|
|
@param[in] BltOperation - Operation to perform on BlitBuffer and video memory
|
|
@param[in] SourceX - X coordinate of source for the BltBuffer.
|
|
@param[in] SourceY - Y coordinate of source for the BltBuffer.
|
|
@param[in] DestinationX - X coordinate of destination for the BltBuffer.
|
|
@param[in] DestinationY - Y coordinate of destination for the BltBuffer.
|
|
@param[in] Width - Width of rectangle in BltBuffer in pixels.
|
|
@param[in] Height - Hight of rectangle in BltBuffer in pixels.
|
|
@param[in] Delta - OPTIONAL
|
|
|
|
@retval EFI_SUCCESS - The Blt operation completed.
|
|
@retval EFI_INVALID_PARAMETER - BltOperation is not valid.
|
|
@retval EFI_DEVICE_ERROR - A hardware error occured writting to the video buffer.
|
|
|
|
--*/
|
|
typedef
|
|
EFI_STATUS
|
|
(EFIAPI *EFI_UGA_DRAW_PROTOCOL_BLT)(
|
|
IN EFI_UGA_DRAW_PROTOCOL * This,
|
|
IN EFI_UGA_PIXEL * BltBuffer, OPTIONAL
|
|
IN EFI_UGA_BLT_OPERATION BltOperation,
|
|
IN UINTN SourceX,
|
|
IN UINTN SourceY,
|
|
IN UINTN DestinationX,
|
|
IN UINTN DestinationY,
|
|
IN UINTN Width,
|
|
IN UINTN Height,
|
|
IN UINTN Delta OPTIONAL
|
|
);
|
|
|
|
/**
|
|
This protocol provides a basic abstraction to set video modes and
|
|
copy pixels to and from the graphics controller's frame buffer.
|
|
|
|
@par Protocol Description:
|
|
The EFI_UGA_DRAW_PROTOCOL provides a software abstraction to allow pixels to be drawn
|
|
directly to the frame buffer. The EFI_UGA_DRAW_PROTOCOL is designed to be lightweight and
|
|
to support the basic needs of graphics output prior to Operating System boot.
|
|
|
|
@param GetMode
|
|
Returns information about the geometry and configuration of the
|
|
graphics controller's current frame buffer configuration.
|
|
|
|
@param SetMode
|
|
Set the graphics device into a given mode and clears the frame buffer to black.
|
|
|
|
@param Blt
|
|
Software abstraction to draw on the video device's frame buffer.
|
|
**/
|
|
struct _EFI_UGA_DRAW_PROTOCOL {
|
|
EFI_UGA_DRAW_PROTOCOL_GET_MODE GetMode;
|
|
EFI_UGA_DRAW_PROTOCOL_SET_MODE SetMode;
|
|
EFI_UGA_DRAW_PROTOCOL_BLT Blt;
|
|
};
|
|
|
|
extern EFI_GUID gEfiUgaDrawProtocolGuid;
|
|
|
|
#endif
|