Share via


BRUSHOBJ (Compact 2013)

3/28/2014

The BRUSHOBJ structure contains three public members that describe a brush object.

Syntax

typedef struct _BRUSHOBJ {
  ULONG iSolidColor;
  PVOID pvRbrush;
  FLONG flColorType;
} BRUSHOBJ;

Parameters

  • 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.

Requirements

Header

winddi.h

See Also

Reference

Fonts Structures