2 UGA Draw protocol from the EFI 1.10 specification.
4 Abstraction of a very simple graphics device.
6 Copyright (c) 2006, Intel Corporation
7 All rights reserved. This program and the accompanying materials
8 are licensed and made available under the terms and conditions of the BSD License
9 which accompanies this distribution. The full text of the license may be found at
10 http://opensource.org/licenses/bsd-license.php
12 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
13 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
17 #ifndef __UGA_DRAW_H__
18 #define __UGA_DRAW_H__
23 #define EFI_UGA_DRAW_PROTOCOL_GUID \
25 0x982c298b, 0xf4fa, 0x41cb, {0xb8, 0x38, 0x77, 0xaa, 0x68, 0x8f, 0xb8, 0x39 } \
28 typedef struct _EFI_UGA_DRAW_PROTOCOL EFI_UGA_DRAW_PROTOCOL
;
31 Return the current video mode information.
33 @param This Protocol instance pointer.
34 @param HorizontalResolution Current video horizontal resolution in pixels
35 @param VerticalResolution Current video vertical resolution in pixels
36 @param ColorDepth Current video color depth in bits per pixel
37 @param RefreshRate Current video refresh rate in Hz.
39 @retval EFI_SUCCESS Mode information returned.
40 @retval EFI_NOT_STARTED Video display is not initialized. Call SetMode ()
41 @retval EFI_INVALID_PARAMETER One of the input args was NULL.
46 (EFIAPI
*EFI_UGA_DRAW_PROTOCOL_GET_MODE
)(
47 IN EFI_UGA_DRAW_PROTOCOL
*This
,
48 OUT UINT32
*HorizontalResolution
,
49 OUT UINT32
*VerticalResolution
,
50 OUT UINT32
*ColorDepth
,
51 OUT UINT32
*RefreshRate
56 Set the current video mode information.
58 @param This Protocol instance pointer.
59 @param HorizontalResolution Current video horizontal resolution in pixels
60 @param VerticalResolution Current video vertical resolution in pixels
61 @param ColorDepth Current video color depth in bits per pixel
62 @param RefreshRate Current video refresh rate in Hz.
64 @retval EFI_SUCCESS Mode information returned.
65 @retval EFI_NOT_STARTED Video display is not initialized. Call SetMode ()
70 (EFIAPI
*EFI_UGA_DRAW_PROTOCOL_SET_MODE
)(
71 IN EFI_UGA_DRAW_PROTOCOL
*This
,
72 IN UINT32 HorizontalResolution
,
73 IN UINT32 VerticalResolution
,
89 } EFI_UGA_PIXEL_UNION
;
93 EfiUgaVideoToBltBuffer
,
94 EfiUgaBltBufferToVideo
,
97 } EFI_UGA_BLT_OPERATION
;
100 Type specifying a pointer to a function to perform an UGA Blt operation.
102 The following table defines actions for BltOperations:
104 <B>EfiUgaVideoFill</B> - Write data from the BltBuffer pixel (SourceX, SourceY)
105 directly to every pixel of the video display rectangle
106 (DestinationX, DestinationY) (DestinationX + Width, DestinationY + Height).
107 Only one pixel will be used from the BltBuffer. Delta is NOT used.
109 <B>EfiUgaVideoToBltBuffer</B> - Read data from the video display rectangle
110 (SourceX, SourceY) (SourceX + Width, SourceY + Height) and place it in
111 the BltBuffer rectangle (DestinationX, DestinationY )
112 (DestinationX + Width, DestinationY + Height). If DestinationX or
113 DestinationY is not zero then Delta must be set to the length in bytes
114 of a row in the BltBuffer.
116 <B>EfiUgaBltBufferToVideo</B> - Write data from the BltBuffer rectangle
117 (SourceX, SourceY) (SourceX + Width, SourceY + Height) directly to the
118 video display rectangle (DestinationX, DestinationY)
119 (DestinationX + Width, DestinationY + Height). If SourceX or SourceY is
120 not zero then Delta must be set to the length in bytes of a row in the
123 <B>EfiUgaVideoToVideo</B> - Copy from the video display rectangle (SourceX, SourceY)
124 (SourceX + Width, SourceY + Height) .to the video display rectangle
125 (DestinationX, DestinationY) (DestinationX + Width, DestinationY + Height).
126 The BltBuffer and Delta are not used in this mode.
129 @param[in] This - Protocol instance pointer.
130 @param[in] BltBuffer - Buffer containing data to blit into video buffer. This
131 buffer has a size of Width*Height*sizeof(EFI_UGA_PIXEL)
132 @param[in] BltOperation - Operation to perform on BlitBuffer and video memory
133 @param[in] SourceX - X coordinate of source for the BltBuffer.
134 @param[in] SourceY - Y coordinate of source for the BltBuffer.
135 @param[in] DestinationX - X coordinate of destination for the BltBuffer.
136 @param[in] DestinationY - Y coordinate of destination for the BltBuffer.
137 @param[in] Width - Width of rectangle in BltBuffer in pixels.
138 @param[in] Height - Hight of rectangle in BltBuffer in pixels.
139 @param[in] Delta - OPTIONAL
141 @retval EFI_SUCCESS - The Blt operation completed.
142 @retval EFI_INVALID_PARAMETER - BltOperation is not valid.
143 @retval EFI_DEVICE_ERROR - A hardware error occured writting to the video buffer.
148 (EFIAPI
*EFI_UGA_DRAW_PROTOCOL_BLT
)(
149 IN EFI_UGA_DRAW_PROTOCOL
* This
,
150 IN EFI_UGA_PIXEL
* BltBuffer
, OPTIONAL
151 IN EFI_UGA_BLT_OPERATION BltOperation
,
154 IN UINTN DestinationX
,
155 IN UINTN DestinationY
,
158 IN UINTN Delta OPTIONAL
161 struct _EFI_UGA_DRAW_PROTOCOL
{
162 EFI_UGA_DRAW_PROTOCOL_GET_MODE GetMode
;
163 EFI_UGA_DRAW_PROTOCOL_SET_MODE SetMode
;
164 EFI_UGA_DRAW_PROTOCOL_BLT Blt
;
167 extern EFI_GUID gEfiUgaDrawProtocolGuid
;