ó ;c›]c@`s¼dZddlmZmZmZddlmZddlZddlZ ddl mZmZddl m Z d Zd ZejdƒZidd6dd6ZxVedged ƒƒD];\ZZdeee")`` to grab images from a (web) camera. * ``imread("")`` to grab a screenshot (on Windows or OS X). * ``imread("")`` to grab an image from the clipboard (on Windows). For writing one can also use ``''`` or ``imageio.RETURN_BYTES`` to make a write function return the bytes instead of writing to a file. Note that reading from HTTP and zipfiles works for many formats including png and jpeg, but may not work for all formats (some plugins "seek" the file object, which HTTP/zip streams do not support). In such a case one can download/extract the file first. For HTTP one can use something like ``imageio.imread(imageio.core.urlopen(url).read(), '.gif')``. i(tabsolute_importtprint_functiontdivision(tNumberNi(tRequesttRETURN_BYTESi(tformatst256MBt1GBs"^(\d+\.?\d*)\s*([kKMGTPEZY]?i?)B?$ttkMGTPEZYièiticC`sµ|s dS|tkr|St|tƒr-|Stj|ƒ}|dkr`tdj|ƒƒ‚n|jƒ\}}yt |ƒt |SWn&tk r°tdj|ƒƒ‚nXdS(NsEMemory size could not be parsed (is your capitalisation correct?): {}sEMemory size unit not recognised (is your capitalisation correct?): {}(tNonetTruet isinstanceRtmem_retmatcht ValueErrortformattgroupstfloattsizestKeyError(targtdefaultRtnumtunit((s5lib/python2.7/site-packages/imageio/core/functions.pyt to_nbytesds$ cC`s%|sttƒntt|ƒdS(s; help(name=None) Print the documentation of the format specified by name, or a list of supported formats if name is omitted. Parameters ---------- name : str Can be the name of a format, a filename extension, or a full filename. See also the :doc:`formats page `. N(tprintR(tname((s5lib/python2.7/site-packages/imageio/core/functions.pythelp€s t?cK`sjt|d||}|dk r/t|}ntj|ƒ}|dkr]td|ƒ‚n|j|ƒS(s± get_reader(uri, format=None, mode='?', **kwargs) Returns a :class:`.Reader` object which can be used to read data and meta data from the specified file. Parameters ---------- uri : {str, pathlib.Path, bytes, file} The resource to load the image from, e.g. a filename, pathlib.Path, http address or file object, see the docs for more info. format : str The format to use to read the file. By default imageio selects the appropriate for you based on the filename and its contents. mode : {'i', 'I', 'v', 'V', '?'} Used to give the reader a hint on what the user expects (default "?"): "i" for an image, "I" for multiple images, "v" for a volume, "V" for multiple volumes, "?" for don't care. kwargs : ... Further keyword arguments are passed to the reader. See :func:`.help` to see what arguments are available for a particular format. trs=Could not find a format to read the specified file in mode %rN(RRRtsearch_read_formatRt get_reader(turiRtmodetkwargstrequest((s5lib/python2.7/site-packages/imageio/core/functions.pyR"•s cK`sŸ|tkr5t|tƒr5td|jdƒ}nt|d||}|dk rdt|}ntj|ƒ}|dkr’td|ƒ‚n|j |ƒS(sŠ get_writer(uri, format=None, mode='?', **kwargs) Returns a :class:`.Writer` object which can be used to write data and meta data to the specified file. Parameters ---------- uri : {str, pathlib.Path, file} The resource to write the image to, e.g. a filename, pathlib.Path or file object, see the docs for more info. format : str The format to use to write the file. By default imageio selects the appropriate for you based on the filename. mode : {'i', 'I', 'v', 'V', '?'} Used to give the writer a hint on what the user expects (default '?'): "i" for an image, "I" for multiple images, "v" for a volume, "V" for multiple volumes, "?" for don't care. kwargs : ... Further keyword arguments are passed to the writer. See :func:`.help` to see what arguments are available for a particular format. t.s. tws>Could not find a format to write the specified file in mode %rN( RRtstrtstripRRRtsearch_write_formatRt get_writer(R#RR$R%R&((s5lib/python2.7/site-packages/imageio/core/functions.pyR,½s cK`sNd|krtdƒ‚nt||d|}||jdƒSWdQXdS(sY imread(uri, format=None, **kwargs) Reads an image from the specified file. Returns a numpy array, which comes with a dict of meta data at its 'meta' attribute. Note that the image data is returned as-is, and may not always have a dtype of uint8 (and thus may differ from what e.g. PIL returns). Parameters ---------- uri : {str, pathlib.Path, bytes, file} The resource to load the image from, e.g. a filename, pathlib.Path, http address or file object, see the docs for more info. format : str The format to use to read the file. By default imageio selects the appropriate for you based on the filename and its contents. kwargs : ... Further keyword arguments are passed to the reader. See :func:`.help` to see what arguments are available for a particular format. R$s<Invalid keyword argument "mode", perhaps you mean "pilmode"?RiN(t TypeErrortreadtget_data(R#RR%treader((s5lib/python2.7/site-packages/imageio/core/functions.pytimreadìscK`sÍt|ƒ}tj|ƒ}tj|jtjƒsNtdj|jƒƒ‚nC|j dkr`n1|j dkr…|j dd kr…ntdƒ‚t||d|}||j|ƒWdQX|j jƒS( s© imwrite(uri, im, format=None, **kwargs) Write an image to the specified file. Parameters ---------- uri : {str, pathlib.Path, file} The resource to write the image to, e.g. a filename, pathlib.Path or file object, see the docs for more info. im : numpy.ndarray The image data. Must be NxM, NxMx3 or NxMx4. format : str The format to use to read the file. By default imageio selects the appropriate for you based on the filename and its contents. kwargs : ... Further keyword arguments are passed to the writer. See :func:`.help` to see what arguments are available for a particular format. sImage is not numeric, but {}.iiiis+Image must be 2D (grayscale, RGB, or RGBA).RN(iii(ttypetnpt asanyarrayt issubdtypetdtypetnumberRRt__name__tndimtshapeR,tappend_dataR&t get_result(R#timRR%timttwriter((s5lib/python2.7/site-packages/imageio/core/functions.pytimwrite s"c K`s–t||d|}t|tƒ}g}d}x_|D]W}|j|ƒ||j7}|r7||kr7g|(tdjt|ƒƒƒ‚q7q7W|S(s mimread(uri, format=None, memtest="256MB", **kwargs) Reads multiple images from the specified file. Returns a list of numpy arrays, each with a dict of meta data at its 'meta' attribute. Parameters ---------- uri : {str, pathlib.Path, bytes, file} The resource to load the images from, e.g. a filename,pathlib.Path, http address or file object, see the docs for more info. format : str The format to use to read the file. By default imageio selects the appropriate for you based on the filename and its contents. memtest : {bool, int, float, str} If truthy, this function will raise an error if the resulting list of images consumes greater than the amount of memory specified. This is to protect the system from using so much memory that it needs to resort to swapping, and thereby stall the computer. E.g. ``mimread('hunger_games.avi')``. If the argument is a number, that will be used as the threshold number of bytes. If the argument is a string, it will be interpreted as a number of bytes with SI/IEC prefixed units (e.g. '1kB', '250MiB', '80.3YB'). - Units are case sensitive - k, M etc. represent a 1000-fold change, where Ki, Mi etc. represent 1024-fold - The "B" is optional, but if present, must be capitalised If the argument is True, the default will be used, for compatibility reasons. Default: '256MB' kwargs : ... Further keyword arguments are passed to the reader. See :func:`.help` to see what arguments are available for a particular format. tIis“imageio.mimread() has read over {}B of image data. Stopped to avoid memory problems. Use imageio.get_reader(), increase threshold, or memtest=False(R.RtMEMTEST_DEFAULT_MIMtappendtnbytestRuntimeErrorRtint( R#RtmemtestR%R0tnbyte_limittimsRDR=((s5lib/python2.7/site-packages/imageio/core/functions.pytmimread9s( c K`st||d|}d}|¾x¶|D]®}t|ƒ}tj|ƒ}tj|jtjƒs}tdj|j ƒƒ‚nC|j dkrn1|j dkr´|jddkr´ntdƒ‚|j|ƒ|d7}q)WWd QX|söt d ƒ‚n|jjƒS(sÊ mimwrite(uri, ims, format=None, **kwargs) Write multiple images to the specified file. Parameters ---------- uri : {str, pathlib.Path, file} The resource to write the images to, e.g. a filename, pathlib.Path or file object, see the docs for more info. ims : sequence of numpy arrays The image data. Each array must be NxM, NxMx3 or NxMx4. format : str The format to use to read the file. By default imageio selects the appropriate for you based on the filename and its contents. kwargs : ... Further keyword arguments are passed to the writer. See :func:`.help` to see what arguments are available for a particular format. RAisImage is not numeric, but {}.iiiis+Image must be 2D (grayscale, RGB, or RGBA).NsZero images were written.(iii(R,R2R3R4R5R6R7RRR8R9R:R;RER&R<(R#RIRR%R?twrittenR=R>((s5lib/python2.7/site-packages/imageio/core/functions.pytmimwritexs$ " cK`s3t||d|}||jdƒSWdQXdS(sË volread(uri, format=None, **kwargs) Reads a volume from the specified file. Returns a numpy array, which comes with a dict of meta data at its 'meta' attribute. Parameters ---------- uri : {str, pathlib.Path, bytes, file} The resource to load the volume from, e.g. a filename, pathlib.Path, http address or file object, see the docs for more info. format : str The format to use to read the file. By default imageio selects the appropriate for you based on the filename and its contents. kwargs : ... Further keyword arguments are passed to the reader. See :func:`.help` to see what arguments are available for a particular format. tviN(R.R/(R#RR%R0((s5lib/python2.7/site-packages/imageio/core/functions.pytvolread°scK`sÍt|ƒ}tj|ƒ}tj|jtjƒsNtdj|jƒƒ‚nC|j dkr`n1|j dkr…|j ddkr…ntdƒ‚t||d|}||j|ƒWdQX|j jƒS(sÄ volwrite(uri, vol, format=None, **kwargs) Write a volume to the specified file. Parameters ---------- uri : {str, pathlib.Path, file} The resource to write the image to, e.g. a filename, pathlib.Path or file object, see the docs for more info. vol : numpy.ndarray The image data. Must be NxMxL (or NxMxLxK if each voxel is a tuple). format : str The format to use to read the file. By default imageio selects the appropriate for you based on the filename and its contents. kwargs : ... Further keyword arguments are passed to the writer. See :func:`.help` to see what arguments are available for a particular format. sImage is not numeric, but {}.iii s1Image must be 3D, or 4D if each voxel is a tuple.RMN(R2R3R4R5R6R7RRR8R9R:R,R;R&R<(R#R=RR%R>R?((s5lib/python2.7/site-packages/imageio/core/functions.pytvolwriteÉs"c K`s–t||d|}t|tƒ}g}d}x_|D]W}|j|ƒ||j7}|r7||kr7g|(tdjt|ƒƒƒ‚q7q7W|S(s mvolread(uri, format=None, memtest='1GB', **kwargs) Reads multiple volumes from the specified file. Returns a list of numpy arrays, each with a dict of meta data at its 'meta' attribute. Parameters ---------- uri : {str, pathlib.Path, bytes, file} The resource to load the volumes from, e.g. a filename, pathlib.Path, http address or file object, see the docs for more info. format : str The format to use to read the file. By default imageio selects the appropriate for you based on the filename and its contents. memtest : {bool, int, float, str} If truthy, this function will raise an error if the resulting list of images consumes greater than the amount of memory specified. This is to protect the system from using so much memory that it needs to resort to swapping, and thereby stall the computer. E.g. ``mimread('hunger_games.avi')``. If the argument is a number, that will be used as the threshold number of bytes. If the argument is a string, it will be interpreted as a number of bytes with SI/IEC prefixed units (e.g. '1kB', '250MiB', '80.3YB'). - Units are case sensitive - k, M etc. represent a 1000-fold change, where Ki, Mi etc. represent 1024-fold - The "B" is optional, but if present, must be capitalised If the argument is True, the default will be used, for compatibility reasons. Default: '1GB' kwargs : ... Further keyword arguments are passed to the reader. See :func:`.help` to see what arguments are available for a particular format. tVis”imageio.mvolread() has read over {}B of image data. Stopped to avoid memory problems. Use imageio.get_reader(), increase threshold, or memtest=False(R.RtMEMTEST_DEFAULT_MVOLRCRDRERRF( R#RRGR%R0RHRIRDR=((s5lib/python2.7/site-packages/imageio/core/functions.pytmvolreadõs( cK`st||d|}d}|¾x¶|D]®}t|ƒ}tj|ƒ}tj|jtjƒs}tdj|j ƒƒ‚nC|j dkrn1|j dkr´|jddkr´ntdƒ‚|j|ƒ|d7}q)WWd QX|söt d ƒ‚n|jjƒS(sî mvolwrite(uri, vols, format=None, **kwargs) Write multiple volumes to the specified file. Parameters ---------- uri : {str, pathlib.Path, file} The resource to write the volumes to, e.g. a filename, pathlib.Path or file object, see the docs for more info. ims : sequence of numpy arrays The image data. Each array must be NxMxL (or NxMxLxK if each voxel is a tuple). format : str The format to use to read the file. By default imageio selects the appropriate for you based on the filename and its contents. kwargs : ... Further keyword arguments are passed to the writer. See :func:`.help` to see what arguments are available for a particular format. RPisImage is not numeric, but {}.iii s1Image must be 3D, or 4D if each voxel is a tuple.iNsZero volumes were written.(R,R2R3R4R5R6R7RRR8R9R:R;RER&R<(R#RIRR%R?RKR=R>((s5lib/python2.7/site-packages/imageio/core/functions.pyt mvolwrite3s$ " (+t__doc__t __future__RRRtnumbersRtretnumpyR3R RRRRBRQtcompileRRRt enumeratetlistRtsitupperRRR"R,R1R@RJRLRNRORRRSR.tsavetimsavetmimsavetvolsavetmvolsave(((s5lib/python2.7/site-packages/imageio/core/functions.pytKs@&(/!,?8,>8