Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                                     ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
DWORD Pixel(lpDestDev, X, Y, dwPhysColor, lpDrawMode)
LPPDEVICE lpDestDev;
WORD X;
WORD Y;
DWORD dwPhysColor;
LPDRAWMODE lpDrawMode;
 
The Pixel function sets or retrieves the color of the specified pixel. The
function sets the given pixel to the color given by the dwPhysColor
parameter if the lpDrawMode parameter specifies a binary-raster operation.
Pixel returns the physical color of the pixel if the lpDrawMode parameter is
NULL. GDI calls this function when simulating output or when an application
calls the SetPixel or GetPixel function (GDI.31 or GDI.83).
 
Every graphics driver must export a Pixel function.
 
Parameter    Description
────────────────────────────────────────────────────────────────────────────
 
lpDestDev    Points to a PDEVICE or PBITMAP structure specifying the
             destination device or bitmap.
 
X            Specifies the x-coordinate of the pixel to retrieve or set.
 
Y            Specifies the y-coordinate of the pixel to retrieve or set.
 
dwPhysColor  Specifies the physical color value used to set the pixel.
 
lpDrawMode   Points to a DRAWMODE structure specifying the binary-raster
             operation to use to combine the physical color with the
             existing pixel color.
 
             If lpDrawMode is NULL, Pixel retrieves and returns the current
             color of the specified pixel.
 
Return Value
 
The return value is either the physical color of the specified pixel or 1
depending on whether lpDrawMode is NULL, if the function is successful.
Otherwise, the function returns 0x80000000L.
 
Comments
 
The export ordinal for this function is 9.
 
                                      ♦