Skip to contents

grid.pattern_magick() draws a imagemagick pattern onto the graphic device. names_magick, names_magick_intensity, and names_magick_stripe are character vectors of supported type values plus subsets for shaded intensity and stripes.

Usage

grid.pattern_magick(
  x = c(0, 0, 1, 1),
  y = c(1, 0, 0, 1),
  id = 1L,
  ...,
  type = "hexagons",
  fill = "grey20",
  scale = 1,
  filter = "box",
  alpha = gp$alpha %||% NA_real_,
  aspect_ratio = 1,
  key_scale_factor = 1,
  res = getOption("ggpattern_res", 72),
  default.units = "npc",
  name = NULL,
  gp = gpar(),
  draw = TRUE,
  vp = NULL
)

names_magick

names_magick_intensity

names_magick_stripe

Format

An object of class character of length 54.

An object of class character of length 21.

An object of class character of length 19.

Arguments

x

A numeric vector or unit object specifying x-locations of the pattern boundary.

y

A numeric vector or unit object specifying y-locations of the pattern boundary.

id

A numeric vector used to separate locations in x, y into multiple boundaries. All locations within the same id belong to the same boundary.

...

Currently ignored.

type

Magick pattern types. names_magick, names_magick_intensity, and names_magick_stripe are character vectors of supported type values plus subsets for shaded intensity and stripes.

fill

Fill colour

scale

Extra scaling

filter

Filter to use when scaling. magick::filter_types() returns a vector of supported values.

alpha

Alpha (between 0 and 1) or NA (default, preserves colors' alpha value).

aspect_ratio

Override aspect ratio.

key_scale_factor

Additional scale factor for legend.

res

Assumed resolution (in pixels per graphic device inch) to use when creating array pattern.

default.units

A string indicating the default units to use if x or y are only given as numeric vectors.

name

A character identifier.

gp

An object of class "gpar", typically the output from a call to the function gpar. This is basically a list of graphical parameter settings.

draw

A logical value indicating whether graphics output should be produced.

vp

A Grid viewport object (or NULL).

Value

A grid grob object invisibly. If draw is TRUE then also draws to the graphic device as a side effect.

See also

The imagemagick documentation http://www.imagemagick.org/script/formats.php for more information.

Examples

  if (requireNamespace("magick")) {
    x_hex <- 0.5 + 0.5 * cos(seq(2 * pi / 4, by = 2 * pi / 6, length.out = 6))
    y_hex <- 0.5 + 0.5 * sin(seq(2 * pi / 4, by = 2 * pi / 6, length.out = 6))
    grid.pattern_magick(x_hex, y_hex, type="octagons", fill="blue", scale=2)
  }


  # supported magick pattern names
  print(names_magick)
#>  [1] "bricks"               "checkerboard"         "circles"             
#>  [4] "crosshatch"           "crosshatch30"         "crosshatch45"        
#>  [7] "fishscales"           "gray0"                "gray5"               
#> [10] "gray10"               "gray15"               "gray20"              
#> [13] "gray25"               "gray30"               "gray35"              
#> [16] "gray40"               "gray45"               "gray50"              
#> [19] "gray55"               "gray60"               "gray65"              
#> [22] "gray70"               "gray75"               "gray80"              
#> [25] "gray85"               "gray90"               "gray95"              
#> [28] "gray100"              "hexagons"             "horizontal"          
#> [31] "horizontal2"          "horizontal3"          "horizontalsaw"       
#> [34] "hs_bdiagonal"         "hs_cross"             "hs_diagcross"        
#> [37] "hs_fdiagonal"         "hs_horizontal"        "hs_vertical"         
#> [40] "left30"               "left45"               "leftshingle"         
#> [43] "octagons"             "right30"              "right45"             
#> [46] "rightshingle"         "smallfishscales"      "vertical"            
#> [49] "vertical2"            "vertical3"            "verticalbricks"      
#> [52] "verticalleftshingle"  "verticalrightshingle" "verticalsaw"