ImageRecolor
ImageRecolor[image,regioncolor]
recolors pixels in image specified by region using the specified color.
ImageRecolor[image,{region1color1,…}]
recolors multiple regions.
ImageRecolor[video,…]
recolors frames of a video.
Details and Options
- ImageRecolor can be used to replace pixels in a region with a solid color or a region consisting of shades of one color with shades of another color.
- ImageRecolor works with arbitrary 2D and 3D images.
- The region can be specified using any of the following:
-
col pixels with values close to col maskimage grayscale or binary mask image ColorsNear[col,…] pixels defined by a specific ColorsNear object ImageMarker[markerimage] marker image used to compute the color to be replaced - Use ImageRecolor[img,col1col2] to swap two colors. »
- For video inputs, the recolor specification can be a fixed specification for all frames or a function of time (in seconds from the start).
- The following options can be given:
-
DistanceFunction Automatic color distance metric to use MaxColorDistance 0.1 maximum distance from the reference color Method "BrightnessPreserving" method to use - DistanceFunction supports all the distance metrics available in ColorDistance.
- Possible settings for Method include:
-
"BrightnessPreserving" replace hue and saturation, preserving the brightness "SaturationPreserving" replace brightness and hue, preserving the saturation "HuePreserving" replace brightness and saturation, preserving the hue "Brightness" replace brightness only "Saturation" replace saturation only "Hue" replace hue only
Examples
open allclose allScope (10)
Color Specification (8)
Options (3)
DistanceFunction (1)
The default color distance is the EuclideanDistance in the Lab color space:
Use DistanceFunction to select a specific distance:
MaxColorDistance (1)
Use MaxColorDistance to define the maximum distance from the reference color:
Method (1)
By default, both hue and saturation of a color are replaced:
Use Method to specify a replacement target:
Applications (4)
Properties & Relations (7)
Color space and data type of the input image may be affected by the color replacement:
Replacing pixels of a grayscale image with color values will result in a color image:
Replacing with colors not representable in integer images will result in a type change:
Replacing a color with a transparent color will add an alpha channel to the image:
Pixels affected by a replacement will not be further processed:
Smaller values of MaxColorDistance allow finer control:
Using TwoWayRule is equivalent to two successive recolorings:
ColorReplace is used to replace a color region with an exact color:
ImageRecolor by default preserves the brightness of the replaced colors:
ImageRecolor performs the replacement in the region defined by the reference color:
ColorBalance scales every color in the image to match the reference color with the destination color:
FindMatchingColor can be used to improve reference color selection. Recolor yellow regions of an image:
Text
Wolfram Research (2019), ImageRecolor, Wolfram Language function, https://reference.wolfram.com/language/ref/ImageRecolor.html (updated 2021).
CMS
Wolfram Language. 2019. "ImageRecolor." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2021. https://reference.wolfram.com/language/ref/ImageRecolor.html.
APA
Wolfram Language. (2019). ImageRecolor. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/ImageRecolor.html