colorverse 0.5.0

color vision convertor
Documentation 
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
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106

# Colorverse

Color vision convertor / simluator

[![crates.io](https://img.shields.io/crates/v/colorverse?label=latest)](https://crates.io/crates/colorverse)
[![Documentation](https://docs.rs/colorverse/badge.svg?version=latest)](https://docs.rs/colorverse)
[![Dependency Status](https://deps.rs/crate/colorverse/latest/status.svg)](https://deps.rs/crate/colorverse)
[![Executable](https://github.com/nabbisen/colorverse/actions/workflows/release-executable.yaml/badge.svg)](https://github.com/nabbisen/colorverse/actions/workflows/release-executable.yaml)
[![License](https://img.shields.io/github/license/nabbisen/colorverse)](https://github.com/nabbisen/colorverse/blob/main/LICENSE)

Based on [Machado, Oliveira & Fernandes (2009)](https://www.inf.ufrgs.br/~oliveira/pubs_files/CVD_Simulation/CVD_Simulation.html) model.
Customized with dynamic level parameter introduced and nonlinear easing of the level.

## Usage

Configure:

```console
$ cargo add colorverse
```

Use:

```rust
use colorverse::convert;
use colorverse::core::color_vision::color_vision_type::ColorVisionType;

let color_vision_type = ColorVisionType::Protanomaly;
let level = 0.5;
let input_file_path = "input.png";
let output_file_path = format!("output-{}-{}.png", color_vision, level * 100.0);

convert(input_file_path, &color_vision, level)
    .unwrap()
    .save_as(output_file_path.as_str());
```

```rust
use colorverse::convert;
use colorverse::core::color_vision::color_vision_type::ColorVisionType;

let mut color_vision_type_iterator = ColorVisionTypeIterator::new(&ColorVisionType::Trichromacy);
while let Some(color_vision_type) = color_vision_type_iterator.next() {
    for level in [0.5, 1.0] {
        match convert("input.png", &color_vision_type, level) {
            Ok(x) => {
                let output_file_path = format!("output-{}-{}.png", &color_vision_type, level * 100.0);
                x.save_as(output_file_path.as_str());
            }
            Err(err) => eprintln!("{}", err),
        }
    }
}
```

## Samples

### Trichromacy

![trichromacy](docs/assets/trichromacy.png)

### Protanomaly 50%

![protanomaly](docs/assets/protanomaly-50.png)

### Protanomaly 100% (Protanopia)

![protanopia](docs/assets/protanomaly-100.png)

### Deuteranomaly 50%

![deuteranomaly](docs/assets/deuteranomaly-50.png)

### Deuteranomaly 100% (Deuteranopia)

![deuteranopia](docs/assets/deuteranomaly-100.png)

### Tritanomaly 50%

![tritanomaly](docs/assets/tritanomaly-50.png)

### Tritanomaly 100% (Tritanopia)

![tritanopia](docs/assets/tritanomaly-100.png)

### Achromatomaly 50%

![achromatomaly](docs/assets/achromatomaly-50.png)

### Achromatomaly 100% (Achromatopsia)

![achromatopsia](docs/assets/achromatomaly-100.png)


---

## Open-source, with care

This project is lovingly built and maintained by volunteers.  
We hope it helps streamline your work.  
Please understand that the project has its own direction — while we welcome feedback, it might not fit every edge case 🌱

## Acknowledgements

Depends on [image](https://github.com/image-rs/image) / [nalgebra](https://github.com/dimforge/nalgebra).
Also, on [argh](https://github.com/google/argh) on CLI I/F.