2.3.4.8 META_DIBCREATEPATTERNBRUSH Record
The META_DIBCREATEPATTERNBRUSH Record creates a Brush Object (section 2.2.1.1) with a pattern specified by a DeviceIndependentBitmap (DIB) Object (section 2.2.2.9).
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
RecordSize |
|||||||||||||||||||||||||||||||
|
RecordFunction |
Style |
||||||||||||||||||||||||||||||
|
ColorUsage |
Target (variable) |
||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
RecordSize (4 bytes): A 32-bit unsigned integer that defines the number of WORD structures, defined in [MS-DTYP] section 2.2.61, in the WMF record.
RecordFunction (2 bytes): A 16-bit unsigned integer that defines this record type. The lower byte MUST match the lower byte of the RecordType Enumeration (section 2.1.1.1) table value META_DIBCREATEPATTERNBRUSH.
Style (2 bytes): A 16-bit unsigned integer that defines the brush style. The legal values for this field are defined as follows: if the value is not BS_PATTERN, BS_DIBPATTERNPT MUST be assumed. These values are specified in the BrushStyle Enumeration (section 2.1.1.4).
ColorUsage (2 bytes): A 16-bit unsigned integer that defines whether the Colors field of a DIB Object contains explicit RGB values, or indexes into a palette.
-
If the Style field specifies BS_PATTERN, a ColorUsage value of DIB_RGB_COLORS MUST be used regardless of the contents of this field.
-
If the Style field specified anything but BS_PATTERN, this field MUST be one of the values in the ColorUsage Enumeration (section 2.1.1.6).
Target (variable): Variable-bit DIB Object data that defines the pattern to use in the brush.
The following table shows the types of Brush Objects created by the META_DIBCREATEPATTERNBRUSH Record (section 2.3.4.8), according to BrushStyle Enumeration values.
|
BrushStyle |
ColorUsage |
Brush Object created |
|---|---|---|
|
BS_SOLID |
Same as the following BS_DIBPATTERNPT. |
Same as the following BS_DIBPATTERNPT. |
|
BS_NULL |
Same as the following BS_DIBPATTERNPT. |
Same as the following BS_DIBPATTERNPT. |
|
BS_PATTERN |
A ColorUsage Enumeration value, which SHOULD define how to interpret the logical color values in the brush pattern. |
A BS_PATTERN Brush Object that SHOULD contain a pattern defined by a Bitmap16 Object (section 2.2.2.1). |
|
BS_DIBPATTERNPT |
A ColorUsage Enumeration value, which SHOULD define how to interpret the logical color values in the brush pattern. |
A BS_DIBPATTERNPT Brush Object that SHOULD contain a pattern defined by a DIB Object. |
|
BS_HATCHED |
Same as the preceding BS_DIBPATTERNPT. |
Same as preceding BS_DIBPATTERNPT. |
See section 2.3.4 for the specification of other Object Records.