| Extracted from Pike v7.8 release 866 at 2018-02-09.

[Top]
Image
Image.Image

# Method Image.Image()->outline()

Method outline

  `object outline()`
  `object outline(int olr, int olg, int olb)`
  `object outline(int olr, int olg, int olb, int bkgr, int bkgg, int bkgb)`
  `object outline(array(array(int)) mask)`
  `object outline(array(array(int)) mask, int olr, int olg, int olb)`
  `object outline(array(array(int)) mask, int olr, int olg, int olb, int bkgr, int bkgg, int bkgb)`
  `object outline_mask()`
  `object outline_mask(int bkgr, int bkgg, int bkgb)`
  `object outline_mask(array(array(int)) mask)`
  `object outline_mask(array(array(int)) mask, int bkgr, int bkgg, int bkgb)`

Description

  Makes an outline of this image, ie paints with the given color around the non-background pixels.

  Default is to paint above, below, to the left and the right of these pixels.

  You can also run your own outline mask.

  The outline_mask function gives the calculated outline as an alpha channel image of white and black instead.

  original | masked through threshold | ...and outlined with red

Parameter `mask`

  mask matrix. Default is `({({0,1,0}),({1,1,1}),({0,1,0})})`.

Parameter `olr`
Parameter `olg`
Parameter `olb`

  outline color. Default is current.

Parameter `bkgr`
Parameter `bkgg`
Parameter `bkgb`

  background color (what color to outline to); default is color of pixel 0,0.

Parameter `div`

  division factor, default is 1.0.

Returns

  the new image object

Note

  no antialias!