normeditor 0.1.1

An image editor written from scratch (as close as possible).
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

# norm

<p align="center">
    <img src="obama-luma-gaussian-blur.png" width="250"/>
    <img src="obama-normal.png" width="250"/>
    <img src="obama-line-detection.png" width="250"/>
</p>
<br>

A PNG editor from scratch (well, as close to scratch as possible).

As a decoder, this project uses the [PNG test suite](http://www.schaik.com/pngsuite/) to validate its ability to handle
various PNG features and edge cases. Currently, norm can decode and render images with an 8-bit color depth.

The renderer supports various image processing features on the GPU.

## Usage

Run `cargo run --release <image_path>`. For example:

```bash
cargo r --release ./tests/obama.png
```

### Additional Scripts

```bash
# Run the renderer with an experimental camera
cargo r --features camera -- ./tests/obama.png

# Profile the decoder
cargo b --release && samply record ./target/release/norm_decode_png ./tests/reagan.png

# Run ad-hoc benchmarks
cargo r --release --bin norm_decode_png --features time ./tests/Periodic_table_large.png

# Parse and render glyphs from the lato font file
# See the generated `glyph_playground` directory.
cargo r --bin norm_lato_glyphs hfkdp!

# Run the PNG test suite
cargo r --bin norm_png_test_suite

# Fuzz the decoder
./fuzz.sh
```

## Reading

### PNG Specification

https://www.w3.org/TR/2003/REC-PNG-20031110/<br>
http://www.libpng.org/pub/png/pngintro.html<br>
https://www.w3.org/Graphics/PNG/platform.html<br>
https://optipng.sourceforge.net/pngtech/optipng.html<br>
https://optipng.sourceforge.net/pngtech/better-filtering.html<br>
http://www.libpng.org/pub/png/pngpic2.html<br>
https://www.lucaversari.it/FJXL_and_FPNGE.pdf<br>

### GPU Programming

https://sotrh.github.io/learn-wgpu/beginner/tutorial5-textures/<br>
https://raphlinus.github.io/gpu/2020/02/12/gpu-resources.html<br>

### Image Processing

https://www.youtube.com/watch?v=KuXjwB4LzSA<br>
https://www.shadertoy.com/view/4tSyzy<br>
https://www.shadertoy.com/view/wsK3Wt<br>

https://www.cns.nyu.edu/pub/lcv/wang03-preprint.pdf<br>
https://www.cns.nyu.edu/pub/eero/wang03b.pdf<br>
https://ece.uwaterloo.ca/~z70wang/research/ssim/<br>
http://arxiv.org/pdf/2006.13846<br>

### TrueType Font Rendering

https://faultlore.com/blah/text-hates-you/<br>
https://developer.apple.com/fonts/TrueType-Reference-Manual/<br>
https://www.youtube.com/watch?v=SO83KQuuZvg<br>
https://www.microsoft.com/en-us/research/wp-content/uploads/2005/01/p1000-loop.pdf<br>
https://medium.com/@evanwallace/easy-scalable-text-rendering-on-the-gpu-c3f4d782c5ac<br>

### Miscellaneous

https://www.joelonsoftware.com/2003/10/08/the-absolute-minimum-every-software-developer-absolutely-positively-must-know-about-unicode-and-character-sets-no-excuses/<br>