Epson Research and Development
Page 117
Vancouver Design Center
14.2.3 Surface Support
The S1D13506 HAL library depends heavily on the concept of surfaces. Through surfaces
the HAL tracks memory requirements of the attached display devices, hardware cursor and
ink layers, and the Dual Panel buffer.
Surfaces allow the HAL to permit or fail function calls which change the geometry of the
S1D13506 display memory. Most HAL functions either allocate surface memory or manip-
ulate a surface that has been allocated.
The functions in this sections allow the application programmer a little greater control over
surfaces.
int seGetSurfaceDisplayMode(void)
Description:
Parameters:
Return Value:
This function determines the type of display associated with the current active surface.
None.
The return value indicates the active surface display type. Return values will be one of:
LCD
CRT
TV
The LCD panel is the active surface.
The CRT display is the active surface.
The TV is the active display.
DWORD seGetSurfaceSize(void)
Description:
This function returns the number of display memory bytes allocated to the current active
surface. The return value does not account for the size for the hardware cursor or ink layer
which may be associated with the surface.
Parameters:
None.
Return Value:
The return value is the number of bytes allocated to the current active surface.
The return value can be 0 if this function is called before initializing and making active a
surface.
DWORD seGetSurfaceLinearAddress(void)
Description:
Parameters:
Return Value:
This function returns the linear address of the start of memory for the active surface.
None.
The return value is the linear address to the start of memory for the active surface. A linear
address is a 32-bit offset, in CPU address space.
The return value will be NULL if this function is called before a surface has been initial-
ized and made active.
Note
On 16-bit Intel platforms, this function will always return NULL. The PCI memory may
be located beyond the addressing range of 16-bit programs so all S1D13505 controller
accesses must be made through the HAL.
Programming Notes and Examples
Issue Date: 01/02/06
S1D13506
X25B-G-003-03
EPSON [ EPSON COMPANY ]
