Module `read`

Read an exr image.

For great flexibility and customization, use the read() function. The return value of the read() function must be further customized before reading a file. For very simple applications, you can alternatively use one of these functions:

read_first_rgba_layer_from_file(path, your_constructor, your_pixel_setter): You specify how to store the pixels. The first layer containing rgba channels is then loaded from the file. Fails if no rgba layer can be found.
read_all_rgba_layers_from_file(path, your_constructor, your_pixel_setter): You specify how to store the pixels. All layers containing rgba channels are then loaded from the file. Fails if any layer in the image does not contain rgba channels.
read_first_flat_layer_from_file(path): The first layer containing non-deep data with arbitrary channels is loaded from the file. Fails if no non-deep layer can be found.
read_all_flat_layers_from_file(path): All layers containing non-deep data with arbitrary channels are loaded from the file. Fails if any layer in the image contains deep data.
read_all_data_from_file(path): All layers with arbitrary channels and all resolution levels are extracted from the file.

Note: Currently does not support deep data, and currently fails if any layer in the image contains deep data.

Modules

any_channels How to read arbitrary channels.
image The last wrapper of image readers, finally containing the [from_file(path)] method. This completes the builder and reads a complete image.
layers How to read either a single or a list of layers.
levels How to read a set of resolution levels.
samples How to read samples (a grid of f32, f16 or u32 values).
specific_channels How to read arbitrary but specific selection of arbitrary channels. This is not a zero-cost abstraction.

Structs

ReadBuilder Utilizes the builder pattern to configure an image reader. This is the initial struct.

Functions

read Create a reader which can be used to load an exr image. Allows you to exactly specify how to load the image, for example:
read_all_data_from_file All resolution levels, all channels, all layers.
read_all_flat_layers_from_file No deep data, no resolution levels, all channels, all layers. Uses parallel decompression and relaxed error handling. Inspect the source code of this function if you need customization.
read_all_rgba_layers_from_file No deep data, no resolution levels, rgba channels, all layers.
read_first_flat_layer_from_file No deep data, no resolution levels, all channels, first layer. Uses parallel decompression and relaxed error handling. Inspect the source code of this function if you need customization.
read_first_rgba_layer_from_file No deep data, no resolution levels, rgba channels, choosing the first layer with rgba channels.