gridpattern

Table of Contents

• Overview
• Installation
• Examples
• Using these patterns with the "ggpattern" package
• Using these patterns with the "ggplot2" package
• Using these patterns with the "piecepackr" package

Overview

gridpattern provides grid.pattern() and patternGrob() functions to use with R's grid graphics system. They fill in a user-specified boundary path with a user-specified pattern. These pattern grobs include enhanced versions of the patterns originally contained within Mike FC's awesome ggpattern package as well as several original patterns.

{gridpattern} currently provides {grid} grob support for the following patterns:

1. ambient: noise array patterns powered by the ambient package
2. aRtsy: patterns powered by the aRtsy package
3. circle: circle geometry patterns
4. crosshatch: crosshatch geometry patterns
5. fill: simple fill patterns
6. gradient: gradient array/geometry patterns
7. hatch: heraldic hatching patterns
8. image: image array patterns
9. line: line geometry patterns
10. magick: imagemagick array patterns
11. none: draws nothing
12. placeholder: placeholder image array patterns
13. plasma: plasma array patterns
14. pch: plotting character geometry patterns
15. polygon_tiling: polygon tiling patterns
16. regular_polygon: regular polygon geometry patterns

Installation

You can install the development version from R-universe

install.packages('gridpattern', repos = c('https://trevorld.r-universe.dev', 'https://cloud.r-project.org'))

or straight from the source hosted on Github using the {remotes} package:

# install.packages("remotes")
remotes::install_github("trevorld/gridpattern")

You can install the CRAN release version using:

install.packages("gridpattern")

Examples

library("grid")
library("gridpattern")
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_circle(x_hex, y_hex, density = 0.5, grid = "hex_circle",
                    fill = c("blue", "yellow", "red"))

grid.pattern_regular_polygon(x_hex, y_hex, shape = c("convex4", "star8", "circle"),
                             colour = "black", fill = c("blue", "yellow", "red"),
                             density = c(0.45, 0.42, 0.4), spacing = 0.08, angle = 0)

grid.pattern_regular_polygon(x_hex, y_hex, shape = "convex6", grid = "hex",
                             color = "transparent", fill = c("white", "grey", "black"),
                             density = 1.0, spacing = 0.1)

gp <- gpar(fill = c("yellow", "blue", "red"))
grid.pattern_polygon_tiling(x_hex, y_hex, type = "truncated_hexagonal",
                            spacing = 0.15, gp = gp)

This is the beginning of the README. Read the rest at the original. Read the full README ↗