rgb-color-yiq-value

Function to calculate the YIQ value of a color in RGB format

Description

Determines the perceived brightness of a colour based on the YIQ calculation.

See...

• Install/Usage
• Types
• Syntax
• Examples
• See Also

Install

npm install --save @chriscodesthings/rgb-color-yiq-value

Usage

import rgbColorYIQValue from '@chriscodesthings/rgb-color-yiq-value';

console.log(rgbColorYIQValue([100, 149, 237])); // cornflowerblue
// => 144.381

Types

This package uses types from:

• basic-color-types: Defines named types for common color formats

Syntax

rgbYIQValue([r, g, b, (a)]);

Parameters

• r, g, b: red green and blue color components
• a (optional): Alpha value is ignored if present

Return Value

Returns calculated YIQ value of the color.

Examples

// get contrasting text colour for a given background colour
function getTextColourForBackground(r, g, b) {
    if( rgbYIQValue([r, g, b]) > 128) {
        // colour is light, return black
        return [0, 0, 0];
    }

    // colour is dark, return white
    return [255, 255, 255];
} 

See Also...

• Calculating Color Contrast
• rgb-color-is-dark: Determine if a color in RGB format is dark using YIQ calculation
• color-object: Simple, lightweight class to store and manipulate a color, and convert between formats
• random-css-hex-color: Generates a random color in CSS hex format