Module exr::image

Data structures that represent a complete exr image. Contains generic structs that must be nested to obtain a complete image type.

For example, an rgba image containing multiple layers can be represented using Image<Layers<SpecificChannels<MyPixelStorage>>>. An image containing a single layer with arbitrary channels and no deep data can be represented using Image<Layer<AnyChannels<FlatSamples>>>.

These and other predefined types are included in this module as

1. PixelImage: A single layer, fixed set of arbitrary channels.
2. PixelLayersImage: Multiple layers, fixed set of arbitrary channels.
3. RgbaImage: A single layer, fixed set of channels: rgb, optional a.
4. RgbaLayersImage: Multiple layers, fixed set of channels: rgb, optional a.
5. FlatImage: Multiple layers, any channels, no deep data.
6. AnyImage: All supported data (multiple layers, arbitrary channels, no deep data yet)

You can also use your own types inside an image, for example if you want to use a custom sample storage.

This is the high-level interface for the pixels of an image. See exr::blocks module for a low-level interface.

Modules

• crop
  Crop away unwanted pixels. Includes automatic detection of bounding rectangle. Currently does not support deep data and resolution levels.
• pixel_vec
  Provides a predefined pixel storage. Currently only contains a simple flattened vector storage. Use the functions create_pixel_vec::<YourPixelTuple> and set_pixel_in_vec::<YourPixelTuple> for reading a predefined pixel vector. Use the function PixelVec::new to create a pixel vector which can be written to a file.
• read
  Read an exr image.
• recursive
  A generic wrapper which can be used to represent recursive types. Supports conversion from and to tuples of the same size.
• validate_results
  Compare the result of a round trip test with the original method. Supports lossy compression methods.
• write
  Write an exr image to a file.

Structs

• AnyChannel
  A single arbitrary channel. Samples can currently only be FlatSamples or Levels<FlatSamples>
• AnyChannels
  A dynamic list of arbitrary channels. Samples can currently only be FlatSamples or Levels<FlatSamples>.
• Encoding
  How the pixels are split up and compressed.
• FlatSampleIterator
  Iterate over all channels of a single pixel in the image
• Image
  The complete exr image. Layers can be either a single Layer or Layers.
• Layer
  A single Layer, including fancy attributes and compression settings. Channels can be either SpecificChannels or AnyChannels
• RipMaps
  In addition to the full resolution image, this layer also contains smaller versions, and each smaller version has further versions with varying aspect ratios. Samples can currently only be FlatSamples.
• SpecificChannels
  A grid of pixels. The pixels are written to your custom pixel storage. PixelStorage can be anything, from a flat Vec<f16> to Vec<Vec<AnySample>>, as desired. In order to write this image to a file, your PixelStorage must implement GetPixel.
• SpecificChannelsBuilder
  Used to construct a SpecificChannels. Call with_named_channel as many times as desired, and then call with_pixels to define the colors.

Enums

• Blocks
  How the image pixels are split up into separate blocks.
• FlatSamples
  A vector of non-deep values (one value per pixel per channel). Stores row after row in a single vector. The precision of all values is either f16, f32 or u32.
• Levels
  One or multiple resolution levels of the same image. Samples can be FlatSamples.

Traits

• CheckDuplicates
  This check can be executed at compile time if the channel names are &'static str and the compiler is smart enough.
• IntoSample
  Convert this type into one of the known sample types. Also specify the preferred native type, which dictates the default sample type in the image.

Functions

• ignore_progress 🔒
  Don’t do anything

Type Aliases

• AnyImage
  This image type contains all supported exr features and can represent almost any image. It currently does not support deep data yet.
• FlatImage
  This image type contains the most common exr features and can represent almost any plain image. Does not contain resolution levels. Does not support deep data.
• FlatSamplesPixel
  A list of samples representing a single pixel. Does not heap allocate for images with 8 or fewer channels.
• Layers
  A list of layers. Channels can be SpecificChannels or AnyChannels.
• LevelMaps
  A list of resolution levels. Samples can currently only be FlatSamples.
• PixelImage
  This image type contains a single layer containing a user-defined type of pixels.
• PixelLayersImage
  This image type contains multiple layers, with each layer containing a user-defined type of pixels.
• RgbChannels
  Contains information about the channels in an rgb image, in the order (red, green, blue).
• RgbaChannels
  Contains information about the channels in an rgba image, in the order (red, green, blue, alpha). The alpha channel is not required. May be None if the image did not contain an alpha channel.
• RgbaImage
  This image type contains a single layer containing a user-defined type of rgba pixels.
• RgbaLayersImage
  This image type contains multiple layers, with each layer containing a user-defined type of rgba pixels.