1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
|
# Lab
[](https://crates.io/crates/lab)
[](https://docs.rs/lab)
[](https://travis-ci.com/github/TooManyBees/lab)
[](https://ci.appveyor.com/project/TooManyBees/lab)
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]`
```rust
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>`
```rust
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);
```
```rust
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](https://doc.rust-lang.org/std/mem/union.MaybeUninit.html) struct
Lab 0.7.0 requires Rust >= 1.31.0 for the [chunks_exact](https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact) slice method
|
