bokeh-creator 0.1.3

Easy to use library to replicate real world lens kernels
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
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139

[![Tests](https://github.com/gillesvink/bokeh-creator/actions/workflows/test.yaml/badge.svg)](https://github.com/gillesvink/bokeh-creator/actions/workflows/test.yaml) 
[![License](https://img.shields.io/crates/l/bokeh-creator)](https://crates.io/crates/bokeh-creator) 
[![Version](https://img.shields.io/crates/v/bokeh-creator)](https://crates.io/crates/bokeh-creator) 


# Bokeh Creator

Simple library to replicate real world lens kernels written in Rust. Currently it requires the `std` library.

## Install
Add this crate to your project by adding it in your `Cargo.toml`:
```bash
cargo add bokeh-creator
```

The [Image](https://crates.io/crates/image) crate is optional, as there is a method to render when you specify coordinates only.


## Usage

```rust
use bokeh_creator::{Renderer, Settings};
use image::Rgba32FImage;

fn main() {
    let settings = Settings {
        angle: 195.3,
        curvature: 0.1,
        ..Default::default()
    };
    let mut result = Rgba32FImage::new(256, 256);
    let renderer = Renderer::render_to_image(&mut result, settings);
    // Do whatever you need to do with the result :)
}
```


## Examples

![1_expected.jpg](https://codeberg.org/gillesvink/bokeh-creator/raw/branch/main/test/images/1_expected.jpg) 
```rust
use bokeh_creator::Settings;
Settings::default();
```

![2_expected.jpg](https://codeberg.org/gillesvink/bokeh-creator/raw/branch/main/test/images/2_expected.jpg) 
```rust
use bokeh_creator::{FilterType, Settings};
Settings {
    filter_type: FilterType::BLADE,
    angle: 195.3,
    curvature: 0.1,
    ..Default::default()
};
```

![3_expected.jpg](https://codeberg.org/gillesvink/bokeh-creator/raw/branch/main/test/images/3_expected.jpg) 
```rust
use bokeh_creator::{FilterType, Settings};
Settings {
    filter_type: FilterType::BLADE,
    angle: 90.0,
    blades: 15,
    ..Default::default()
};
```


![4_expected.jpg](https://codeberg.org/gillesvink/bokeh-creator/raw/branch/main/test/images/4_expected.jpg) 
```rust
use bokeh_creator::Settings;
Settings {
    aspect_ratio: 0.5,
    ..Default::default()
};
```

![5_expected.jpg](https://codeberg.org/gillesvink/bokeh-creator/raw/branch/main/test/images/5_expected.jpg) 
```rust
use bokeh_creator::Settings;
Settings {
    aspect_ratio: 2.0,
    ..Default::default()
};
```

![6_expected.jpg](https://codeberg.org/gillesvink/bokeh-creator/raw/branch/main/test/images/6_expected.jpg) 
```rust
use bokeh_creator::Settings;
Settings {
    ring_color: 0.5,
    inner_color: 0.9,
    ring_size: 0.5,
    ..Default::default()
};
```

![7_expected.jpg](https://codeberg.org/gillesvink/bokeh-creator/raw/branch/main/test/images/7_expected.jpg) 
```rust
use bokeh_creator::{Noise, Settings};
Settings {
    noise: {
        Noise { 
            size: 0.3, 
            intensity: 1.0, 
            ..Default::default()
        }
    },
    ..Default::default()
};
```

![8_expected.jpg](https://codeberg.org/gillesvink/bokeh-creator/raw/branch/main/test/images/8_expected.jpg) 
```rust
use bokeh_creator::{Noise, Settings};
Settings {
    noise: {
        Noise { 
            intensity: 0.0, 
            ..Default::default()
        }
    },
    ..Default::default()
};
```

![9_expected.jpg](https://codeberg.org/gillesvink/bokeh-creator/raw/branch/main/test/images/9_expected.jpg) 
```rust
use bokeh_creator::{Noise, Settings};
Settings {
    noise: {
        Noise { 
            seed: 30, 
            ..Default::default()
        }
    },
    ..Default::default()
};
```