#color-space #rgb #color-conversion

lab

Tools for converting RGB colors to the CIE-L*a*b* color space, and comparing differences in color

18 releases (10 breaking)

Uses old Rust 2015

0.11.0 Jul 30, 2021
0.9.0 Mar 20, 2021
0.8.2 Dec 10, 2020
0.8.1 Aug 14, 2020
0.3.0 Jan 30, 2017

#70 in Images

Download history 13867/week @ 2024-07-07 14855/week @ 2024-07-14 17486/week @ 2024-07-21 16732/week @ 2024-07-28 15063/week @ 2024-08-04 12561/week @ 2024-08-11 12025/week @ 2024-08-18 17516/week @ 2024-08-25 16466/week @ 2024-09-01 14435/week @ 2024-09-08 15775/week @ 2024-09-15 14858/week @ 2024-09-22 16587/week @ 2024-09-29 15910/week @ 2024-10-06 12549/week @ 2024-10-13 12542/week @ 2024-10-20

58,988 downloads per month
Used in 61 crates (15 directly)

MIT license

62KB
1.5K SLoC

Lab

Lab crate Lab documentation minimum rustc 1.31 TravisCI Build Status AppVeyor Build Status

Tools for converting RGB colors to L*a*b* measurements.

RGB colors, for this crate at least, are considered to be composed of u8 values from 0 to 255, while L*a*b* colors are represented by its own struct that uses f32 values.

Usage

Converting single values

To convert a single value, use one of the functions

  • lab::Lab::from_rgb(rgb: &[u8; 3]) -> Lab
  • lab::Lab::from_rgba(rgba: &[u8; 4]) -> Lab (drops the fourth alpha byte)
  • lab::Lab::to_rgb(&self) -> [u8; 3]
extern crate lab;
use lab::Lab;

let pink_in_lab = Lab::from_rgb(&[253, 120, 138]);
// Lab { l: 66.639084, a: 52.251457, b: 14.860654 }

Converting multiple values

To convert slices of values

  • lab::rgbs_to_labs(rgbs: &[[u8; 3]]) -> Vec<Lab>
  • lab::labs_to_rgbs(labs: &[Lab]) -> Vec<[u8; 3]>
  • lab::rgb_bytes_to_labs(bytes: &[u8]) -> Vec<Lab>
  • lab::labs_to_rgb_bytes(labs: &[Lab]) -> Vec<u8>
extern crate lab;
use lab::rgbs_to_labs;

let rgbs = vec![
    [0xFF, 0x69, 0xB6],
    [0xE7, 0x00, 0x00],
    [0xFF, 0x8C, 0x00],
    [0xFF, 0xEF, 0x00],
    [0x00, 0x81, 0x1F],
    [0x00, 0xC1, 0xC1],
    [0x00, 0x44, 0xFF],
    [0x76, 0x00, 0x89],
];

let labs = rgbs_to_labs(&rgbs);
extern crate lab;
use lab::rgb_bytes_to_labs;

let rgbs = vec![
    0xFF, 0x69, 0xB6,
    0xE7, 0x00, 0x00,
    0xFF, 0x8C, 0x00,
    0xFF, 0xEF, 0x00,
    0x00, 0x81, 0x1F,
    0x00, 0xC1, 0xC1,
    0x00, 0x44, 0xFF,
    0x76, 0x00, 0x89,
];

let labs = rgb_bytes_to_labs(&rgbs);

These functions will use x86_64 AVX2 instructions if compiled to a supported target.

Minimum Rust version

Lab 0.8.0 requires Rust >= 1.36.0 for the MaybeUninit struct

Lab 0.7.0 requires Rust >= 1.31.0 for the chunks_exact slice method

No runtime deps