Struct openexr::core::input_part::InputPart

#[repr(transparent)]
pub struct InputPart<'a> { /* fields omitted */ }

Implementations

impl<'a> InputPart<'a>

pub fn new(
    multi_part_file: &MultiPartInputFile,
    part_number: i32
) -> Result<InputPart<'_>, Error>

Get an interface to the part part_number of the MultiPartInputFile multi_part_file.

pub fn header(&self) -> HeaderRef<'_>

Access to the file Header

pub fn version(&self) -> i32

Access to the file format version

pub fn set_frame_buffer(
    &mut self,
    frame_buffer: &FrameBuffer
) -> Result<(), Error>

Set the current frame buffer – copies the FrameBuffer object into the InputPart object.

The current frame buffer is the destination for the pixel data read from the file. The current frame buffer must be set at least once before read_pixels() is called. The current frame buffer can be changed after each call to read_pixels().

Errors

• Error::InvalidArgument - if the sampling factors do not match or if the frame buffer does not have a sample count slice.

pub fn frame_buffer(&self) -> FrameBufferRef<'_>

Access to the current frame buffer

pub fn is_complete(&self) -> bool

Check if all pixels in the data window are present in the input file

pub fn is_optimization_enabled(&self) -> bool

Check if SSE optimization is enabled

Call after set_frame_buffer() to query whether optimized file decoding is available - decode times will be faster if returns true

Optimization depends on: the file type (only scanline data is supported), the framebuffer channels (RGB/RGBA mono or stereo) the framebuffer channel types (all channels half-float format only) the file channels (RGB/RGBA mono or stereo) the file channel types (all channel half-float format only) whether SSE2 instruction support was detected at compile time

Errors

• Error::InvalidArgument - if no frame buffer has been set

pub fn read_pixels(&mut self, s1: i32, s2: i32) -> Result<(), Error>

Read all scanlines in the range [s1, s2] and put them in the current frame buffer.

read_pixel_sample_counts() must be called before calling this method.

Errors

• Error::InvalidArgument - if no frame buffer has been set, if s1 or s2 are outside the data window, or if the sample counts have not been read yet
• Error::Base - if any other error occurs