@colorblender/converter-ansi

Converter Ansi

Convert rgb to ansi16 / ansi256 and vice versa.

Installation

This package requires the installation of the main package @colorblender/converter.

npm install @colorblender/converter @colorblender/converter-ansi

Import

import {
  rgbToAnsi16,
  rgbToAnsi256,
  ansi16ToRgb,
  ansi256ToRgb,
} from '@colorblender/converter-ansi';

Usage

Model conversions

You can convert between any of the supported color models.

// ansi to rgb
ansi16ToRgb(ansi16: Ansi16Color, rounded?: boolean)
ansi256ToRgb(ansi256: Ansi256Color, rounded?: boolean)

// rgb to ansi
rgbToAnsi16(rgb: RgbColor)
rgbToAnsi256(rgb: RgbColor)

Example

import { rgbToHsl } from '@colorblender/converter-ansi';

rgbToAnsi16({
  r: 255,
  g: 255,
  b: 255,
});

// Rounded
ansi16ToRgb(167, true);

Conversion

You can convert any compatible model to RGB format and vice versa.

To convert two compatible and different RGB models you will have to go through a sub-conversion. For example to convert a HEX value to ANSI16 you will have to do: HEX -> RGB -> ANSI16. This allows you to convert any compatible model to any other.

Keep in mind that large conversions may result in a loss of accuracy.

Supported color models

• ANSI16: number
• ANSI256 number

Issues

Please file an issue for bugs, missing documentation, or unexpected behavior.

File an issue

License

MIT