Expand Minimize

EngStrokeAndFillPath function

The EngStrokeAndFillPath function causes GDI to fill a path and stroke it at the same time.

Syntax


BOOL EngStrokeAndFillPath(
       SURFOBJ   *pso,
       PATHOBJ   *ppo,
       CLIPOBJ   *pco,
       XFORMOBJ  *pxo,
       BRUSHOBJ  *pboStroke,
       LINEATTRS *plineattrs,
       BRUSHOBJ  *pboFill,
       POINTL    *pptlBrushOrg,
  _In_ MIX       mixFill,
  _In_ FLONG     flOptions
);

Parameters

pso

Pointer to a SURFOBJ structure that defines the drawing surface.

ppo

Pointer to a PATHOBJ structure that defines the path to be filled. The PATHOBJ_Xxx service routines are provided to enumerate the lines, Bezier curves, and other data that make up the path.

pco

Pointer to a CLIPOBJ structure. The CLIPOBJ_Xxx service routines are provided to enumerate the clip region as a set of rectangles.

pxo

Pointer to a XFORMOBJ structure that is only needed when a geometric wide line is to be drawn and specifies the transform that converts world coordinates to device coordinates. The path is provided in device coordinates but a geometric wide line is actually widened in world coordinates.

The driver can use the XFORMOBJ_Xxx service routines to determine the transform.

pboStroke

Pointer to a BRUSHOBJ structure that describes the brush to use when stroking the path.

plineattrs

Pointer to a LINEATTRS structure.

pboFill

Pointer to a BRUSHOBJ structure that describes the brush to use when filling the path.

pptlBrushOrg

Pointer to a POINTL structure that defines the brush origin for both brushes.

mixFill [in]

Defines the foreground and background raster operations to use for the fill brush.

flOptions [in]

Specifies which fill mode to use. This parameter can be FP_WINDINGMODE or FP_ALTERNATEMODE; all other bits should be ignored. For more information about these modes, see Path Fill Modes.

Return value

The return value is TRUE if GDI fills the path. If the driver should fill the path, the return value is FALSE, and an error code is not logged. If GDI encounters an unexpected error, such as not being able to realize the brush, the return value is DDI_ERROR, and an error code is logged.

Remarks

The mix mode defines how the incoming pattern should be mixed with the data already on the device surface. The MIX data type consists of two ROP2 values packed into a single ULONG. The low-order byte defines the foreground raster operation; the next byte defines the background raster operation. For more information about raster operation codes, see the Microsoft Windows SDK documentation.

Requirements

Target platform

Universal

Version

Available in Windows 2000 and later versions of the Windows operating systems.

Header

Winddi.h (include Winddi.h)

Library

Win32k.lib

DLL

Win32k.sys

See also

BRUSHOBJ
CLIPOBJ
DrvStrokeAndFillPath
LINEATTRS
PATHOBJ
SURFOBJ
XFORMOBJ

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft