### Description

Create objects which describe linear and radial gradients. These objects can later be used to apply a gradient fill to grobs, and also to define a gradient so that it may be reused multiple times.

### Usage

``````linearGradient(col = c("black", "white"),
stops = seq(0, 1, length.out = length(col)),
x0 = unit(0, "npc"), x1 = unit(1, "npc"),
y0 = unit(0, "npc"), y1 = unit(1, "npc"),
default.units = "npc",
stops = seq(0, 1, length.out = length(col)),
x = unit(0.5, "npc"), y = unit(0.5, "npc"),
r = unit(0.5, "npc"),
fx = unit(0.5, "npc"), fy = unit(0.5, "npc"),
default.units = "npc",
``````

### Arguments

 `col` A vector of colours used for gradient stops. `stops` A numeric vector of offsets (typically between 0 and 1) to place the the colours (`col`) at. `gradientUnits` If `"bbox"`, the gradient is positioned relative to the bounding box of the referring grob. All units attempt to be converted to equivalent "npc" coordinates as a result. If `"coords"`, uses grid coordinates to determine positioning. `x0` Numeric or unit object indicating the starting x-location of the linear gradient. `x1` Numeric or unit object indicating the stopping x-location of the linear gradient. `y0` Numeric or unit object indicating the starting y-location of the linear gradient. `y1` Numeric or unit object indicating the stopping y-location of the linear gradient. `x` Numeric or unit object indicating the x-location of the radial gradient. `y` Numeric or unit object indicating the y-location of the radial gradient. `r` A numeric vector or unit object specifying the radius of the radial gradient. `fx` A numeric vector or unit object specifying an x-location. Determines the x-location of the focal point of the radial gradient. `fy` A numeric vector or unit object specifying an y-location. Determines the y-location of the focal point of the radial gradient. `default.units` A string indicating the default units to use if `x`, `y`, `r`, `fx` or `fy` are only given as numeric vectors. `spreadMethod` A character vector determining when happens when a gradient begins or ends within its bounds. See details.

### Details

When defining gradient stops via `col` and `stops`, the order is important. Gradient stops which are defined earlier are drawn first, with later stops being drawn over the top.

For `spreadMethod` the possible values are:

• pad Use the terminal colors of the gradient to fill the remainder of the target region.

• reflect Reflect the gradient pattern start-to-end, end-to-start, start-to-end, etc. continuously until the target region is filled.

• repeat Repeat the gradient pattern start-to-end, start-to-end, start-to-end, etc. continuously until the target region is filled.

### Value

A `gradient` object.

### Author(s)

Simon Potter

gridSVG documentation built on March 31, 2023, 11:17 p.m.