properties: Query or change colour properties

Description Usage Arguments Details Value Author(s) Examples

Description

These functions obtain the value of a colour property, or modify it. They will convert between colour spaces as required, but the RGB representation will be appropriately updated in the result.

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
saturation(shades, values = NULL)

brightness(shades, values = NULL)

lightness(shades, values = NULL)

chroma(shades, values = NULL)

hue(shades, values = NULL)

delta(values)

Arguments

shades

One or more colours, in any suitable form (see shade).

values

New values for the property in question. If NULL, the current value(s) will be returned. May also be a function computing new values from old ones, notably delta, which adds its argument.

Details

Brightness and lightness differ technically, in the sense that one is absolute and the other is relative. Intuitively, a grey square on white paper is brighter under bright sunlight than in a dark room, but its lightness (relative to the white around it) is constant between conditions. In these functions, brightness is “value” in HSV space and is between 0 and 1, while lightness is defined in Lab space and is between 0 and 100. Saturation and chroma are also related. Hue is defined in HSV space, with red at 0º (and 360º), which is generally the most familiar parameterisation.

Value

Current colour property values, or new colours of class "shade".

Author(s)

Jon Clayden <[email protected]>

Examples

1
2
3
saturation(c("papayawhip","lavenderblush","olivedrab"))
saturation("papayawhip", 0.7)
saturation("papayawhip", delta(0.2))

shades documentation built on Jan. 10, 2018, 5:04 p.m.