DrvPaint

BOOL DrvPaint(

    IN SURFOBJ  *pso,
   IN CLIPOBJ  *pco,
   IN BRUSHOBJ  *pbo,
   IN POINTL  *pptlBrushOrg,
   IN MIX  mix
  );

DrvPaint paints a specified region. This function is required if any drawing is to be done on a device-managed surface.

Parameters

pso

Points to a SURFOBJ structure that describes the surface on which to draw.

pco

Points to a CLIPOBJ structure that describes the area to be painted. The CLIPOBJ_Xxx service routines are provided to enumerate the clip region as a set of rectangles.

pbo

Points to a BRUSHOBJ structure that defines the pattern and colors with which to fill.

pptlBrushOrg

Points to a POINTL structure that defines the brush origin, which is used to align the brush pattern on the device.

mix

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

Return Value

The return value is TRUE if the function is successful. Otherwise, it is FALSE, and an error code is logged.

Comments

Vector drivers can support this function with the help of EngCreatePath and the PATHOBJ_Xxx service routines.

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 Win32 SDK.

See Also

BRUSHOBJ, CLIPOBJ, EngCreatePath, PATHOBJ, SURFOBJ