DrvGradientFill (Compact 2013)
3/26/2014
This function translates between device-managed raster surfaces and graphics device interface (GDI) standard format bitmaps.
Syntax
BOOL DrvGradientFill(
SURFOBJ* pso,
CLIPOBJ* pco,
XLATEOBJ* pxlo,
TRIVERTEX* pVertex,
ULONG nVertex,
PVOID pMesh,
ULONG nMesh,
RECTL* prclExtents,
POINTL* pptlDitherOrg,
ULONG ulMode
);
Parameters
- pso
[out] Pointer to the destination surface for the gradient fill operation.
- pco
[in] Pointer to a CLIPOBJ structure that defines a clipping region on the destination surface.
- pxlo
[in] Pointer to a XLATEOBJ structure that defines the translation of color indices between the source and target surfaces.
- pVertex
[in] Pointer to an array of TRIVERTEX structures, each of which defines a triangle vertex.
- nVertex
[in] Number of vertices in the pVertex parameter.
- pMesh
[in] Array of GRADIENT_RECT structures in rectangle mode.
- nMesh
[in] Number of rectangles in the pMesh parameter.
- prclExtents
[in] Pointer to a RECTL structure that defines the area to modify. This structure uses the coordinate system of the destination surface. The bottom and right edges of this rectangle are not part of the blit; that is, the rectangle is bottom-right exclusive.
- pptlDitherOrg
[in] Pointer to a POINTL structure that defines the upper-left corner of the destination surface.
ulMode
[in] Gradient fill mode. The following table shows the possible values for the ulMode parameter.Value
Description
GRADIENT_FILL_RECT_H
Two endpoints describe a rectangle. The rectangle is defined to have a constant color, specified by the TRIVERTEX structure, for the left and right edges. GDI interpolates the color from the left-to-right edge and fills the interior.
GRADIENT_FILL_RECT_V
Two endpoints describe a rectangle. The rectangle is defined to have a constant color, specified by the TRIVERTEX structure, for the top and bottom edges. GDI interpolates the color from the top-to-bottom edge and fills the interior.
GRADIENT_FILL_TRIANGLE
Not supported.
Return Value
TRUE indicates success. FALSE indicates failure.
Remarks
Set SYSGEN_GRADFILL for the GradientFill function to be available to GDI. __SYSGEN_GPE_GRADFILL is set automatically when you set SYSGEN_GRADFILL. If the display driver is not GPE-based, the display driver has to export the DrvGradientFill function, and set SYSGEN_GRADFILL.
Requirements
Header |
winddi.h |
Library |
Ddi_ati_lib.lib, |
sysgen |
SYSGEN_MINGDI |
See Also
Reference
Display Driver Functions
XLATEOBJ