https://github.com/d3/d3-hsv
The HSV (Hue, Saturation, Value) color space.
https://github.com/d3/d3-hsv
Last synced: 8 months ago
JSON representation
The HSV (Hue, Saturation, Value) color space.
- Host: GitHub
- URL: https://github.com/d3/d3-hsv
- Owner: d3
- License: bsd-3-clause
- Created: 2016-06-08T22:49:19.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2020-07-10T15:03:16.000Z (almost 6 years ago)
- Last Synced: 2025-01-30T15:25:55.559Z (over 1 year ago)
- Language: JavaScript
- Homepage:
- Size: 19.5 KB
- Stars: 27
- Watchers: 8
- Forks: 10
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# d3-hsv
This module implements the [HSV](https://en.wikipedia.org/wiki/HSL_and_HSV) (Hue, Saturation, Value) color space.
For example, to recreate R’s terrain.colors:
```js
var i0 = d3.interpolateHsvLong(d3.hsv(120, 1, 0.65), d3.hsv(60, 1, 0.90)),
i1 = d3.interpolateHsvLong(d3.hsv(60, 1, 0.90), d3.hsv(0, 0, 0.95));
function interpolateTerrain(t) {
return t < 0.5 ? i0(t * 2) : i1((t - 0.5) * 2);
}
```
## Installing
If you use NPM, `npm install d3-hsv`. Otherwise, download the [latest release](https://github.com/d3/d3-hsv/releases/latest). You can also load directly from [d3js.org](https://d3js.org) as a [standalone library](https://d3js.org/d3-hsv.v0.1.min.js). AMD, CommonJS, and vanilla environments are supported. In vanilla, a `d3` global is exported:
```html
var yellow = d3.hsv("yellow"); // {h: 60, s: 1, v: 1, opacity: 1}
```
[Try d3-hsv in your browser.](https://tonicdev.com/npm/d3-hsv)
## API Reference
# d3.hsv(h, s, v[, opacity]) [<>](https://github.com/d3/d3-hsv/blob/master/src/hsv.js "Source")
# d3.hsv(specifier)
# d3.hsv(color)
Constructs a new [HSV](https://en.wikipedia.org/wiki/HSL_and_HSV) color. The channel values are exposed as `h`, `s` and `v` properties on the returned instance.
If *h*, *s* and *v* are specified, these represent the channel values of the returned color; an *opacity* may also be specified. If a CSS Color Module Level 3 *specifier* string is specified, it is parsed and then converted to the HSV color space. See [d3.color](https://github.com/d3/d3-color#color) for examples. If a [*color*](https://github.com/d3/d3-color#color) instance is specified, it is converted to the RGB color space using [*color*.rgb](https://github.com/d3/d3-color#color_rgb) and then converted to HSV.
# d3.interpolateHsv(a, b) [<>](https://github.com/d3/d3-hsv/blob/master/src/interpolateHsv.js "Source")
Returns an HSV color space interpolator between the two colors *a* and *b*. The colors *a* and *b* need not be in HSV; they will be converted to HSV using [d3.hsv](#hsv). If either color’s hue or chroma is NaN, the opposing color’s channel value is used. The shortest path between hues is used. The return value of the interpolator is an RGB string.
# d3.interpolateHsvLong(a, b) [<>](https://github.com/d3/d3-hsv/blob/master/src/interpolateHsv.js "Source")
Like [interpolateHsv](#interpolateHsv), but does not use the shortest path between hues.