- imageio.v3.imopen(uri, io_mode, *, plugin=None, extension=None, format_hint=None, legacy_mode=False, **kwargs)#
Open an ImageResource.
This warning is for pypy users. If you are not using a context manager, remember to deconstruct the returned plugin to avoid leaking the file handle to an unclosed file.
- uristr or pathlib.Path or bytes or file or Request
The ImageResource to load the image from.
The mode in which the file is opened. Possible values are:
``r`` - open the file for reading ``w`` - open the file for writing
Depreciated since v2.9: A second character can be added to give the reader a hint on what the user expects. This will be ignored by new plugins and will only have an effect on legacy plugins. Possible values are:
``i`` for a single image, ``I`` for multiple images, ``v`` for a single volume, ``V`` for multiple volumes, ``?`` for don't care (default)
- pluginstr, Plugin, or None
The plugin to use. If set to None (default) imopen will perform a search for a matching plugin. If not None, this takes priority over the provided format hint.
If not None, treat the provided ImageResource as if it had the given extension. This affects the order in which backends are considered, and when writing this may also influence the format used when encoding.
Deprecated. Use extension instead.
If true (default) use the v2 behavior when searching for a suitable plugin. This will ignore v3 plugins and will check
pluginagainst known extensions if no plugin with the given name can be found.
Additional keyword arguments will be passed to the plugin upon construction.
Registered plugins are controlled via the
Requestas the uri is only supported if
True. In this case
Using the kwarg
format_hintdoes not enforce the given format. It merely provides a hint to the selection process and plugin. The selection processes uses this hint for optimization; however, a plugin’s decision how to read a ImageResource will - typically - still be based on the content of the resource.
>>> import imageio.v3 as iio >>> with iio.imopen("/path/to/image.png", "r") as file: >>> im = file.read()
>>> with iio.imopen("/path/to/output.jpg", "w") as file: >>> file.write(im)