a6dddlZddlZddlmZddlmZddlmZm Z ddl m Z ddl m Z gd Zdd Z dd ZddZddZddZdZdS)N)warn)is_low_contrast)rgb2grayrgba2rgb call_plugin)file_or_url_context)imreadimsaveimshowshowimread_collectionimshow_collectionFc t|tjr!t|}|9t |dr)|drd}t|5}td|fd|i|}dddn #1swxYwYt |ds|S|j dkr{|j d d vr;|j d d vr,tj |d d }tj |d d }|r/|j dd krt|}t|}|S)aLoad an image from file. Parameters ---------- fname : str or pathlib.Path Image file name, e.g. ``test.jpg`` or URL. as_gray : bool, optional If True, convert color images to gray-scale (64-bit floats). Images that are already in gray-scale format are not converted. plugin : str, optional Name of plugin to use. By default, the different plugins are tried (starting with imageio) until a suitable candidate is found. If not given and fname is a tiff file, the tifffile plugin will be used. Other Parameters ---------------- plugin_args : keywords Passed to the given plugin. Returns ------- img_array : ndarray The different color bands/channels are stored in the third dimension, such that a gray-image is MxN, an RGB-image MxNx3 and an RGBA-image MxNx4. Nlowerz.tiffz.tiftifffiler pluginndimr)r) isinstancepathlibPathstrresolvehasattrrendswithr r rshapenpswapaxesrr)fnameas_grayr plugin_argsimgs .lib/python3.11/site-packages/skimage/io/_io.pyr r s:%&&%EMMOO$$ ~'%11~ ;;== ! !"3 4 4 F U # #Iu(EHH&HKHHIIIIIIIIIIIIIII 3    x!|| 9R= & &39R=F+B+B+c2r**C+c2r**C  y|q  smm3--C JsB##B'*B'Tc $td||fd|i|S)a Load a collection of images. Parameters ---------- load_pattern : str or list List of objects to load. These are usually filenames, but may vary depending on the currently active plugin. See the docstring for ``ImageCollection`` for the default behaviour of this parameter. conserve_memory : bool, optional If True, never keep more than one in memory at a specific time. Otherwise, images will be cached once they are loaded. Returns ------- ic : ImageCollection Collection of images. Other Parameters ---------------- plugin_args : keywords Passed to the given plugin. rrr) load_patternconserve_memoryrr)s r+rrGs24 *L/ 5 5$ 5(3 5 55c t|tjr!t|}|9t |dr)|drd}|jtkr,t|dd| dd z}|r!t|rt|d td ||fd |i|S) aSave an image to file. Parameters ---------- fname : str or pathlib.Path Target filename. arr : ndarray of shape (M,N) or (M,N,3) or (M,N,4) Image data. plugin : str, optional Name of plugin to use. By default, the different plugins are tried (starting with imageio) until a suitable candidate is found. If not given and fname is a tiff file, the tifffile plugin will be used. check_contrast : bool, optional Check for low contrast and print warning (default: True). Other Parameters ---------------- plugin_args : keywords Passed to the given plugin. Notes ----- When saving a JPEG, the compression ratio may be controlled using the ``quality`` keyword argument which is an integer with values in [1, 100] where 1 is worst quality and smallest file size, and 100 is best quality and largest file size (default 75). This is only available when using the PIL and imageio plugins. Nrrrz~ is a boolean image: setting True to 255 and False to 0. To silence this warning, please convert the image using img_as_ubyte.r) stackleveluint8z is a low contrast imager r)rrrr r!r"rr#dtypeboolrastyperr )r'arrrcheck_contrastr)s r+r r es<%&&%EMMOO$$ ~'%11~ ;;== ! !"3 4 4 F yD )* , , , ,jj!!C'1/#..1  / / /000 x J JF Jk J JJr/c pt|trtd||}td|fd|i|S)aDisplay an image. Parameters ---------- arr : ndarray or str Image data or name of image file. plugin : str Name of plugin to use. By default, the different plugins are tried (starting with imageio) until a suitable candidate is found. Other Parameters ---------------- plugin_args : keywords Passed to the given plugin. r )rrr)rr r )r7rr)s r+rrsG$#s8(C777 x C CV C{ C CCr/c "td|fd|i|S)apDisplay a collection of images. Parameters ---------- ic : ImageCollection Collection to display. plugin : str Name of plugin to use. By default, the different plugins are tried until a suitable candidate is found. Other Parameters ---------------- plugin_args : keywords Passed to the given plugin. rrr)icrr)s r+rrs"" *B M Mv M M MMr/c tdS)aDisplay pending images. Launch the event loop of the current gui plugin, and display all pending images, queued via `imshow`. This is required when using `imshow` from non-interactive scripts. A call to `show` will block execution of code until all windows have been closed. Examples -------- >>> import skimage.io as io >>> rng = np.random.default_rng() >>> for i in range(4): ... ax_im = io.imshow(rng.random((50, 50))) >>> io.show() # doctest: +SKIP _app_showrr/r+rrs( { # ##r/)FN)TN)NT)N)rnumpyr% _shared.utilsrexposurercolor.colorconvrrio.manage_pluginsr utilr __all__r rr rrrr>r/r+rFs &&&&&&00000000++++++%%%%%% 5 5 54444n59!5555<*K*K*K*KZDDDD.NNNN($$$$$r/