Pigmnts is a library to create a color palette from an image built using Rust, compiled to WebAssembly. This allows for super-fast color palette extraction from an image on the web. It uses the K-means++ clustering algorithm to select the most commonly occuring colors from the image.
```html
```
Start by installing the npm package
bash
npm install pigmnts
Configure your build process to copy the wasm file in the your build directory.
Use it in code
```javascript import init, { pigments } from 'pigmnts';
async function run() {
// Load the wasm file from path where wasm file was copied by the bundler
await init('
// Canvas element from which palette should be created const canvas = document.querySelector('canvas');
// Call the pigments wasm function const palette = pigments(canvas, 5); } run(); ```
Pigmnts exposes following function in WebAssembly
HtmlCanvasElement, k: number, mood: Mood|number, batch_size: number)canvas canvas element which has the image to be processed. Internally, the pixel data is taken from the canvas, and then clustered to create the color palette. k defines the number of colors to be gathered from the image. mood defines the weight function to use. Only 'dominant' mood is supported which has a value of 0batch_size (optional) defines the number of pixels to randomly sample from the image. It should be greater than the total number of pixels in the image and the k. By default, all the pixels in the image are processed.Returns an Array of Objects where each Object is a color of the following format.
javascript
[
{
dominance: 0.565 // Dominance of color in image(From 0 to 1)
hex: '#6DDAD0' // 6-digit Hex color code
rgb: { // Equivalent RGB color
r: 109,
g: 218,
b: 208
},
hsl: { // Equivalent HSL color (Normalized to 0-1)
h: 0.48333,
s: 0.6,
l: 0.64,
}
},
// Other colors
{
...
}
]
If this crate is used in some Rust projects, then following function is also available
&Vec<LAB>, k: u8, weight: fn(&LAB) -> f32, maxiter: Option<u16>) -> Vec<(LAB, f32)>This function can be used when color data is gathered from an image decoded using image-rs.
pixels reference to a Vector of colors in LAB format.k defines the number of colors to be gathered from the image.weight defines the weight function to use. src/weights.rs file has few implemented weight functions.max_iter defines the maximum iterations that algorithm makes, default is 300Returns a vector of tuples with colors as LAB and dominance(as percentage) of each color found in the image.
Pigmnts is MIT Licensed