Skip to content

Commit 36b2bb7

Browse files
authored
Merge pull request opencv#28214 from steaphenai:docs-openexr-clarification
docs(env_reference): clarify OpenEXR optional support and security rationale
2 parents 38979d1 + d77e46e commit 36b2bb7

1 file changed

Lines changed: 4 additions & 0 deletions

File tree

doc/tutorials/introduction/env_reference/env_reference.markdown

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -352,3 +352,7 @@ Some external dependencies can be detached into a dynamic library, which will be
352352
| OPENCV_IO_MAX_IMAGE_PIXELS | num | 1 << 30 | |
353353
| OPENCV_IO_ENABLE_OPENEXR | bool | true (set build option OPENCV_IO_FORCE_OPENEXR or use external OpenEXR), false (otherwise) | enable OpenEXR backend |
354354
| OPENCV_IO_ENABLE_JASPER | bool | true (set build option OPENCV_IO_FORCE_JASPER), false (otherwise) | enable Jasper backend |
355+
356+
### Note
357+
* OpenEXR support in OpenCV is optional. Source builds may include a bundled 3rdparty OpenEXR 2.3.0, but runtime support must be explicitly enabled via `OPENCV_IO_ENABLE_OPENEXR`. Users can also build OpenCV against a system-installed OpenEXR library.
358+
* Support is disabled by default due to historical security considerations with malformed EXR files in older OpenEXR versions. Upgrading to OpenEXR 3.x is not a drop-in change and requires API and ABI adaptations.

0 commit comments

Comments
 (0)