o h@sddlZddlZddlmZddlmZddlmZm Z ddl m Z ddl m Z gd Zdd d Z dddZdddZdddZdddZddZdS)N)warn)is_low_contrast)rgb2grayrgba2rgb call_plugin)file_or_url_context)imreadimsaveimshowshowimread_collectionimshow_collectionFcKst|tjr t|}|durt|dr|drd}t|}t d|fd|i|}Wdn1s8wYt|dsD|S|j dkrv|j d d vre|j d d vret |d d }t |d d }|rv|j dd krrt|}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 rrshapenpswapaxesrr)fnameas_grayr plugin_argsimgr)I/var/www/html/scripts/venv/lib/python3.10/site-packages/skimage/io/_io.pyr s&     r TcKstd||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'r)r)r*rGs rcKst|tjr t|}|durt|dr|drd}|jt kr3t |ddd| dd }|r@t |r@t |d t d ||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)rrrrrr rr!dtypeboolrastyperr)r%arrrcheck_contrastr'r)r)r*r es     r cKs.t|tr td||d}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 )rr r)rrr)r3rr'r)r)r*r s r cKstd|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'r)r)r*rsrcCstdS)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)r)r*rsr)FN)TN)NT)N)rnumpyr# _shared.utilsrexposurercolor.colorconvrrio.manage_pluginsrutilr __all__r rr r rrr)r)r)r*s      7  -