# color-classifier-ts
> Classify the color along the reference color. using algorithm the CIEDE2000, RGB, HSV.
Latest version **2.0.0** (published 2016-12-04) · MIT license · 0 weekly downloads
## Install
```sh
npm install color-classifier-ts
pnpm add color-classifier-ts
yarn add color-classifier-ts
bun add color-classifier-ts
```
## Health
**Score 25/100 (F)** — status: abandoned.
Positive: has types; no vulnerabilities; high quality score.
Warnings: low downloads; no esm support.
Negative: abandoned; low maintenance score.
## Facts
| | |
|---|---|
| Version | 2.0.0 |
| Published | 2016-12-04 |
| First published | 2016-12-04 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | tsuyoshiwada |
| Maintainers | roaders |
| Keywords | color, classify, ciede2000, hsv, rgb |
## Links
- npm: https://www.npmjs.com/package/color-classifier-ts
- npm.io page: https://npm.io/package/color-classifier-ts
## Alternatives
- [postcss-color-hex-alpha](https://npm.io/package/postcss-color-hex-alpha.md) — 6.4M weekly downloads
- [randomcolor](https://npm.io/package/randomcolor.md) — 348.0K weekly downloads
- [bows](https://npm.io/package/bows.md) — 1.3K weekly downloads
- [ep_prefer_color_scheme](https://npm.io/package/ep_prefer_color_scheme.md) — 260 weekly downloads
- [coc-yank](https://npm.io/package/coc-yank.md) — 61 weekly downloads
## Recent versions
- 2.0.0 (latest) — 2016-12-04
- 1.0.1 — 2016-12-04
## README
color-classifier.js
===================
Classify the color along the reference color. using algorithm the CIEDE2000, RGB, HSV.
Forked from [https://github.com/tsuyoshiwada/color-classifier](https://github.com/tsuyoshiwada/color-classifier) and turned into Typescript project
## INSTALL
```bash
$ npm install color-classifier-ts --save
```
## USAGE
The following is the basic usage.
```javascript
import ColorClassifier from "color-classifier"
const palette = ["#fff", "#000"];
const colorClassifier = new ColorClassifier(palette);
const color = colorClassifier.classify("#fefefe");
console.log(color); // {r: 255, g: 255, b: 255}
```
The type of pallet and algorithms have been some available.
```javascript
import ColorClassifier, { Palette, AlgorithmTypes } from "color-classifier"
const colorClassifier = new ColorClassifier(Palette.W3C, AlgorithmTypes.HSV);
const color = colorClassifier.classify("#fefefe");
console.log(color); // {r: 255, g: 255, b: 255}
```
The available values are as follows.
### Palette
The following is the palette list at preset.
#### [Palette.W3C](https://github.com/tsuyoshiwada/color-classifier/blob/master/src/palette/w3c.js)
| hex | color |
|-----------|--------------------------------------------------------------------------------------------|
| `#000000` |  |
| `#808080` |  |
| `#c0c0c0` |  |
| `#ffffff` |  |
| `#800000` |  |
| `#ff0000` |  |
| `#008000` |  |
| `#00ff00` |  |
| `#808000` |  |
| `#ffff00` |  |
| `#008080` |  |
| `#00ffff` |  |
| `#000080` |  |
| `#0000ff` |  |
| `#800080` |  |
| `#ff00ff` |  |
#### [Palette.RAINBOW](https://github.com/tsuyoshiwada/color-classifier/blob/master/src/palette/rainbow.js)
| hex | color |
|-----------|--------------------------------------------------------------------------------------------|
| `#000000` |  |
| `#808080` |  |
| `#ffffff` |  |
| `#ff0000` |  |
| `#ffa500` |  |
| `#ffff00` |  |
| `#008000` |  |
| `#00ffff` |  |
| `#0000ff` |  |
| `#800080` |  |
### AlgorithmTypes
The difference algorithm of color is possible some selection.
| value | description |
|----------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `AlgorithmTypes.CIEDE2000` | Using the CIE Delta E 2000 Color-Difference algorithm (CIEDE2000).
[The CIEDE2000 color-difference formula](http://www.ece.rochester.edu/~gsharma/ciede2000/ciede2000noteCRNA.pdf),
[Color difference - Wikipedia, the free encyclopedia](https://en.wikipedia.org/wiki/Color_difference#CIEDE2000) |
| `AlgorithmTypes.HSV` | Using the HSV color space.
[HSL and HSV - Wikipedia, the free encyclopedia](https://en.wikipedia.org/wiki/HSL_and_HSV) |
| `AlgorithmTypes.RGB` | Using the RGB color space.
[RGB color model - Wikipedia, the free encyclopedia](https://en.wikipedia.org/wiki/RGB_color_model)
## API
### new ColorClassifier(palette = Palette.W3C, algorithmType = AlgorithmTypes.CIEDE2000)
**palette**: {Array}
**algorithmType**: {String}
Palette is specify array in RGB object or HEX string.
**HEX String**:
```javascript
const palette = ["#fff", "#000"];
const colorClassifier = new ColorClassifier(palette);
```
**RGB Object**:
```javascript
const palette = [
{r: 255, g: 255, b: 255},
{r: 0, g: 0, b: 0}
];
const colorClassifier = new ColorClassifier(palette);
```
### classify(color, format = "rgb")
**color**: {Object || String}
**format**: {String} ("rgb", "hex", "hsv")
Classifies the specified color along the palette.
```javascript
const color1 = {r: 255, g: 255, b: 255};
console.log(colorClassifier.classify(color1, "rgb")); //{r: 255, g: 255, b: 255}
console.log(colorClassifier.classify(color1, "hex")); //#ffffff
console.log(colorClassifier.classify(color1, "hsv")); //{h: 0, s: 0, v: 100}
const color2 = "#fff";
console.log(colorClassifier.classify(color2, "rgb")); //{r: 255, g: 255, b: 255}
console.log(colorClassifier.classify(color2, "hex")); //#ffffff
console.log(colorClassifier.classify(color2, "hsv")); //{h: 0, s: 0, v: 100}
```
### classifyFromArray(colors, format = "rgb")
**colors**: {Array}
**format**: {String} ("rgb, "hex", "hsv")
Classifies the specified array of colors along the palette.
```javascript
const colors = ["#fefefe", "#fafafa", "#010101", "#020202"];
const results = colorClassifier.classifyFromArray(colors, "hex");
console.log(results);
// [
// {
// palette: "#ffffff",
// colors: [
// "#fefefe",
// "#fafafa"
// ]
// },
// {
// palette: "#000000",
// colors: [
// "#010101",
// "#020202"
// ]
// }
// ]
```
## LICENCE
Released under the [MIT Licence](https://raw.githubusercontent.com/tsuyoshiwada/color-classifier/master/LICENSE)
## ORIGINAL AUTHOR
[tsuyoshiwada](https://github.com/tsuyoshiwada)
---
_Source: https://npm.io/package/color-classifier-ts · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._