Expand description
Format-aware image opening.
Wraps image::open so:
- HEIC/HEIF (every modern iPhone photo) decodes through libheif
when the
heicCargo feature is enabled, fails clearly otherwise. - TIFF-based RAW (NEF / CR2 / CR3 / ARW / DNG / ORF / RW2 /
PEF / RWL / SRW) decodes via the camera’s embedded full-res
JPEG preview when the
rawfeature is on (default). - Everything else falls through to the
imagecrate.
Call this from any code path that previously did image::open(...)
— thumbnail generation, face detection, brightness sampling.
Functions§
- open_
image - Open and decode an image. Returns a fully-decoded
DynamicImageregardless of the on-disk format. HEIC/HEIF route through libheif when compiled in; RAW files route throughraw_previewto extract the embedded full-res JPEG preview (the camera’s intended rendering, much better than software-debayered output without proprietary colour profiles); everything else uses theimagecrate’s native decoders.