drvGradientFill 函数 (winddi.h)

  • 项目

DrvGradientFill 函数对指定的基元进行着色。

语法

BOOL DrvGradientFill(
  [in, out]      SURFOBJ   *psoDest,
  [in]           CLIPOBJ   *pco,
  [in, optional] XLATEOBJ  *pxlo,
  [in]           TRIVERTEX *pVertex,
  [in]           ULONG     nVertex,
  [in]           PVOID     pMesh,
  [in]           ULONG     nMesh,
  [in]           RECTL     *prclExtents,
  [in]           POINTL    *pptlDitherOrg,
  [in]           ULONG     ulMode
);

参数

[in, out] psoDest

指向 SURFOBJ 结构的指针，该结构标识要绘制的图面。

[in] pco

指向 CLIPOBJ 结构的指针。 提供 CLIPOBJ_Xxx 服务例程以一组矩形的形式枚举 剪辑区域 。 此枚举限制修改的目标区域。 GDI 尽可能简化涉及的剪裁。

[in, optional] pxlo

指向 XLATEOBJ 结构的指针。 驱动程序应忽略此参数。

[in] pVertex

指向 TRIVERTEX 结构数组的指针，其中每个条目都包含位置和颜色信息。 MICROSOFT WINDOWS SDK文档中介绍了 TRIVERTEX 结构。

[in] nVertex

指定 数组中 pVertex 指向的 TRIVERTEX 结构的数目。

[in] pMesh

指向结构的数组的指针，这些结构定义 pVertex 指向的 TRIVERTEX 元素的连接。

绘制矩形时， pMesh 指向GRADIENT_RECT结构的数组，其中每个结构指定两个定义矩形的 TRIVERTEX 元素。 TRIVERTEX 元素可以表示任何对角相对的矩形顶点对。 矩形绘图在右下角是独占的。 TRIVERTEX 和 GRADIENT_RECT 均在 Windows SDK 文档中定义。

绘制三角形时， pMesh 指向GRADIENT_TRIANGLE结构的数组，其中每个结构指定定义三角形的三个 TRIVERTEX 元素。 三角形绘图在右下角是独占的。 Windows SDK文档中定义了GRADIENT_TRIANGLE。

[in] nMesh

指定 数组中 pMesh 指向的元素数。

[in] prclExtents

指向 RECTL 结构的指针，该结构定义渐变绘制所在的区域。 这些点在目标图面的坐标系中指定。 此参数可用于估算绘图操作的大小。

[in] pptlDitherOrg

指向 POINTL 结构的指针，该结构定义图面上的原点进行抖减。 抖变图案的左上角像素与此点对齐。

[in] ulMode

指定当前绘制模式以及如何解释 pMesh 指向的数组。 此参数可能是以下值之一：

GRADIENT_FILL_RECT_H

pMesh 参数指向GRADIENT_RECT结构的数组。 每个矩形都将从左到右进行着色。 具体而言，左上角和左下角像素的颜色与右上角和右下角像素的颜色相同。

GRADIENT_FILL_RECT_V

pMesh 参数指向GRADIENT_RECT结构的数组。 每个矩形都将从上到下进行着色。 具体而言，左上角和右上方像素的颜色相同，左下角和右下角像素也相同。

GRADIENT_FILL_TRIANGLE

pMesh 参数指向GRADIENT_TRIANGLE结构的数组。

每个模式的 渐变填充 计算记录在“备注”部分中。

返回值

成功后，DrvGradientFill 返回 TRUE 。 否则，它将返回 FALSE ，并通过调用 EngSetLastError 报告错误。

注解

DrvGradientFill 可以选择在图形驱动程序中实现。 GDI 从不对托盘化表面调用此函数。

驱动程序在调用 EngAssociateSurface 或 EngModifySurface 时通过设置 HOOK_GRADIENTFILL 标志来挂钩 DrvGradientFill。 如果驱动程序已挂钩 DrvGradientFill 并被调用以执行它不支持的操作，则驱动程序应让 GDI 通过对 EngGradientFill 的调用中的数据来处理该操作。

GDI 不会对 8bpp 目标图面调用 DrvGradientFill 。

用于计算基元每个像素的颜色值的公式取决于 ulMode ，如下所示：

所有三个颜色通道累计的总误差不得超过 8 (8) 。 有关允许的错误的详细信息，请参阅 显示驱动程序中的特殊效果。

驱动程序应忽略顶点的 alpha 值，使支持 alpha 混合的图面的 alpha 通道保持不变。

要求

要求 值
目标平台 桌面
标头 winddi.h (包括 Winddi.h)

另请参阅

EngAssociateSurface

EngGradientFill