applies the function f to the list of channel values for each pixel in image.


applies f to the sequence of corresponding pixel values taken from each imagei.

Details and Options

  • ImageApply[f,image] replaces the list of channel values for each pixel by the result of applying the function f to the list.
  • ImageApply works with 2D and 3D images with any number of channels.
  • ImageApply[f,image] returns an image of the same type as image.
  • In ImageApply[f,image], the function f can return a number or a list of any length.
  • The channel values supplied to f are normally in the range 0 to 1, regardless of the underlying type used in the Image object. The function f is assumed to return channel values that are normally in the range 0 to 1.
  • In ImageApply[f,{image1,image2,,imagen}], f is supplied with n arguments. »
  • ImageApply[f,{image1,image2,}] works with any number of commensurate images.
  • ImageApply[f,{image1,image2,}] gives an image with the largest type of imagei, clipping or truncating values if necessary.
  • ImageApply has the option Interleaving, which specifies whether f should be applied to individual channel values or to the complete list of channel values for a given pixel. The default setting is Interleaving->True.
  • With the setting Masking->roi, a region of interest to be processed can be specified.
  • In ImageApply[f,image], evaluations of f may be cached to focus on speed of getting a result.  »


open allclose all

Basic Examples  (2)

Replace each pixel with the maximum of the color channels:

Click for copyable input

Compute the average of three color images:

Click for copyable input

Scope  (5)

Options  (4)

Applications  (8)

Properties & Relations  (2)

Possible Issues  (2)

Neat Examples  (4)

See Also

ImageApplyIndexed  ImageScan  ImageAdd  ImageMultiply  ImageFilter  ColorNegate  ColorConvert  MapThread


Introduced in 2008
| Updated in 2012