Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The BRUSHOBJ structure contains three public members that describe a brush object.
Syntax
typedef struct _BRUSHOBJ {
ULONG iSolidColor;
PVOID pvRbrush;
FLONG flColorType;
} BRUSHOBJ;
Members
iSolidColor
Specifies the color index of a solid brush. This index has been translated to the target surface's palette. Drawing can proceed without realization of the brush. A value of 0xFFFFFFFF indicates that a nonsolid brush must be realized.
pvRbrush
Pointer to the driver's realized brush.
flColorType
Specifies an FLONG value containing flags that describe this brush object. This member can be a combination of any of the following values (only one of BR_HOST_ICM and BR_DEVICE_ICM can be set):
| Value | Meaning |
|---|---|
| BR_CMYKCOLOR | When this bit is set, iSolidColor contains a 32-bit CMYK color value. Otherwise, iSolidColor contains a palette index or 0xFFFFFFFF. |
| BR_DEVICE_ICM | The driver performs image color management for the brush color. |
| BR_HOST_ICM | The driver need not perform image color management for the brush color because GDI (or the calling application) is responsible. |
Remarks
Drivers can call BRUSHOBJ_Xxx service routines to realize brushes or to find previously realized brushes.
If the iSolidColor member is 0xFFFFFFFF or the pvRbrush member is NULL, the driver must call the BRUSHOBJ_pvGetRbrush function to realize the brush.
If neither BR_HOST_ICM or BR_DEVICE_ICM are set, ICM is not enabled in the graphics engine or in the driver.
For a description of the FLONG data type, see GDI Data Types.
Requirements
| Requirement | Value |
|---|---|
| Header | winddi.h (include Winddi.h) |
See also
BRUSHOBJ_pvGetRbrush