PillowPlugin.iter(*, mode: Optional[str] = None, rotate: bool = False, apply_gamma: bool = False, writeable_output: bool = True) Iterator[ndarray][source]#

Iterate over all ndimages/frames in the URI

mode{str, None}

Convert the image to the given mode before returning it. If None, the mode will be left unchanged. Possible modes can be found at:


If set to True and the image contains an EXIF orientation tag, apply the orientation before returning the ndimage.


If True and the image contains metadata about gamma, apply gamma correction to the image.


If True, ensure that the image is writable before returning it to the user. This incurs a full copy of the pixel data if the data served by pillow is read-only. Consequentially, setting this flag to False improves performance for some images.