exr 0.9.0

Read and write OpenEXR files without any unsafe code
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

extern crate image as png;
use std::cmp::Ordering;

extern crate exr;
use exr::prelude::simple_image as simple_exr;

/// For each layer in the exr file,
/// extract each channel as grayscale png,
/// including all multi-resolution levels.
//
// FIXME throws "access denied" sometimes, simply trying again usually works.
//
pub fn main() {
    let path = "tests/images/valid/openexr/BeachBall/multipart.0001.exr";

    let now = ::std::time::Instant::now();

    // load the exr file from disk with multi-core decompression
    let image = simple_exr::Image::read_from_file(path, simple_exr::read_options::high()).unwrap();

    // warning: highly unscientific benchmarks ahead!
    println!("\nloaded file in {:?}s", now.elapsed().as_secs_f32());
    println!("writing images...");

    for (layer_index, layer) in image.layers.iter().enumerate() {
        let layer_name = layer.attributes.layer_name.as_ref()
            .map_or(String::from("main_layer"), simple_exr::Text::to_string);

        for channel in &layer.channels {
            match &channel.samples {
                simple_exr::Samples::F16(samples) => {
                    let data : Vec<f32> = samples.iter().map(|f16| f16.to_f32()).collect();

                    save_f32_image_as_png(&data, layer.size, format!(
                        "tests/images/out/{} ({}) {}_f16_{}x{}.png",
                        layer_index, layer_name, channel.name,
                        layer.size.width(), layer.size.height(),
                    ))
                },

                simple_exr::Samples::F32(samples) => {
                    save_f32_image_as_png(samples, layer.size, format!(
                        "tests/images/out/{} ({}) {}_f32_{}x{}.png",
                        layer_index, layer_name, channel.name,
                        layer.size.width(), layer.size.height(),
                    ))
                },

                simple_exr::Samples::U32(samples) => {
                    let data : Vec<f32> = samples.iter().map(|value| *value as f32).collect();

                    save_f32_image_as_png(&data, layer.size, format!(
                        "tests/images/out/{} ({}) {}_u32_{}x{}.png",
                        layer_index, layer_name, channel.name,
                        layer.size.width(), layer.size.height(),
                    ))
                },
            }
        }
    }

    /// Save raw float data to a PNG file, doing automatic brightness adjustments per channel
    fn save_f32_image_as_png(data: &[f32], size: simple_exr::Vec2<usize>, name: String) {
        let mut png_buffer = png::GrayImage::new(size.width() as u32, size.height() as u32);
        let mut sorted = Vec::from(data);
        sorted.sort_by(|a, b| a.partial_cmp(b).unwrap_or(Ordering::Less));

        // percentile normalization
        let max = sorted[7 * sorted.len() / 8];
        let min = sorted[1 * sorted.len() / 8];

        // primitive tone mapping
        let tone = |v: f32| (v - 0.5).tanh() * 0.5 + 0.5;
        let max_toned = tone(*sorted.last().unwrap());
        let min_toned = tone(*sorted.first().unwrap());

        // for each pixel, tone map the value
        for (x, y, pixel) in png_buffer.enumerate_pixels_mut() {
            let v = data[(y as usize * size.0 + x as usize)];
            let v = (v - min) / (max - min);
            let v = tone(v);

            let v = (v - min_toned) / (max_toned - min_toned);

            // TODO does the `image` crate expect gamma corrected data?
            *pixel = png::Luma([(v.max(0.0).min(1.0) * 255.0) as u8]);
        }

        png_buffer.save(&name).unwrap();
    }

    println!("created all images");
}