Segment mark — mark_segment • vellumplot

mark_segment() draws a straight line from (x, y) to (xend, yend) per row.

Usage

mark_segment(
  plot,
  ...,
  blend = NULL,
  effects = list(),
  sketch = NULL,
  data = NULL
)

plot: A PlotSpec (from vplot()).
...: Encodings (tidy-eval): x, y, xend, yend (+ color, linewidth, alpha).
blend: Optional blend mode for compositing this layer against what is already drawn beneath it (the panel and earlier layers), one of the CSS mix-blend-mode names, e.g. "multiply", "screen", "darken". The whole layer composites as one isolated group (not per element).
effects: A list of layer render effects applied to the mark at draw time — glow(), outline(), and shadow(). Available on stroked and point marks.
sketch: A sketch() spec giving this layer a hand-drawn look (wobbly outlines, hachure fills), NA/FALSE to force it crisp (overriding a plot-wide theme_sketch()), or NULL (default) to inherit. Geometry marks accept it; text, raster, hex and datashade marks do not.
data: Optional layer data frame; overrides the plot data for this layer.

The modified PlotSpec.

d <- data.frame(x = 1, y = 1, xend = 5, yend = 4)
vplot(d) |> mark_segment(x = x, y = y, xend = xend, yend = yend)