colour.io.write_image_OpenImageIO¶

colour.io.write_image_OpenImageIO(image, path, bit_depth='float32', attributes=None)[source]¶

Writes given image at given path using OpenImageIO.

Parameters

image (array_like) – Image data.
path (unicode) – Image path.
bit_depth (unicode, optional) – {‘float32’, ‘uint8’, ‘uint16’, ‘float16’}, Bit depth to write the image at, the bit depth conversion behaviour is ruled directly by OpenImageIO.
attributes (array_like, optional) – An array of colour.io.ImageAttribute_Specification class instances used to set attributes of the image.

Returns

Definition success.

Return type

bool

Examples

Basic image writing:

>>> import os
>>> import colour
>>> path = os.path.join(colour.__path__[0], 'io', 'tests', 'resources',
...                     'CMS_Test_Pattern.exr')
>>> image = read_image(path)  
>>> path = os.path.join(colour.__path__[0], 'io', 'tests', 'resources',
...                     'CMSTestPattern.tif')
>>> write_image(image, path)  
True

Advanced image writing while setting attributes:

>>> compression = ImageAttribute_Specification('Compression', 'none')
>>> write_image(image, path, 'uint8', [compression])  
True