Utilities¶

Common
EXIF Data Manipulation
Image Exposure Value Computation
Image Data & Metadata Utilities

Common ¶

colour_hdri

`vivification`()	Implements supports for vivification of the underlying dict like
`vivified_to_dict`(vivified)	Converts given vivified data-structure to dictionary.
`path_exists`(path)	Returns if given path exists.
`filter_files`(directory, extensions)	Filters given directory for files matching given extensions.

EXIF Data Manipulation ¶

colour_hdri

`EXIF_EXECUTABLE`	Command line exif manipulation application, usually Phil Harvey’s ExifTool.
`ExifTag`	Hunt colour appearance model induction factors.
`parse_exif_string`(exif_tag)	Parses given exif tag assuming it is a string and return its value.
`parse_exif_numeric`(exif_tag[, dtype])	Parses given exif tag assuming it is a numeric type and return its value.
`parse_exif_fraction`(exif_tag[, dtype])	Parses given exif tag assuming it is a fraction and return its value.
`parse_exif_array`(exif_tag[, dtype, shape])	Parses given exif tag assuming it is an array and return its value.
`parse_exif_data`(data)	Parses given exif data output from exiftool.
`read_exif_tags`(image)	Returns given image exif image tags.
`copy_exif_tags`(source, target)	Copies given source image file exif tag to given image target.
`update_exif_tags`(images)	Updates given images siblings images pairs exif tags.
`delete_exif_tags`(image)	Deletes all given image exif tags.
`read_exif_tag`(image, tag)	Returns given image exif tag value.
`write_exif_tag`(image, tag, value)	Sets given image exif tag value.

Image Exposure Value Computation ¶

colour_hdri

`exposure_value`(f_number, exposure_time, iso)	Computes the exposure value from given image FNumber, Exposure Time and ISO values.
`adjust_exposure`(a, EV)	Adjusts given array exposure using given \(EV\) exposure value.
`average_luminance`(f_number, exposure_time, iso)	Computes the average luminance from given image FNumber, Exposure Time and ISO values.

Image Data & Metadata Utilities ¶

colour_hdri

`Metadata`	Defines the base object for storing exif metadata relevant to HDRI / radiance image generation.
`Image`([path, data, metadata])	Defines the base object for storing an image along its path, pixel data and metadata needed for HDRI / radiance images generation.
`ImageStack`()	Defines a convenient stack storing a sequence of images for HDRI / radiance images generation.