Package org.apache.poi.hwmf.record

Enum HwmfTernaryRasterOp

java.lang.Object
java.lang.Enum<HwmfTernaryRasterOp>
org.apache.poi.hwmf.record.HwmfTernaryRasterOp
All Implemented Interfaces:
Serializable, Comparable<HwmfTernaryRasterOp>, java.lang.constant.Constable
public enum HwmfTernaryRasterOp extends Enum<HwmfTernaryRasterOp>
Each ternary 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. Following are the three operands used in these operations.
Raster-operation code meaning
OperandMeaning
DDestination bitmap
PSelected brush (also called pattern)
SSource bitmap
Following are the Boolean operators used in these operations.
Boolean operator meaning
OperandMeaning
aBitwise AND
nBitwise NOT (inverse)
oBitwise OR
xBitwise 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: DPSoo (there are alternative spellings of some functions, so although a particular spelling MAY NOT be listed in the enumeration, an equivalent form SHOULD be). 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 list.
Raster-operation examples
PSDDPoDPan
00000
00101
01011
01111
10011
10111
11011
11111
The operation indexes are determined by reading the binary values in a column of the table from the bottom up. For example, in the PSo column, the binary value is 11111100, which is equivalent to 00FC (hexadecimal is implicit for these values), which is the operation index for PSo. Using this method, DPSoo can be seen to have the operation index 00FE. Operation indexes define the locations of corresponding raster operation codes in the preceding enumeration. The PSo operation is in line 252 (0x00FC) of the enumeration; DPSoo is in line 254 (0x00FE). The most commonly used raster operations have been given explicit enumeration names, which SHOULD be used; examples are PATCOPY and WHITENESS. 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 red green blue (RGB) values.