[Overview][Constants][Types][Classes][Procedures and functions][Variables][Index] | Reference for unit 'Graphics' (#lcl)

# TPen.Mode

Pen mode for the class instance.

## Declaration

Source position: graphics.pp line 691

`published property TPen.Mode default pmCopy;`

## Description

Mode is a TFPPenMode property which contains the pen mode used in the class instance. A pen mode indicates the raster operation performed to combine the pen color with existing pixels in the destination bitmap. Mode can contain any of the values:

pmBlack
  Pixels affected by the pen are always set to black.
pmWhite
  Pixels affected by the pen are always set to white.
pmNop
  Pixels affected by the pen are unchanged.
pmNot
  Pixels affected by the pen are set to the inverse for the current color.
pmCopy
  Pixels affected by the pen are set to the pen color.
pmNotCopy
  Pixels affected by the pen are set to the inverse of the pen color.
pmMergePenNot
  Pixels affected by the pen are set to a combination of the pen color and the inverse of the pixel color.
pmMaskPenNot
  Pixels affected by the pen are set to colors common to both the pen and the inverse of the pixel color.
pmMergeNotPen
  Pixels affected by the pen are set to a combination of the pen color and the inverse of the pixel color.
pmMaskNotPen
  Pixels affected by the pen are set to a combination of the colors common to the inverse of the pen color and the current pixel color.
pmMerge
  Pixels affected by the pen are set to a combination of the pen color and the current pixel color.
pmNotMerge
  Pixels affected by the pen are set to the inverse of the color derived using pmMerge pen mode.
pmMask
  Pixels affected by the pen are set a combination of the colors common to the pen color and the current pixel color.
pmNotMask
  Pixels affected by the pen are set to the inverse of the color for pmMask pen mode.
pmXor
  Pixels affected by the pen are set to a combination of the pen color and the current pixel color, but not both.
pmNotXor
  Pixels affected by the pen are set to the inverse of the color using pmXor pen mode.

The default value for the property is pmCopy.