elite-matrix/README.md

Elite Matrix

A (very) small library for working with the Elite Dangerous color matrix in javascript. Types included!

Adapted from EDScout's color adjuster.

Usage

npm i elite-matrix

The input matrix is stored in an EliteMatrix object, and must be passed in as three arrays, one for each line in the matrix, each containing three numbers.

A GraphicsConfiguration.xml that looks like this:

<MatrixRed>   1, 0, 0 </MatrixRed>
<MatrixGreen> 0, 1, 0 </MatrixGreen>
<MatrixBlue>  0, 0, 1 </MatrixBlue>

Would need to be translated into this and passed to EliteMatrix:

import { EliteMatrix } from 'elite-matrix';

const matrixRed = [1, 0, 0];
const matrixGreen = [0, 1, 0];
const matrixBlue = [0, 0, 1];
const matrix = new EliteMatrix(matrixRed, matrixGreen, matrixBlue);

From there you can use the EliteMatrix object to apply color filters. filterColor accepts either a string hex color (with or without the '#'), or an RGB array. It will return in a matching format, and will include the '#' for a hex color.

matrix.filterColor('#F5A804');
// -> '#ffbae3'

matrix.filterColor('F5A804');
// -> '#ffbae3'

matrix.filterColor([96, 66, 2]);
// -> [255, 186, 227]
// Which, by the way, can be passed directly to CSS rgb() via template literals:
document.getElementById('elem').style.color = `rgb(${[255, 186, 227]})`;