;c]c(@`sdZddlmZmZmZddlZddlmZddl m Z m Z ddl m Z mZmZmZd e fd YZd efd YZd efdYZdefdYZdefdYZied6ed6ed6ed6ed6dd6dd6dd6Zidd6Zdddddddddddddddddddddddddddddddddddddg%ZdZdZedS(s Plugin that wraps the freeimage lib. The wrapper for Freeimage is part of the core of imageio, but it's functionality is exposed via the plugin system (therefore this plugin is very thin). i(tabsolute_importtprint_functiontdivisionNi(tformats(tFormatt image_as_uinti(tfitdownloadtIO_FLAGStFNAME_PER_PLATFORMtFreeimageFormatcB`sgeZdZdZedZdZdZdej fdYZ dej fdYZ RS( ss This is the default format used for FreeImage. Each Freeimage format has the 'flags' keyword argument. See the Freeimage documentation for more information. The freeimage plugin requires a `freeimage` binary. If this binary not available on the system, it can be downloaded manually from by either - the command line script ``imageio_download_bin freeimage`` - the Python method ``imageio.plugins.freeimage.download()`` Parameters for reading ---------------------- flags : int A freeimage-specific option. In most cases we provide explicit parameters for influencing image reading. Parameters for saving ---------------------- flags : int A freeimage-specific option. In most cases we provide explicit parameters for influencing image saving. ticC`s|jS(N(t_fif(tself((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pytfif0scC`sztjrvt|ds]y"tj|jd|j|_Wq]tk rYd|_q]Xn|j|jkrvt SndS(NR tri( Rthas_libthasattrtgetFIFtfilenamet firstbytesR t ExceptionRtTrue(R trequest((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyt _can_read4s " cC`sttjrpt|dsWytj|jd|_WqWtk rSd|_qWXn|j|jkrptSndS(NR twi( RRRRRR RRR(R R((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyt _can_write?s  tReadercB`s8eZdZddZdZdZdZRS(cC`sdS(Ni((R ((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyt _get_lengthMsicC`sAtj|jj|jj||_|jj|jjdS(N( Rt create_bitmapRRtformatRt_bmtload_from_filenametget_local_filename(R tflags((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyt_openPs$cC`s|jjdS(N(Rtclose(R ((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyt_closeTscC`s7|dkrtdn|jj|jjfS(Nis+This format only supports singleton images.(t IndexErrorRtget_image_datat get_meta_data(R tindex((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyt _get_dataWs cC`s1|dkp|dks$tn|jjS(Ni(tNoneR&RR((R R)((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyt_get_meta_data\s (t__name__t __module__RR#R%R*R,(((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyRLs     tWritercB`s/eZddZdZdZdZRS(icC`s(||_d|_t|_i|_dS(N(t_flagsR+RtFalset_is_sett_meta(R R"((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyR#ds   cC`s=|jj|j|jj|jj|jjdS(N(Rt set_meta_dataR3tsave_to_filenameRR!R$(R ((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyR%jscC`s|jst|_n td|jdkre|jddkre|dddddf}n|jdkrtj|j j |j j |j |_|jj|n|jj|||_dS(Ns1Singleton image; can only append image data once.iiii(R2Rt RuntimeErrortndimtshapeRR+RRRRRRR0tallocatetset_image_dataR3(R timtmeta((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyt _append_dataqs   ""!cC`s ||_dS(N(R3(R R<((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyt_set_meta_datas(R-R.R#R%R=R>(((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyR/cs   ( R-R.t__doc__t_modestpropertyRRRRRR/(((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyR s tFreeimageBmpFormatcB`s'eZdZdejfdYZRS(s A BMP format based on the Freeimage library. This format supports grayscale, RGB and RGBA images. The freeimage plugin requires a `freeimage` binary. If this binary not available on the system, it can be downloaded manually from by either - the command line script ``imageio_download_bin freeimage`` - the Python method ``imageio.plugins.freeimage.download()`` Parameters for saving --------------------- compression : bool Whether to compress the bitmap using RLE when saving. Default False. It seems this does not always work, but who cares, you should use PNG anyway. R/cB`s eZdedZdZRS(icC`sBt|}|r"|tjO}n |tjO}tjj||S(N(tintRt BMP_SAVE_RLEt BMP_DEFAULTR R/R#(R R"t compression((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyR#s   cC`s(t|dd}tjj|||S(Ntbitdepthi(RR R/R=(R R;R<((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyR=s(R-R.R1R#R=(((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyR/s (R-R.R?R R/(((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyRBstFreeimagePngFormatcB`s@eZdZdejfdYZdejfdYZRS(sZ A PNG format based on the Freeimage library. This format supports grayscale, RGB and RGBA images. The freeimage plugin requires a `freeimage` binary. If this binary not available on the system, it can be downloaded manually from by either - the command line script ``imageio_download_bin freeimage`` - the Python method ``imageio.plugins.freeimage.download()`` Parameters for reading ---------------------- ignoregamma : bool Avoid gamma correction. Default True. Parameters for saving --------------------- compression : {0, 1, 6, 9} The compression factor. Higher factors result in more compression at the cost of speed. Note that PNG compression is always lossless. Default 9. quantize : int If specified, turn the given RGB or RGBA image in a paletted image for more efficient storage. The value should be between 2 and 256. If the value of 0 the image is not quantized. interlaced : bool Save using Adam7 interlacing. Default False. RcB`seZdedZRS(icC`s5t|}|r"|tjO}ntjj||S(N(RCRtPNG_IGNOREGAMMAR RR#(R R"t ignoregamma((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyR#s (R-R.RR#(((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyRsR/cB`s&eZdddedZdZRS(ii cC`sitjd6tjd6tjd6tjd6}t|}|rP|tjO}ny|||O}Wntk rtdnXt j j ||S(Niiii s&Png compression must be 0, 1, 6, or 9.( RtPNG_Z_NO_COMPRESSIONtPNG_Z_BEST_SPEEDtPNG_Z_DEFAULT_COMPRESSIONtPNG_Z_BEST_COMPRESSIONRCtPNG_INTERLACEDtKeyErrort ValueErrorR R/R#(R R"RFtquantizet interlacedtcompression_map((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyR#s      cC`st|jdkr*t|dd}nt|dd}tjj|||t|jjj dt }|syn|j dko|j ddkst dnR|d ks|d krt d n+|jjd |}|jj||_dS( Ntuint16RGiiRRiisCan only quantize RGB imagesiis!PNG quantize param must be 2..256i(tstrtdtypeRR R/R=RCRtkwargstgetR1R7R8RQRRRR$(R R;R<tqtbm((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyR=s" (R-R.R1R#R=(((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyR/s(R-R.R?R RR/(((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyRHs tFreeimageJpegFormatcB`s@eZdZdejfdYZdejfdYZRS(sB A JPEG format based on the Freeimage library. This format supports grayscale and RGB images. The freeimage plugin requires a `freeimage` binary. If this binary not available on the system, it can be downloaded manually from by either - the command line script ``imageio_download_bin freeimage`` - the Python method ``imageio.plugins.freeimage.download()`` Parameters for reading ---------------------- exifrotate : bool Automatically rotate the image according to the exif flag. Default True. If 2 is given, do the rotation in Python instead of freeimage. quickread : bool Read the image more quickly, at the expense of quality. Default False. Parameters for saving --------------------- quality : scalar The compression factor of the saved image (1..100), higher numbers result in higher quality but larger file size. Default 75. progressive : bool Save as a progressive JPEG file (e.g. for images on the web). Default False. optimize : bool On saving, compute optimal Huffman coding tables (can reduce a few percent of file size). Default False. baseline : bool Save basic JPEG, without metadata or any markers. Default False. RcB`s,eZdeedZdZdZRS(icC`sWt|}|r.|dkr.|tjO}n|sD|tjO}ntjj||S(Ni(RCRtJPEG_EXIFROTATEt JPEG_ACCURATER RR#(R R"t exifrotatet quickread((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyR#/s  cC`s7tjj||\}}|j||}||fS(N(R RR*t_rotate(R R)R;R<((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyR*9scC`s|jjjdd dkry|dd}Wntk rCqX|d krSn|dkrttj|d}n|dkrtj|d}n|dkrtj|}n|dkrtj|}qn|S(sO Use Orientation information from EXIF meta data to orient the image correctly. Freeimage is also supposed to support that, and I am pretty sure it once did, but now it does not, so let's just do it in Python. Edit: and now it works again, just leave in place as a fallback. R_it EXIF_MAINt OrientationiiiiiiiN(ii(ii(ii(ii(iiii(RRXRYR+RPtnptrot90tfliplr(R R;R<tori((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyRa>s       (R-R.RR1R#R*Ra(((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyR.s R/cB`s)eZddeeedZdZRS(iiKcC`st|}|dks$|dkr3tdnt|}||O}|r_|tjO}n|ru|tjO}n|r|tjO}ntjj||S(Niids)JPEG quality should be between 1 and 100.( RCRQRtJPEG_PROGRESSIVEt JPEG_OPTIMIZEt JPEG_BASELINER R/R#(R R"tqualityt progressivetoptimizetbaseline((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyR#[s   cC`sY|jdkr1|jddkr1tdnt|dd}tjj|||S(Niiis$JPEG does not support alpha channel.RGi(R7R8tIOErrorRR R/R=(R R;R<((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyR=ns"(R-R.R1R#R=(((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyR/Zs(R-R.R?R RR/(((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyR\s$,tFreeimagePnmFormatcB`s'eZdZdejfdYZRS(sm A PNM format based on the Freeimage library. This format supports single bit (PBM), grayscale (PGM) and RGB (PPM) images, even with ASCII or binary coding. The freeimage plugin requires a `freeimage` binary. If this binary not available on the system, it can be downloaded manually from by either - the command line script ``imageio_download_bin freeimage`` - the Python method ``imageio.plugins.freeimage.download()`` Parameters for saving --------------------- use_ascii : bool Save with ASCII coding. Default True. R/cB`seZdedZRS(icC`s5t|}|r"|tjO}ntjj||S(N(RCRtPNM_SAVE_ASCIIR R/R#(R R"t use_ascii((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyR#s (R-R.RR#(((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyR/s(R-R.R?R R/(((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyRpustjpegtpngtbmptppmtppmrawtgifticotmngtFI_TIFFtTIFFtBMPsWindows or OS/2 BitmaptCUTisDr. HalotcuttDDSisDirectX SurfacetddstEXRis ILM OpenEXRtexrtG3isRaw fax format CCITT G.3tg3tGIFisGraphics Interchange FormattHDRisHigh Dynamic Range ImagethdrtICOs Windows IcontIFFisIFF Interleaved Bitmapsiff,lbmtJ2KisJPEG-2000 codestreamsj2k,j2ctJNGisJPEG Network GraphicstjngtJP2isJPEG-2000 File Formattjp2tJPEGsJPEG - JFIF Compliantsjpg,jif,jpeg,jpesJPEG-XRi$sJPEG XR image formats jxr,wdp,hdptKOALAisC64 Koala GraphicstkoatMNGisMultiple-image Network GraphicstPBMisPortable Bitmap (ASCII)tpbmtPBMRAWisPortable Bitmap (RAW)tPCDi s Kodak PhotoCDtpcdtPCXi sZsoft PaintbrushtpcxtPFMi sPortable floatmaptpfmtPGMi sPortable Greymap (ASCII)tpgmtPGMRAWi sPortable Greymap (RAW)tPICTi!sMacintosh PICTs pct,pict,pictPNGi sPortable Network GraphicstPPMisPortable Pixelmap (ASCII)tPPMRAWisPortable Pixelmap (RAW)tPSDisAdobe PhotoshoptpsdtRASisSun Raster ImagetrastRAWi"sRAW camera images3fr,arw,bay,bmq,cap,cine,cr2,crw,cs1,dc2,dcr,drf,dsc,dng,erf,fff,ia,iiq,k25,kc2,kdc,mdc,mef,mos,mrw,nef,nrw,orf,pef,ptx,pxn,qtk,raf,raw,rdc,rw2,rwl,rwz,sr2,srf,srw,stitSGIisSGI Image Formatssgi,rgb,rgba,bwtTARGAisTruevision Targas tga,targaisTagged Image File Formatstif,tifftWBMPisWireless Bitmaps wap,wbmp,wbmtWebPi#sGoogle WebP image formattwebptXBMisX11 Bitmap FormattxbmtXPMisX11 Pixmap FormattxpmcC`stxmtD]e\}}}}tj|jt}|r||d|||j}||_tj|qqWdS(Ns-FI( t fiformatstSPECIAL_CLASSESRYtlowerR R@R Rt add_format(tnameR tdestextt FormatClassR((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyt$_create_predefined_freeimage_formatss  cC`sgt(tdkrdStj}xt|jD]}|j|r3|j|jd}|j |jd}|j |jd}tj ||||ft j |jt}|sq3n||d|||j}||_tj|dtq3q3WdS(s By default, imageio registers a list of predefined formats that freeimage can handle. If your version of imageio can handle more formats, you can call this function to register them. Ntasciis-FIt overwrite(RRR+t_libtrangetFreeImage_GetFIFCounttFreeImage_IsPluginEnabledtFreeImage_GetFormatFromFIFtdecodetFreeImage_GetFIFDescriptiontFreeImage_GetFIFExtensionListtappendRRYRR R@R RRR(tlibR RRRRR((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pytcreate_freeimage_formatss    (R}isWindows or OS/2 BitmapRu(R~isDr. HaloR(RisDirectX SurfaceR(Ris ILM OpenEXRR(RisRaw fax format CCITT G.3R(RisGraphics Interchange FormatRx(RisHigh Dynamic Range ImageR(Ris Windows IconRy(RisIFF Interleaved Bitmapsiff,lbm(RisJPEG-2000 codestreamsj2k,j2c(RisJPEG Network GraphicsR(RisJPEG-2000 File FormatR(RisJPEG - JFIF Compliantsjpg,jif,jpeg,jpe(sJPEG-XRi$sJPEG XR image formats jxr,wdp,hdp(RisC64 Koala GraphicsR(RisMultiple-image Network GraphicsRz(RisPortable Bitmap (ASCII)R(RisPortable Bitmap (RAW)R(Ri s Kodak PhotoCDR(Ri sZsoft PaintbrushR(Ri sPortable floatmapR(Ri sPortable Greymap (ASCII)R(Ri sPortable Greymap (RAW)R(Ri!sMacintosh PICTs pct,pict,pic(Ri sPortable Network GraphicsRt(RisPortable Pixelmap (ASCII)Rv(RisPortable Pixelmap (RAW)Rv(RisAdobe PhotoshopR(RisSun Raster ImageR(Ri"sRAW camera images3fr,arw,bay,bmq,cap,cine,cr2,crw,cs1,dc2,dcr,drf,dsc,dng,erf,fff,ia,iiq,k25,kc2,kdc,mdc,mef,mos,mrw,nef,nrw,orf,pef,ptx,pxn,qtk,raf,raw,rdc,rw2,rwl,rwz,sr2,srf,srw,sti(RisSGI Image Formatssgi,rgb,rgba,bw(RisTruevision Targas tga,targa(R|isTagged Image File Formatstif,tiff(RisWireless Bitmaps wap,wbmp,wbm(Ri#sGoogle WebP image formatR(RisX11 Bitmap FormatR(RisX11 Pixmap FormatR(R?t __future__RRRtnumpyRdtRtcoreRRt _freeimageRRRR R RBRHR\RpR+RtNAME_MAPRRR(((s8lib/python2.7/site-packages/imageio/plugins/freeimage.pyts~ "}%Qm    !