Ternary Raster Operations (Compact 2013)
3/28/2014
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
Reference
Raster Operation Codes
Binary Raster Operations
BitBlt
PatBlt
StretchBlt
MAKEROP4