magick: painting – R documentation

Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!

painting

Image Painting

Description

The image_fill() function performs flood-fill by painting starting point and all neighboring pixels of approximately the same color. Annotate prints some text on the image.

Usage

image_fill(image, color, point = "+1+1", fuzz = 0, refcolor = NULL)

image_annotate(
  image,
  text,
  gravity = "northwest",
  location = "+0+0",
  degrees = 0,
  size = 10,
  font = "",
  style = "normal",
  weight = 400,
  kerning = 0,
  decoration = NULL,
  color = NULL,
  strokecolor = NULL,
  boxcolor = NULL
)

Arguments

`image`	magick image object returned by `image_read()` or `image_graph()`
`color`	a valid color string such as `"navyblue"` or `"#000080"`. Use `"none"` for transparency.
`point`	a geometry_point string indicating the starting point of the flood-fill
`fuzz`	relative color distance (value between 0 and 100) to be considered similar in the filling algorithm
`refcolor`	if set, `fuzz` color distance will be measured against this color, not the color of the starting `point`. Any color (within `fuzz` color distance of the given `refcolor`), connected to starting point will be replaced with the `color`. If the pixel at the starting point does not itself match the given `refcolor` (according to `fuzz`) then no action will be taken.
`text`	character vector of length equal to 'image' or length 1
`gravity`	string with gravity value from gravity_types.
`location`	geometry string with location relative to `gravity`
`degrees`	rotates text around center point
`size`	font-size in pixels
`font`	string with font family such as `"sans"`, `"mono"`, `"serif"`, `"Times"`, `"Helvetica"`, `"Trebuchet"`, `"Georgia"`, `"Palatino"` or `"Comic Sans"`.
`style`	value of style_types for example `"italic"`
`weight`	thickness of the font, 400 is normal and 700 is bold.
`kerning`	increases or decreases whitespace between letters
`decoration`	value of decoration_types for example `"underline"`
`strokecolor`	a color string adds a stroke (border around the text)
`boxcolor`	a color string for background color that annotation text is rendered on.

Details

Note that more sophisticated drawing mechanisms are available via the graphics device using image_draw.

Setting a font, weight, style only works if your imagemagick is compiled with fontconfig support.

Examples

logo <- image_read("logo:")
logo <- image_background(logo, 'white')
image_fill(logo, "pink", point = "+450+400")
image_fill(logo, "pink", point = "+450+400", fuzz = 25)
# Add some text to an image
image_annotate(logo, "This is a test")
image_annotate(logo, "CONFIDENTIAL", size = 50, color = "red", boxcolor = "pink",
 degrees = 30, location = "+100+100")

# Setting fonts requires fontconfig support (and that you have the font)
image_annotate(logo, "The quick brown fox", font = "monospace", size = 50)

magick

Advanced Graphics and Image-Processing in R

v2.7.2

MIT + file LICENSE

Authors

Jeroen Ooms [aut, cre] (<https://orcid.org/0000-0002-4035-0289>)

Initial release