Epson S1D13706 - Page 251

Epson Research and Development
Page 91
Vancouver Design Center
Programming Notes and Examples S1D13706
Issue Date: 01/02/23 X31B-G-003-03
void seDrawLine(long x1, long y1, long x2, long y2, DWORD Color)
void seDrawMainWinLine(long x1, long y1, long x2, long y2, DWORD Color)
void seDrawSubWinLine(long x1, long y1, long x2, long y2, DWORD Color)
Description:
These functions draw a line between two points in the specified color.
Use seDrawLine() to draw a line on the current active surface. See seSetMainWinAsAc-
tiveSurface() and seSetSubWinAsActiveSurface() for information about changing the
active surface.
Use seDrawMainWinLine() and seDrawSubWinLine() to draw a line on the surface refer-
enced by the function name.
If no memory was allocated to the surface, these functions return without writing to dis-
play memory.
Parameters:
x1 The X co-ordinate, in pixels, of the first endpoint of the line to be
drawn.
y1 The Y co-ordinate, in pixels, of the first endpoint of the line to be
drawn.
x2 The X co-ordinate, in pixels, of the second endpoint of the line to be
drawn.
y2 The Y co-ordinate, in pixels, of the second endpoint of the line to be
drawn.
Color Specifies the color to draw the line with. Color is interpreted differently
at different color depths.
At 1, 2, 4 and 8 bpp, display colors are derived from the lookup table
values. The least significant byte of Color is an index into the lookup
table.
At 16 bpp the lookup table is bypassed and each word of
display memory forms the color to display. In this mode the least
significant word describes the color to draw the line with in 5-6-5 RGB
format.
Return Value:
None.