Learn R Programming

ggsketch (version 2.0.0)

watercolor_wash_multi: Build a hole-aware watercolour wash for a multi-ring region

Description

The multi-ring analogue of watercolor_wash(): each wash layer is a jittered, resized copy of every ring, so the grob can paint a layer as one even-odd path and keep holes empty (rings shrink/grow about their own centroid). Used by the band / multi-ring grobs (filled contours, density bands).

Usage

watercolor_wash_multi(
  rings,
  n_layers = 6L,
  bleed = NULL,
  granulation = 0,
  grain = 0,
  seed = NULL
)

Value

A list with washes (a list of layers; each layer is a list of 2-column (x, y) ring matrices, outermost/lightest first) and granules

(list(x, y, r) in inches, or NULL).

Arguments

rings

A list of rings, each a list with inch-space x and y vertex vectors. Even-odd nesting defines holes.

n_layers

Number of wash copies. Default 6.

bleed

Edge irregularity in inches. NULL (default) scales to ~2% of the combined bounding diagonal.

granulation

Fraction in [0, 1]: density of pigment specks (0 = none). Default 0. Specks land inside the even-odd region (never in holes).

grain

Paper-grain coupling in [0, ~1]: how strongly each ring's edge feathers along the paper tooth. 0 (default) is the historical pure-uniform jitter and draws no extra randomness. See paper_grain().

seed

Integer seed.

See Also

Other sketch-core: arrowhead(), curve_fill(), engrave_fill(), engrave_ladder(), hachure_fill(), hachure_fill_multi(), leader_path(), repel_layout(), rough_arc(), rough_bezier(), rough_ellipse(), roughen_polyline(), sketch_arrowheads(), sketch_fill(), sketch_fill_multi(), spray_scatter(), stroke_profile(), stroke_ribbon(), treemap_layout(), wash_bleed(), watercolor_wash()