Pattern Format for _setfillmask()

 Last reviewed: July 17, 1997
Article ID: Q39215
5.10 6.00 6.00a 6.00ax 7.00 | 5.10 6.00 6.00a | 1.00 1.50 
MS-DOS                      | OS/2            | WINDOWS
kbprg

The information in this article applies to:

  • The C Run-time (CRT), included with: 

        - Microsoft C for MS-DOS, versions 5.1, 6.0, 6.0a, and 6.0ax
    - Microsoft C for OS/2, versions 5.1, 6.0, and 6.0a
    - Microsoft C/C++ for MS-DOS, version 7.0
    - Microsoft Visual C++ for Windows, versions 1.0 and 1.5

SUMMARY

The _setfillmask() function sets a background pattern using repeated 8-by-8 pixel patterns. The mask consists of an 8-byte character array.

MORE INFORMATION

The following example illustrates a pixel pattern: 

                         Powers of 2

    decimal:   128  64  32  16  08  04  02  01
        hex:    80  40  20  10  08  04  02  01
               --------------------------------
       byte 1 |      1   1           1   1        =   0x66
       byte 2 |      1   1           1   1        =   0x66
       byte 3 |                                   =   0x00
       byte 4 |                  1                =   0x08
       byte 5 |              1   1                =   0x18
       byte 6 |  1                           1    =   0x81
       byte 7 |      1                   1        =   0x42
       byte 8 |          1   1   1   1            =   0x3C
The character array for this particular fill mask would be declared in a C program as follows: 

   unsigned char *maskarray = "\x66\x66\x00\x08\x18\x81\x42\x3C";
When the fill mask above is used with _setfillmask() and a graphics function such as _rectangle() or _ellipse(), the pattern creates a continuous field of faces.

Additional reference words: kbinf 5.10 6.00 6.00a 6.00ax 7.00 1.00 1.50
KBCategory: kbprg
KBSubcategory: CRTIss GraphicsIss
Keywords : kb16bitonly

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Last reviewed: July 17, 1997
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.