[go: up one dir, main page]

exr 1.3.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


// exr imports
extern crate exr;

/// Read an image and print information about the image into the console.
/// This example shows how to read an image with multiple layers and specific channels.
/// This example does not include resolution levels (mipmaps or ripmaps).
fn main() {
    use exr::prelude::*;

    let image = read().no_deep_data()
        .largest_resolution_level()

        .specific_channels()
        .optional("A", f16::ONE)
        .required("Y") // TODO also accept a closure with a detailed selection mechanism
        .optional("right.Y", 0.0)
        .collect_pixels(
            |resolution, (a_channel, y_channel, y_right_channel)| {
                println!("image contains alpha channel? {}", a_channel.is_some());
                println!("image contains stereoscopic luma channel? {}", y_right_channel.is_some());
                println!("the type of luma samples is {:?}", y_channel.sample_type);

                vec![vec![(f16::ZERO, 0.0, 0.0); resolution.width()]; resolution.height()]
            },

            // all samples will be converted to f32 (you can also use the enum `Sample` instead of `f32` here to retain the original data type from the file)
            |vec, position, (a,y,yr): (f16, f32, f32)| {
                vec[position.y()][position.x()] = (a, y, yr)
            }
        )

        .all_layers()
        .all_attributes()
        .on_progress(|progress| println!("progress: {:.1}", progress*100.0))
        .from_file("tests/images/valid/openexr/MultiView/Fog.exr")
        .unwrap();

    // output a random color of each channel of each layer
    for layer in &image.layer_data {
        let (alpha, luma, luma_right) = layer.channel_data.pixels.first().unwrap().first().unwrap();

        println!(
            "bottom left color of layer `{}`: (a, y, yr) = {:?}",
            layer.attributes.layer_name.clone().unwrap_or_default(),
            (alpha.to_f32(), luma, luma_right)
        )
    }
}