1.. _raster.exr:
2
3================================================================================
4EXR -- Extended Dynamic Range Image File Format
5================================================================================
6
7.. versionadded:: 3.1
8
9.. shortname:: EXR
10
11.. build_dependencies:: libopenexr
12
13OpenEXR is a high dynamic range raster file format. The driver supports reading
14and writing images in that format.
15
16Georeferencing is written as a WKT CRS string and a 3x3 geotransform matrix in
17EXR header metadata.
18
19"Deep images" are not supported.
20
21Creation Options
22----------------
23
24-  **COMPRESS=[NONE/RLE/ZIPS/ZIP/PIZ/PXR24/B44/B44A/DWAA/DWAB]**: Compression method.
25   Defaults to ZIP.
26   Details on the format `Wikipedia page <https://en.wikipedia.org/wiki/OpenEXR#Compression_methods>`_
27
28-  **PIXEL_TYPE=HALF/FLOAT/UINT**: Pixel type used for encoding.
29
30   - ``HALF`` corresponds to a IEEE-754 16-bit floating point value.
31   - ``FLOAT`` corresponds to a IEEE-754 32-bit floating point value.
32   - ``UINT`` corresponds to a 32-bit unsigned integer value.
33
34   If not specified, the following GDAL data types will be mapped as following:
35
36   - ``Byte`` ==> HALF
37   - ``Int16`` ==> HALF (potentially lossy)
38   - ``UInt16`` ==> HALF (potentially lossy)
39   - ``Int32`` ==> FLOAT (potentially lossy)
40   - ``UInt32`` ==> UINT
41   - ``Float32`` ==> FLOAT
42   - ``Float64`` ==> FLOAT (generally lossy)
43
44-  **TILED=YES/NO**: By default tiled files will be created, unless this option
45   is set to NO. In Create() mode, setting TILED=NO is not possible.
46
47-  **BLOCKXSIZE=n**: Sets tile width, defaults to 256.
48
49-  **BLOCKYSIZE=n**: Sets tile height, defaults to 256.
50
51-  **OVERVIEWS=YES/NO**: Whether to create overviews. Default to NO. Only
52   compatible of CreateCopy() mode.
53
54-  **OVERVIEW_RESAMPLING=NEAR/AVERAGE/CUBIC/...**: Resampling method to use for
55   overview creation. Defaults to CUBIC.
56
57-  **PREVIEW=YES/NO**: Whether to create a preview. Default to NO. Only
58   compatible of CreateCopy() mode, and with RGB(A) data of type Byte.
59
60-  **AUTO_RESCALE=YES/NO**: Whether to rescale Byte RGB(A) values from 0-255 to
61   the 0-1 range usually used in EXR ecosystem.
62
63-  **DWA_COMPRESSION_LEVEL=n**: DWA compression level. The higher, the more
64   compressed the image will be (and the more artifacts). Defaults to 45
65   for OpenEXR 2.4
66
67Driver capabilities
68-------------------
69
70.. supports_createcopy::
71
72.. supports_create::
73
74    With the caveat, that it is only for tiled data, and each tile must be
75    written at most once, and written tiles cannot be read back before dataset
76    closing.
77
78.. supports_georeferencing::
79
80.. supports_virtualio::
81