Windows 3.1 Device Drivers (ddag31qh.hlp) (Table of Contents; Topic list)
ScanLR
                                                     Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
WORD ScanLR(lpDestDev, X, Y, dwPhysColor, Style)
LPPDEVICE lpDestDev;
WORD X;
WORD Y;
PCOLOR dwPhysColor;
WORD Style;
 
The ScanLR function scans the display surface horizontally from the given
pixel, looking for the first pixel having the given color or a pixel that
has any other color. The scan can be left or right. GDI calls this function
when an application calls the FloodFill or ExtFloodFill function (GDI.25 or
GDI.372).
 
A graphics driver must export the ScanLR function if it sets the
DT_RASDISPLAY value in the dpTechnology member of the GDIINFO structure.
 
Parameter    Description
────────────────────────────────────────────────────────────────────────────
 
lpDestDev    Points to a PDEVICE or PBITMAP structure specifying the
             destination device or bitmap.
 
X            Specifies the x-coordinate of the starting pixel.
 
Y            Specifies the y-coordinate of the starting pixel.
 
dwPhysColor  Specifies a physical color value.
 
Style        Specifies the action to take. The parameter can be a
             combination of the following values.
 
             Value   Meaning
             ───────────────────────────────────────────────────────────────
             0x0001  Scans for a pixel with color matching the dwPhysColor
                     parameter. If this value is not given, the function
                     scans for a pixel with color that does not match.
 
             0x0002  Scans to the left. If this value is not specified, the
                     function scans to the right.
 
Return Value
 
The return value is the x-coordinate of the first qualifying pixel.
Otherwise, it is -1 if no qualifying pixel is found. The return value is
0x8000 if the X or Y parameters specify coordinates that exceed the display
surface or bitmap boundaries.
 
Comments
 
The export ordinal for this function is 12.
 
                                      ♦