Ternary Raster Operations (Compact 2013)

Article
04/19/2017

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

Share via

Ternary Raster Operations (Compact 2013)

Raster-Operation Codes

See Also

Reference

Additional resources