Share via

DrvGradientFill (Windows Embedded CE 6.0)

  • Article

1/6/2010

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, Ddi_flat_lib.lib, Ddi_gx_lib.lib, Ddi_mq200_lib.lib, Ddi_nop_lib.lib, Ddi_rflat_lib.lib, Ddi_rgx_lib.lib, Ddi_tvia5_lib.lib
Windows Embedded CE Windows CE .NET 4.2 and later

See Also

Reference

Display Driver Functions
XLATEOBJ

Other Resources

Display Drivers
GradientFill
GRADIENT_RECT
RECTL
TRIVERTEX