Share via


Ternary Raster Operations (Windows CE 5.0)

Send Feedback

Ternary raster operation codes define how the graphics device interface (GDI) combines the bits in a source bitmap with the bits in the destination bitmap.

This topic lists the ternary raster-operation codes used by the BitBlt, PatBlt, and StretchBlt functions.

Each raster-operation code represents a Boolean operation in which the values of the pixels in the source, the selected brush, and the destination are combined.

The following table shows the three operands used in these operations.

Operand Meaning
D Destination bitmap
P Selected brush (also called pattern)
S Source bitmap

The following table shows the Boolean operators used in ternary raster operations.

Operator Meaning
a Bitwise AND
n Bitwise NOT (inverse)
o Bitwise OR
x Bitwise exclusive OR (XOR)

All Boolean operations are presented in reverse Polish notation. For example, the following operation replaces the values of the pixels in the destination bitmap with a combination of the pixel values of the source and brush:

PSo 

The following operation combines the values of the pixels in the source and brush with the pixel values of the destination bitmap (there are alternative spellings of the same function, so although a particular spelling may not be in the list, an equivalent form would be):

DPSoo 

Each raster-operation code is a 32-bit integer whose high-order word is a Boolean operation index and whose low-order word is the operation code.

The 16-bit operation index is a zero-extended, 8-bit value that represents the result of the Boolean operation on predefined brush, source, and destination values.

For example, the operation indexes for the PSo and DPSoo operations are shown in the following table.

P S D PSo DPSoo
0 0 0 0 0
0 0 1 0 1
0 1 0 1 1
0 1 1 1 1
1 0 0 1 1
1 0 1 1 1
1 1 0 1 1
1 1 1 1 1
Operation index:     00FCh 00FEh

In this case, PSo has the operation index 00FC (read from the bottom up); DPSoo has the operation index 00FE.

These values define the location of the corresponding raster-operation codes, as shown in the following Raster-Operation Codes table.

The PSo operation is in line 252 (00FCh) of the table; DPSoo is in line 254 (00FEh).

The most commonly used raster operations have been given special names in the header file Wingdi.h (included through Windows.h).   These common names are shown in table below, use them whenever possible in your applications.

When the source and destination bitmaps are monochrome, a bit value of 0 represents a black pixel and a bit value of 1 represents a white pixel. When the source and the destination bitmaps are color, those colors are represented with RGB values. For more information about RGB values, see RGB.

Raster-Operation Codes

Boolean function (hexadecimal) Raster operation (hexadecimal) Boolean function in reverse Polish Common name
00 00000042 0 BLACKNESS
01 00010289 DPSoon  
02 00020C89 DPSona  
03 000300AA PSon  
04 00040C88 SDPona  
05 000500A9 DPon  
06 00060865 PDSxnon  
07 000702C5 PDSaon  
08 00080F08 SDPnaa  
09 00090245 PDSxon  
0A 000A0329 DPna  
0B 000B0B2A PSDnaon  
0C 000C0324 SPna  
0D 000D0B25 PDSnaon  
0E 000E08A5 PDSonon  
0F 000F0001 Pn  
10 00100C85 PDSona  
11 001100A6 DSon NOTSRCERASE
12 00120868 SDPxnon  
13 001302C8 SDPaon  
14 00140869 DPSxnon  
15 001502C9 DPSaon  
16 00165CCA PSDPSanaxx  
17 00171D54 SSPxDSxaxn  
18 00180D59 SPxPDxa  
19 00191CC8 SDPSanaxn  
1A 001A06C5 PDSPaox  
1B 001B0768 SDPSxaxn  
1C 001C06CA PSDPaox  
1D 001D0766 DSPDxaxn  
1E 001E01A5 PDSox  
1F 001F0385 PDSoan  
20 00200F09 DPSnaa  
21 00210248 SDPxon  
22 00220326 DSna  
23 00230B24 SPDnaon  
24 00240D55 SPxDSxa  
25 00251CC5 PDSPanaxn  
26 002606C8 SDPSaox  
27 00271868 SDPSxnox  
28 00280369 DPSxa  
29 002916CA PSDPSaoxxn  
2A 002A0CC9 DPSana  
2B 002B1D58 SSPxPDxaxn  
2C 002C0784 SPDSoax  
2D 002D060A PSDnox  
2E 002E064A PSDPxox  
2F 002F0E2A PSDnoan  
30 0030032A PSna  
31 00310B28 SDPnaon  
32 00320688 SDPSoox  
33 00330008 Sn NOTSRCCOPY
34 003406C4 SPDSaox  
35 00351864 SPDSxnox  
36 003601A8 SDPox  
37 00370388 SDPoan  
38 0038078A PSDPoax  
39 00390604 SPDnox  
3A 003A0644 SPDSxox  
3B 003B0E24 SPDnoan  
3C 003C004A PSx  
3D 003D18A4 SPDSonox  
3E 003E1B24 SPDSnaox  
3F 003F00EA PSan  
40 00400F0A PSDnaa  
41 00410249 DPSxon  
42 00420D5D SDxPDxa  
43 00431CC4 SPDSanaxn  
44 00440328 SDna SRCERASE
45 00450B29 DPSnaon  
46 004606C6 DSPDaox  
47 0047076A PSDPxaxn  
48 00480368 SDPxa  
49 004916C5 PDSPDaoxxn  
4A 004A0789 DPSDoax  
4B 004B0605 PDSnox  
4C 004C0CC8 SDPana  
4D 004D1954 SSPxDSxoxn  
4E 004E0645 PDSPxox  
4F 004F0E25 PDSnoan  
50 00500325 PDna  
51 00510B26 DSPnaon  
52 005206C9 DPSDaox  
53 00530764 SPDSxaxn  
54 005408A9 DPSonon  
55 00550009 Dn DSTINVERT
56 005601A9 DPSox  
57 00570389 DPSoan  
58 00580785 PDSPoax  
59 00590609 DPSnox  
5A 005A0049 DPx PATINVERT
5B 005B18A9 DPSDonox  
5C 005C0649 DPSDxox  
5D 005D0E29 DPSnoan  
5E 005E1B29 DPSDnaox  
5F 005F00E9 DPan  
60 00600365 PDSxa  
61 006116C6 DSPDSaoxxn  
62 00620786 DSPDoax  
63 00630608 SDPnox  
64 00640788 SDPSoax  
65 00650606 DSPnox  
66 00660046 DSx SRCINVERT
67 006718A8 SDPSonox  
68 006858A6 DSPDSonoxxn  
69 00690145 PDSxxn  
6A 006A01E9 DPSax  
6B 006B178A PSDPSoaxxn  
6C 006C01E8 SDPax  
6D 006D1785 PDSPDoaxxn  
6E 006E1E28 SDPSnoax  
6F 006F0C65 PDSxnan  
70 00700CC5 PDSana  
71 00711D5C SSDxPDxaxn  
72 00720648 SDPSxox  
73 00730E28 SDPnoan  
74 00740646 DSPDxox  
75 00750E26 DSPnoan  
76 00761B28 SDPSnaox  
77 007700E6 DSan  
78 007801E5 PDSax  
79 00791786 DSPDSoaxxn  
7A 007A1E29 DPSDnoax  
7B 007B0C68 SDPxnan  
7C 007C1E24 SPDSnoax  
7D 007D0C69 DPSxnan  
7E 007E0955 SPxDSxo  
7F 007F03C9 DPSaan  
80 008003E9 DPSaa  
81 00810975 SPxDSxon  
82 00820C49 DPSxna  
83 00831E04 SPDSnoaxn  
84 00840C48 SDPxna  
85 00851E05 PDSPnoaxn  
86 008617A6 DSPDSoaxx  
87 008701C5 PDSaxn  
88 008800C6 DSa SRCAND
89 00891B08 SDPSnaoxn  
8A 008A0E06 DSPnoa  
8B 008B0666 DSPDxoxn  
8C 008C0E08 SDPnoa  
8D 008D0668 SDPSxoxn  
8E 008E1D7C SSDxPDxax  
8F 008F0CE5 PDSanan  
90 00900C45 PDSxna  
91 00911E08 SDPSnoaxn  
92 009217A9 DPSDPoaxx  
93 009301C4 SPDaxn  
94 009417AA PSDPSoaxx  
95 009501C9 DPSaxn  
96 00960169 DPSxx  
97 0097588A PSDPSonoxx  
98 00981888 SDPSonoxn  
99 00990066 DSxn  
9A 009A0709 DPSnax  
9B 009B07A8 SDPSoaxn  
9C 009C0704 SPDnax  
9D 009D07A6 DSPDoaxn  
9E 009E16E6 DSPDSaoxx  
9F 009F0345 PDSxan  
A0 00A000C9 DPa  
A1 00A11B05 PDSPnaoxn  
A2 00A20E09 DPSnoa  
A3 00A30669 DPSDxoxn  
A4 00A41885 PDSPonoxn  
A5 00A50065 PDxn  
A6 00A60706 DSPnax  
A7 00A707A5 PDSPoaxn  
A8 00A803A9 DPSoa  
A9 00A90189 DPSoxn  
AA 00AA0029 D  
AB 00AB0889 DPSono  
AC 00AC0744 SPDSxax  
AD 00AD06E9 DPSDaoxn  
AE 00AE0B06 DSPnao  
AF 00AF0229 DPno  
B0 00B00E05 PDSnoa  
B1 00B10665 PDSPxoxn  
B2 00B21974 SSPxDSxox  
B3 00B30CE8 SDPanan  
B4 00B4070A PSDnax  
B5 00B507A9 DPSDoaxn  
B6 00B616E9 DPSDPaoxx  
B7 00B70348 SDPxan  
B8 00B8074A PSDPxax  
B9 00B906E6 DSPDaoxn  
BA 00BA0B09 DPSnao  
BB 00BB0226 DSno MERGEPAINT
BC 00BC1CE4 SPDSanax  
BD 00BD0D7D SDxPDxan  
BE 00BE0269 DPSxo  
BF 00BF08C9 DPSano  
C0 00C000CA PSa MERGECOPY
C1 00C11B04 SPDSnaoxn  
C2 00C21884 SPDSonoxn  
C3 00C3006A PSxn  
C4 00C40E04 SPDnoa  
C5 00C50664 SPDSxoxn  
C6 00C60708 SDPnax  
C7 00C707AA PSDPoaxn  
C8 00C803A8 SDPoa  
C9 00C90184 SPDoxn  
CA 00CA0749 DPSDxax  
CB 00CB06E4 SPDSaoxn  
CC 00CC0020 S SRCCOPY
CD 00CD0888 SDPono  
CE 00CE0B08 SDPnao  
CF 00CF0224 SPno  
D0 00D00E0A PSDnoa  
D1 00D1066A PSDPxoxn  
D2 00D20705 PDSnax  
D3 00D307A4 SPDSoaxn  
D4 00D41D78 SSPxPDxax  
D5 00D50CE9 DPSanan  
D6 00D616EA PSDPSaoxx  
D7 00D70349 DPSxan  
D8 00D80745 PDSPxax  
D9 00D906E8 SDPSaoxn  
DA 00DA1CE9 DPSDanax  
DB 00DB0D75 SPxDSxan  
DC 00DC0B04 SPDnao  
DD 00DD0228 SDno  
DE 00DE0268 SDPxo  
DF 00DF08C8 SDPano  
E0 00E003A5 PDSoa  
E1 00E10185 PDSoxn  
E2 00E20746 DSPDxax  
E3 00E306EA PSDPaoxn  
E4 00E40748 SDPSxax  
E5 00E506E5 PDSPaoxn  
E6 00E61CE8 SDPSanax  
E7 00E70D79 SPxPDxan  
E8 00E81D74 SSPxDSxax  
E9 00E95CE6 DSPDSanaxxn  
EA 00EA02E9 DPSao  
EB 00EB0849 DPSxno  
EC 00EC02E8 SDPao  
ED 00ED0848 SDPxno  
EE 00EE0086 DSo SRCPAINT
EF 00EF0A08 SDPnoo  
F0 00F00021 P PATCOPY
F1 00F10885 PDSono  
F2 00F20B05 PDSnao  
F3 00F3022A PSno  
F4 00F40B0A PSDnao  
F5 00F50225 PDno  
F6 00F60265 PDSxo  
F7 00F708C5 PDSano  
F8 00F802E5 PDSao  
F9 00F90845 PDSxno  
FA 00FA0089 DPo  
FB 00FB0A09 DPSnoo PATPAINT
FC 00FC008A PSo  
FD 00FD0A0A PSDnoo  
FE 00FE02A9 DPSoo  
FF 00FF0062 1 WHITENESS

See Also

Raster Operation Codes | Binary Raster Operations | BitBlt | PatBlt | StretchBlt | MAKEROP4

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.