grid.pattern_text {gridpattern} | R Documentation |
Text character patterned grobs
Description
grid.pattern_text()
draws a text character pattern onto the graphic device.
Usage
grid.pattern_text(
x = c(0, 0, 1, 1),
y = c(1, 0, 0, 1),
id = 1L,
...,
colour = gp$col %||% "grey20",
angle = 30,
spacing = 0.05,
xoffset = 0,
yoffset = 0,
units = "snpc",
scale = 0.5,
shape = "X",
grid = "square",
type = NULL,
subtype = NULL,
rot = 0,
alpha = gp$alpha %||% NA_real_,
size = gp$fontsize %||% 12,
fontfamily = gp$fontfamily %||% "sans",
fontface = gp$fontface %||% "plain",
use_R4.1_masks = getOption("ggpattern_use_R4.1_masks",
getOption("ggpattern_use_R4.1_features")),
png_device = NULL,
res = getOption("ggpattern_res", 72),
default.units = "npc",
name = NULL,
gp = gpar(),
draw = TRUE,
vp = NULL
)
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 |
... |
Currently ignored. |
colour |
Stroke colour(s). |
angle |
Rotation angle in degrees. |
spacing |
Spacing between repetitions of pattern (in |
xoffset |
Shift pattern along x axis (in |
yoffset |
Shift pattern along y axis (in |
units |
|
scale |
For star polygons, multiplier (between 0 and 1) applied to exterior radius to get interior radius. |
shape |
A character or expression vector.
See |
grid |
Adjusts placement and density of certain graphical elements.
|
type |
Adjusts the repeating of certain aesthetics such as color.
Can use any type in |
subtype |
See for |
rot |
Angle to rotate regular polygon (degrees, counter-clockwise). |
alpha |
Alpha (between 0 and 1) or |
size |
Fontsize |
fontfamily |
The font family. See |
fontface |
The font face. See |
use_R4.1_masks |
If |
png_device |
“png” graphics device to save intermediate raster data with if |
res |
Resolution of desired |
default.units |
A string indicating the default units to use if |
name |
A character identifier. |
gp |
An object of class |
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.
Examples
if (capabilities("png") &&
gridpattern:::device_supports_unicode()) {
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))
playing_card_symbols <- c("\u2660", "\u2665", "\u2666", "\u2663")
grid.pattern_text(x_hex, y_hex,
shape = playing_card_symbols,
colour = c("black", "red", "red", "black"),
size = 18, spacing = 0.1, angle = 0)
}