B |bVYR@sbdZddlZddlZddlZddlZddlmZddlmZm Z m Z ddl m Z ddl mZmZmZmZmZmZmZmZmZddlmZmZmZmZdd lmZdd lmZm Z dd l!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'dd l(m)Z)m*Z*d Z+dZ,e)dkrdZ,dZ-e.dddddddddddddddddddddZ/e)dkrhe.dddddddddddddddddddddd dd!Z/d"Z0e)dkrzd#Z0d$Z1e)dkrd%Z1d&Z2d'Z3e)dkrd(Z3d)Z4e)dkrd*Z4d+Z5d,Z6d-Z7d.Z8e)dkrd/Z8d0Z9d1Z:e)dkrd2Z:d3Z;d4Zd8Z?e)dkrd9Z?d:Z@e)dkr*d;Z@dd?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVgZCdWZDdXdYdZd[d\d]d^d_d`dadbdcdddedfdgdgdhdidjdkdldmd]dndodpdqdrdsdtdudvdwdxdydzd{d|d}d~dddddddddddddddddddddddddddddddddddddddd`dQZEdZFdZGe.ddddddddZHdZIe)dkrFdZIdZJdZKdZLe)dkr`dZLddZMddZNGddde ZOGdddeOZPGddde ejQZQGdddeRZSGdddeSejTZUGdddeSejTZVGdddeSejTZWGdd„deSejTZXGddĄdeSejYZZGddƄdeSejYZ[GddȄdejYZ\GddʄdeRZ]Gdd̄deZ^dS)ah:mod:`wand.image` --- Image objects ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Opens and manipulates images. Image objects can be used in :keyword:`with` statement, and these resources will be automatically managed (even if any error happened):: with Image(filename='pikachu.png') as i: print('width =', i.width) print('height =', i.height) N) assertions)libc libmagicklibrary)Color) abcbinary binary_typeencode_filename file_types string_typetextto_bytesxrange)MissingDelegateError WandExceptionWandRuntimeErrorWandLibraryVersionError)Font)DestroyedResourceErrorResource) CCObjectInfoCCObjectInfo70AChannelFeature GeometryInfo PixelInfo RectangleInfo)MAGICK_VERSION_NUMBER MAGICK_HDRI)+ALPHA_CHANNEL_TYPESAUTO_THRESHOLD_METHODSCHANNELSCOLORSPACE_TYPESCOMPARE_METRICSCOMPOSITE_OPERATORSCOMPRESSION_TYPES DISPOSE_TYPESDISTORTION_METHODSDITHER_METHODS EVALUATE_OPS FILTER_TYPESFUNCTION_TYPES GRAVITY_TYPESIMAGE_LAYER_METHOD IMAGE_TYPESINTERLACE_TYPESKERNEL_INFO_TYPESMORPHOLOGY_METHODS NOISE_TYPESORIENTATION_TYPES PAPERSIZE_MAPPIXEL_INTERPOLATE_METHODSRENDERING_INTENT_TYPESSPARSE_COLOR_METHODSSTATISTIC_TYPES STORAGE_TYPESVIRTUAL_PIXEL_METHOD UNIT_TYPES BaseImageChannelDepthDictChannelImageDictClosedImageError HistogramDictImage ImagePropertyIteratorMetadata OptionDict manipulative ArtifactTree ProfileDictConnectedComponentObject) undefinedactivate backgroundcopy deactivateextractopaqueresetsetshape transparentflattenremove associate disassociatei)rKrLrXrMrNrOZdiscreterYrPoffonrQrWrSrTrU)rKkapurZotsutriangle /i@i)rKredgraycyangreenmagentablueyellowalphaopacityblackindexcomposite_channels all_channels true_alphargb rgb_channels gray_channels sync_channelsdefault_channelsi)rKrfrgrhrirjrkrlrormrnrpZreadmask write_maskmetarqrrrsrtrurvrwrx)"rKrtrgrUohtalabxyzycbcryccyiqypbpryuvcmyksrgbhsbhslhwbZ rec601luma rec601ycbcrZ rec709luma rec709ycbcrlogcmyluvhcllchlmslchablchuvscrgbhsihsvhclpydbdr)!rKrrrgrrrrrrrrrrrrrrr~rrrtrrrUZxyyrrrrrrr) rKabsolute mean_absolutemean_error_per_pixel mean_squared peak_absolutepeak_signal_to_noise_ratioroot_mean_squarenormalized_cross_correlationfuzz) rKrrrrrrrrZperceptual_hashrZstructural_similarityZstructural_dissimilarity)rKadd conjugatedivide magnitudemultiplyZreal_imaginarysubtract)FrKno modulus_addatopblendbumpmap change_maskclear color_burn color_dodgecolorize copy_black copy_bluerN copy_cyan copy_green copy_magentaZ copy_opacitycopy_red copy_yellowdarkendst_atopdstdst_indst_outdst_over differencedisplacedissolve exclusion hard_lighthueinlighten linear_lightluminize minus_dstmodulateroutoveroverlayplusreplacesaturatescreen soft_lightsrc_atopsrcsrc_insrc_outsrc_overmodulus_subtract thresholdxor divide_dstdistortblur pegtop_light vivid_light pin_light linear_dodge linear_burn mathematics divide_src minus_srcdarken_intensitylighten_intensityhard_mixstereo)HrKrmrrrrrrrrrrrrNrrrZ copy_alpharrrrrrrrrrrrrrrrrrrrZ intensityrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)rKrbzipdxt1dxt3dxt5faxgroup4jpegjpeg2000 losslessjpeglzwrlezipzipspizpxr24b44b44alzmajbig1jbig2)rKrrrrrrrrrrrrrrrrrrrrr)rKnonerMprevious)rKZaffineZaffine_projectionZscale_rotate_translateZ perspectiveZperspective_projectionZbilinear_forwardZbilinear_reverse polynomialarcZpolarZdepolarZcylinder_2_planeZplane_2_cylinderZbarrelZbarrel_inverseshepardsresizesentinelZ rigidaffine)rKr riemersmaZfloyd_steinberg)!rKrandr leftshiftmaxminror rightshiftrSrrpowrrthresholdblackthresholdwhite gaussiannoise impulsenoiselaplaciannoisemultiplicativenoise poissonnoise uniformnoisecosinesine addmodulusmeanabs exponentialmediansumrootmeansquare)"rKrrrrrrrrrrrrr rrr rrr rr r rrSrrrrrrrrZ inverse_log)rKpointboxr]ZhermiteZhanningZhammingZblackmangaussianZ quadraticZcubiccatromZmitchellZjincZsincZsincfastZkaiserZwelshZparzenZbohmanZbartlettZlagrangeZlanczosZ lanczossharpZlanczos2Z lanczos2sharpZrobidouxZ robidouxsharprspliner)rKrsinusoidarcsinarctan)rKr%r&rr$) Zforget north_westnorth north_eastwestcentereast south_westsouth south_eastZstatic)rKcoalesce compareany compareclearcompareoverlaydisposeoptimizeZ optimizeimageZ optimizeplusZ optimizetransZ removedupsZ removezero compositemergerVmosaic trimbounds) rKbilevel grayscaleZgrayscalemattepaletteZ palettematte truecolortruecolormattecolorseparationZcolorseparationmatter5Zpalettebilevelmatte) rKr:r;Zgrayscalealphar<Z palettealphar=truecoloralphar?Zcolorseparationalphar5Zpalettebilevelalpha)rKrlineZplane partitionZgifrpng)&rKunityr!dogrrcomet laplaciansobel frei_chenrobertsprewittcompasskirschdiamondsquare rectangleoctagondiskrcrossringpeaksedgescorners diagonals line_endsline_junctionsridges convex_hullthin_seskeleton chebyshev manhattan octagonal euclidean user_definedbinomial)&rKrDr!rErrrFrdrGrHrIrJrKrLrMrNrOrPrQrRrrSrTrUrVrWrXrYrZr[r\r]r^r_r`rarbrc)rKconvolve correlateerodedilateerode_intensitydilate_intensitydistanceopencloseopen_intensityclose_intensitysmoothedgeinedgeoutedgetophat bottom_hat hit_and_missthinningthickenvoronoiiterative_distance)rKrerfrgrhrirjrzrlrmrnrorprqrrrsrtrurvrwrxrkry)rKuniformr!Zmultiplicative_gaussianZimpulserGZpoissonrandomcaptioncommentz date:createz date:modifyzexif:ColorSpacezexif:InteroperabilityIndexfillz film-gammagammaz hdr:exposurezjpeg:colorspacezjpeg:sampling-factorlabelzpdf:use-cropboxzpng:bit-depth-writtenzpng:IHDR.bit-depth-origzpng:IHDR.color-type-origzpng:tIMEzreference-blackzreference-white signatureztiff:Orientationztiff:photometricztiff:ResolutionUnitz type:hintingz vips:metadata) rKtop_left top_right bottom_right bottom_leftleft_top right_top right_bottom left_bottom)i i)ihi)ii)i@i)ii)ii`)ii)ii)ii)iiU)i* i)iP i* )iiP )ii)iJi)iSiJ)iiS)i*i)i*)r)ir)Jr)i`i)ii)ii )i i )ih i)iih )[)ii)ii)ii)ii)iki)iik)i)rr)i' i\)i-i' )ii-)ii)ii)ii)iCi)iC)ii0)i0i )i i` )ii)idi)iid)i i)ii )X})ii)ii)ii)ii)ibi)ib)r)rr)ii)ii)ii)ili)iil)i)rzr)ii)idi)idi)ii)ibi )QZ4x6Z5x7Z7x9Z8x10Z9x11Z9x12Z10x13Z10x14Z11x17Z4A0Z2A0Za0Za1Za2a3Za4Za4smallZa5Za6Za7Za8Za9Za10ZarchaZarchbZarchCZarchdZarcheZb0b1Zb10b2Zb3Zb4Zb5Zb6Zb7Zb8Zb9Zc0c1c2c3Zc4Zc5Zc6Zc7ZcsheetZdsheetZesheetZ executiveZflsaZflseZfolioZ halfletterZisob0Zisob1Zisob10Zisob2Zisob3Zisob4Zisob5Zisob6Zisob7Zisob8Zisob9Zjisb0Zjisb1Zjisb2Zjisb3Zjisb4Zjisb5Zjisb6ledgerZlegalletterZ lettersmallZmonarchZquartoZ statementZtabloid) rKZaverageZaverage9Z average16rMbilinearrr"integerZmeshZnearestr#)rK saturationZ perceptualrrelative)rKZ barycentricrrryZinverser`) rKgradientmaximumrrminimummodenonpeakstandard_deviationr) rKrrrrrrrrr)rKchardoublefloatrlongZquantumshort)rKZ pixelsperinchZpixelspercentimeter)rKrMZconstantditherrsmirrorr|tilerUmaskrorgwhitehorizontal_tile vertical_tilehorizontal_tile_edgevertical_tile_edge checker_tile)rKrMrrsrr|rrUrrorgrrrrrrcstfdd}|S)zDMark the operation manipulating itself instead of returning new one.cs|f||}d|_|S)NT)dirty)selfargskwargsresult)functionM/home/ankuromar296_gmail_com/.local/lib/python3.7/site-packages/wand/image.pywrapped?szmanipulative..wrapped) functoolswraps)rrr)rrrG=srGcstfdd}|S)Ncs$|f||}t|s ||S)N)boolraise_exception)rrrr)rrrrHsztrap_exception..wrapped)rr)rrr)rrtrap_exceptionGsrc @seZdZdZdZdZdZdZej Z ej Z ej ZejZdZddZddZdd Zd d Zd d ZddZddZddZd0ddZeddZeddZejeddZeddZ eddZ!e!jed dZ!ed!d"Z"e"jed#d"Z"ed$d%Z#e#jd&d%Z#ed'd(Z$e$jd)d(Z$ed*d+Z%ed,d-Z&e&jed.d-Z&ed/d0Z'e'jd1d0Z'ed2d3Z(e(jd4d3Z(ed5d6Z)e)jed7d6Z)ed8d9Z*e*jd:d9Z*ed;d<Z+e+jed=d<Z+ed>d?Z,e,jd@d?Z,edAdBZ-e-jedCdBZ-edDdEZ.e.jdFdEZ.edGdHZ/e/jedIdHZ/edJdKZ0e0jedLdKZ0edMdNZ1e1jedOdNZ1edPdQZ2e2jdRdQZ2edSdTZ3e3jdUdTZ3edVdWZ4e4jedXdWZ4edYdZZ5e5jd[dZZ5ed\d]Z6e6jed^d]Z6ed_d`Z7edadbZ8e8jdcdbZ8edddeZ9e9jdfdeZ9edgdhZ:edidjZ;edkdlZedsdtZ?edudvZ@edwdxZAeAjedydxZAedzd{ZBeBjed|d{ZBed}d~ZCeCjedd~ZCeddZDeDjeddZDeddZEeEjeddZEeddZFeFjeddZFeddZGeddZHeHjddZHeddZIeIjddZIeddZJeJjeddZJeddZKeKjddZKeddZLeLjddZLeddZMeMjddZMeddZNeddZOeddZPeddZQeddZReRjddZReddZSeSjddZSeddZTeTjddZTeddZUeUjeddZUeddZVeVjeddZVeddZWeWjddZWeddZXeXjddZXeXjYddZXeddZZeZjeddZZeddZ[e[jddZ[edd„Z\ddĄZ]ddƄZ^ee_d1ddɄZ`ee_d2dd˄Zaee_d3dd̈́Zbed4ddτZcee_d5dd҄Zdee_ddԄZeee_ddքZfee_dd؄Zgee_d6ddۄZhee_dd݄Ziee_d7ddZjee_d8ddZke_d9ddZlee_d:ddZmee_d;ddZnedddZtddZuee_d?ddZvee_ddZwee_ddZxd@ddZyee_ddZzee_dAddZ{ee_dBdd Z|ee_dCd d Z}edDddZ~edEddZe_dFddZee_dGddZee_dHddZddZee_dIddZee_dJdd ZdKd!d"Zee_dLd#d$Ze_dMd&d'Zee_d(d)Zee_d*d+Zee_d,d-Zee_d.d/Zee_dNd0d1Zee_dOd2d3Zee_dPd4d5Zee_d6d7Zee_d8d9Zee_dQd:d;Zee_dRd<d=ZdSd@dAZee_dTdBdCZdDdEZdUdFdGZee_dHdIZee_dJdKZe_dVdLdMZee_dWdNdOZee_dXdPdQZedYdRdSZee_dZdTdUZee_d[dVdWZd\dXdYZee_d]dZd[Zee_d^d]d^Zd_d_d`Ze_d`dadbZe_dadddeZe_dbdfdgZdhdiZdjdkZdldmZdndoZdpdqZdrdsZdtduZdvdwZee_dcdzd{Zddd}d~Zee_deddZe_dfddZee_dgddZee_dhddZee_diddZee_djddZedkddZee_dlddZee_ddZdmddZee_dnddZee_ddZdoddZedpddZee_dqddZee_drddZee_dsddZee_dtddZee_duddZee_dvddZee_dwddZee_dxddZee_ddZee_ddZee_dyddZɐddZʐddZee_dzddZee_ddZee_d{ddZee_d|dd„Zee_d}dÐdĄZАd~dŐdƄZee_ddǐdȄZe_ddɐdʄZee_ddːd̄Zee_dd͐d΄ZՐdϐdЄZ֐dѐd҄Zee_ddӐdԄZee_ddՐdքZee_ddאd؄Zee_ddِdڄZee_ddېd܄Zee_ddݐdބZee_dddZee_dddZee_dddZee_dddZee_dddZee_dddZee_dddZdddZee_dddZe_dddZee_dddZee_dddZee_dddZee_dddZee_dddZee_dddZe_ddZee_dddZee_ddZee_dd d Zee_dd d Zee_dd dZee_dddZee_ddZee_dddZeddZee_ddZee_ddZee_dddZee_ddZee_dd d!Zee_dd"d#Zedd$d%Zee_dd&d'Zee_dd(d)Zee_d*d+Zee_d,d-Ze_dd.d/ZdS(r=aThe abstract base of :class:`Image` (container) and :class:`~wand.sequence.SingleImage`. That means the most of operations, defined in this abstract class, are possible for both :class:`Image` and :class:`~wand.sequence.SingleImage`. .. versionadded:: 0.3.0 N)Z_wandcCs.||_t||_t||_t||_d|_dS)NF)wandr?channel_imagesr>channel_depthsrFoptionsr)rrrrr__init__|s    zBaseImage.__init__cCst|t|r|j|jkSdS)NF) isinstancetyper)rotherrrr__eq__s zBaseImage.__eq__c Cst|ts>t|tjr>t|}t|}d|kr>dksRntd|q|dkr0|\}}t|t}t|t}|r|st||d}n|s|rt||d}n|s||s|t|t j rt|t j st dt ||f|dkr||j 7}|dkr||j7}||j krtdn<||jkr2tdn&|dkrFtdn|dkrXtd t|}||||SQRX|jdkr|jdkstd n8|jdkr|jdkr|jdkr|jdkr|S|}y||j|j|j|jWn0tk r*} ztt| Wdd} ~ XYnX|S||dSnt|t j r|dkrb||j7}n8||jkrtd t |n|dkrtd t |t|}|||SQRXnt|tr|dd|fSt d t |dS)Nrr^zindex cannot be {0}-dimensionalzx and y must be integral, not rzx must be less than widthzy must be less than heightzx cannot be less than 0zy cannot be less than 0z slicing with step is unsupportedz(index must be less than height, but got z(index cannot be less than zero, but got zunsupported index type: )rr rIterabletuplelen ValueErrorformatslicenumbersIntegral TypeErrorreprwidthheight IndexErroriterseeknextstepstartstopclonecropstr) ridxdxyZx_sliceZy_sliceiteratorclonederrr __getitem__sz                            zBaseImage.__getitem__c Cst|trt|}tj|dt|tjs:tdt|t |}t |dkrdd t |}t ||j }td}|j\}}|\}} d\} } t|tjrt| tjstd|dkr||7}| dkr| |7} ||krt d n| |krt d |d krd } tjd } |j| d<n|dkrtd} tjd} |j| d<|j| d <|j| d<|j| d<|jr| d7} |j| d<nHd} tjd} |j| d<|j| d <|j| d<|jr| d7} |j| d<t|j|| | | | |t| }|s|dS)N)colorz'Expecting list of x,y coordinates, not r^z&pixel index can not be {0}-dimensionalr)rrzExpecting x & y to be integersrzx must be less than image widthz y must be less than image heightrgIrrsCMYKAr_sRGB) rr rr assert_colorrrrrrrrr colorspacer:rpsizerrctypesc_doublerfrirkro alpha_channelrmrMagickImportImagePixelsrbyrefr)rrrmsgrs_indexrrx1y1Zx2y2 channel_mappixelrrrr __setitem__sn                          zBaseImage.__setitem__cCs t|jS)N)hashr)rrrr__hash__szBaseImage.__hash__cCs t|dS)N)image)rD)rrrr__iter__szBaseImage.__iter__cCs|jS)N)r)rrrr__len__szBaseImage.__len__cCs ||k S)Nr)rrrrr__ne__ szBaseImage.__ne__ ({self.width}x{self.height})cCslt|}d|jt|d|j}t|dddkr:d|S|j}|sNd|Sd||dd|j|dS) Nz{0}.{1} __qualname__Z c_resourcez<{0}: (closed)>z<{0}: (empty)>z <{0}: {1}{2}>rd)r)rr __module__getattr__name__r)r extra_formatclstypenamesigrrr__repr__s  zBaseImage.__repr__c Cs|jstd|j\}}d}|j}|dkr4td}n|dkrFtd}ntd}|jr`|td7}t|}|||tj|_ t |j d d ||||t |j }|s|tt|j d f|||fd d d S)apAllows image-data from :class:`Image ` instances to be loaded into numpy's array. .. code:: import numpy from wand.image import Image with Image(filename='rose:') as img: img_data = numpy.asarray(img) :raises ValueError: if image has no data. .. versionadded:: 0.5.0 .. versionchanged:: 0.6.0 The :attr:`shape` property is now ordered by ``height``, ``width``, and ``channel``. .. versionchanged:: 0.6.2 Color spaces ``gray`` & ``cmyk`` are now supported. z No image data to interface with.r)rgR)rZCMYKRGBArTz|u1r)datarTtypestrversion)rrrrr rrrc_charZ _c_bufferrMagickExportImagePixelsrrrdict addressof)rrrZ storage_typecsZchannel_formatZchannel_numberrrrr__array_interface__s0    zBaseImage.__array_interface__cCstt|jS)a (:class:`bool`) Get state of image alpha channel. It can also be used to enable/disable alpha channel, but with different behavior such as new, copied, or existing. Behavior of setting :attr:`alpha_channel` is defined with the following values: - ``'activate'``, ``'on'``, or :const:`True` will enable an images alpha channel. Existing alpha data is preserved. - ``'deactivate'``, ``'off'``, or :const:`False` will disable an images alpha channel. Any data on the alpha will be preserved. - ``'associate'`` & ``'disassociate'`` toggle alpha channel flag in certain image-file specifications. - ``'set'`` enables and resets any data in an images alpha channel. - ``'opaque'`` enables alpha/matte channel, and forces full opaque image. - ``'transparent'`` enables alpha/matte channel, and forces full transparent image. - ``'extract'`` copies data in alpha channel across all other channels, and disables alpha channel. - ``'copy'`` calculates the gray-scale of RGB channels, and applies it to alpha channel. - ``'shape'`` is identical to ``'copy'``, but will color the resulting image with the value defined with :attr:`background_color`. - ``'remove'`` will composite :attr:`background_color` value. - ``'background'`` replaces full-transparent color with background color. .. note:: The :attr:`alpha_channel` attribute will always return ``True`` if alpha channel is enabled, and ``False`` otherwise. Setting this property with a string value from :const:`ALPHA_CHANNEL_TYPES` will resolve to a :class:`bool` after applying channel operations listed above. With ImageMagick-6, values ``'on'`` & ``'off'`` are aliased to ``'activate'`` & ``'deactivate'``. However in ImageMagick-7, both ``'on'`` & ``'off'`` have their own behavior. .. versionadded:: 0.2.1 .. versionchanged:: 0.4.1 Support for additional setting values. However :attr:`Image.alpha_channel` will continue to return :class:`bool` if the current alpha/matte state is enabled. .. versionchanged:: 0.6.0 Setting the alpha channel will apply the change to all frames in the image stack. )rrZMagickGetImageAlphaChannelr)rrrrrNs6zBaseImage.alpha_channelcCstdk}|dks|dkr"|r"d}n|dks6|dkr:|r:d}tjtd|d t|}t|jt|j}t |jx2t d |d D] }t |j|t |j|qWdS) NiFrZrOTr[rLzwand.image.ALPHA_CHANNEL_TYPES)rrr) rrstring_in_listr rprMagickSetLastIteratorrMagickGetIteratorIndexMagickResetIteratorrMagickSetIteratorIndexZMagickSetImageAlphaChannel)rZ alpha_typeZis_im6Z alpha_indexnirrrrs    cCsdS)a(:class:`bool`) Whether the image is animation or not. It doesn't only mean that the image has two or more images (frames), but all frames are even the same size. It's about image format, not content. It's :const:`False` even if :mimetype:`image/ico` consits of two or more images of the same size. For example, it's :const:`False` for :mimetype:`image/jpeg`, :mimetype:`image/gif`, :mimetype:`image/ico`. If :mimetype:`image/gif` has two or more frames, it's :const:`True`. If :mimetype:`image/gif` has only one frame, it's :const:`False`. .. versionadded:: 0.3.0 .. versionchanged:: 0.3.8 Became to accept :mimetype:`image/x-gif` as well. Fr)rrrr animationszBaseImage.animationcCstt|jS)z(:class:`bool`) If vectors & fonts will use anti-aliasing. .. versionchanged:: 0.5.0 Previously named :attr:`font_antialias`. )rrZMagickGetAntialiasr)rrrr antialiasszBaseImage.antialiascCstj|dt|j|dS)N)r+)r assert_boolrZMagickSetAntialiasr)rr+rrrr+s cCs^t}t|jr$t|j|}nt|j}d}|sB|nt|}t |}|SdS)z(:class:`wand.color.Color`) The image background color. It can also be set to change the background color. .. versionadded:: 0.1.9 .. versionchanged:: 0.6.7 Allow property to be set before image read. TN) r NewPixelWandMagickGetNumberImagesrZMagickGetImageBackgroundColorZMagickGetBackgroundColorrrfrom_pixelwandDestroyPixelWand)rrrrrrrbackground_colors      zBaseImage.background_colorc Csvt|trt|}tj|d|Jt|jrLt|j|j }|sL| t |j|j }|sh| WdQRXdS)N)r) rr rrrrr.rZMagickSetImageBackgroundColorresourcerMagickSetBackgroundColor)rrrrrrr1s   cCs~td}td}d}d}tdkrBt|j||}|j|jf}n,td}t|j|||}|j|j|jf}|sz||S)z(:class:`tuple`) The chromatic blue primary point for the image. With ImageMagick-6 the primary value is ``(x, y)`` coordinates; however, ImageMagick-7 has ``(x, y, z)``. .. versionadded:: 0.5.2 gNi)rrrrZMagickGetImageBluePrimaryrvaluer)rrrrpzrrr blue_primarys   zBaseImage.blue_primarycCsfd}t|tjstdtdkr:|\}}t|j||}n|\}}}t|j|||}|sb|dS)NzPrimary must be a tuplei) rrSequencerrrZMagickSetImageBluePrimaryrr)r coordinatesrrrr6rrrr7s  cCs@t}t|j|}|s$|nt|}t|}|SdS)z(:class:`wand.color.Color`) The image border color. Used for special effects like :meth:`polaroid()`. .. versionadded:: 0.5.4 N)rr-ZMagickGetImageBorderColorrrrr/r0)rrrrrrr border_colors   zBaseImage.border_colorc CsNt|trt|}tj|d|"t|j|j}|s@| WdQRXdS)N)r:) rr rrrrZMagickSetImageBorderColorrr2r)rrrrrrr:s  cCs t|jS)z(:class:`numbers.Integral`) Count of unique colors used within the image. This is READ ONLY property. .. versionadded:: 0.5.3 )rZMagickGetImageColorsr)rrrrcolors)szBaseImage.colorscCs$t|j}|s|tt|S)z(:class:`basestring`) The image colorspace. Defines image colorspace as in :const:`COLORSPACE_TYPES` enumeration. It may raise :exc:`ValueError` when the colorspace is unknown. .. versionadded:: 0.3.4 )rZMagickGetImageColorspacerrr#r)rZcolorspace_type_indexrrrr2s zBaseImage.colorspacecCs4tjtd|dt|jt|}|s0|dS)Nzwand.image.COLORSPACE_TYPES)r)rr#r#rZMagickSetImageColorspacerrpr)rcolorspace_typerrrrrBs cCst|j}t|S)z(:class:`basestring`) The type of image compose. It's a string from :const:`COMPOSITE_OPERATORS` list. It also can be set. .. versionadded:: 0.5.1 )rZMagickGetImageComposerr%)rZ compose_indexrrrcomposeOs zBaseImage.composecCs(tjtd|dt|jt|dS)Nzwand.image.COMPOSITE_OPERATORS)r=)rr#r%rZMagickSetImageComposerrp)roperatorrrrr=Zs cCst|j}t|S)aO(:class:`basestring`) The type of image compression. It's a string from :const:`COMPRESSION_TYPES` list. It also can be set. .. versionadded:: 0.3.6 .. versionchanged:: 0.5.2 Setting :attr:`compression` now sets both `image_info` and `images` in the internal image stack. )rZMagickGetImageCompressionrr&)rZcompression_indexrrr compressionbs zBaseImage.compressioncCs<tjtd|dt|jt|t|jt|dS)Nzwand.image.COMPRESSION_TYPES)r?)rr#r&rZMagickSetCompressionrrpZMagickSetImageCompression)rr4rrrr?ps cCs t|jS)a (:class:`numbers.Integral`) Compression quality of this image. .. versionadded:: 0.2.0 .. versionchanged:: 0.5.2 Setting :attr:`compression_quality` now sets both `image_info` and `images` in the internal image stack. )rZ MagickGetImageCompressionQualityr)rrrrcompression_quality~s zBaseImage.compression_qualitycCs@tj|dt|j|t|j|}|s|dS)N)rJgz!cannot be less than 0.0, but got )r assert_realrrrZMagickSetPointsizerr)rrrrrrrJs  cCs0d}t|j}|r,tt|}t|}|S)a(:class:`basestring`) The image format. If you want to convert the image format, just reset this property:: assert isinstance(img, wand.image.Image) img.format = 'png' It may raise :exc:`ValueError` when the format is unsupported. .. seealso:: `ImageMagick Image Formats`__ ImageMagick uses an ASCII string known as *magick* (e.g. ``GIF``) to identify file formats, algorithms acting as formats, built-in patterns, and embedded profile types. __ http://www.imagemagick.org/script/formats.php .. versionadded:: 0.1.6 N)rZMagickGetImageFormatrrrrOrP)rZfmt_strZfmt_prrrr)s   zBaseImage.formatcCshtj|d|}t|jt|}|s>tt |dt |jdt| }|sd| dS)N)rz is unsupported formatsbuffer.) r assert_stringstriprMagickSetImageFormatrr upperrrMagickSetFilenamelowerr)rfmtrrrrrGs cCs t|jS)z(:class:`numbers.Real`) The normalized real number between ``0.0`` and :attr:`quantum_range`. This property influences the accuracy of :meth:`compare()`. .. versionadded:: 0.5.3 )rZMagickGetImageFuzzr)rrrrrSszBaseImage.fuzzcCstj|dt|j|dS)N)r)rrQrZMagickSetImageFuzzr)rr4rrrr]s cCs t|j}|s|t|S)z(:class:`basestring`) The text placement gravity used when annotating with text. It's a string from :const:`GRAVITY_TYPES` list. It also can be set. )rZMagickGetGravityrrr-)rZ gravity_indexrrrgravitybs zBaseImage.gravitycCs(tjtd|dt|jt|dS)Nzwand.image.GRAVITY_TYPES)rY)rr#r-rZMagickSetGravityrrp)rr4rrrrYnscCs~td}td}d}d}tdkrBt|j||}|j|jf}n,td}t|j|||}|j|j|jf}|sz||S)z(:class:`tuple`) The chromatic green primary point for the image. With ImageMagick-6 the primary value is ``(x, y)`` coordinates; however, ImageMagick-7 has ``(x, y, z)``. .. versionadded:: 0.5.2 gNi)rrrrZMagickGetImageGreenPrimaryrr4r)rrrrr5r6rrr green_primaryvs   zBaseImage.green_primarycCsfd}t|tjstdtdkr:|\}}t|j||}n|\}}}t|j|||}|sb|dS)NzPrimary must be a tuplei) rrr8rrrZMagickSetImageGreenPrimaryrr)rr9rrrr6rrrrZs  cCs t|jS)z5(:class:`numbers.Integral`) The height of this image.)rZMagickGetImageHeightr)rrrrrszBaseImage.heightcCs"tj|dt|j|j|dS)N)r)rassert_unsigned_integerr MagickSetSizerr)rrrrrrs cCst|S)ab(:class:`HistogramDict`) The mapping that represents the histogram. Keys are :class:`~wand.color.Color` objects, and values are the number of pixels. .. tip:: True-color photos can have millions of color values. If performance is more valuable than accuracy, remember to :meth:`quantize` the image before generating a :class:`HistogramDict`. with Image(filename='hd_photo.jpg') as img: img.quantize(255, 'RGB', 0, False, False) hist = img.histogram .. versionadded:: 0.3.0 )rA)rrrr histogramszBaseImage.histogramcCst|j}t|S)a5(:class:`basestring`) The interlace used by the image. See :const:`INTERLACE_TYPES`. .. versionadded:: 0.5.2 .. versionchanged:: 0.6.2 The :attr:`interlace_scheme` property now points to the image. Previously was pointing to the :c:struct:`MagickWand`. )rZMagickGetImageInterlaceSchemerr0)r scheme_idxrrrinterlace_schemes zBaseImage.interlace_schemecCs,tjtd|dt|}t|j|dS)Nzwand.image.INTERLACE_TYPES)r_)rr#r0rprZMagickSetImageInterlaceSchemer)rschemer^rrrr_s  cCst|j}t|S)z(:class:`basestring`) The interpolation method of the image. See :const:`PIXEL_INTERPOLATE_METHODS`. .. versionadded:: 0.5.2 )rZMagickGetImageInterpolateMethodrr6)r method_idxrrrinterpolate_methods zBaseImage.interpolate_methodcCs,tjtd|dt|}t|j|dS)Nz$wand.image.PIXEL_INTERPOLATE_METHODS)rb)rr#r6rprZMagickSetImageInterpolateMethodr)rmethodrarrrrbs  cCs|\}}|S)z(:class:`numbers.Real`) The kurtosis of the image. .. tip:: If you want both :attr:`kurtosis` & :attr:`skewness`, it would be faster to call :meth:`kurtosis_channel()` directly. .. versionadded:: 0.5.3 )kurtosis_channel)rk_rrrkurtosiss zBaseImage.kurtosiscCs$td}t|jt||jS)z(:class:`numbers.Integral`) The original size, in bytes, of the image read. This will return `0` if the image was modified in a way that would invalidate the original length value. .. versionadded:: 0.5.4 r)rc_size_trZMagickGetImageLengthrrr4)rZsize_ptrrrrlength_of_bytess zBaseImage.length_of_bytescCs t|jS)zc(:class:`numbers.Integral`) Number of frame iterations. A value of ``0`` will loop forever.)rZMagickGetImageIterationsr)rrrrloopszBaseImage.loopcCstj|dt|j|dS)N)rj)rr[rZMagickSetImageIterationsr)r iterationsrrrrjs cCs>t}t|j|}|r2t|}t|}|S|dS)z(:class:`wand.color.Color`) The color value of the matte channel. This can also be set. .. versionadded:: 0.4.1 N)rr-ZMagickGetImageMatteColorrrr/r0r)rrrrrrr matte_colors  zBaseImage.matte_colorc CsNt|trt|}tj|d|"t|j|j}|s@| WdQRXdS)N)rl) rr rrrrZMagickSetImageMatteColorrr2r)rrrrrrrls  cCs|\}}|S)a;(:class:`numbers.Real`) The maximum quantum value within the image. Value between 0.0 and :attr:`quantum_range` .. tip:: If you want both :attr:`maxima` & :attr:`minima`, it would be faster to call :meth:`range_channel()` directly. .. versionadded:: 0.5.3 ) range_channel)rrfZmax_qrrrmaxima$s zBaseImage.maximacCs|\}}|S)a:(:class:`numbers.Real`) The mean of the image, and have a value between 0.0 and :attr:`quantum_range` .. tip:: If you want both :attr:`mean` & :attr:`standard_deviation`, it would be faster to call :meth:`mean_channel()` directly. .. versionadded:: 0.5.3 ) mean_channel)rmrfrrrr3s zBaseImage.meancCs|\}}|S)a;(:class:`numbers.Real`) The minimum quantum value within the image. Value between 0.0 and :attr:`quantum_range` .. tip:: If you want both :attr:`maxima` & :attr:`minima`, it would be faster to call :meth:`range_channel()` directly. .. versionadded:: 0.5.3 )rm)rZmin_qrfrrrminimaBs zBaseImage.minimacCs2t|j}yt|Stk r,tdSXdS)z(:class:`basestring`) The image orientation. It's a string from :const:`ORIENTATION_TYPES` list. It also can be set. .. versionadded:: 0.3.0 rN)rZMagickGetImageOrientationrr4r)rZorientation_indexrrr orientationQs  zBaseImage.orientationcCs,tjtd|dt|}t|j|dS)Nzwand.image.ORIENTATION_TYPES)rr)rr#r4rprZMagickSetImageOrientationr)rr4rprrrrr_s  cCsdt}t}t}t}t|j||||}|s@|t|jt|jt|jt|jfS)aThe dimensions and offset of this Wand's page as a 4-tuple: ``(width, height, x, y)``. .. code:: with Image(filename='wizard:') as img: img.page = (595, 842, 0, 0) Note that since it is based on the virtual canvas, it may not equal the dimensions of an image. See the ImageMagick documentation on the virtual canvas for more information. This attribute can also be set by using a named papersize. For example:: with Image(filename='wizard:') as img: img.page = 'a4' .. versionadded:: 0.4.3 .. versionchanged:: 0.6.4 Added support for setting by papersize. ) rrh c_ssize_trZMagickGetImagePagerrintr4)rwhrrrrrrpagehszBaseImage.pagec Cst|tr^t|}t}t|tj}t |t ||j |j |j |jf}t|~t|tjrx|\}}}}ntdt|j||||}|s|dS)Nzpage layout must be 4-tuple)rr rZGetPageGeometryencoderrcastc_char_pZParseAbsoluteGeometryrrrrr DestroyStringrr8rrZMagickSetImagePagerr) rnewpageZc_ptrrirurvrrrrrrrws   cCs |jdS)zl(:class:`numbers.Integral`) The height of the page for this wand. .. versionadded:: 0.4.3 r)rw)rrrr page_heightszBaseImage.page_heightcCst|j}||d<||_dS)Nr)listrw)rrr|rrrr~s cCs |jdS)zk(:class:`numbers.Integral`) The width of the page for this wand. .. versionadded:: 0.4.3 r)rw)rrrr page_widthszBaseImage.page_widthcCst|j}||d<||_dS)Nr)rrw)rrr|rrrrs cCs |jdS)zn(:class:`numbers.Integral`) The X-offset of the page for this wand. .. versionadded:: 0.4.3 r^)rw)rrrrpage_xszBaseImage.page_xcCst|j}||d<||_dS)Nr^)rrw)rrr|rrrrs cCs |jdS)zn(:class:`numbers.Integral`) The Y-offset of the page for this wand. .. versionadded:: 0.4.3 r)rw)rrrrpage_yszBaseImage.page_ycCst|j}||d<||_dS)Nr)rrw)rrr|rrrrs cCst}tt||jS)z(`:class:`numbers.Integral`) The maximum value of a color channel that is supported by the imagemagick library. .. versionadded:: 0.2.0 )rrhrZMagickGetQuantumRangerr4)rrrrr quantum_rangeszBaseImage.quantum_rangecCs~td}td}d}d}tdkrBt|j||}|j|jf}n,td}t|j|||}|j|j|jf}|sz||S)z(:class:`tuple`) The chromatic red primary point for the image. With ImageMagick-6 the primary value is ``(x, y)`` coordinates; however, ImageMagick-7 has ``(x, y, z)``. .. versionadded:: 0.5.2 gNi)rrrrZMagickGetImageRedPrimaryrr4r)rrrrr5r6rrr red_primarys   zBaseImage.red_primarycCsfd}t|tjstdtdkr:|\}}t|j||}n|\}}}t|j|||}|sb|dS)NzPrimary must be a tuplei) rrr8rrrZMagickSetImageRedPrimaryrr)rr9rrrr6rrrr s  cCst|j}t|S)z(:class:`basestring`) PNG rendering intent. See :const:`RENDERING_INTENT_TYPES` for valid options. .. versionadded:: 0.5.4 )rZMagickGetImageRenderingIntentrr7)rri_indexrrrrendering_intent s zBaseImage.rendering_intentcCs,tjtd|dt|}t|j|dS)Nz!wand.image.RENDERING_INTENT_TYPES)r)rr#r7rprZMagickSetImageRenderingIntentr)rr4rrrrr s  cCs<td}td}t|j||}|s0||j|jfS)z(:class:`tuple`) Resolution of this image. .. versionadded:: 0.3.0 .. versionchanged:: 0.5.8 Resolution returns a tuple of float values to match ImageMagick's behavior. g)rrrZMagickGetImageResolutionrrr4)rrrrrrr resolution s  zBaseImage.resolutioncCsrt|tjr|\}}n t|tjr.||}}ntd|jdkrRt|j ||}nt |j ||}|sn| dS)Nz;resolution must be a (x, y) pair or a float of the same x/y)rr) rrr8rRealrrrMagickSetResolutionrZMagickSetImageResolutionr)rgeometryrrrrrrr1 s     csHtd}t|jt|tfddt|jD}t |S)a{(:class:`tuple`) Factors used in sampling data streams. This can be set by given it a string ``"4:2:2"``, or tuple of numbers ``(2, 1, 1)``. However the given string value will be parsed to aspect ratio (i.e. ``"4:2:2"`` internally becomes ``"2,1"``). .. note:: This property is only used by YUV, DPX, & EXR encoders. For JPEG & TIFF set ``"jpeg:sampling-factor"`` on :attr:`Image.options` dictionary:: with Image(filename='input.jpg') as img: img.options['jpeg:sampling-factor'] = '2x1' .. versionadded:: 0.6.3 rc3s|]}|VqdS)Nr).0r)factorsrr V sz-BaseImage.sampling_factors..) rrhrZMagickGetSamplingFactorsrrrrr4rP)r factors_lenZ factors_tupler)rrsampling_factorsB s    zBaseImage.sampling_factorscCst|trPt}tt|t|}||j@dkrB|j |j f}ql|j |j f}nt|t j slt dt|t|}tj||}t|j||dS)Nrz9sampling_factors must be a sequence of real numbers, not )rr rr ParseGeometryr rr SigmaValuerhosigmarr8rrrrrZMagickSetSamplingFactorsr)rr geometry_infoflagsrZ factors_ptrrrrrZ s     cCs t|jS)z(:class:`numbers.Integral`) The scene number of the current frame within an animated image. .. versionadded:: 0.5.4 )rZMagickGetImageScener)rrrrscenek szBaseImage.scenecCstj|dt|j|dS)N)r)rr[rZMagickSetImageScener)rr4rrrrt s cCs|jS)z(:class:`numbers.Integral`) The seed for random number generator. .. warning:: This property is only available with ImageMagick 7.0.8-41, or greater. .. versionadded:: 0.5.5 )_seed)rrrrseedy s zBaseImage.seedcCs:tjdkrd}t|tj|d||_t|j|dS)Nz:Property requires ImageMagick version 7.0.8-41 or greater.)r)rZ MagickSetSeedrrr[rr)rr4rrrrr s   cCs0d}t|j}|r,tt|}t|}|S)zx(:class:`str`) The SHA-256 message digest for the image pixel stream. .. versionadded:: 0.1.9 N)rZMagickGetImageSignaturerrrrOrP)rZsig_strZsig_prrrr s   zBaseImage.signaturecCs |j|jfS)a(:class:`tuple`) The pair of (:attr:`width`, :attr:`height`). .. note:: When working with animations, or other layer-based image formats, the :attr:`width` & :attr:`height` properties are referencing the last frame read into the image stack. To get the :attr:`size` of the entire animated images, call :meth:`Image.coalesce() ` method immediately after reading the image. )rr)rrrrr s zBaseImage.sizecCs|\}}|S)z(:class:`numbers.Real`) The skewness of the image. .. tip:: If you want both :attr:`kurtosis` & :attr:`skewness`, it would be faster to call :meth:`kurtosis_channel()` directly. .. versionadded:: 0.5.3 )rd)rrfsrrrskewness s zBaseImage.skewnesscCs|\}}|S)a (:class:`numbers.Real`) The standard deviation of the image. .. tip:: If you want both :attr:`mean` & :attr:`standard_deviation`, it would be faster to call :meth:`mean_channel()` directly. .. versionadded:: 0.5.3 )ro)rrfrrrrr s zBaseImage.standard_deviationcCs|jd}|rt|SdS)Nstroke)rr)rrrrrrG s zBaseImage.stroke_colorcCsPt|trt|}t|tr*|j|jd<n"|dkr<|jd=ntdt|dS)Nrz-stroke_color must be a wand.color.Color, not )rr rrNrrr)rrrrrrG s   cCs|jd}|rt|SdS)N strokewidth)rr)rrrrrrH s zBaseImage.stroke_widthcCstj|dt||jd<dS)N)rHr)rrQrr)rrrrrrH s cCs t|jS)zh(:class:`numbers.Integral`) Internal clock for animated images. .. versionadded:: 0.5.4 )rZMagickGetImageTicksPerSecondr)rrrrticks_per_second szBaseImage.ticks_per_secondcCs*tj|dt|j|}|s&|dS)N)r)rr[rZMagickSetImageTicksPerSecondrr)rr4rrrrr s cCs$t|j}|s|tt|S)z(:class:`basestring`) The image type. Defines image type as in :const:`IMAGE_TYPES` enumeration. It may raise :exc:`ValueError` when the type is unknown. .. versionadded:: 0.2.2 )rZMagickGetImageTyperrr/r)rZimage_type_indexrrrr s zBaseImage.typecCs4tjtd|dt|jt|}|s0|dS)Nzwand.image.IMAGE_TYPES)r)rr#r/rMagickSetImageTyperrpr)r image_typerrrrr s  cCst|j}tt|S)z9(:class:`basestring`) The resolution units of this image.)rZMagickGetImageUnitsrr<r)rrrrrunits s zBaseImage.unitscCs4tjtd|dt|jt|}|s0|dS)Nzwand.image.UNIT_TYPES)r)rr#r<rZMagickSetImageUnitsrrpr)rrrrrrr s cCst|j}t|S)z(:class:`basestring`) The virtual pixel of image. This can also be set with a value from :const:`VIRTUAL_PIXEL_METHOD` ... versionadded:: 0.4.1 )rZ MagickGetImageVirtualPixelMethodrr;)rZ method_indexrrr virtual_pixel s zBaseImage.virtual_pixelcCs(tjtd|dt|jt|dS)Nzwand.image.VIRTUAL_PIXEL_METHOD)r)rr#r;rZ MagickSetImageVirtualPixelMethodrrp)rrcrrrr$ s cCs0y|jStk r*tt|dYnXdS)zInternal pointer to the MagickWand instance. It may raise :exc:`ClosedImageError` when the instance has destroyed already. z is closed alreadyN)r2rr@r)rrrrr. szBaseImage.wandcCs4y ||_Wn$tk r.tt|dYnXdS)Nz is not a MagickWand instance)r2rr)rrrrrr9 s cCs|`dS)N)r2)rrrrr@ scCs t|jS)z4(:class:`numbers.Integral`) The width of this image.)rZMagickGetImageWidthr)rrrrrD szBaseImage.widthcCs"tj|dt|j||jdS)N)r)rr[rr\rr)rrrrrrI s cCs~td}td}d}d}tdkrBt|j||}|j|jf}n,td}t|j|||}|j|j|jf}|sz||S)z(:class:`tuple`) The chromatic white point for the image. With ImageMagick-6 the primary value is ``(x, y)`` coordinates; however, ImageMagick-7 has ``(x, y, z)``. .. versionadded:: 0.5.2 gNi)rrrrZMagickGetImageWhitePointrr4r)rrrrr5r6rrr white_pointO s   zBaseImage.white_pointcCsfd}t|tjstdtdkr:|\}}t|j||}n|\}}}t|j|||}|sb|dS)NzPrimary must be a tuplei) rrr8rrrZMagickSetImageWhitePointrr)rr9rrrr6rrrrf s  c Cst|jd}|r(t|}t|}ndS|s4dStt|}dd|jt j |j dd|j |j t j |j dd|jt j |j ddd }||}|sdS|d|_dS) zFallback for :attr:`auto_orient()` method (which wraps :c:func:`MagickAutoOrientImage`), fixes orientation by checking EXIF data. .. versionadded:: 0.4.1 sexif:orientationNgf@)degreegV@gp@) rKrrrrrrrrr)rMagickGetImagePropertyrrrOrPr4rtfloprpartialrotateflip transpose transversegetrr)rZv_ptrZexif_orientationZorientation_typeZ fn_lookupfnrrr _auto_orientt s.     zBaseImage._auto_orientcCs~d}t|tjr t|ts |}nBt|trR|tkrtjdkrd}t|tjtd|dt|}t|j|S)aAutomatically performs threshold method to reduce grayscale data down to a binary black & white image. Included algorithms are Kapur, Otsu, and Triangle methods. .. warning:: This class method is only available with ImageMagick 7.0.8-41, or greater. :param method: Which threshold method to apply. See :const:`AUTO_THRESHOLD_METHODS`. Defaults to ``'kapur'``. :type method: :class:`basestring` :raises WandLibraryVersionError: if function is not available on system's library. .. versionadded:: 0.5.5 Nz8Method requires ImageMagick version 7.0.8-41 or greater.z!wand.image.AUTO_THRESHOLD_METHODS)rc)rZMagickAutoThresholdImagerrr#r!rpr)rrcrrarrrauto_threshold s  zBaseImage.auto_thresholdc CsBt|trt|}tj|d|t|j|j}WdQRX|S)zForces all pixels above a given color as black. Leaves pixels above threshold unaltered. :param threshold: Color to be referenced as a threshold. :type threshold: :class:`Color` .. versionadded:: 0.5.3 )rN) rr rrrrZMagickBlackThresholdImagerr2)rrrrrrblack_threshold s  zBaseImage.black_threshold?cCstj|dt|j|S)zMutes colors of the image by shifting blue values. :see: Example of :ref:`blue_shift` :param factor: Amount to adjust values. :type factor: :class:`numbers.Real` .. versionadded:: 0.5.3 )factor)rrQrZMagickBlueShiftImager)rrrrr blue_shift s zBaseImage.blue_shiftcCs~tj||d|dkr(t|j||}nR||}tdkrNt|j|||}n,t|j|}t|j||}t|j||S)aFBlurs the image. Convolve the image with a gaussian operator of the given ``radius`` and standard deviation (``sigma``). For reasonable results, the ``radius`` should be larger than ``sigma``. Use a ``radius`` of 0 and :meth:`blur()` selects a suitable ``radius`` for you. :see: Example of :ref:`blur`. :param radius: the radius of the, in pixels, not counting the center pixel. Default is ``0.0``. :type radius: :class:`numbers.Real` :param sigma: the standard deviation of the, in pixels. Default value is ``0.0``. :type sigma: :class:`numbers.Real` :param channel: Optional color channel to apply blur. See :const:`CHANNELS`. :type channel: :class:`basestring` .. versionadded:: 0.4.5 .. versionchanged:: 0.5.5 Added optional ``channel`` argument. .. versionchanged:: 0.5.7 Positional arguments ``radius`` & ``sigman`` have been converted to key-word arguments. )rrNi) rrQrZMagickBlurImagerrrZMagickBlurImageChannelr)rrrrrrrrrrr s zBaseImage.blurrNc Cst|trt|}tj|d|TtdkrBt|j|j ||}n0tj t d|dt |}t|j|j |||}WdQRX|S)aySurrounds the image with a border. :param bordercolor: the border color pixel wand :type image: :class:`~wand.color.Color` :param width: the border width :type width: :class:`numbers.Integral` :param height: the border height :type height: :class:`numbers.Integral` :param compose: Use composite operator when applying frame. Only used if called with ImageMagick 7+. :type compose: :class:`basestring` .. versionadded:: 0.3.0 .. versionchanged:: 0.5.0 Added ``compose`` paramater, and ImageMagick 7 support. )rizwand.image.COMPOSITE_OPERATORS)r=N) rr rrrrrZMagickBorderImagerr2r#r%rp)rrrrr=rZ compose_idxrrrborder s      zBaseImage.bordercCs~tj||d|dkr(t|j||}nR||}tdkrNt|j|||}n,t|j|}t|j||}t|j||S)aConverts ``brightness`` & ``contrast`` paramaters into a slope & intercept, and applies a polynomial function. :param brightness: between ``-100.0`` and ``100.0``. Default is ``0.0`` for unchanged. :type brightness: :class:`numbers.Real` :param contrast: between ``-100.0`` and ``100.0``. Default is ``0.0`` for unchanged. :type contrast: :class:`numbers.Real` :param channel: Isolate a single color channel to apply contrast. See :const:`CHANNELS`. .. versionadded:: 0.5.4 .. versionchanged:: 0.5.5 Optional ``channel`` argument added. ) brightnesscontrastNi) rrQrZMagickBrightnessContrastImagerrrZ$MagickBrightnessContrastImageChannelr)rrrrrrrrrrbrightness_contrast< s" zBaseImage.brightness_contrast?皙?333333?cCs<tjdkrd}t|tj||||dt|j||||S)a"Detect edges by leveraging a multi-stage Canny algorithm. .. warning:: This class method is only available with ImageMagick 7.0.8-41, or greater. :param radius: Size of gaussian filter. :type radius: :class:`numbers.Real` :param sigma: Standard deviation of gaussian filter. :type sigma: :class:`numbers.Real` :param lower_percent: Normalized lower threshold. Values between ``0.0`` (0%) and ``1.0`` (100%). The default value is ``0.1`` or 10%. :type lower_percent: :class:`numbers.Real` :param upper_percent: Normalized upper threshold. Values between ``0.0`` (0%) and ``1.0`` (100%). The default value is ``0.3`` or 30%. :type upper_percent: :class:`numbers.Real` :raises WandLibraryVersionError: if function is not available on system's library. .. versionadded:: 0.5.5 Nz8Method requires ImageMagick version 7.0.8-41 or greater.)rr lower_percent upper_percent)rZMagickCannyEdgeImagerrrQr)rrrrrrrrrcannyd s  zBaseImage.cannyc CsFtj||d|dk r0t|ts0tdt||dk rHtjtd|d|dkr\|j|}n tj|d|dkr||j |}n tj|d|dkry|j }|dkrtWntk rtdYnXt p}t |j||||_ |p|j|_td } t |j| jWdQRX|jd |d d ||||WdQRXdS) aWrites a caption ``text`` into the position. :param text: text to write :type text: :class:`basestring` :param left: x offset in pixels :type left: :class:`numbers.Integral` :param top: y offset in pixels :type top: :class:`numbers.Integral` :param width: width of caption in pixels. default is :attr:`width` of the image :type width: :class:`numbers.Integral` :param height: height of caption in pixels. default is :attr:`height` of the image :type height: :class:`numbers.Integral` :param font: font to use. default is :attr:`font` of the image :type font: :class:`wand.font.Font` :param gravity: text placement gravity. uses the current :attr:`gravity` setting of the image by default :type gravity: :class:`basestring` .. versionadded:: 0.3.0 )rrNz#font must be a wand.font.Font, not zwand.image.GRAVITY_TYPES)rY)r)rz+font must be specified or existing in imagerUscaption:zutf-8)filename)rrArrrrr#r-rrrLrBrr\rrYrr3r2readrxr6) rrrrrrrLrYZ textboardr1rrrr} s:       zBaseImage.captioncCs ||S)zPAlias for :meth:`color_decision_list`. .. versionadded:: 0.5.7 )color_decision_list)rcccrrrcdl sz BaseImage.cdlcCstj||dt|j||S)aZTransform an image into a simulated charcoal drawing. :see: Example of :ref:`charcoal`. :param radius: The size of the Gaussian operator. :type radius: :class:`numbers.Real` :param sigma: The standard deviation of the Gaussian. :type sigma: :class:`numbers.Real` .. versionadded:: 0.5.3 )rr)rrQrZMagickCharcoalImager)rrrrrrcharcoal s zBaseImage.charcoalcCs0tj||dtj||dt|j||||S)aRemoves a region of an image, and reduces the image size accordingly. :param width: Size of region. :type width: :class:`numbers.Integral` :param height: Size of region. :type height: :class:`numbers.Integral` :param x: Offset on the X-axis. :type x: :class:`numbers.Integral` :param y: Offset on the Y-axis. :type y: :class:`numbers.Integral` .. versionadded:: 0.5.5 )rr)rr)rr[rArZMagickChopImager)rrrrrrrrchop szBaseImage.chopcCsFtjdkrd}t|tj||dtj||dt|j||||S)aContrast limited adaptive histogram equalization. .. warning:: The CLAHE method is only available with ImageMagick-7. :param width: Tile division width. :type width: :class:`numbers.Integral` :param height: Tile division height. :type height: :class:`numbers.Integral` :param number_bins: Histogram bins. :type number_bins: :class:`numbers.Real` :param clip_limit: contrast limit. :type clip_limit: :class:`numbers.Real` :raises WandLibraryVersionError: If system's version of ImageMagick does not support this method. .. versionadded:: 0.5.5 Nz0CLAHE method not defined in ImageMagick library.)rr) number_bins clip_limit)rZMagickCLAHEImagerrr[rQr)rrrrrrrrrclahe s  zBaseImage.clahecCsd|dkrt|j}nJ||}tdkr8t|j|}n(t|j|}t|j}t|j||S)a{Restrict color values between 0 and quantum range. This is useful when applying arithmetic operations that could result in color values over/under-flowing. :param channel: Optional color channel. :type channel: :class:`basestring` .. versionadded:: 0.5.0 .. versionchanged:: 0.5.5 Added ``channel`` argument. Ni)rZMagickClampImagerrrZMagickClampImageChannelr)rrrrrrrrclamp s  zBaseImage.clampcCs t|dS)a<Clones the image. It is equivalent to call :class:`Image` with ``image`` parameter. :: with img.clone() as cloned: # manipulate the cloned image pass :returns: the cloned new image :rtype: :class:`Image` .. versionadded:: 0.1.1 )r )rB)rrrrr( szBaseImage.clonerKcCst|tstdt|tdkrZ|dkr 0.9 1.2 0.5 0.4 -0.5 0.6 1.0 0.8 1.5 0.85 :param ccc: A XML string of the CCC contents. :type ccc: :class:`basestring` .. versionadded:: 0.5.7 )rZMagickColorDecisionListImagerr )rrrrrrv szBaseImage.color_decision_listc Cst|tjstdt||dks.||jkr6td|rt|trLt|}t|tsftdt||$t |j ||j }|s| WdQRXnBt }t |j ||}|st |}| t|}t |}|S)aGet & Set a color at a palette index. If ``color`` is given, the color at the index location will be set & returned. Omitting the ``color`` argument will only return the color value at index. Valid indexes are between ``0`` and total :attr:`colors` of the image. .. note:: Ensure the image type is set to ``'palette'`` before calling the :meth:`color_map` method. For example:: with Image(filename='graph.png') as img: img.type = 'palette' palette = [img.color_map(idx) for idx in range(img.colors)] # ... :param index: The color postion of the image palette. :type index: :class:`numbers.Integral` :param color: Optional color to _set_ at the given index. :type color: :class:`wand.color.Color` :returns: Color at index. :rtype: :class:`wand.color.Color` .. versionadded:: 0.5.3 zindex most be an integer, not rzindex is out of palette rangez$expecting in instance of Color, not N)rrrrrr;rr rrZMagickSetImageColormapColorrr2rr-ZMagickGetImageColormapColorr0r/)rrprrZ color_ptrrrr color_map s4       zBaseImage.color_mapc Cst|tjstdt|t|}d}g}xj|D]b}t|tjsRtdt||dkrdt|}n|t|krxtdx|D]}|t|q~Wq2Wt d ||d |}t }tdkrt |} n t ||} t |}t|j| } t | } | S)a. Adjust color values by applying a matrix transform per pixel. Matrix should be given as 2D list, with a max size of 6x6. An example of 3x3 matrix:: matrix = [ [1.0, 0.0, 0.0], [0.0, 1.0, 0.0], [0.0, 0.0, 1.0], ] Which would translate RGB color channels by calculating the following: .. math:: \begin{aligned} red' &= 1.0 * red + 0.0 * green + 0.0 * blue\\ green' &= 0.0 * red + 1.0 * green + 0.0 * blue\\ blue' &= 0.0 * red + 0.0 * green + 1.0 * blue\\ \end{aligned} For RGB colorspace images, the rows & columns are laid out as: +---------+-----+-------+------+------+-------+--------+ | | Red | Green | Blue | n/a | Alpha | Offset | +=========+=====+=======+======+======+=======+========+ | Red' | 1 | 0 | 0 | 0 | 0 | 0 | +---------+-----+-------+------+------+-------+--------+ | Green' | 0 | 1 | 0 | 0 | 0 | 0 | +---------+-----+-------+------+------+-------+--------+ | Blue' | 0 | 0 | 1 | 0 | 0 | 0 | +---------+-----+-------+------+------+-------+--------+ | n/a | 0 | 0 | 0 | 0 | 0 | 0 | +---------+-----+-------+------+------+-------+--------+ | Alpha' | 0 | 0 | 0 | 0 | 0 | 0 | +---------+-----+-------+------+------+-------+--------+ | Offset' | 0 | 0 | 0 | 0 | 0 | 0 | +---------+-----+-------+------+------+-------+--------+ Or for a CMYK colorspace image: +----------+------+--------+---------+-------+-------+--------+ | | Cyan | Yellow | Magenta | Black | Alpha | Offset | +==========+======+========+=========+=======+=======+========+ | Cyan' | 1 | 0 | 0 | 0 | 0 | 0 | +----------+------+--------+---------+-------+-------+--------+ | Yellow' | 0 | 1 | 0 | 0 | 0 | 0 | +----------+------+--------+---------+-------+-------+--------+ | Magenta' | 0 | 0 | 1 | 0 | 0 | 0 | +----------+------+--------+---------+-------+-------+--------+ | Black' | 0 | 0 | 0 | 1 | 0 | 0 | +----------+------+--------+---------+-------+-------+--------+ | Alpha' | 0 | 0 | 0 | 0 | 0 | 0 | +----------+------+--------+---------+-------+-------+--------+ | Offset' | 0 | 0 | 0 | 0 | 0 | 0 | +----------+------+--------+---------+-------+-------+--------+ See `color-matrix`__ for examples. __ https://www.imagemagick.org/Usage/color_mods/#color-matrix :see: Example of :ref:`color_matrix`. :param matrix: 2D List of doubles. :type matrix: :class:`collections.abc.Sequence` .. versionadded:: 0.5.3 zmatrix must be a sequence, not Nz#nested row must be a sequence, not z!rows have different column lengthz {0}x{1}:{2},i)rrr8rrrrappendrr rjoinrAcquireExceptionInforAcquireKernelInfoDestroyExceptionInforZMagickColorMatrixImagerDestroyKernelInfo) rZmatrixrrvaluesrowcolumnkernelexception_info kernel_inforrrr color_matrix s4I           zBaseImage.color_matrixc Cst|trt|}t|tr$t|}tj||dtjdkrHd}t||*|t|j|j |j }WdQRXWdQRX|S)aForces all pixels in color range to white, and all other pixels to black. .. note:: This method is only works with ImageMagick-7.0.10, or later. :param start: Color to begin color range. :type start: :class:`wand.color.Color` :param stop: Color to end color range. :type stop: :class:`wand.color.Color` .. versionadded:: 0.6.4 )rrNz'Method "color_threshold" not available.) rr rrrrZMagickColorThresholdImagerrr2)rrrrrrrrcolor_threshold-s   zBaseImage.color_thresholdc Csjt|trt|}t|tr$t|}tj||d|*|t|j|j|j}WdQRXWdQRX|S)aBlends a given fill color over the image. The amount of blend is determined by the color channels given by the ``alpha`` argument. :see: Example of :ref:`colorize`. :param color: Color to paint image with. :type color: :class:`wand.color.Color` :param alpha: Defines how to blend color. :type alpha: :class:`wand.color.Color` .. versionadded:: 0.5.3 )rrmN) rr rrrrZMagickColorizeImagerr2)rrrmrrrrrMs  zBaseImage.colorizerurtcCsptjtd|dt|jt|}||}tdkrHt |j|}nt |j|}|rh||_| t |S)aCreates an image where each color channel is assigned by a grayscale image in a sequence. .. warning:: If your using ImageMagick-6, use ``channel`` argument to control the color-channel order. With ImageMagick-7, the ``channel`` argument has been replaced with ``colorspace``. For example:: for wand.image import Image with Image() as img: img.read(filename='red_channel.png') img.read(filename='green_channel.png') img.read(filename='blue_channel.png') img.combine(colorspace='rgb') img.save(filename='output.png') :param channel: Determines the colorchannel ordering of the sequence. Only used for ImageMagick-6. See :const:`CHANNELS`. :type channel: :class:`basestring` :param colorspace: Determines the colorchannel ordering of the sequence. Only used for ImageMagick-7. See :const:`COLORSPACE_TYPES`. :type colorspace: :class:`basestring` .. versionadded:: 0.5.9 zwand.image.COLORSPACE_TYPES)ri) rr#r#rr&rrprrZMagickCombineImagesrr)rrrZ colorspace_cZ channel_cnew_wandrrrcombinehs"   zBaseImage.combinecCstjtd|d|r8t|tr$|j}t|jdt ||r`t|trL|j}t|jdt |t |}t d}t |j|j|t |}tt||jfS)acCompares an image with another, and returns a reconstructed image & computed distortion. The reconstructed image will show the differences colored with ``highlight``, and similarities with ``lowlight``. If you need the computed distortion between to images without a image being reconstructed, use :meth:`get_image_distortion()` method. Set :attr:`fuzz` property to adjust pixel-compare thresholds. For example:: from wand.image import Image with Image(filename='input.jpg') as base: with Image(filename='subject.jpg') as img: base.fuzz = base.quantum_range * 0.20 # Threshold of 20% result_image, result_metric = base.compare(img) with result_image: result_image.save(filename='diff.jpg') :param image: The reference image :type image: :class:`wand.image.Image` :param metric: The metric type to use for comparing. See :const:`COMPARE_METRICS` :type metric: :class:`basestring` :param highlight: Set the color of the delta pixels in the resulting difference image. :type highlight: :class:`~wand.color.Color` or :class:`basestring` :param lowlight: Set the color of the similar pixels in the resulting difference image. :type lowlight: :class:`~wand.color.Color` or :class:`basestring` :returns: The difference image(:class:`wand.image.Image`), the computed distortion between the images (:class:`numbers.Real`) :rtype: :class:`tuple` ( :class:`Image`, :class:`numbers.Real` ) .. versionadded:: 0.4.3 .. versionchanged:: 0.5.3 Added support for ``highlight`` & ``lowlight``. zwand.image.COMPARE_METRICS)metricscompare:highlight-colorscompare:lowlight-colorg)rr#r$rrrNrMagickSetImageArtifactrr rprrZMagickCompareImagesrrBr=r4)rr r highlightZlowlightZ distortionZcompared_imagerrrcompares*-        zBaseImage.comparecCs~tjdkrd}t|tjtd|d|dk rJd}t|}t|j||t |}t|j|}t |sr| t t |S)aPerforms `complex`_ mathematics against two images in a sequence, and generates a new image with two results. .. seealso:: :meth:`forward_fourier_transform` & :meth:`inverse_fourier_transform` .. code:: from wand.image import Image with Image(filename='real_part.png') as imgA: with Image(filename='imaginary_part.png') as imgB: imgA.sequence.append(imgB) with imgA.complex('conjugate') as results: results.save(filename='output-%02d.png') .. _complex: https://en.wikipedia.org/wiki/Complex_number .. warning:: This class method is only available with ImageMagick 7.0.8-41, or greater. :param operator: Define which mathematic operator to perform. See :const:`COMPLEX_OPERATORS`. :type operator: :class:`basestring` :param snr: Optional ``SNR`` parameter for ``'divide'`` operator. :type snr: :class:`basestring` :raises WandLibraryVersionError: If ImageMagick library does not support this function. .. versionadded:: 0.5.5 Nz8Method requires ImageMagick version 7.0.8-41 or greater.zwand.image.COMPLEX_OPERATORS)r>scomplex:snr=float)rZMagickComplexImagesrrr#COMPLEX_OPERATORSrrrrprrrBr=)rr>ZsnrrkeyvalZ operator_idxrrrrcomplexs%  zBaseImage.complexrc CsJ|dkr6|dkr6|dkr|j}|||j|j\}}n,|dk rHtdn|dkrVd}n |dkrbd}tj||dyt|}Wn$t k rt t |dYnX|rtj |dt |jtdt|}|s|t |jtdt|}|s|tdkr&t |j|j|t|t|}n t |j|j|d t|t|}|S) a@Places the supplied ``image`` over the current image, with the top left corner of ``image`` at coordinates ``left``, ``top`` of the current image. The dimensions of the current image are not changed. :param image: the image placed over the current image :type image: :class:`wand.image.Image` :param left: the x-coordinate where `image` will be placed :type left: :class:`numbers.Integral` :param top: the y-coordinate where `image` will be placed :type top: :class:`numbers.Integral` :param operator: the operator that affects how the composite is applied to the image. available values can be found in the :const:`COMPOSITE_OPERATORS` list. Default is ``'over'``. :type operator: :class:`basestring` :param arguments: Additional numbers given as a geometry string, or comma delimited values. This is needed for ``'blend'``, ``'displace'``, ``'dissolve'``, and ``'modulate'`` operators. :type arguments: :class:`basestring` :param gravity: Calculate the ``top`` & ``left`` values based on gravity value from :const:`GRAVITY_TYPES`. :type: gravity: :class:`basestring` .. versionadded:: 0.2.0 .. versionchanged:: 0.5.3 The operator can be set, as well as additional composite arguments. .. versionchanged:: 0.5.3 Optional ``gravity`` argument was added. Nz+Can not use gravity if top & left are givenr)rrzU is an invalid composite operator type; see wand.image.COMPOSITE_OPERATORS dictionary) argumentsz compose:argsiT)rYrrrrrrAr%rprrrrRrrrr rrMagickCompositeImagert) rr rrr>rrYoprrrrr6sF#     zBaseImage.compositec CsNtj|d||}|rJ|dkrB|dkrB|||j|j\}}ntd|dkrVd}|dkrbd}tj||dyt |} Wn$t k rt t |dYnX|rtj|dt |jtdt|t |jtdt|t jrt |j||j| t|t|} nNz+Can not use gravity if top & left are givenr)rrzU is an invalid composite operator type; see wand.image.COMPOSITE_OPERATORS dictionary)rz compose:argsT)rrRrrrrrrAr%rprrrrrr ZMagickCompositeImageChannelrtrr) rrr r>rrrrYch_constrrZch_maskrrrcomposite_channel[sD'        zBaseImage.composite_channelFcCs4tj|dt|j|}|r,||_|t|S)aConcatenates images in stack into a single image. Left-to-right by default, top-to-bottom if ``stacked`` is True. :param stacked: stack images in a column, or in a row (default) :type stacked: :class:`bool` .. versionadded:: 0.5.0 )stacked)rr,rZMagickAppendImagesrrr)rrrrrrconcats zBaseImage.concatcKs|dd}|dd}|dd}|dd}|dd}|dd}|d d}|d d} |d d} |d d} |d d} |dd} |dd}|dd}|dd}|dd}tjdkrd}t||dkrtd|dk r d}t|}t|j|||dk r2d}t|}t|j|||dk rXd}t|}t|j|||dk r~d}t|}t|j|||dk rd}t|}t|j|||dk rd}t|}t|j||| dk rd}t| }t|j||| dk rd}t| }t|j||| dk r}|}|j||}tt||||t|~qrWt|}n||S))a Evaluates binary image, and groups connected pixels into objects. This method will also return a list of :class:`ConnectedComponentObject` instances that will describe an object's features. .. code:: from wand.image import Image with Image(filename='objects.gif') as img: objects = img.connected_components() for cc_obj in objects: print("{0._id}: {0.size} {0.offset}".format(cc_obj)) #=> 0: (256, 171) (0, 0) #=> 2: (120, 135) (104, 18) #=> 3: (50, 36) (129, 44) #=> 4: (21, 23) (0, 45) #=> 1: (4, 10) (252, 0) .. warning:: This class method is only available with ImageMagick 7.0.8-41, or greater. .. tip:: Set :attr:`fuzz` property to increase pixel matching by reducing tolerance of color-value comparisons:: from wand.image import Image from wand.version import QUANTUM_RANGE with Image(filename='objects.gif') as img: img.fuzz = 0.1 * QUANTUM_RANGE # 10% objects = img.connected_components() :param angle_threshold: Optional argument that merges any region with an equivalent ellipse smaller than a given value. Requires ImageMagick-7.0.9-24, or greater. :type angle_threshold: :class:`basestring` :param area_threshold: Optional argument to merge objects under an area size. :type area_threshold: :class:`basestring` :param background_id: Optional argument to identify which object should be the background. Requires ImageMagick-7.0.9-24, or greater. :type background_id: :class:`basestring` :param circularity_threshold: Optional argument that merges any region smaller than value defined as: ``4*pi*area/perimeter^2``. Requires ImageMagick-7.0.9-24, or greater. :type circularity_threshold: :class:`basestring` :param connectivity: Either ``4``, or ``8``. A value of ``4`` will evaluate each pixels top-bottom, & left-right neighbors. A value of ``8`` will use the same pixels as with ``4``, but will also include the four corners of each pixel. Default value of ``4``. :type connectivity: :class:`numbers.Integral` :param diameter_threshold: Optional argument to merge any region under a given value. A region is defined as: ``sqr(4*area/pi)``. Requires ImageMagick-7.0.9-24. :type diameter_threshold: :class:`basestring` :param eccentricity_threshold: Optional argument to merge any region with ellipse eccentricity under a given value. Requires ImageMagick-7.0.9-24, or greater. :param keep: Comma separated list of object IDs to isolate, the reset are converted to transparent. :type keep: :class:`basestring` :param keep_colors: Semicolon separated list of objects to keep by their color value. Requires ImageMagick-7.0.9-24, or greater. :type keep_colors: :class:`basestring` :param keep_top: Keeps only the top number of objects by area. Requires ImageMagick-7.0.9-24, or greater. :type keep_top: :class:`basestring` :param major_axis_threshold: Optional argument to merge any ellipse with a major axis smaller then given value. Requires ImageMagick-7.0.9-24, or greater. :type major_axis_threshold: :class:`basestring` :param mean_color: Optional argument. Replace object color with mean color of the source image. :type mean_color: :class:`bool` :param minor_axis_threshold: Optional argument to merge any ellipse with a minor axis smaller then given value. Requires ImageMagick-7.0.9-24, or greater. :type minor_axis_threshold: :class:`basestring` :param perimeter_threshold: Optional argument to merge any region with a perimeter smaller than the given value. Requires ImageMagick-7.0.9-24, or greater. :param remove: Comma separated list of object IDs to ignore, and convert to transparent. :type remove: :class:`basestring` :param remove_colors: Semicolon separated list of objects to remove by there color. Requires ImageMagick-7.0.9-24, or greater. :type remove_colors: :class:`basestring` :returns: A list of :class:`ConnectedComponentObject`. :rtype: :class:`list` [:class:`ConnectedComponentObject`] :raises WandLibraryVersionError: If ImageMagick library does not support this method. .. versionadded:: 0.5.5 .. versionchanged:: 0.5.6 Added ``mean_color``, ``keep``, & ``remove`` optional arguments. .. versionchanged:: 0.6.4 Added ``angle_threshold``, ``circularity_threshold``, ``diameter_threshold``, ``eccentricity_threshold``, ``keep_colors``, ``major_axis_threshold``, ``minor_axis_threshold``, ``perimeter_threshold``, and ``remove_colors`` optional arguments. angle_thresholdNarea_threshold background_idcircularity_threshold connectivityr_diameter_thresholdeccentricity_thresholdkeep keep_colorskeep_topmajor_axis_threshold mean_colorFminor_axis_thresholdperimeter_thresholdrW remove_colorsz8Method requires ImageMagick version 7.0.8-41 or greater.)r_r`zconnectivity must be 4, or 8.s$connected-components:angle-thresholds#connected-components:area-thresholds"connected-components:background-ids*connected-components:circularity-thresholds'connected-components:diameter-thresholds+connected-components:eccentricity-thresholdsconnected-components:keeps connected-components:keep-colorssconnected-components:keep-tops)connected-components:major-axis-thresholdsconnected-components:mean-colorstrues)connected-components:minor-axis-thresholds(connected-components:perimeter-thresholdsconnected-components:removes"connected-components:remove-colorsri )rrZMagickConnectedComponentsImagerrrrrrc_void_prrrsizeofrr4rr;memmover rrJrZRelinquishMagickMemoryr)rrrrrrr r r r r rrrrrrWrrrrZ objects_ptrZCCObjectInfoStructureZ ccoi_mem_sizerobjectsr)tempZsrc_addrrrrconnected_componentssw                                     zBaseImage.connected_componentsTcCstj|dt|j|S)aKEnhances the difference between lighter & darker values of the image. Set ``sharpen`` to ``False`` to reduce contrast. :param sharpen: Increase, or decrease, contrast. Default is ``True`` for increased contrast. :type sharpen: :class:`bool` .. versionadded:: 0.5.7 )sharpen)rr,rZMagickContrastImager)rrrrrrs zBaseImage.contrastcCstj|d|dkr|}tj|dt|j|j}d|krHdkrTnn||9}d|krhdkrtnn||9}||}|dkrt|j||}nP||}tj rt |j|||}n,t |j|}t|j||}t |j||S)a5Enhance contrast of image by adjusting the span of the available colors. :param black_point: black point between 0.0 and 1.0. default is 0.0 :type black_point: :class:`numbers.Real` :param white_point: white point between 0.0 and 1.0. Defaults to the same value given to the ``black_point`` argument. :type white_point: :class:`numbers.Real` :param channel: optional color channel to apply contrast stretch :type channel: :const:`CHANNELS` :raises ValueError: if ``channel`` is not in :const:`CHANNELS` .. versionadded:: 0.4.1 .. versionchanged:: 0.5.5 The ``white_point`` argument will now default to the value given by the ``black_point`` argument. ) black_pointN)rgg?) rrQrrrrZMagickContrastStretchImagerrZ!MagickContrastStretchImageChannelr)rrrrZcontrast_rangerr channel_maskrrrcontrast_stretchs6   zBaseImage.contrast_stretchc Csg}tdkrd}t||}|dk rbt|tr:|j}tj|dd}t|}t |j ||t |j ddt |j dt}t |j t|}|rt||j} t |}| d d d } d d | D}n|WdQRX|S)aFind the smallest convex polygon, and returns a list of points. .. note:: Requires ImageMagick-7.0.10 or greater. You can pass the list of points directly to :meth:`Drawing.polygon() ` method to draw the convex hull shape on the image. .. code:: from wand.image import Image from wand.drawing import Drawing with Image(filename='kdf_black.png') as img: points = img.convex_hull() with Drawing() as ctx: ctx.fill_color = 'transparent' ctx.stroke_color = 'red' ctx.polygon(points=points) ctx(img) img.save(filename='kdf_black_convex_hull.png') .. image:: ../_images/wand/image/kdf_black.png .. image:: ../_images/wand/image/kdf_black_convex_hull.png :param background: Define which color value to evaluate as the background. :type background: :class:`basestring` or :class:`~wand.color.Color` :returns: list of points :rtype: :class:`list` [ :class:`tuple` ( :class:`float`, :class:`float` ) ] .. versionadded:: 0.6.4 i z4ImageMagick-7.0.10 is required to use convex_hull().N)rMsconvex-hull:background-colorsformats%[convex-hull]sINFOasciiignore cSs$g|]}ttdd|dqS)cSst|S)N)r)rrrrz2BaseImage.convex_hull...r)rmapsplit)rr5rrr sz)BaseImage.convex_hull..)rrrrrrNrrRrrrrMagickSetOptionrTrrhMagickGetImageBlobrrOr4rPdecoderSr$r) rrMrrtmprrlengthblob_pblobptsrrrr\s0#     zBaseImage.convex_hullc Cs|dks|dkstdn|dks2|dks2tdd dd} |rl|dksP|dkrXtd||||\}}n| ||jd}| ||jd}|dkr| ||j}||}|dkr| ||j}||}tj||d||krdkrnn||jkr||jkrd S|jrt|j |_ | t |j t |j } t |j xltd| d D]6} t|j | t|j ||||} |rV|qVWn"t|j ||||} |r|| S) a Crops the image in-place. .. sourcecode:: text +--------------------------------------------------+ | ^ ^ | | | | | | top | | | | | | | v | | | <-- left --> +-------------------+ bottom | | | ^ | | | | | <-- width --|---> | | | | | height | | | | | | | | | | | v | | | | +-------------------+ v | | <--------------- right ----------> | +--------------------------------------------------+ :param left: x-offset of the cropped image. default is 0 :type left: :class:`numbers.Integral` :param top: y-offset of the cropped image. default is 0 :type top: :class:`numbers.Integral` :param right: second x-offset of the cropped image. default is the :attr:`width` of the image. this parameter and ``width`` parameter are exclusive each other :type right: :class:`numbers.Integral` :param bottom: second y-offset of the cropped image. default is the :attr:`height` of the image. this parameter and ``height`` parameter are exclusive each other :type bottom: :class:`numbers.Integral` :param width: the :attr:`width` of the cropped image. default is the :attr:`width` of the image. this parameter and ``right`` parameter are exclusive each other :type width: :class:`numbers.Integral` :param height: the :attr:`height` of the cropped image. default is the :attr:`height` of the image. this parameter and ``bottom`` parameter are exclusive each other :type height: :class:`numbers.Integral` :param reset_coords: optional flag. If set, after the rotation, the coordinate frame will be relocated to the upper-left corner of the new image. By default is `True`. :type reset_coords: :class:`bool` :param gravity: optional flag. If set, will calculate the :attr:`top` and :attr:`left` attributes. This requires both :attr:`width` and :attr:`height` parameters to be included. :type gravity: :const:`GRAVITY_TYPES` :raises ValueError: when one or more arguments are invalid .. note:: If you want to crop the image but not in-place, use slicing operator. .. versionchanged:: 0.4.1 Added ``gravity`` option. Using ``gravity`` along with ``width`` & ``height`` to auto-adjust ``left`` & ``top`` attributes. .. versionchanged:: 0.1.8 Made to raise :exc:`~exceptions.ValueError` instead of :exc:`~exceptions.IndexError` for invalid ``width``/``height`` arguments. .. versionadded:: 0.1.7 NzFparameters right and width are exclusive each other; use one at a timezHparameters bottom and height are exclusive each other; use one at a timecSsj|dkr|dkr|S|St|tjs6tdt|n ||krVtt|dt||dkrf||S|S)Nzexpected integer, not z > r)rrrrrr)r(rpnullrrrabs_rs zBaseImage.crop..abs_z2both width and height must be defined with gravityr)rrTr)N)rrrrrassert_counting_numberr*rrrrr$r%r&rr'ZMagickCropImage reset_coords) rrrrightbottomrrr1rYr/r(r)rrrrrsPO         zBaseImage.croprcCstj|dt|j|S)zShift the image color-map by a given offset. :param offset: number of steps to rotate index by. :type offset: :class:`numbers.Integral` .. versionadded:: 0.5.3 )r)rrArZMagickCycleColormapImager)rrrrrcycle_color_maps zBaseImage.cycle_color_mapcCstj|dt|jt|S)aqDecrypt ciphered pixels into original values. .. note:: :class:`~wand.exceptions.ImageError` will be thrown if the system's ImageMagick library was compiled without cipher support. :param passphrase: the secret passphrase to decrypt with. :type passphrase: :class:`basestring` .. versionadded:: 0.6.3 ) passphrase)rrRrMagickDecipherImagerr )rr5rrrdeciphers zBaseImage.deciphercCs&t|j}|r||_|t|S)zIterates over internal image stack, and adjust each frame size to minimum bounding region of any changes from the previous frame. .. versionadded:: 0.5.0 )rZMagickDeconstructImagesrrr)rrrrr deconstructs  zBaseImage.deconstructcCs<tj|dd|kr dkr.nn ||j9}t|j|S)axAttempts to remove skew artifacts common with most scanning & optical import devices. :params threshold: limit between foreground & background. Use a real number between `0.0` & `1.0` to match CLI's percent argument. :type threshold: :class:`numbers.Real` .. versionadded:: 0.5.0 )rrg?)rrQrrZMagickDeskewImager)rrrrrdeskews  zBaseImage.deskewcCs t|jS)z~Applies filter to reduce noise in image. :see: Example of :ref:`despeckle`. .. versionadded:: 0.5.0 )rZMagickDespeckleImager)rrrr despeckles zBaseImage.despecklecCsdtjtd|dt|tjs,tdt|t|}t j ||}t |}t |j|||t|S)aDistorts an image using various distorting methods. .. code:: python from wand.image import Image from wand.color import Color with Image(filename='checks.png') as img: img.virtual_pixel = 'background' img.background_color = Color('green') img.matte_color = Color('skyblue') arguments = (0, 0, 20, 60, 90, 0, 70, 63, 0, 90, 5, 83, 90, 90, 85, 88) img.distort('perspective', arguments) img.save(filename='checks_perspective.png') .. image:: ../_images/wand/image/checks.png .. image:: ../_images/wand/image/checks_perspective.png Use :attr:`virtual_pixel`, :attr:`background_color`, and :attr:`matte_color` properties to control the behavior of pixels rendered outside of the image boundaries. Use :attr:`interpolate_method` to control how images scale-up. Distortion viewport, and scale, can be defined by using :attr:`Image.artifacts` dictionary. For example:: img.artifacts['distort:viewport'] = '44x44+15+0' img.artifacts['distort:scale'] = '10' :see: Additional examples of :ref:`distort`. :param method: Distortion method name from :const:`DISTORTION_METHODS` :type method: :class:`basestring` :param arguments: List of distorting float arguments unique to distortion method :type arguments: :class:`collections.abc.Sequence` :param best_fit: Attempt to resize resulting image fit distortion. Defaults False :type best_fit: :class:`bool` .. versionadded:: 0.4.1 zwand.image.DISTORTION_METHODS)rcz"expected sequence of doubles, not )rr#r(rrr8rrrrrrprZMagickDistortImagerr)rrcrZbest_fitargcargvrarrrrs1    zBaseImage.distortcCstj|dt|j|S)zApplies convolution filter to detect edges. :see: Example of :ref:`edge`. :param radius: aperture of detection filter. :type radius: :class:`numbers.Real` .. versionadded:: 0.5.0 )r)rrQrZMagickEdgeImager)rrrrrrs,s zBaseImage.edgecCstj||dt|j||S)aApplies convolution filter against Gaussians filter. .. note:: The `radius` value should be larger than `sigma` for best results. :see: Example of :ref:`emboss`. :param radius: filter aperture size. :type radius: :class:`numbers.Real` :param sigma: standard deviation. :type sigma: :class:`numbers.Real` .. versionadded:: 0.5.0 )rr)rrQrZMagickEmbossImager)rrrrrremboss;szBaseImage.embosscCstj|dt|jt|S)anEncrypt plain pixels into ciphered values. .. note:: :class:`~wand.exceptions.ImageError` will be thrown if the system's ImageMagick library was compiled without cipher support. :param passphrase: the secret passphrase to encrypt with. :type passphrase: :class:`basestring` .. versionadded:: 0.6.3 )r5)rrRrr6rr )rr5rrrencipherPs zBaseImage.enciphercCs t|jS)z{Applies digital filter to reduce noise. :see: Example of :ref:`enhance`. .. versionadded:: 0.5.0 )rZMagickEnhanceImager)rrrrenhancebs zBaseImage.enhancecCsd|dkrt|j}nJ||}tdkr8t|j|}n(t|j|}t|j}t|j||S)aEqualizes the image histogram :param channel: Optional channel. See :const:`CHANNELS`. :type channel: :class:`basestring` .. versionadded:: 0.3.10 .. versionchanged:: 0.5.5 Added optional ``channel`` argument. Ni)rZMagickEqualizeImagerrrZMagickEqualizeImageChannelr)rrrrrrrrequalizems   zBaseImage.equalizecCstjtd|dtj|dt|}|dkr@t|j||}nP||}tj rdt |j|||}n,t |j|}t|j||}t |j||S)aMApply arithmetic, relational, or logical expression to an image. Percent values must be calculated against the quantum range of the image:: fifty_percent = img.quantum_range * 0.5 img.evaluate(operator='set', value=fifty_percent) :see: Example of :ref:`evaluate`. :param operator: Type of operation to calculate :type operator: :const:`EVALUATE_OPS` :param value: Number to calculate with ``operator`` :type value: :class:`numbers.Real` :param channel: Optional channel to apply operation on. :type channel: :const:`CHANNELS` :raises TypeError: When ``value`` is not numeric. :raises ValueError: When ``operator``, or ``channel`` are not defined in constants. .. versionadded:: 0.4.1 zwand.image.EVALUATE_OPS)r>)r4N) rr#r*rQrprZMagickEvaluateImagerrZMagickEvaluateImageChannelr)rr>r4rZidx_oprrrrrrevaluates"   zBaseImage.evaluateRGBArc Cs|j\}}|dkr|}|dkr"|}tj||||dtj|dtjtd|d|}d} x$|D]} | | krbtdt| qbWdt j t j t j t j t jt j t jg} t|} | | } ||}|t|}|| }t|j||||t|| t |}|s||d|S)acExport pixel data from a raster image to a list of values. The ``channel_map`` tells ImageMagick which color channels to export, and what order they should be written as -- per pixel. Valid entries for ``channel_map`` are: - ``'R'`` - Red channel - ``'G'`` - Green channel - ``'B'`` - Blue channel - ``'A'`` - Alpha channel (``0`` is transparent) - ``'O'`` - Alpha channel (``0`` is opaque) - ``'C'`` - Cyan channel - ``'Y'`` - Yellow channel - ``'M'`` - Magenta channel - ``'K'`` - Black channel - ``'I'`` - Intensity channel (only for grayscale) - ``'P'`` - Padding See :const:`STORAGE_TYPES` for a list of valid ``storage`` options. This tells ImageMagick what type of data it should calculate & write to. For example; a storage type of ``'char'`` will write a 8-bit value between 0 ~ 255, a storage type of ``'short'`` will write a 16-bit value between 0 ~ 65535, and a ``'integer'`` will write a 32-bit value between 0 ~ 4294967295. .. note:: By default, the entire image will be exported as ``'char'`` storage with each pixel mapping Red, Green, Blue, & Alpha channels. :param x: horizontal starting coordinate of raster. :type x: :class:`numbers.Integral` :param y: vertical starting coordinate of raster. :type y: :class:`numbers.Integral` :param width: horizontal length of raster. :type width: :class:`numbers.Integral` :param height: vertical length of raster. :type height: :class:`numbers.Integral` :param channel_map: a string listing the channel data format for each pixel. :type channel_map: :class:`basestring` :param storage: what data type each value should be calculated as. :type storage: :class:`basestring` :returns: list of values. :rtype: :class:`collections.abc.Sequence` .. versionadded:: 0.5.0 N)rrrr)rzwand.image.STORAGE_TYPES)storage RGBAOCYMKIPzUnknown channel label: )rrrArRr#r:rUrrrc_ubyterc_floatc_uintc_ulongc_ushortrprrrrr rr)rrrrrrrC_w_hvalid_channelsrc_storage_typesrZ c_storageZ total_pixelsZ c_buffer_sizec_bufferrrrr export_pixelssH9       zBaseImage.export_pixelscCsb|dks|dkr|j}|dks&|dkr,|j}|dkr>tdn|dkrNtdt|j||||S)afextends the image as defined by the geometry, gravity, and wand background color. Set the (x,y) offset of the geometry to move the original wand relative to the extended wand. :param width: the :attr:`width` of the extended image. default is the :attr:`width` of the image. :type width: :class:`numbers.Integral` :param height: the :attr:`height` of the extended image. default is the :attr:`height` of the image. :type height: :class:`numbers.Integral` :param x: the :attr:`x` offset of the extended image. default is 0 :type x: :class:`numbers.Integral` :param y: the :attr:`y` offset of the extended image. default is 0 :type y: :class:`numbers.Integral` .. versionadded:: 0.4.5 Nrz&image width cannot be negative integerz'image height cannot be negative integer)rrrrZMagickExtentImager)rrrrrrrrextents zBaseImage.extentcsfdd}tdkrtj}ntj}tj|d||j|i}r|j}|jr\|d|d<|dkrt|d|d<nl|dkr|d|d<|d |d <|d |d <|d |d <n*|d |d <|d |d <|d|d<t |S)aCalculate directional image features for each color channel. Feature metrics including: - angular second moment - contrast - correlation - variance sum of squares - inverse difference moment - sum average - sum variance - sum entropy - entropy - difference variance - difference entropy - information measures of correlation 1 - information measures of correlation 2 - maximum correlation coefficient With each metric containing horizontal, vertical, left & right diagonal values. .. code:: from wand.image import Image with Image(filename='rose:') as img: channel_features = img.features(distance=32) for channels, features in channel_features.items(): print(channels) for feature, directions in features.items(): print(' ', feature) for name, value in directions.items(): print(' ', name, value) :param distance: Define the distance if pixels to calculate. :type distance: :class:`numbers.Integral` :returns: a dict mapping each color channel with a dict of each feature. :rtype: :class:`dict` .. versionadded:: 0.5.5 cslt}t|}tt|t|||d}i}x.|jD]$}|d}tt|t ||||<q@W|S)N) horizontalverticalZ left_diagonalZright_diagonalr) rrrrr r"_fields_rrr)addressrfeaturerkeysZ feature_dictrea) feature_ptrrr build_channelbs   z)BaseImage.features..build_channeli)rkrmrgrrhrjrlrorfrirk) rrZMagickGetImageChannelFeaturesZMagickGetImageFeaturesrr[rrrrP)rrkrYrcresponserr)rXrfeatures7s.+    zBaseImage.featurescCs ||S)zVAlias for :meth:`forward_fourier_transform`. .. versionadded:: 0.5.7 )forward_fourier_transform)rrrrrfftsz BaseImage.fftcCs t|jS)zCreates a vertical mirror image by reflecting the pixels around the central x-axis. It manipulates the image in place. :see: Example of :ref:`flip_flop`. .. versionadded:: 0.3.0 )rZMagickFlipImager)rrrrrs zBaseImage.flipcCs t|jS)zCreates a horizontal mirror image by reflecting the pixels around the central y-axis. It manipulates the image in place. :see: Example of :ref:`flip_flop`. .. versionadded:: 0.3.0 )rZMagickFlopImager)rrrrrs zBaseImage.flopcCstj|dt|j|S)aPerforms a discrete Fourier transform. The image stack is replaced with the results. Either a pair of magnitude & phase images, or real & imaginary (HDRI). .. code:: from wand.image import Image from wand.version import QUANTUM_RANGE with Image(filename='source.png') as img: img.forward_fourier_transform() img.depth = QUANTUM_RANGE img.save(filename='fft_%02d.png') .. seealso:: :meth:`inverse_fourier_transform` & :meth:`complex` .. note:: ImageMagick must have HDRI support to compute real & imaginary components (i.e. ``magnitude=False``). :param magnitude: If ``True``, generate magnitude & phase, else real & imaginary. Default ``True`` :type magnitude: :class:`bool` .. versionadded:: 0.5.5 )r)rr,rZ"MagickForwardFourierTransformImager)rrrrrr\s z#BaseImage.forward_fourier_transformc Cs|dkrtd}t|tr"t|}tj|dtj||dtj||d|\tdkrrt |j |j ||||}n4tj t d|dt |}t |j |j |||||}WdQRX|S) atCreates a bordered frame around image. Inner & outer bevel can simulate a 3D effect. :param matte: color of the frame :type matte: :class:`wand.color.Color` :param width: total size of frame on x-axis :type width: :class:`numbers.Integral` :param height: total size of frame on y-axis :type height: :class:`numbers.Integral` :param inner_bevel: inset shadow length :type inner_bevel: :class:`numbers.Real` :param outer_bevel: outset highlight length :type outer_bevel: :class:`numbers.Real` :param compose: Optional composite operator. Default ``'over'``, and only available with ImageMagick-7. :type compose: :class:`basestring` .. versionadded:: 0.4.1 .. versionchanged:: 0.5.6 Added optional ``compose`` parameter. Nrg)matte)rr) inner_bevel outer_bevelizwand.image.COMPOSITE_OPERATORS)r=)rrr rrrArQrrZMagickFrameImagerr2r#r%rp) rr^rrr_r`r=rrrrrframes0    zBaseImage.framec Cstjtd|dt|tjs,tdt|t|}t j ||}t |}|dkrht |j|||}nT||}t jrt |j||||}n.t |j|} t |j|||}t |j| |S)ajApply an arithmetic, relational, or logical expression to an image. Defaults entire image, but can isolate affects to single color channel by passing :const:`CHANNELS` value to ``channel`` parameter. .. note:: Support for function methods added in the following versions of ImageMagick. - ``'polynomial'`` >= 6.4.8-8 - ``'sinusoid'`` >= 6.4.8-8 - ``'arcsin'`` >= 6.5.3-1 - ``'arctan'`` >= 6.5.3-1 :see: Example of :ref:`function`. :param function: a string listed in :const:`FUNCTION_TYPES` :type function: :class:`basestring` :param arguments: a sequence of doubles to apply against ``function`` :type arguments: :class:`collections.abc.Sequence` :param channel: optional :const:`CHANNELS`, defaults all :type channel: :class:`basestring` :raises ValueError: when a ``function``, or ``channel`` is not defined in there respected constant :raises TypeError: if ``arguments`` is not a sequence .. versionadded:: 0.4.1 zwand.image.FUNCTION_TYPES)rz%expecting sequence of arguments, not N)rr#r,rrr8rrrrrrprZMagickFunctionImagerrZMagickFunctionImageChannelr) rrrrr;r<rpr ch_channelrrrrrs,     zBaseImage.functioncCstj|dt|}|dkr,t|j|}nL||}tjrNt|j||}n*t|j|}t|j|}t|j||rt t |dS| dS)aLManipulate each pixel of an image by given expression. FX will preserver current wand instance, and return a new instance of :class:`Image` containing affected pixels. Defaults entire image, but can isolate affects to single color channel by passing :const:`CHANNELS` value to ``channel`` parameter. .. seealso:: The anatomy of FX expressions can be found at http://www.imagemagick.org/script/fx.php :see: Example of :ref:`fx`. :param expression: The entire FX expression to apply :type expression: :class:`basestring` :param channel: Optional channel to target. :type channel: :const:`CHANNELS` :returns: A new instance of an image with expression applied :rtype: :class:`Image` .. versionadded:: 0.4.1 ) expressionN)r ) rrRr rZ MagickFxImagerrZMagickFxImageChannelrrBr=r)rrcrZ c_expressionrrbrrrrfx9s   z BaseImage.fxcCsttj|d|dkr$t|j|}nL||}tjrFt|j||}n*t|j|}t|j|}t|j||S)aZGamma correct image. Specific color channels can be correct individual. Typical values range between 0.8 and 2.3. :see: Example of :ref:`gamma`. :param adjustment_value: value to adjust gamma level. Default `1.0` :type adjustment_value: :class:`numbers.Real` :param channel: optional channel to apply gamma correction :type channel: :class:`basestring` :raises TypeError: if ``gamma_point`` is not a :class:`numbers.Real` :raises ValueError: if ``channel`` is not in :const:`CHANNELS` .. versionadded:: 0.4.1 )adjustment_valueN)rrQrZMagickGammaImagerrZMagickGammaImageChannelr)rrerrrrrrrrhs  zBaseImage.gammacCs~tj||d|dkr(t|j||}nR||}tdkrNt|j|||}n,t|j|}t|j||}t|j||S)aBlurs the image. We convolve the image with a gaussian operator of the given ``radius`` and standard deviation (``sigma``). For reasonable results, the ``radius`` should be larger than ``sigma``. Use a ``radius`` of 0 and :meth:`blur()` selects a suitable ``radius`` for you. :see: Example of :ref:`gaussian_blur`. :param radius: the radius of the, in pixels, not counting the center pixel :type radius: :class:`numbers.Real` :param sigma: the standard deviation of the, in pixels :type sigma: :class:`numbers.Real` :param channel: Optional color channel to target. See :const:`CHANNELS` :type channel: :class:`basestring` .. versionadded:: 0.3.3 .. versionchanged:: 0.5.5 Added ``channel`` argument. .. versionchanged:: 0.5.7 Positional arguments ``radius`` & ``sigma`` have been converted to keyword arguments. )rrNi) rrQrZMagickGaussianBlurImagerrrZMagickGaussianBlurImageChannelr)rrrrrrrrrr gaussian_blurs zBaseImage.gaussian_blurcCsdt|tstdt|tjtd|dt|}t d}t |j |j ||}|s^| |jS)a@Compares two images, and return the specified distortion metric. This method is faster than :meth:`compare()` method as ImageMagick will not need to reconstruct an image. :param image: Image to reference. :type image: :class:`wand.image.BaseImage` :param metric: Compare disortion metric to use. See :const:`COMPARE_METRICS`. :type metric: :class:`basestring` :returns: Computed value of the distortion metric used. :rtype: :class:`numbers.Real` .. versionadded:: 0.6.6 zexpecting a base image, not zwand.image.COMPARE_METRICS)rg)rr=rrrr#r$rprrrZMagickGetImageDistortionrrr4)rr r metric_idxdistokrrrget_image_distortions    zBaseImage.get_image_distortioncCst|tstdt||dkr4t|j|j}nR||}tdkrZt |j||j}n,t |j|}t|j|j}t |j||S)aReplace color values by referencing a Higher And Lower Dimension (HALD) Color Look Up Table (CLUT). You can generate a HALD image by using ImageMagick's `hald:` protocol. :: with Image(filename='rose:') as img: with Image(filename='hald:3') as hald: hald.gamma(1.367) img.hald_clut(hald) :param image: The HALD color matrix. :type image: :class:`wand.image.BaseImage` :param channel: Optional color channel to target. See :const:`CHANNELS` :type channel: :class:`basestring` .. versionadded:: 0.5.0 .. versionchanged:: 0.5.5 Added ``channel`` argument. zexpecting a base image, not Ni) rr=rrrZMagickHaldClutImagerrrZMagickHaldClutImageChannelr)rr rrrrrrr hald_cluts    zBaseImage.hald_clut(cCsDtjdkrd}t||dkr"|}tj|||dt|j|||S)aIdentify lines within an image. Use :meth:`canny` to reduce image to a binary edge before calling this method. .. warning:: This class method is only available with ImageMagick 7.0.8-41, or greater. :param width: Local maxima of neighboring pixels. :type width: :class:`numbers.Integral` :param height: Local maxima of neighboring pixels. :type height: :class:`numbers.Integral` :param threshold: Line count to limit. Default to 40. :type threshold: :class:`numbers.Integral` :raises WandLibraryVersionError: If system's version of ImageMagick does not support this method. .. versionadded:: 0.5.5 Nz8Method requires ImageMagick version 7.0.8-41 or greater.)rrr)rZMagickHoughLineImagerrr[r)rrrrrrrr hough_liness  zBaseImage.hough_linescCs |||S)zVAlias for :meth:`inverse_fourier_transform`. .. versionadded:: 0.5.7 )inverse_fourier_transform)rphaserrrriftsz BaseImage.iftcCsRtj|dtjtd|dtdkr4t|j|}nt|}t|j||}|S)a(Creates a "imploding" effect by pulling pixels towards the center of the image. :see: Example of :ref:`implode`. :param amount: Normalized degree of effect between `0.0` & `1.0`. :type amount: :class:`numbers.Real` :param method: Which interpolate method to apply to effected pixels. See :const:`PIXEL_INTERPOLATE_METHODS` for a list of options. Only available with ImageMagick-7. :type method: :class:`basestring` .. versionadded:: 0.5.2 )amountz$wand.image.PIXEL_INTERPOLATE_METHODS)rci) rrQr#r6rrZMagickImplodeImagerrp)rrqrcrrarrrimplode$s  zBaseImage.imploderc Cs>|j\}} |dkr|}|dkr"| }tj||||dtjtd|dtj|d|}d} x$|D]} | | krbtdt| qbWt |t j st dt|||t |} t |} | | krd | | }t|dtjtjtjtjtjtjtjg}t|}||}t |||}t|j||||t||t|}|S) a_Import pixel data from a byte-string to the image. The instance of :class:`Image` must already be allocated with the correct size. The ``channel_map`` tells ImageMagick which color channels to export, and what order they should be written as -- per pixel. Valid entries for ``channel_map`` are: - ``'R'`` - Red channel - ``'G'`` - Green channel - ``'B'`` - Blue channel - ``'A'`` - Alpha channel (``0`` is transparent) - ``'O'`` - Alpha channel (``0`` is opaque) - ``'C'`` - Cyan channel - ``'Y'`` - Yellow channel - ``'M'`` - Magenta channel - ``'K'`` - Black channel - ``'I'`` - Intensity channel (only for grayscale) - ``'P'`` - Padding See :const:`STORAGE_TYPES` for a list of valid ``storage`` options. This tells ImageMagick what type of data it should calculate & write to. For example; a storage type of ``'char'`` will write a 8-bit value between 0 ~ 255, a storage type of ``'short'`` will write a 16-bit value between 0 ~ 65535, and a ``'integer'`` will write a 32-bit value between 0 ~ 4294967295. .. note:: By default, the entire image will be exported as ``'char'`` storage with each pixel mapping Red, Green, Blue, & Alpha channels. :param x: horizontal starting coordinate of raster. :type x: :class:`numbers.Integral` :param y: vertical starting coordinate of raster. :type y: :class:`numbers.Integral` :param width: horizontal length of raster. :type width: :class:`numbers.Integral` :param height: vertical length of raster. :type height: :class:`numbers.Integral` :param channel_map: a string listing the channel data format for each pixel. :type channel_map: :class:`basestring` :param storage: what data type each value should be calculated as. :type storage: :class:`basestring` .. versionadded:: 0.5.0 N)rrrrzwand.image.STORAGE_TYPES)rC)rrDzUnknown channel label: zdata must list of values, notz#data length should be {0}, not {1}.)rrrAr#r:rRrUrrrrr8rrrrrErrFrGrHrIrprrrr r)rrrrrrrCrrJrKrLr expected_lenZ given_lenrrMrZc_typerNrrrr import_pixels?sT9       zBaseImage.import_pixelscCs8t|tstdt|tj|dt|j|j|S)a.Applies the inverse of a discrete Fourier transform. The image stack is replaced with the results. Either a pair of magnitude & phase images, or real & imaginary (HDRI). .. code:: from wand.image import Image with Image(filename='magnitude.png') as img: with Image(filename='phase.png') as phase: img.inverse_fourier_transform(phase) img.save(filename='output.png') .. seealso:: :meth:`forward_fourier_transform` & :meth:`complex` .. note:: ImageMagick must have HDRI support to compute real & imaginary components (i.e. ``magnitude=False``). :param phase: Second part (image) of the transform. Either the phase, or the imaginary part. :type phase: :class:`BaseImage` :param magnitude: If ``True``, accept magnitude & phase input, else real & imaginary. Default ``True`` :type magnitude: :class:`bool` .. versionadded:: 0.5.5 zphase must be an image, not )r) rr=rrrr,rZ"MagickInverseFourierTransformImager)rrorrrrrns   z#BaseImage.inverse_fourier_transformcCst|jdS)zSets the internal image-stack iterator to the first image. Useful for prepending an image at the start of the stack. .. versionadded:: 0.6.2 N)rZMagickSetFirstIteratorr)rrrriterator_firstszBaseImage.iterator_firstcCs t|jS)zReturns the position of the internal image-stack index. :rtype: :class:`int` .. versionadded:: 0.6.2 )rr%r)rrrr iterator_getszBaseImage.iterator_getcCst|jdS)zSets the internal image-stack iterator to the last image. Useful for appending an image to the end of the stack. .. versionadded:: 0.6.2 N)rr$r)rrrr iterator_lastszBaseImage.iterator_lastcCs t|jS)zsGet the count of images in the image-stack. :rtype: :class:`int` .. versionadded:: 0.6.2 )rr.r)rrrriterator_lengthszBaseImage.iterator_lengthcCs2t|j}|r.t|j}t|j|d}|S)zsSteps the image-stack index forward by one :rtype: :class:`bool` .. versionadded:: 0.6.2 r)rZMagickHasNextImagerr%r')rZhas_nextrrrr iterator_nexts   zBaseImage.iterator_nextcCs2t|j}|r.t|j}t|j|d}|S)zqSteps the image-stack index back by one. :rtype: :class:`bool` .. versionadded:: 0.6.2 r)rZMagickHasPreviousImagerr%r')rZhas_prevrrrriterator_previouss   zBaseImage.iterator_previouscCst|jdS)zReset internal image-stack iterator. Useful for iterating over the image-stack without allocating :class:`~wand.sequence.Sequence`. .. versionadded:: 0.6.2 N)rr&r)rrrriterator_reset szBaseImage.iterator_resetcCstj|dt|j|S)ztSets the index of the internal image-stack. :rtype: :class:`bool` .. versionadded:: 0.6.2 )rp)rrArr'r)rrprrr iterator_sets zBaseImage.iterator_setd{Gz?cCsJtdkstjdkrd}t|tj||dtj|dt|j|||S)aReduces the number of colors in an image by appling the K-means clustering algorithm. .. note:: Requires ImageMagick-7.0.10-37, or later. :param number_colors: the target number of colors to use as seeds. :type number_colors: :class:`numbers.Integral` :param max_iterations: maximum number of iterations needed until convergence. Default ``100``. :type max_iterations: :class:`numbers.Integral` :param tolerance: maximum tolerance between distrotion iterations. Default ``0.01`` :type tolerance: :class:`numbers.Real` .. versionadded:: 0.6.4 i Nz/Kmeans requires ImageMagick-7.0.10-37 or later.) number_colorsmax_iterations) tolerance)rrZMagickKmeansImagerrr[rQr)rrrrrrrrkmeanss  zBaseImage.kmeansrxcCs||}td}td}tdkrFt|j|t|t|n8t|j|}t |jt|t|t|j||j |j fS)aECalculates the kurtosis and skewness of the image. .. code:: python from wand.image import Image with Image(filename='input.jpg') as img: kurtosis, skewness = img.kurtosis_channel() :param channel: Select which color channel to evaluate. See :const:`CHANNELS`. Default ``'default_channels'``. :type channel: :class:`basestring` :returns: Tuple of :attr:`kurtosis` & :attr:`skewness` values. :rtype: :class:`tuple` .. versionadded:: 0.5.3 gi) rrrrrZMagickGetImageChannelKurtosisrrrZMagickGetImageKurtosisr4)rrrbrerrrrrrd9s     zBaseImage.kurtosis_channelcCsDtjdkrd}t||dkr&|d}tj||dt|j||S)aEdge preserving noise reduction filter. https://en.wikipedia.org/wiki/Kuwahara_filter If ``sigma`` is not given, the value will be calculated as: sigma = radius - 0.5 To match original algorithm's behavior, increase ``radius`` value by one: myImage.kuwahara(myRadius + 1, mySigma) .. warning:: This class method is only available with ImageMagick 7.0.8-41, or greater. :see: Example of :ref:`kuwahara`. :param radius: Size of the filter aperture. :type radius: :class:`numbers.Real` :param sigma: Standard deviation of Gaussian filter. :type sigma: :class:`numbers.Real` :raises WandLibraryVersionError: If system's version of ImageMagick does not support this method. .. versionadded:: 0.5.5 Nz8Method requires ImageMagick version 7.0.8-41 or greater.g?)rr)rZMagickKuwaharaImagerrrQr)rrrrrrrkuwahara^s zBaseImage.kuwaharac Cstj|d|dkrd|}tj||dt|j|}t|j|}trZ|d8}|d8}|dkrvt|j|||}nT||}tj rt |j||||}n.t |j|} t|j|||}t |j| |S)aAdjusts the levels of an image by scaling the colors falling between specified black and white points to the full available quantum range. If only ``black`` is given, ``white`` will be adjusted inward. :see: Example of :ref:`level`. :param black: Black point, as a percentage of the system's quantum range. Defaults to 0. :type black: :class:`numbers.Real` :param white: White point, as a percentage of the system's quantum range. Defaults to 1.0. :type white: :class:`numbers.Real` :param gamma: Optional gamma adjustment. Values > 1.0 lighten the image's midtones while values < 1.0 darken them. :type gamma: :class:`numbers.Real` :param channel: The channel type. Available values can be found in the :const:`CHANNELS` mapping. If ``None``, normalize all channels. :type channel: :const:`CHANNELS` .. note:: Images may not be affected if the ``white`` value is equal to or less than the ``black`` value. .. versionadded:: 0.4.1 )roNg?)rrg?) rrQrrrrZMagickLevelImagerrZMagickLevelImageChannelr) rrorrrbpZwprrrrrrlevels.  zBaseImage.levelc Cstjdkrd}t|t|tr(t|}t|tr:t|}tj||dd}|dk rl||}t |j |}|,|t|j |j |j d}WdQRXWdQRX|dk rt |j ||S)aMaps given colors to "black" & "white" values. .. warning:: This class method is only available with ImageMagick 7.0.8-54, or greater. :param black_color: linearly map given color as "black" point. :type black_color: :class:`Color` :param white_color: linearly map given color as "white" point. :type white_color: :class:`Color` :param channel: target a specific color-channel to levelize. :type channel: :class:`basestring` :raises WandLibraryVersionError: If system's version of ImageMagick does not support this method. .. versionadded:: 0.5.6 Nz8Method requires ImageMagick version 7.0.8-54 or greater.) black_color white_colorF) rMagickLevelImageColorsrrr rrrrrrr2)rrrrrrrrrrr level_colorss.    zBaseImage.level_colorsc Cstjdkrd}t||dkr(t|j}tj|||dd|krLdkrZnn ||j9}d|krndkr|nn ||j9}|dkrt|j|||}n8||}t |j|}t|j|||}t |j||S)aReverse of :meth:`level()`, this method compresses the range of colors between ``black`` & ``white`` values. If only ``black`` is given, ``white`` will be adjusted inward. .. warning:: This class method is only available with ImageMagick 7.0.8-41, or greater. :param black: Black point, as a percentage of the system's quantum range. Defaults to 0. :type black: :class:`numbers.Real` :param white: White point, as a percentage of the system's quantum range. Defaults to 1.0. :type white: :class:`numbers.Real` :param gamma: Optional gamma adjustment. Values > 1.0 lighten the image's midtones while values < 1.0 darken them. :type gamma: :class:`numbers.Real` :param channel: The channel type. Available values can be found in the :const:`CHANNELS` mapping. If ``None``, normalize all channels. :type channel: :const:`CHANNELS` :raises WandLibraryVersionError: If system's version of ImageMagick does not support this method. .. versionadded:: 0.5.5 Nz8Method requires ImageMagick version 7.0.8-41 or greater.)rorrrg?) rZMagickLevelizeImagerrrrrQrrr) rrorrrrrrrrrrlevelizes$     zBaseImage.levelizec Cstjdkrd}t|t|tr(t|}t|tr:t|}tj||dd}d}|dk rp||}t |j |}|,|t|j |j |j d}WdQRXWdQRX|dk rt |j ||S)a Reverse of :meth:`level_colors()`, and creates a de-contrasting gradient of given colors. This works best with grayscale images. .. warning:: This class method is only available with ImageMagick 7.0.8-54, or greater. :param black_color: tint map given color as "black" point. :type black_color: :class:`Color` :param white_color: tint map given color as "white" point. :type white_color: :class:`Color` :param channel: target a specific color-channel to levelize. :type channel: :class:`basestring` :raises WandLibraryVersionError: If system's version of ImageMagick does not support this method. .. versionadded:: 0.5.6 Nz8Method requires ImageMagick version 7.0.8-54 or greater.)rrT) rrrrr rrrrrrr2)rrrrrrrrrrrlevelize_colors#s0    zBaseImage.levelize_colorscCs6tj||dt|j|j}t|j||||S)aHEnhance saturation intensity of an image. :param black_point: Black point between 0.0 and 1.0. Default 0.0 :type black_point: :class:`numbers.Real` :param white_point: White point between 0.0 and 1.0. Default 1.0 :type white_point: :class:`numbers.Real` .. versionadded:: 0.4.1 )rr)rrQrrrrZMagickLinearStretchImager)rrrZ linear_rangerrrlinear_stretchRs zBaseImage.linear_stretchc Csttj||dtj||dt|j||||y |Wn2tk rn}ztt|dWdd}~XYnXdS)aRescales the image with `seam carving`_, also known as image retargeting, content-aware resizing, or liquid rescaling. :param width: the width in the scaled image :type width: :class:`numbers.Integral` :param height: the height in the scaled image :type height: :class:`numbers.Integral` :param delta_x: maximum seam transversal step. 0 means straight seams. default is 0 :type delta_x: :class:`numbers.Real` :param rigidity: introduce a bias for non-straight seams. default is 0 :type rigidity: :class:`numbers.Real` :raises wand.exceptions.MissingDelegateError: when ImageMagick isn't configured ``--with-lqr`` option. .. note:: This feature requires ImageMagick to be configured ``--with-lqr`` option. Or it will raise :exc:`~wand.exceptions.MissingDelegateError`: .. seealso:: `Seam carving`_ --- Wikipedia The article which explains what seam carving is on Wikipedia. .. _Seam carving: http://en.wikipedia.org/wiki/Seam_carving )rr)delta_xrigidityz ImageMagick in the system is likely to be impossible to load liblqr. You might not install liblqr, or ImageMagick may not compiled with liblqr.N) rrArQrZMagickLiquidRescaleImagerrrr)rrrrrrrrrliquid_rescalees!  zBaseImage.liquid_rescale )@cCs4tjdkrd}t|tj||dt|j||S)aHIncrease light-dark transitions within image. .. warning:: This class method is only available with ImageMagick 6.9.3, or greater. :param radius: The size of the Gaussian operator. Default value is ``10.0``. :type radius: :class:`numbers.Real` :param strength: Percentage of blur mask to apply. Values can be between ``0.0`` and ``100`` with a default of ``12.5``. :type strength: :class:`numbers.Real` .. versionadded:: 0.5.7 Nz5Method requires ImageMagick version 6.9.3 or greater.)rstrength)rZMagickLocalContrastImagerrrQr)rrrrrrrlocal_contrasts  zBaseImage.local_contrastcCs t|jS)zQuickly double an image in size. This is a convenience method. Use :meth:`resize()`, :meth:`resample()`, or :meth:`sample()` for more control. .. versionadded:: 0.5.5 )rZMagickMagnifyImager)rrrrmagnifys zBaseImage.magnifycCs||}td}td}tdkrFt|j|t|t|n8t|j|}t |jt|t|t|j||j |j fS)aCalculates the mean and standard deviation of the image. .. code:: python from wand.image import Image with Image(filename='input.jpg') as img: mean, stddev = img.mean_channel() :param channel: Select which color channel to evaluate. See :const:`CHANNELS`. Default ``'default_channels'``. :type channel: :class:`basestring` :returns: Tuple of :attr:`mean` & :attr:`standard_deviation` values. The ``mean`` value will be between 0.0 & :attr:`quantum_range` :rtype: :class:`tuple` .. versionadded:: 0.5.3 gi) rrrrrZMagickGetImageChannelMeanrrrZMagickGetImageMeanr4)rrrbrprrrrrros     zBaseImage.mean_channelcCsdtjdkrd}t|tj||dtj|dd|krDdkrRnn ||j9}t|j|||S)aVRecalculates pixel value by comparing neighboring pixels within a color distance, and replacing with a mean value. Works best with Gray, YCbCr, YIQ, or YUV colorspaces. .. warning:: This class method is only available with ImageMagick 7.0.8-41, or greater. :param width: Size of the neighborhood window in pixels. :type width: :class:`numbers.Integral` :param height: Size of the neighborhood window in pixels. :type height: :class:`numbers.Integral` :param color_distance: Include pixel values within this color distance. :type color_distance: :class:`numbers.Real` :raises WandLibraryVersionError: If system's version of ImageMagick does not support this method. .. versionadded:: 0.5.5 Nz8Method requires ImageMagick version 7.0.8-41 or greater.)rr)color_distancerg?)rZMagickMeanShiftImagerrr0rQrr)rrrrrrrr mean_shifts    zBaseImage.mean_shiftcCsNtj|d|dkrtdt|}t|j|}|rF||_|t |S)aComposes all the image layers from the current given image onward to produce a single image of the merged layers. The initial canvas's size depends on the given ImageLayerMethod, and is initialized using the first images background color. The images are then composited onto that image in sequence using the given composition that has been assigned to each individual image. The method must be set with a value from :const:`IMAGE_LAYER_METHOD` that is acceptable to this operation. (See ImageMagick documentation for more details.) :param method: the method of selecting the size of the initial canvas. :type method: :class:`basestring` .. versionadded:: 0.4.3 )rc)r7rVr8r9z@method can only be 'merge', 'flatten', 'mosaic', or 'trimbounds') rrRrr.rprZMagickMergeImageLayersrrr)rrcrprrrr merge_layerss  zBaseImage.merge_layersc Csti}tdkrd}t||H}|dk rl|dkrPd}|dt|7}t|d}t|}t|j||d}|d 7}|d 7}|d 7}|d 7}|d 7}t |jd|t |jdt }t |jt |} | r^t | |j} t| } | ddd} | dd} dd| D}ttdd| dd} dddddg}tt|| |d}n|WdQRX|S)uFind the minmum bounding box within the image. Use properties :attr:`fuzz` & :attr:`background_color` to influence bounding box thresholds. .. code:: from wand.image import Image from wand.drawing import Drawing with Image(filename='kdf_black.png') as img: img.fuzz = img.quantum_range * 0.1 img.background_color = 'black' mbr = img.minimum_bounding_box() with Drawing() as ctx: ctx.fill_color = 'transparent' ctx.stroke_color = 'red' ctx.polygon(points=mbr['points']) ctx.fill_color = 'red' ctx.stroke_color = 'transparent' ctx.text(1, 10, '{0:.4g}°'.format(mbr['angle'])) ctx(img) img.save(filename='kdf_black_mbr.png') .. image:: ../_images/wand/image/kdf_black.png .. image:: ../_images/wand/image/kdf_black_mbr.png .. note:: Requires ImageMagick-7.0.10 or later. :param orientation: sets the image orientation. Values can be ``'landscape'``, or ``'portrait'``. :type orientation: :class:`basestring` :returns: a directory of MBR properties & corner points. :rtype: :class:`dict` { "points": :class:`list` [ :class:`tuple` ( :class:`float`, :class:`float` ) ], "area": :class:`float`, "width": :class:`float`, "height": :class:`float`, "angle": :class:`float`, "unrotate": :class:`float` } .. versionadded:: 0.6.4 i z4ImageMagick-7.0.10 is required to use convex_hull().N)Z landscapeZportraitz3orientation can only be landscape, or portrait, notr s minimum-bounding-box:orientations%[minimum-bounding-box]s|%[minimum-bounding-box:area]s|%[minimum-bounding-box:width]s|%[minimum-bounding-box:height]s|%[minimum-bounding-box:angle]s!|%[minimum-bounding-box:unrotate]sformatsINFOrr|rcSs$g|]}ttdd|dqS)cSst|S)N)r)rrrrr!er"z;BaseImage.minimum_bounding_box...r)rr#r$)rr5rrrr%esz2BaseImage.minimum_bounding_box..cSs t|S)N)rrS)rrrrr!fr"z0BaseImage.minimum_bounding_box..rarearrrZunrotate)Zpoints)rrrrrrrrrr&rTrrhr'rrOr4rPr(r$rSrr#rrr)rrrrrr)rrZmbr_strr*r+r,partsr-attrrVrrrminimum_bounding_boxsF*   zBaseImage.minimum_bounding_boxcCs|dkr |}|d||dS)aReplace each pixel with the mathematical mode of the neighboring colors. This is an alias of the :meth:`statistic` method. :param width: Number of neighboring pixels to include in mode. :type width: :class:`numbers.Integral` :param height: Optional height of neighboring pixels, defaults to the same value as ``width``. :type height: :class:`numbers.Integral` .. versionadded:: 0.5.4 Nr) statistic)rrrrrrrms zBaseImage.modeY@cCs"tj|||dt|j|||S)a'Changes the brightness, saturation and hue of an image. We modulate the image with the given ``brightness``, ``saturation`` and ``hue``. :param brightness: percentage of brightness :type brightness: :class:`numbers.Real` :param saturation: percentage of saturation :type saturation: :class:`numbers.Real` :param hue: percentage of hue rotation :type hue: :class:`numbers.Real` :raises ValueError: when one or more arguments are invalid .. versionadded:: 0.3.4 )rrr)rrQrZMagickModulateImager)rrrrrrrr~szBaseImage.modulatecCstj||dtj|dd}d}|d}|dtkrT|d}t|dkrT|d}t}|rt|} t } t t |t | } |d kr| | j@dkrd | _n:|d kr| | j@dkrd | _n|d kr| | j@dkrd | _n|d krp| | j@dkr| j| _| jd krd| _| jd kr.| j| _| | j@dkrN| jd d| _| | j@dkr| jd d| _nr|dkr| | j@dkrd| _nP| | j@dkrt|j| jd | _n(| | j@dkr| jt|jd9_tdkrt| t | } nt| t | |} n0|rFtdkr6tt |} ntt ||} d} t|}| rt|}|dkrt |j!||| } nX|"|}tdkrt#|j!|||| } n.t$|j!|}t |j!||| } t$|j!|t%| } nt&dt'|| S)a Manipulate pixels based on the shape of neighboring pixels. The ``method`` determines what type of effect to apply to matching ``kernel`` shapes. Common methods can be add/remove, or lighten/darken pixel values. The ``kernel`` describes the shape of the matching neighbors. Common shapes are provided as "built-in" kernels. See :const`KERNEL_INFO_TYPES` for examples. The format for built-in kernels is: .. sourcecode:: text label:geometry Where `label` is the kernel name defined in :const:`KERNEL_INFO_TYPES`, and `:geometry` is an optional geometry size. For example:: with Image(filename='rose:') as img: img.morphology(method='dilate', kernel='octagon:3x3') # or simply img.morphology(method='edgein', kernel='octagon') Custom kernels can be applied by following a similar format: .. sourcecode:: text geometry:args Where `geometry` is the size of the custom kernel, and `args` list a comma separated list of values. For example:: custom_kernel='5x3:nan,1,1,1,nan 1,1,1,1,1 nan,1,1,1,nan' with Image(filename='rose:') as img: img.morphology(method='dilate', kernel=custom_kernel) :param method: effect function to apply. See :const:`MORPHOLOGY_METHODS` for a list of methods. :type method: :class:`basestring` :param kernel: shape to evaluate surrounding pixels. See :const:`KERNEL_INFO_TYPES` for a list of built-in shapes. :type kernel: :class:`basestring` :param iterations: Number of times a morphology method should be applied to the image. Default ``1``. Use ``-1`` for unlimited iterations until the image is unchanged by the method operator. :type iterations: :class:`numbers.Integral` :param channel: Optional color channel to target. See :const:`CHANNELS` :type channel: `basestring` .. versionadded:: 0.5.0 .. versionchanged:: 0.5.5 Added ``channel`` argument. )rcr)rkN:rr^r)rDg?)rOrNrQrRrrS)rT)rPg@g@)r_r`rarbgY@iz Unable to parse kernel info for )(rrRrAr$r1rrrrprrr rrZRhoValuerrrZXiValuexiZPsiValuepsiZ AspectValuerrZ PercentValuerZAcquireKernelBuiltInrrr2rZMagickMorphologyImagerrZMagickMorphologyImageChannelrrrr)rrcrrkrZbuitinrrrZ kernel_idxrrrrrarrrrr morphologys=                          zBaseImage.morphologycCstj|||d|dkr,t|j|||}nV||}tdkrTt|j||||}n.t|j|}t|j|||}t|j||S)aApply a Gaussian blur along an ``angle`` direction. This simulates motion movement. :see: Example of :ref:`motion_blur`. :param radius: Aperture size of the Gaussian operator. :type radius: :class:`numbers.Real` :param sigma: Standard deviation of the Gaussian operator. :type sigma: :class:`numbers.Real` :param angle: Apply the effect along this angle. :type angle: :class:`numbers.Real` .. versionadded:: 0.5.4 )rrrNi) rrQrZMagickMotionBlurImagerrrZMagickMotionBlurImageChannelr)rrrrrrrrrrr motion_blur3s   zBaseImage.motion_blurcCsh|dkrt|j|}nL||}tjr:t|j||}n*t|j|}t|j|}t|j||S)aNegate the colors in the reference image. :param grayscale: if set, only negate grayscale pixels in the image. :type grayscale: :class:`bool` :param channel: the channel type. available values can be found in the :const:`CHANNELS` mapping. If ``None``, negate all channels. :type channel: :class:`basestring` .. versionadded:: 0.3.8 N)rZMagickNegateImagerrZMagickNegateImageChannelr)rr;rrrrrrrnegateYs  zBaseImage.negater{cCstjtd|dtj|dt|}tdkrb|dkrFt|j|}q| |}t |j||}nP|dkr|t|j||}n6| |}t |j|}t|j||}t |j||S)aAdds noise to image. :see: Example of :ref:`noise`. :param noise_type: type of noise to apply. See :const:`NOISE_TYPES`. :type noise_type: :class:`basestring` :param attenuate: rate of distribution. Only available in ImageMagick-7. Default is ``1.0``. :type attenuate: :class:`numbers.Real` :param channel: Optionally target a color channel to apply noise to. See :const:`CHANNELS`. :type channel: :class:`basestring` .. versionadded:: 0.5.3 .. versionchanged:: 0.5.5 Added optional ``channel`` argument. zwand.image.NOISE_TYPES) noise_type) attenuateiN) rr#r3rQrprrZMagickAddNoiseImagerrZMagickAddNoiseImageChannelr)rrrrZnoise_type_idxrrrrrrnoisexs*      zBaseImage.noisec Cs|dkrt|j}n||}tjr6t|j|}ndt|dT}t|j|}t|j}t|j|td|}t |j|j|dddWdQRX|S)aNormalize color channels. :param channel: the channel type. available values can be found in the :const:`CHANNELS` mapping. If ``None``, normalize all channels. :type channel: :class:`basestring` N)r Zcopy_Fr) rZMagickNormalizeImagerrZMagickNormalizeImageChannelrBrr%rpr)rrrrrrZ copy_maskrrr normalizes&    zBaseImage.normalizecCs:tj||dtdkr&t|j|}nt|j||}|S)aSimulates an oil painting by replace each pixel with most frequent surrounding color. :param radius: The size of the surrounding neighbors. :type radius: :class:`numbers.Real` :param sigma: The standard deviation used by the Gaussian operator. This is only available with ImageMagick-7. :type sigma: :class:`numbers.Real` .. versionadded:: 0.5.4 )rri)rrQrrZMagickOilPaintImager)rrrrrrr oil_paints zBaseImage.oil_paintc Cst|trt|}t|tr$t|}tj||dtj|dtj|d|||dkrxt|j |j |j ||}nb| |}t dkrt |j ||j |j ||}n4t|j |}t|j |j |j ||}t|j |WdQRXWdQRX|S)aReplace any color that matches ``target`` with ``fill``. Use ``fuzz`` to control the threshold of the target match. The ``invert`` will replace all colors *but* the pixels matching the ``target`` color. :param target: The color to match. :type target: :class:`wand.color.Color` :param fill: The color to paint with. :type fill: :class:`wand.color.Color` :param fuzz: Normalized real number between `0.0` and :attr:`quantum_range`. Default is `0.0`. :type fuzz: class:`numbers.Real` :param invert: Replace all colors that do not match target. Default is ``False``. :type invert: :class:`bool` :param channel: Optional color channel to target. See :const:`CHANNELS` :type channel: :class:`basestring` .. versionadded:: 0.5.4 .. versionchanged:: 0.5.5 Added ``channel`` paramater. )targetr)r)invertNi)rr rrrrQr,rZMagickOpaquePaintImagerr2rrZMagickOpaquePaintImageChannelr) rrrrrrrrrrrr opaque_paints:      "zBaseImage.opaque_paintcCs&t|j}|r||_|t|S)aAttempts to crop each frame to the smallest image without altering the animation. For best results, call :meth:`Image.coalesce() ` before manipulating any frames. For timing accuracy, any :attr:`SingleImage.delay ` overwrites must be applied after optimizing layers. .. note:: This will only affect ``GIF`` image formates. .. versionadded:: 0.5.0 )rZMagickOptimizeImageLayersrrr)rrrrroptimize_layerss  zBaseImage.optimize_layerscCstjrt|jStddS)zIterates over frames, and sets transparent values for each pixel unchanged by previous frame. .. note:: This will only affect ``GIF`` image formates. .. versionadded:: 0.5.0 zY`MagickOptimizeImageTransparency' not available on current version of MagickWand library.N)rZMagickOptimizeImageTransparencyrr)rrrroptimize_transparency2s  zBaseImage.optimize_transparencyrcCstj|dt|}tdkrP|dkr4t|j|}q||}t|j||}nL|dkrht |j|}n4||}t |j|}t |j|}t |j||S)a~ Executes a ordered-based dither operations based on predetermined threshold maps. +-----------+-------+-----------------------------+ | Map | Alias | Description | +===========+=======+=============================+ | threshold | 1x1 | Threshold 1x1 (non-dither) | +-----------+-------+-----------------------------+ | checks | 2x1 | Checkerboard 2x1 (dither) | +-----------+-------+-----------------------------+ | o2x2 | 2x2 | Ordered 2x2 (dispersed) | +-----------+-------+-----------------------------+ | o3x3 | 3x3 | Ordered 3x3 (dispersed) | +-----------+-------+-----------------------------+ | o4x4 | 4x4 | Ordered 4x4 (dispersed) | +-----------+-------+-----------------------------+ | o8x8 | 8x8 | Ordered 8x8 (dispersed) | +-----------+-------+-----------------------------+ | h4x4a | 4x1 | Halftone 4x4 (angled) | +-----------+-------+-----------------------------+ | h6x6a | 6x1 | Halftone 6x6 (angled) | +-----------+-------+-----------------------------+ | h8x8a | 8x1 | Halftone 8x8 (angled) | +-----------+-------+-----------------------------+ | h4x4o | | Halftone 4x4 (orthogonal) | +-----------+-------+-----------------------------+ | h6x6o | | Halftone 6x6 (orthogonal) | +-----------+-------+-----------------------------+ | h8x8o | | Halftone 8x8 (orthogonal) | +-----------+-------+-----------------------------+ | h16x16o | | Halftone 16x16 (orthogonal) | +-----------+-------+-----------------------------+ | c5x5b | c5x5 | Circles 5x5 (black) | +-----------+-------+-----------------------------+ | c5x5w | | Circles 5x5 (white) | +-----------+-------+-----------------------------+ | c6x6b | c6x6 | Circles 6x6 (black) | +-----------+-------+-----------------------------+ | c6x6w | | Circles 6x6 (white) | +-----------+-------+-----------------------------+ | c7x7b | c7x7 | Circles 7x7 (black) | +-----------+-------+-----------------------------+ | c7x7w | | Circles 7x7 (white) | +-----------+-------+-----------------------------+ :param threshold_map: Name of threshold dither to use, followed by optional arguments. :type threshold_map: :class:`basestring` :param channel: Optional argument to apply dither to specific color channel. See :const:`CHANNELS`. :type channel: :class:`basestring` .. versionadded:: 0.5.7 ) threshold_mapiN) rrRr rrZMagickOrderedPosterizeImagerrZ"MagickOrderedPosterizeImageChannelZMagickOrderedDitherImager)rrrZbmaprrrrrrordered_ditherEs"9   zBaseImage.ordered_ditherc Cstj|dtd}td}t|j}t|j}tt |t |t |t |t |}t |svt d|j |j |j |j fS)aBHelper method to translate geometry format, and calculate meta-characters against image dimensions. See "Image Geometry" definitions & examples for more info: https://imagemagick.org/script/command-line-processing.php#geometry :param geometry: user string following ImageMagick's geometry format. :type geometry: :class:`basestring` :returns: Calculated width, height, offset-x, & offset-y. :rtype: :class:`tuple` :raises ValueError: If given geometry can not be parsed. .. versionadded:: 0.5.6 )rrzUnable to parse geometry)rrRrrsrhrrrParseMetaGeometryr rrrr4)rrrrrrrrrrparse_meta_geometrys       zBaseImage.parse_meta_geometrycCsH|j|jd}x |D]\}}|||}qW||jd<t|dS)a(Convenience method that expands ImageMagick's `Percent Escape`_ characters into image attribute values. .. _Percent Escape: https://imagemagick.org/script/escape.php .. code:: with wand.image import Image with Image(filename='tests/assets/sasha.jpg') as img: print(img.percent_escape('%f %wx%h')) #=> sasha.jpg 204x247 .. note:: Not all percent escaped values can be populated as I/O operations are managed by Python, and not the CLI utility. :param string_format: The precent escaped string to be translated. :type string_format: :class:`basestring` :returns: String of expanded values. :rtype: :class:`basestring` .. versionadded:: 0.5.6 )z%mz %[magick]rINFO)ritemsrrr make_blob)rZ string_formatZlocal_overwritesrevrrrpercent_escapes   zBaseImage.percent_escapec CsVtj|dtjtd|dt}|rtj|dt|}t|j d|t |t r|j rpt |t|j |jrt||j|jr|jt||jjWdQRXt||j|jr|jt||jjWdQRX|jrt||jn|rtdt|tdkr*t|j ||}nt|}t|j ||||}t|}|S) a/Creates a special effect simulating a Polaroid photo. :see: Example of :ref:`polaroid`. :param angle: applies a shadow effect along this angle. :type angle: :class:`numbers.Real` :param caption: Writes a message at the bottom of the photo's border. :type caption: :class:`basestring` :param font: Specify font style. :type font: :class:`wand.font.Font` :param method: Interpolation method. ImageMagick-7 only. :type method: :class:`basestring` .. versionadded:: 0.5.4 )rz$wand.image.PIXEL_INTERPOLATE_METHODS)rc)r}sCaptionNz0font must be in instance of wand.font.Font, not i)rrQr#r6rZNewDrawingWandrRr MagickSetImagePropertyrrrrFZ DrawSetFontrZDrawSetFontSizerZDrawSetFillColorr2ZDrawSetTextAntialiasr+rGZDrawSetStrokeColorrHZDrawSetStrokeWidthrrrZMagickPolaroidImagerpZDestroyDrawingWand)rrr}rLrcZctx_ptrrrarrrpolaroidsF        zBaseImage.polaroidcCs\tjdkrd}t|t|tjs2tdt|t|}t j ||}t|j |d?|S)aBReplace image with the sum of all images in a sequence by calculating the pixel values a coefficient-weight value, and a polynomial-exponent. For example:: with Image(filename='rose:') as img: img.polynomial(arguments=[0.5, 1.0]) The output image will be calculated as: .. math:: output = 0.5 * image ^ {1.0} This can work on multiple images in a sequence by calculating across each frame in the image stack. .. code:: with Image(filename='2frames.gif') as img: img.polynomial(arguments=[0.5, 1.0, 0.25, 1.25]) Where the results would be calculated as: .. math:: output = 0.5 * frame1 ^ {1.0} + 0.25 * frame2 ^ {1.25} .. warning:: This class method is only available with ImageMagick 7.0.8-41, or greater. :param arguments: A list of real numbers where at least two numbers (weight & exponent) are need for each image in the sequence. :type arguments: :class:`collections.abc.Sequence` :raises WandLibraryVersionError: If system's version of ImageMagick does not support this method. .. versionadded:: 0.5.5 Nz8Method requires ImageMagick version 7.0.8-41 or greater.z"expected sequence of doubles, not r) rZMagickPolynomialImagerrrr8rrrrrr)rrrr;r<rrrr s.   zBaseImage.polynomialrcCs6tj|dtjtd|dt|}t|j||S)a6Reduce color levels per channel. :param levels: Number of levels per channel. :type levels: :class:`numbers.Integral` :param dither: Dither method to apply. See :const:`DITHER_METHODS`. :type dither: `basestring` .. versionadded:: 0.5.0 )levelszwand.image.DITHER_METHODS)r)rrAr#r)rprZMagickPosterizeImager)rrrZ dither_idxrrr posterizeBs  zBaseImage.posterizecCstj|d|dkr|j}tjtd|dtj|dtdkrLtj|dn4|dkrZd }n |d krfd }tjtd |dt|}tj|d t |j |t||||S)av`quantize` analyzes the colors within a sequence of images and chooses a fixed number of colors to represent the image. The goal of the algorithm is to minimize the color difference between the input and output image while minimizing the processing time. :param number_colors: The target number of colors to reduce the image. :type number_colors: :class:`numbers.Integral` :param colorspace_type: Available value can be found in the :const:`COLORSPACE_TYPES`. Defaults :attr:`colorspace`. :type colorspace_type: :class:`basestring` :param treedepth: A value between ``0`` & ``8`` where ``0`` will allow ImageMagick to calculate the optimal depth with ``Log4(number_colors)``. Default value is ``0``. :type treedepth: :class:`numbers.Integral` :param dither: Perform dither operation between neighboring pixel values. If using ImageMagick-6, this can be a value of ``True``, or ``False``. With ImageMagick-7, use a string from :const:`DITHER_METHODS`. Default ``False``. :type dither: :class:`bool`, or :class:`basestring` :param measure_error: Include total quantization error of all pixels in an image & quantized value. :type measure_error: :class:`bool` .. versionadded:: 0.4.2 .. versionchanged:: 0.5.9 Fixed ImageMagick-7 ``dither`` argument, and added keyword defaults. )rNzwand.image.COLORSPACE_TYPES)r<) treedepthi)rFrTrzwand.image.DITHER_METHODS) measure_error) rrArr#r#rr,r)rprZMagickQuantizeImager)rrr<rrrrrrquantizeUs,"    zBaseImage.quantizecCstj||dd|kr"dkr0nn ||j9}d|krDdkrRnn ||j9}|dkrlt|j||}nR||}tdkrt|j|||}n,t |j|}t|j||}t |j||S)aPerforms a random dither to force a pixel into a binary black & white state. Each color channel operarates independently from each other. :param low: bottom threshold. Any pixel value below the given value will be rendered "0", or no value. Given threshold value can be between ``0.0`` & ``1.0``, or ``0`` & :attr:`quantum_range`. :type low: :class:`numbers.Real` :param high: top threshold. Any pixel value above the given value will be rendered as max quantum value. Given threshold value can be between ``0.0`` & ``1.0``, or ``0`` & :attr:`quantum_range`. :type high: :class:`numbers.Real` :param channel: Optional argument to apply dither to specific color channel. See :const:`CHANNELS`. :type channel: :class:`basestring` .. versionadded:: 0.5.7 )lowhighrg?Ni) rrQrrZMagickRandomThresholdImagerrrZ!MagickRandomThresholdImageChannelr)rrrrrrbrrrrrandom_thresholds$   zBaseImage.random_thresholdcCs||}td}td}tdkrFt|j|t|t|n8t|j|}t |jt|t|t|j||j |j fS)aCalculate the minimum and maximum of quantum values in image. .. code:: python from wand.image import Image with Image(filename='input.jpg') as img: minima, maxima = img.range_channel() :param channel: Select which color channel to evaluate. See :const:`CHANNELS`. Default ``'default_channels'``. :type channel: :class:`basestring` :returns: Tuple of :attr:`minima` & :attr:`maxima` values. Each value will be between 0.0 & :attr:`quantum_range`. :rtype: :class:`tuple` .. versionadded:: 0.5.3 gi) rrrrrZMagickGetImageChannelRangerrrZMagickGetImageRanger4)rrrbZ min_colorZ max_colorrrrrrms     zBaseImage.range_channelcCstjdkrd}t||dkr"|}|dkr.|}|dkr:|}tj||||dd|kr`dkrnnn ||j9}d|krdkrnn ||j9}d|krdkrnn ||j9}d|krdkrnn ||j9}t|j||||S)a}Applies soft & hard thresholding. For a soft thresholding, parameters should be monotonically increasing: with Image(filename='text.png') as img: img.range_threshold(0.2, 0.4, 0.6, 0.8) For a hard thresholding, parameters should be the same: with Image(filename='text.png') as img: img.range_threshold(0.4, 0.4, 0.6, 0.6) .. warning:: This class method is only available with ImageMagick 7.0.8-41, or greater. :param low_black: Define the minimum threshold value. :type low_black: :class:`numbers.Real` :param low_white: Define the minimum threshold value. :type low_white: :class:`numbers.Real` :param high_white: Define the maximum threshold value. :type high_white: :class:`numbers.Real` :param high_black: Define the maximum threshold value. :type high_black: :class:`numbers.Real` :raises WandLibraryVersionError: If system's version of ImageMagick does not support this method. .. versionadded:: 0.5.5 Nz8Method requires ImageMagick version 7.0.8-41 or greater.) low_black low_white high_white high_blackrg?)rZMagickRangeThresholdImagerrrQrr)rrrrrrrrrrange_thresholds,"      zBaseImage.range_thresholdcCsVd}d}tjdkrtdn6|dkr6t|j|d}nt|trRt|j||j}|S)aSets the read mask where the gray values of the clip mask are used to blend during composite operations. Call this method with a ``None`` argument to clear any previously set masks. This method is also useful for :meth:`compare` method for limiting region of interest. .. warning:: This method is only available with ImageMagick-7. :param clip_mask: Image to reference as blend mask. :type clip_mask: :class:`BaseImage` .. versionadded:: 0.5.7 FrNzMethod requires ImageMagick-7.)rMagickSetImageMaskrrrr=)r clip_maskrZ ReadPixelMaskrrr read_masks    zBaseImage.read_maskcCsFt|tstdt|tjtd|dt|}t |j |j |S)aRebuild image palette with closest color from given affinity image. :see: Example of :ref:`remap`. :param affinity: reference image. :type affinity: :class:`BaseImage` :param method: dither method. See :const:`DITHER_METHODS`. Default is ``'no'`` dither. :type method: :class:`basestring` .. versionadded:: 0.5.3 z*Expecting affinity to be a BaseImage, not zwand.image.DITHER_METHODS)rc) rr=rrrr#r)rprZMagickRemapImager)rZaffinityrcrarrrremap;s   zBaseImage.remapc Cs|dkr|j\}}|dkr$|j\}}tj|||d|dkrNtdt|n:|dkrhtdt|n t|ttjfst dt|t|tryt |}Wn,t k rtt|dtt YnXn:t|tjr d|krt t ks ntt|d tt|}|jrt|j|_|t|jt|j}t|jxNt|dD](}t|j|t|j||||}qhWnt|j||||}|S) aAdjust the number of pixels in an image so that when displayed at the given Resolution or Density the image will still look the same size in real world terms. .. note:: This method will automatically :meth:`coalesce` & resample all frames in a GIF animation. For other image formats, :meth:`resample` will only effect the current image in the stack. Use :meth:`iterator_reset` & :meth:`iterator_next` to traverse the image stack to resample all images in a multi-layer document. .. code:: with Image(filename='input.tiff') as img: img.iterator_reset() while True: img.resample(128, 128) if not img.iterator_next(): break :param x_res: the X resolution (density) in the scaled image. default is the original resolution. :type x_res: :class:`numbers.Real` :param y_res: the Y resolution (density) in the scaled image. default is the original resolution. :type y_res: :class:`numbers.Real` :param filter: a filter type to use for resizing. choose one in :const:`FILTER_TYPES`. default is ``'undefined'`` which means IM will try to guess best one to use. :type filter: :class:`basestring`, :class:`numbers.Integral` :param blur: the blur factor where > 1 is blurry, < 1 is sharp. default is 1 :type blur: :class:`numbers.Real` .. versionadded:: 0.4.5 N)x_resy_resrrz!x_res must be a Real number, not z!y_res must be a Real number, not zPfilter must be one string defined in wand.image.FILTER_TYPES or an integer, not z) is an invalid filter type; choose on in rz is an invalid filter type)rrrQrrrr rrrr+rprrrrrr*rrrrr$r%r&rr'ZMagickResampleImage) rrrfilterrrfr(r)rrrrresampleRsJ(         zBaseImage.resamplecCst|jddS)zReset the coordinate frame of the image so to the upper-left corner is (0, 0) again (crop and rotate operations change it). .. versionadded:: 0.2.0 N)rMagickResetImagePager)rrrrr1szBaseImage.reset_coordscCsdS)z{Abstract method prototype. See :meth:`wand.image.Image.reset_sequence()`. .. versionadded:: 0.6.0 Nr)rrrrrszBaseImage.reset_sequencecCs|dkr|j}|dkr|j}tj||dtj|dt|ttjfsVt dt |t|tryt |}Wqt k rtt |dt t YqXn6t|tjrd|krtt ksntt |dtt|}|jrpt|j|_|t|jt|j}t|jx8t|dD](}t|j|t|j||||}q2Wt|j||n$t|j||||}t|j|||S) aVResizes the image. :param width: the width in the scaled image. default is the original width :type width: :class:`numbers.Integral` :param height: the height in the scaled image. default is the original height :type height: :class:`numbers.Integral` :param filter: a filter type to use for resizing. choose one in :const:`FILTER_TYPES`. default is ``'undefined'`` which means IM will try to guess best one to use :type filter: :class:`basestring`, :class:`numbers.Integral` :param blur: the blur factor where > 1 is blurry, < 1 is sharp. default is 1 :type blur: :class:`numbers.Real` .. versionchanged:: 0.2.1 The default value of ``filter`` has changed from ``'triangle'`` to ``'undefined'`` instead. .. versionchanged:: 0.1.8 The ``blur`` parameter changed to take :class:`numbers.Real` instead of :class:`numbers.Rational`. .. versionadded:: 0.1.1 N)rr)rzPfilter must be one string defined in wand.image.FILTER_TYPES or an integer, not z) is an invalid filter type; choose on in rz is an invalid filter typer)rrrr0rQrr rrrrr+rprrrrrrr*rrrrr$r%r&rr'ZMagickResizeImager\)rrrrrr(r)rrrrrsD         zBaseImage.resizec Cs|dkrtd}nt|tr$t|}tj|dtj|d||jrt|j |_ | t |j t |j }t |j xhtd|dD]6}t|j |t|j |j|}|rt|j dqWnt|j |j|}|r|WdQRX|S)aRotates the image right. It takes a ``background`` color for ``degree`` that isn't a multiple of 90. :see: Example of :ref:`rotate`. :param degree: a degree to rotate. multiples of 360 affect nothing :type degree: :class:`numbers.Real` :param background: an optional background color. default is transparent :type background: :class:`wand.color.Color` :param reset_coords: optional flag. If set, after the rotation, the coordinate frame will be relocated to the upper-left corner of the new image. By default is `True`. :type reset_coords: :class:`bool` .. versionadded:: 0.2.0 The ``reset_coords`` parameter. .. versionadded:: 0.1.8 NrU)rM)rrr)rrr rrrQr*rrrrr$r%r&rr'ZMagickRotateImager2rr1)rrrMr1r(r)rrrrrs4       zBaseImage.rotatecCstjsd}t|tj|d|rr||}tdkrFt|j||}qt |j|}t|j|}t |j|nt|j|}|S)aBlur an image in a radius around the center of an image. .. warning:: Requires ImageMagick-6.8.8 or greater. :see: Example of :ref:`rotational_blur`. :param angle: Degrees of rotation to blur with. :type angle: :class:`numbers.Real` :param channel: Optional channel to apply the effect against. See :const:`CHANNELS` for a list of possible values. :type channel: :class:`basestring` :raises WandLibraryVersionError: If system's version of ImageMagick does not support this method. .. versionadded:: 0.5.4 zTMethod `rotational_blur` not available on installed version of ImageMagick library. )ri) rZMagickRotationalBlurImagerrrQrrZ MagickRotationalBlurImageChannelrr)rrrrrrrrrrrotational_blur(s   zBaseImage.rotational_blurcCs|dkr|j}|dkr|j}tj||d|jrt|j|_|t |jt |j}t |jx2t |dD]"}t |j|t|j||}qxWt|j||n t|j||}t|j||t|S)aResizes the image by sampling the pixels. It's basically quicker than :meth:`resize()` except less quality as a trade-off. :param width: the width in the scaled image. default is the original width :type width: :class:`numbers.Integral` :param height: the height in the scaled image. default is the original height :type height: :class:`numbers.Integral` .. versionadded:: 0.3.4 N)rrr)rrrr0r*rrrrr$r%r&rr'ZMagickSampleImager\r)rrrr(r)rrrrsampleOs$   zBaseImage.samplecCstj||dt|j||S)aIncrease image size by scaling each pixel value by given ``columns`` and ``rows``. :param columns: The number of columns, in pixels, to scale the image horizontally. :type columns: :class:`numbers.Integral` :param rows: The number of rows, in pixels, to scale the image vertically. :type rows: :class:`numbers.Integral` .. versionadded:: 0.5.7 )rr)rr0rZMagickScaleImager)rrrrrrscalesszBaseImage.scalecCstj|||d|dkr,t|j|||}nV||}tdkrTt|j||||}n.t|j|}t|j|||}t|j||S)a_Blur an image within a given threshold. For best effects, use a value between 10% and 50% of :attr:`quantum_range` .. code:: from wand.image import Image with Image(filename='photo.jpg') as img: # Apply 8x3 blur with a 10% threshold img.selective_blur(8.0, 3.0, 0.1 * img.quantum_range) :see: Example of :ref:`selective_blur`. :param radius: Size of gaussian aperture. :type radius: :class:`numbers.Real` :param sigma: Standard deviation of gaussian operator. :type sigma: :class:`numbers.Real` :param threshold: Only pixels within contrast threshold are effected. Value should be between ``0.0`` and :attr:`quantum_range`. :type threshold: :class:`numbers.Real` :param channel: Optional color channel to target. See :const:`CHANNELS` :type channel: :class:`basestring` .. versionadded:: 0.5.3 .. versionchanged:: 0.5.5 Added ``channel`` argument. )rrrNi) rrQrZMagickSelectiveBlurImagerrrZMagickSelectiveBlurImageChannelr)rrrrrrrrrrrselective_blurs($ zBaseImage.selective_blur皙?cCs<tj|dd|kr dkr.nn ||j9}t|j|S)aCreates a Sepia Tone special effect similar to a darkroom chemical toning. :see: Example of :ref:`sepia_tone`. :param threshold: The extent of the toning. Value can be between ``0`` & :attr:`quantum_range`, or ``0`` & ``1.0``. Default value is ``0.8`` or "80%". :type threshold: :class:`numbers.Real` .. versionadded:: 0.5.7 )rgg?)rrQrrZMagickSepiaToneImager)rrrrr sepia_tones  zBaseImage.sepia_tonecCs tj||dt|j|||S)aCreates a 3D effect by simulating a light from an elevated angle. :see: Example of :ref:`shade`. :param gray: Isolate the effect on pixel intensity. Default is False. :type gray: :class:`bool` :param azimuth: Angle from x-axis. :type azimuth: :class:`numbers.Real` :param elevation: Amount of pixels from the z-axis. :type elevation: :class:`numbers.Real` .. versionadded:: 0.5.0 )azimuth elevation)rrQrZMagickShadeImager)rrgrrrrrshades zBaseImage.shadecCs0tj||dtj||dt|j||||S)aGenerates an image shadow. :param alpha: Ratio of transparency. :type alpha: :class:`numbers.Real` :param sigma: Standard deviation of the gaussian filter. :type sigma: :class:`numbers.Real` :param x: x-offset. :type x: :class:`numbers.Integral` :param y: y-offset. :type y: :class:`numbers.Integral` .. versionadded:: 0.5.0 )rmr)rr)rrQrArZMagickShadowImager)rrmrrrrrrshadowszBaseImage.shadowcCs~tj||d|dkr(t|j||}nR||}tdkrNt|j|||}n,t|j|}t|j||}t|j||S)aApplies a gaussian effect to enhance the sharpness of an image. .. note:: For best results, ensure ``radius`` is larger than ``sigma``. Defaults values of zero will have ImageMagick attempt to auto-select suitable values. :see: Example of :ref:`sharpen`. :param radius: size of gaussian aperture. :type radius: :class:`numbers.Real` :param sigma: Standard deviation of the gaussian filter. :type sigma: :class:`numbers.Real` :param channel: Optional color channel to target. See :const:`CHANNELS`. :type channel: :class:`basestring` .. versionadded:: 0.5.0 .. versionchanged:: 0.5.5 Added ``channel`` argument. )rrNi) rrQrZMagickSharpenImagerrrZMagickSharpenImageChannelr)rrrrrrrrrrrs  zBaseImage.sharpencCstj||dt|j||S)a0Remove pixels from the edges. :param columns: amount to shave off both sides of the x-axis. :type columns: :class:`numbers.Integral` :param rows: amount to shave off both sides of the y-axis. :type rows: :class:`numbers.Integral` .. versionadded:: 0.5.0 )rr)rrArZMagickShaveImager)rrrrrrshave*s zBaseImage.shaveWHITEc CsTt|trt|}tj|dtj||d|t|j|j ||}WdQRX|S)aShears the image to create a parallelogram, and fill the space created with a ``background`` color. :param background: Color to fill the void created by shearing the image. :type background: :class:`wand.color.Color` :param x: Slide the image along the X-axis. :type x: :class:`numbers.Real` :param y: Slide the image along the Y-axis. :type y: :class:`numbers.Real` .. versionadded:: 0.5.4 )rM)rrN) rr rrrrQrZMagickShearImagerr2)rrMrrrrrrshear9s  zBaseImage.shearcCstj|dtj||d|dkr6t|j|||}nV||}tdkr^t|j||||}n.t |j|}t|j|||}t |j||S)aiModifies the contrast of the image by applying non-linear sigmoidal algorithm. .. code:: python with Image(filename='photo.jpg') as img: img.sigmoidal_contrast(sharpen=True, strength=3, midpoint=0.65 * img.quantum_range) :param sharpen: Increase the contrast when ``True`` (default), else reduces contrast. :type sharpen: :class:`bool` :param strength: How much to adjust the contrast. Where a value of ``0.0`` has no effect, ``3.0`` is typical, and ``20.0`` is extreme. :type strength: :class:`numbers.Real` :param midpoint: Normalized value between `0.0` & :attr:`quantum_range` :type midpoint: :class:`numbers.Real` :param channel: Optional color channel to target. See :const:`CHANNELS`. :type channel: :class:`basestring` .. versionadded:: 0.5.4 .. versionchanged:: 0.5.5 Added ``channel`` argument. )r)rmidpointNi) rr,rQrZMagickSigmoidalContrastImagerrrZ#MagickSigmoidalContrastImageChannelr)rrrrrrrrrrrsigmoidal_contrastQs$  zBaseImage.sigmoidal_contrastc Cstj|dt|ts&tdt|tdddd}td}t dkrt t |}t |jd|t |j|jt|t|}n>tjtd|dt|}t |j|j||t|t|}|s|n t |}t|j|j|j|jd } | |jfS) a Scan image for best matching ``reference`` image, and return location & similarity. Use parameter ``threshold`` to stop subimage scanning if the matching similarity value is below the given value. This is the same as the CLI ``-similarity-threshold`` option. This method will always return a location & the lowest computed similarity value. Users are responsible for checking the similarity value to determine if a matching location is valid. Traditionally, a similarity value greater than `0.3183099` is considered dissimilar. .. code:: python from wand.image import Image dissimilarity_threshold = 0.318 similarity_threshold = 0.05 with Image(filename='subject.jpg') as img: with Image(filename='object.jpg') as reference: location, diff = img.similarity(reference, similarity_threshold) if diff > dissimilarity_threshold: print('Images too dissimilar to match') elif diff <= similarity_threshold: print('First match @ {left}x{top}'.format(**location)) else: print('Best match @ {left}x{top}'.format(**location)) .. warning:: This operation can be slow to complete. :param reference: Image to search for. :type reference: :class:`wand.image.Image` :param threshold: Stop scanning if reference similarity is below given threshold. Value can be between ``0.0`` and :attr:`quantum_range`. Default is ``0.0``. :type threshold: :class:`numbers.Real` :param metric: specify which comparison algorithm to use. See :const:`COMPARE_METRICS` for a list of values. Only used by ImageMagick-7. :type metric: :class:`basestring` :returns: List of location & similarity value. Location being a dictionary of ``width``, ``height``, ``left``, & ``top``. The similarity value is the compare distance, so a value of ``0.0`` means an exact match. :rtype: :class:`tuple` (:class:`dict`, :class:`numbers.Real`) .. versionadded:: 0.5.4 has been added. )rz7reference must be in instance of wand.image.Image, not rgiscompare:similarity-thresholdzwand.image.COMPARE_METRICS)r)rrrr)rrQrr=rrrrrrr rrrrZMagickSimilarityImagerr#r$rprDestroyMagickWandrrrrrr4) r referencerrZriodiffZartifact_valuerrglocationrrr similaritys>7          zBaseImage.similaritycCs"tj|||dt|j|||S)aSimulates a pencil sketch effect. For best results, ``radius`` value should be larger than ``sigma``. :see: Example of :ref:`sketch`. :param radius: size of Gaussian aperture. :type radius: :class:`numbers.Real` :param sigma: standard deviation of the Gaussian operator. :type sigma: :class:`numbers.Real` :param angle: direction of blur. :type angle: :class:`numbers.Real` .. versionadded:: 0.5.3 )rrr)rrQrZMagickSketchImager)rrrrrrrsketchszBaseImage.sketchcCsFtj|dt|jt|jt||}|r>||_|t|S)aAppends all images together. Similar behavior to :meth:`concat`, but with an optional offset between images. :param stacked: If True, will join top-to-bottom. If False, join images from left-to-right (default). :type stacked: :class:`bool` :param offset: Minimum space (in pixels) between each join. :type offset: :class:`numbers.Integral` .. versionadded:: 0.5.3 )r)rrArr&rZMagickSmushImagesrr)rrrrrrrsmushs  zBaseImage.smushcCsvtj|d|dkr$t|j|}nN||}tdkrHt|j||}n*t|j|}t|j|}t|j||S)aSimulates extreme overexposure. :see: Example of :ref:`solarize`. :param threshold: between ``0.0`` and :attr:`quantum_range`. :type threshold: :class:`numbers.Real` :param channel: Optional color channel to target. See :const:`CHANNELS` :type channel: :class:`basestring` .. versionadded:: 0.5.3 .. versionchanged:: 0.5.5 Added ``channel`` argument. )rNi) rrQrZMagickSolarizeImagerrrZMagickSolarizeImageChannelr)rrrrrrrrrsolarize s  zBaseImage.solarizerdc Csbtjtd|dt|tjs,tdt|tj|dt|}t }x| D]\}}t|t rjt |}|\}} | || | |f} |td@r| | j|td@r| | j|td@r| | j|td@r| | jWd QRXqPWt|} tj| |} td kr0t|j||| | } n.t|j|}t|j|| | } t|j|| S) aInterpolates color values between points on an image. The ``colors`` argument should be a dict mapping :class:`~wand.color.Color` keys to coordinate tuples. For example:: from wand.color import Color from wand.image import Image colors = { Color('RED'): (10, 50), Color('YELLOW'): (174, 32), Color('ORANGE'): (74, 123) } with Image(filename='input.png') as img: img.sparse_color('bilinear', colors) The available interpolate methods are: - ``'barycentric'`` - ``'bilinear'`` - ``'shepards'`` - ``'voronoi'`` - ``'inverse'`` - ``'manhattan'`` You can control which color channels are effected by building a custom channel mask. For example:: from wand.image import Image, CHANNELS with Image(filename='input.png') as img: colors = { img[50, 50]: (50, 50), img[100, 50]: (100, 50), img[50, 75]: (50, 75), img[100, 100]: (100, 100) } # Only apply Voronoi to Red & Alpha channels mask = CHANNELS['red'] | CHANNELS['alpha'] img.sparse_color('voronoi', colors, channel_mask=mask) :param method: Interpolate method. See :const:`SPARSE_COLOR_METHODS` :type method: :class:`basestring` :param colors: A dictionary of :class:`~wand.color.Color` keys mapped to an (x, y) coordinate tuple. :type colors: :class:`abc.Mapping` { :class:`~wand.color.Color`: (int, int) } :param channel_mask: Isolate specific color channels to apply interpolation. Default to RGB channels. :type channel_mask: :class:`numbers.Integral` .. versionadded:: 0.5.3 zwand.image.SPARSE_COLOR_METHODS)rczColors must be a dict, not)rrfrirkrmNi)rr#r8rrMappingrrr[rrr rrr"rfrirkrmrrrrrZMagickSparseColorImagerr)rrcr;rrarrrrrcr;rrrrr sparse_color*sN:             zBaseImage.sparse_colorcCs&tj||||dt|j||||S)aKPartitions image by splicing a ``width`` x ``height`` rectangle at (``x``, ``y``) offset coordinate. The space inserted will be replaced by the :attr:`background_color` value. :param width: number of pixel columns. :type width: :class:`numbers.Integral` :param height: number of pixel rows. :type height: :class:`numbers.Integral` :param x: offset on the X-axis. :type x: :class:`numbers.Integral` :param y: offset on the Y-axis. :type y: :class:`numbers.Integral` .. versionadded:: 0.5.3 )rrrr)rrArZMagickSpliceImager)rrrrrrrrspliceszBaseImage.splicecCsRtj|dtjtd|dt|}tdkr>t|j|}nt|j||}|S)aURandomly displace pixels within a defined radius. :see: Example of :ref:`spread`. :param radius: Distance a pixel can be displaced from source. Default value is ``0.0``, which will allow ImageMagick to auto select a radius. :type radius: :class:`numbers.Real` :param method: Interpolation method. Only available with ImageMagick-7. See :const:`PIXEL_INTERPOLATE_METHODS`. .. versionadded:: 0.5.3 .. versionchanged:: 0.5.7 Added default value to ``radius``. )rz$wand.image.PIXEL_INTERPOLATE_METHODS)rci) rrQr#r6rprrZMagickSpreadImager)rrrcrarrrrspreads  zBaseImage.spreadc Cstjtd|dtj||dt|}|dkrDt|j|||}nV||}t dkrlt |j||||}n.t |j|}t|j|||}t |j||S)ajReplace each pixel with the statistic results from neighboring pixel values. The ``width`` & ``height`` defines the size, or aperture, of the neighboring pixels. :see: Example of :ref:`statistic`. :param stat: The type of statistic to calculate. See :const:`STATISTIC_TYPES`. :type stat: :class:`basestring` :param width: The size of neighboring pixels on the X-axis. :type width: :class:`numbers.Integral` :param height: The size of neighboring pixels on the Y-axis. :type height: :class:`numbers.Integral` :param channel: Optional color channel to target. See :const:`CHANNELS` :type channel: :class:`basestring` .. versionadded:: 0.5.3 .. versionchanged:: 0.5.5 Added optional ``channel`` argument. zwand.image.STATISTIC_TYPES)r)rrNi) rr#r9rArprZMagickStatisticImagerrrZMagickStatisticImageChannelr) rstatrrrZstat_idxrrrrrrrs*     zBaseImage.statisticcCsRt|tstdt|tj|dt|j|j|}|rJ||_| t |S)a{Hide a digital watermark of an image within the image. .. code-block:: python from wand.image import Image # Embed watermark with Image(filename='source.png') as img: with Image(filename='gray_watermark.png') as watermark: print('watermark size (for recovery)', watermark.size) img.stegano(watermark) img.save(filename='public.png') # Recover watermark with Image(width=w, height=h, pseudo='stegano:public.png') as img: img.save(filename='recovered_watermark.png') :param watermark: Image to hide within image. :type watermark: :class:`wand.image.Image` :param offset: Start embedding image after a number of pixels. :type offset: :class:`numbers.Integral` .. versionadded:: 0.5.4 z=Watermark image must be in instance of wand.image.Image, not )r) rr=rrrrArZMagickSteganoImagerrr)r watermarkrrrrrsteganos    zBaseImage.steganocCs t|jS)zWStrips an image of all profiles and comments. .. versionadded:: 0.2.0 )rZMagickStripImager)rrrrrS szBaseImage.stripcCsRtj|dtdkr$t|j|}n*tjtd|dt|}t|j||}|S)aWSwirls pixels around the center of the image. The larger the degree the more pixels will be effected. :see: Example of :ref:`swirl`. :param degree: Defines the amount of pixels to be effected. Value between ``-360.0`` and ``360.0``. :type degree: :class:`numbers.Real` :param method: Controls interpolation of the effected pixels. Only available for ImageMagick-7. See :const:`PIXEL_INTERPOLATE_METHODS`. :type method: :class:`basestring` .. versionadded:: 0.5.7 )riz$wand.image.PIXEL_INTERPOLATE_METHODS)rc) rrQrrZMagickSwirlImagerr#r6rp)rrrcrrarrrswirl" s  zBaseImage.swirlcCs<t|tstdt|t|j|j}|r4||_t|S)aRepeat tile-image across the width & height of the image. .. code:: python from wand.image import Image with Image(width=100, height=100) as canvas: with Image(filename='tile.png') as tile: canvas.texture(tile) canvas.save(filename='output.png') :param tile: image to repeat across canvas. :type tile: :class:`Image ` .. versionadded:: 0.5.4 z8Tile image must be an instance of wand.image.Image, not )rr=rrrZMagickTextureImagerr)rrrrrrtexture? s  zBaseImage.texture?cCsPtj|d||jd9}|dkr2t|j|}n||}t|j||}|S)aChanges the value of individual pixels based on the intensity of each pixel compared to threshold. The result is a high-contrast, two color image. It manipulates the image in place. :param threshold: threshold as a factor of quantum. A normalized float between ``0.0`` and ``1.0``. :type threshold: :class:`numbers.Real` :param channel: the channel type. available values can be found in the :const:`CHANNELS` mapping. If ``None``, threshold all channels. :type channel: :class:`basestring` .. versionadded:: 0.3.10 )rrN)rrQrrZMagickThresholdImagerrZMagickThresholdImageChannel)rrrrrrrrrZ s  zBaseImage.thresholdcCs:|dkr|j}|dkr|j}tj||dt|j||S)a Changes the size of an image to the given dimensions and removes any associated profiles. The goal is to produce small low cost thumbnail images suited for display on the web. :param width: the width in the scaled image. default is the original width :type width: :class:`numbers.Integral` :param height: the height in the scaled image. default is the original height :type height: :class:`numbers.Integral` .. versionadded:: 0.5.4 N)rr)rrrr[rZMagickThumbnailImager)rrrrrr thumbnailx s zBaseImage.thumbnailc Csjt|trt|}t|tr$t|}tj||d|*|t|j|j|j}WdQRXWdQRX|S)aDApplies a color vector to each pixel in the image. :see: Example of :ref:`tint`. :param color: Color to calculate midtone. :type color: :class:`~wand.color.Color` :param alpha: Determine how to blend. :type alpha: :class:`~wand.color.Color` .. versionadded:: 0.5.3 )rrmN) rr rrrrZMagickTintImagerr2)rrrmrrrrtint s  zBaseImage.tintrc CsDtj||dy|d}Wntk r8tdYnXy|d}Wntk rdtdYnXtjs|rtd}td}t |j }t |j }d|krt |t|t|t|t|n*t |t|t|t|t||j|j|j|j|jdd|rtd}td}t |j }t |j }t |t|t|t|t||j|j|jd d S|jr t}t|j}t|j} xLt| D]@} t|| t|||} t|| t| rt| qWt|rt||nt|j||}|r<||_t|S) a Transforms the image using :c:func:`MagickTransformImage`, which is a convenience function accepting geometry strings to perform cropping and resizing. Cropping is performed first, followed by resizing. Either or both arguments may be omitted or given an empty string, in which case the corresponding action will not be performed. Geometry specification strings are defined as follows: A geometry string consists of a size followed by an optional offset. The size is specified by one of the options below, where **bold** terms are replaced with appropriate integer values: **scale**\ ``%`` Height and width both scaled by specified percentage. **scale-x**\ ``%x``\ \ **scale-y**\ ``%`` Height and width individually scaled by specified percentages. Only one % symbol is needed. **width** Width given, height automagically selected to preserve aspect ratio. ``x``\ \ **height** Height given, width automagically selected to preserve aspect ratio. **width**\ ``x``\ **height** Maximum values of width and height given; aspect ratio preserved. **width**\ ``x``\ **height**\ ``!`` Width and height emphatically given; original aspect ratio ignored. **width**\ ``x``\ **height**\ ``>`` Shrinks images with dimension(s) larger than the corresponding width and/or height dimension(s). **width**\ ``x``\ **height**\ ``<`` Enlarges images with dimensions smaller than the corresponding width and/or height dimension(s). **area**\ ``@`` Resize image to have the specified area in pixels. Aspect ratio is preserved. **X**\ ``:``\ **Y** Resize at a given aspect ratio. Common aspect ratios may include ``4:3`` for video/tv, ``3:2`` for 35mm film, ``16:9`` for HDTV, and ``2.39:1`` for cinema. Aspect ratio can be used with the crop parameter, but is only available with ImageMagick version 7.0.8 or greater. The offset, which only applies to the cropping geometry string, is given by ``{+-}``\ **x**\ ``{+-}``\ **y**\ , that is, one plus or minus sign followed by an **x** offset, followed by another plus or minus sign, followed by a **y** offset. Offsets are in pixels from the upper left corner of the image. Negative offsets will cause the corresponding number of pixels to be removed from the right or bottom edge of the image, meaning the cropped size will be the computed size minus the absolute value of the offset. For example, if you want to crop your image to 300x300 pixels and then scale it by 2x for a final size of 600x600 pixels, you can call:: image.transform('300x300', '200%') This method is a fairly thin wrapper for the C API, and does not perform any additional checking of the parameters except insofar as verifying that they are of the correct type. Thus, like the C API function, the method is very permissive in terms of what it accepts for geometry strings; unrecognized strings and trailing characters will be ignored rather than raising an error. :param crop: A geometry string defining a subregion of the image to crop to :type crop: :class:`basestring` :param resize: A geometry string defining the final size of the image :type resize: :class:`basestring` .. seealso:: `ImageMagick Geometry Specifications`__ Cropping and resizing geometry for the ``transform`` method are specified according to ImageMagick's geometry string format. The ImageMagick documentation provides more information about geometry strings. __ http://www.imagemagick.org/script/command-line-processing.php#geometry .. versionadded:: 0.2.2 .. versionchanged:: 0.5.0 Will call :meth:`crop()` followed by :meth:`resize()` in the event that :c:func:`MagickTransformImage` is not available. .. deprecated:: 0.6.0 Use :meth:`crop()` and :meth:`resize()` instead. )rrrz2crop must only contain ascii-encodable characters.z4resize must only contain ascii-encodable characters.r:F)rrrrr1)rrT)rrRrxUnicodeEncodeErrorrrZMagickTransformImagerrsrhrrrrrZ GetGeometryrr4rr* NewMagickWandrrr.rr'MagickAddImagerrr) rrrrrrrrZsrc_wandr*r)Ztmp_wandrrr transform s~f                   zBaseImage.transformcCs$tjtd|dt|jt|S)a Transform image's colorspace. :param colorspace_type: colorspace_type. available value can be found in the :const:`COLORSPACE_TYPES` :type colorspace_type: :class:`basestring` .. versionadded:: 0.4.2 zwand.image.COLORSPACE_TYPES)r)rr#r#rZMagickTransformImageColorspacerrp)rr<rrrtransform_colorspaceW!s zBaseImage.transform_colorspacec CsVtj||dt|tr t|}tj|d|t|j|j |||}WdQRX|S)a3Makes the color ``color`` a transparent color with a tolerance of fuzz. The ``alpha`` parameter specify the transparency level and the parameter ``fuzz`` specify the tolerance. :param color: The color that should be made transparent on the image, color object :type color: :class:`wand.color.Color` :param alpha: the level of transparency: 1.0 is fully opaque and 0.0 is fully transparent. :type alpha: :class:`numbers.Real` :param fuzz: By default target must match a particular pixel color exactly. However, in many cases two colors may differ by a small amount. The fuzz member of image defines how much tolerance is acceptable to consider two colors as the same. For example, set fuzz to 10 and the color red at intensities of 100 and 102 respectively are now interpreted as the same color for the color. :type fuzz: :class:`numbers.Real` :param invert: Boolean to tell to paint the inverse selection. :type invert: :class:`bool` .. versionadded:: 0.3.0 .. versionchanged:: 0.6.3 Parameter ``fuzz`` type switched from Integral to Real. )rmr)rN) rrQrr rrrZMagickTransparentPaintImagerr2)rrrmrrrrrrtransparent_colork!s   zBaseImage.transparent_colorcCs|rtt|jt|}|j|jks2|jdkr:tdt|jdt dkrVd}nd}t |jt ||j d|jdd|d S) aMakes the image transparent by subtracting some percentage of the black color channel. The ``transparency`` parameter specifies the percentage. :param transparency: the percentage fade that should be performed on the image, from 0.0 to 1.0 :type transparency: :class:`numbers.Real` .. versionadded:: 0.2.0 rz=transparency must be a numbers.Real value between 0.0 and 1.0ir>r@rrn)r>r4rN)rrrrr4rrr'rrrr/rprAr)r transparencytrrrrtransparentize!s   zBaseImage.transparentizecCs t|jS)zCreates a vertical mirror image by reflecting the pixels around the central x-axis while rotating them 90-degrees. .. versionadded:: 0.4.1 )rZMagickTransposeImager)rrrrr!szBaseImage.transposecCs t|jS)zCreates a horizontal mirror image by reflecting the pixels around the central y-axis while rotating them 270-degrees. .. versionadded:: 0.4.1 )rZMagickTransverseImager)rrrrr!szBaseImage.transversec Cs|dk}|r^|dkr|d}nt|tr0t|}tj|d||j|ddddWdQRXtj|dtj|d|dk rtj|d tt |d d d }d |}t |j tdt||st|trt|}tj|dd}|j} t |j t|t| t |j |} |r$|nb|rt|j} t| ddd| d<t| ddd| d<| dd8<| dd8<| |_| S)aRemove solid border from image. Uses top left pixel as a guide by default, or you can also specify the ``color`` to remove. :param color: the border color to remove. if it's omitted top left pixel is used by default :type color: :class:`~wand.color.Color` :param fuzz: Defines how much tolerance is acceptable to consider two colors as the same. Value can be between ``0.0``, and :attr:`quantum_range`. :type fuzz: :class:`numbers.Real` :param reset_coords: Reset coordinates after triming image. Default ``False``. :type reset_coords: :class:`bool` :param percent_background: Sets how aggressive the trim operation will be. A value of `0.0` will trim to the minimal bounding box of all matching color, and `1.0` to the most outer edge. :type percent_background: :class:`numbers.Real` :param background_color: Local alias to :attr:`background_color`, and has the same effect as defining ``color`` parameter -- but much faster. .. versionadded:: 0.2.1 .. versionchanged:: 0.3.0 Optional ``color`` and ``fuzz`` parameters. .. versionchanged:: 0.5.2 The ``color`` parameter may accept color-compliant strings. .. versionchanged:: 0.6.0 Optional ``reset_coords`` parameter added. .. versionchanged:: 0.6.4 Optional ``percent_background`` & ``background_color`` parameters have been added. N)rr)rrrN)r=)r)r1)percent_backgroundg?ggY@z{0:g}%ztrim:percent-background)r1ztrim:background-colorrr^r)rr rrrrrQr,r r rrrrr rNZMagickTrimImager1rrw) rrrr1rr1Z use_borderZstr_pbZbc_keyZbc_valrZadjusted_coordsrrrtrim!sL*             zBaseImage.trimcCs t|jS)zxDiscards all duplicate pixels, and rebuilds the image as a single row. .. versionadded:: 0.5.0 )rZMagickUniqueImageColorsr)rrrr unique_colors "szBaseImage.unique_colorsc Cstj||||d|dkr0t|j||||}nZ||}tdkrZt|j|||||}n0t|j|}t|j||||}t|j||S)abSharpens the image using unsharp mask filter. We convolve the image with a Gaussian operator of the given ``radius`` and standard deviation (``sigma``). For reasonable results, ``radius`` should be larger than ``sigma``. Use a radius of 0 and :meth:`unsharp_mask()` selects a suitable radius for you. :see: Example of :ref:`unsharp_mask`. :param radius: the radius of the Gaussian, in pixels, not counting the center pixel :type radius: :class:`numbers.Real` :param sigma: the standard deviation of the Gaussian, in pixels :type sigma: :class:`numbers.Real` :param amount: the percentage of the difference between the original and the blur image that is added back into the original :type amount: :class:`numbers.Real` :param threshold: the threshold in pixels needed to apply the difference amount. :type threshold: :class:`numbers.Real` :param channel: Optional color channel to target. See :const:`CHANNELS` :type channel: :class:`basestring` .. versionadded:: 0.3.4 .. versionchanged:: 0.5.5 Added optional ``channel`` argument. .. versionchanged:: 0.5.7 Added default values to match CLI behavior. )rrrqrNi) rrQrZMagickUnsharpMaskImagerrrZMagickUnsharpMaskImageChannelr) rrrrqrrrrrrrr unsharp_mask*"s#     zBaseImage.unsharp_maskcCs"tj||dt|j||||S)aCreates a soft vignette style effect on the image. :see: Example of :ref:`vignette`. :param radius: the radius of the Gaussian blur effect. :type radius: :class:`numbers.Real` :param sigma: the standard deviation of the Gaussian effect. :type sigma: :class:`numbers.Real` :param x: Number of pixels to offset inward from the top & bottom of the image before drawing effect. :type x: :class:`numbers.Integral` :param y: Number of pixels to offset inward from the left & right of the image before drawing effect. :type y: :class:`numbers.Integral` .. versionadded:: 0.5.2 )rr)rrQrZMagickVignetteImager)rrrrrrrrvignette_"szBaseImage.vignettec CsB|(}||||j|||dWdQRX|dS)a'Transparentized the supplied ``image`` and places it over the current image, with the top left corner of ``image`` at coordinates ``left``, ``top`` of the current image. The dimensions of the current image are not changed. :param image: the image placed over the current image :type image: :class:`wand.image.Image` :param transparency: the percentage fade that should be performed on the image, from 0.0 to 1.0 :type transparency: :class:`numbers.Real` :param left: the x-coordinate where `image` will be placed :type left: :class:`numbers.Integral` :param top: the y-coordinate where `image` will be placed :type top: :class:`numbers.Integral` .. versionadded:: 0.2.0 )rrN)rrrr6r)rr rrrZwatermark_imagerrrrv"s   zBaseImage.watermarkcCsXtj||dtjtd|dtdkr8t|j||}nt|}t|j|||}|S)aCreates a ripple effect within the image. :see: Example of :ref:`wave`. :param amplitude: height of wave form. :type amplitude: :class:`numbers.Real` :param wave_length: width of wave form. :type wave_length: :class:`numbers.Real` :param method: pixel interpolation method. Only available with ImageMagick-7. See :const:`PIXEL_INTERPOLATE_METHODS` :type method: :class:`basestring` .. versionadded:: 0.5.2 ) amplitude wave_lengthz$wand.image.PIXEL_INTERPOLATE_METHODS)rci) rrQr#r6rrZMagickWaveImagerrp)rrrrcrrarrrwave"s  zBaseImage.wavecCsxtjdkrd}t|tj||dd|kr8dkrFnn ||j9}d|krZdkrhnn ||j9}t|j||S)aRemoves noise by applying a `wavelet transform`_. .. _`wavelet transform`: https://en.wikipedia.org/wiki/Wavelet_transform .. warning:: This class method is only available with ImageMagick 7.0.8-41, or greater. :see: Example of :ref:`wavelet_denoise`. :param threshold: Smoothing limit. :type threshold: :class:`numbers.Real` :param softness: Attenuate of the smoothing threshold. :type softness: :class:`numbers.Real` :raises WandLibraryVersionError: If system's version of ImageMagick does not support this method. .. versionadded:: 0.5.5 Nz8Method requires ImageMagick version 7.0.8-41 or greater.)rsoftnessgg?)rZMagickWaveletDenoiseImagerrrQrr)rrrrrrrwavelet_denoise"s    zBaseImage.wavelet_denoisecCs4d}tdkrt|ntjdkr(t|t|jS)zUses LAB colorspace to apply a white balance to the image. .. note:: Requires ImageMagick-7.0.10-37 or later. .. versionadded:: 0.6.4 z)Requires ImageMagick-7.0.10-37, or later.i N)rrrZMagickWhiteBalanceImager)rrrrr white_balance"s   zBaseImage.white_balancec CsBt|trt|}tj|d|t|j|j}WdQRX|S)zForces all pixels above a given color as white. Leaves pixels below threshold unaltered. :param threshold: Color to be referenced as a threshold. :type threshold: :class:`Color` .. versionadded:: 0.5.2 )rN) rr rrrrZMagickWhiteThresholdImagerr2)rrrrrrwhite_threshold"s  zBaseImage.white_thresholdcCsVd}d}tjdkrtdn6|dkr6t|j|d}nt|trRt|j||j}|S)aSets the write mask which prevents pixel-value updates to the image. Call this method with a ``None`` argument to clear any previously set masks. .. warning:: This method is only available with ImageMagick-7. :param clip_mask: Image to reference as blend mask. :type clip_mask: :class:`BaseImage` .. versionadded:: 0.5.7 Fr^NzMethod requires ImageMagick-7.)rrrrrr=)rrrZWritePixelMaskrrrr|"s    zBaseImage.write_mask)r )rrN)NN)rrN)r)rrr)r\)r)rrN)rN)rrN)rrrr)rrNNNN)rr)N)rKN)N)NN)NN)rurt)rKNN)rKN)NNrNN)NNNN)F)T)rNN)N)rrNNNNTN)r)F)r)rr)N)NrN)rrNNrBr)NNrr)T)T)Nrrrrr)N)N)rN)rrN)rK)N)Nrl)T)rrK)rrNNrrN)T)Nr}r~)rx)rN)rNrN)N)rNrN)N)rr)rr)rr)rx)r)N)N)rrr)NNrN)rrrN)FN)r{rN)N)rr)NNrFN)rN)rNNrK)Nr)NrFF)rrN)rx)rNNN)N)Nr)NNrKr)NNrKr)NT)rN)NN)rr)rrrN)r)Frr)rrrr)rrN)rr)rrr)TrrN)rrK)rrr)Fr)rN)rd)NNNN)rrK)rKNNN)r)rrK)rN)NN)NN)rr)rF)NrFNN)rrrrN)rrrr)rrr)rrrK)rr)N(rrr__doc__rsequencerrrZ IsMagickWand c_is_resourcerc_destroy_resourceZMagickGetExceptionc_get_exceptionZMagickClearExceptionc_clear_exception __slots__rrrrrr r r rpropertyr"rsetterrGr*r+r1r7r:r;rr=r?r@rBrDr4rLrMrKrIrJrrrYrZrr]r_rbrgrirjrlrnrrqrrrwr~rrrrrrrrrrrrrrrGrHrrrrrdeleterrrrrrrrrrrrrrrrrrrrrrr}rrrrrrrr0rrrrrrrrr6rrrrrr\rr4r7r8r9r:rrsr=r>r?r@rArOrPr[r]rrr\rarrdrrfrjrkrmrprrrtrnrurvrwrxryrzr{r|rrdrrrrrrrrrrorrrrrrrrrrrrrrrrrrrrrrrmrrrrr1rrrrrrrrrrrrrrrrrrrrrrrrSrrrrrrrrrrrrrrrrrrr r r|rrrrr=Qsd @:  1 8                                 "                        *'!$&) ,!&"9 *6d/A4HK ] 6=   ;  ._ Q  1:.$*$f%    %&<+1-- &O$,":L  #578,&7M @2%"8* 3Xc/$-&$  R 2!r=cs.eZdZdZdZdZdZdZdZd7fdd Z fddZ d8ddZ d d Z e d9d d Ze d:d dZe ddZeddZeddZd;ddZddZddZddZddZdd Zed!d"Zd#d$Zed%d&Zed'd(Zed)d*Zdd0d1Z"d2d3Z#d?d5d6Z$Z%S)@rBa An image object. :param image: makes an exact copy of the ``image`` :type image: :class:`Image` :param blob: opens an image of the ``blob`` byte array :type blob: :class:`bytes` :param file: opens an image of the ``file`` object :type file: file object :param filename: opens an image of the ``filename`` string. Additional :ref:`read_mods` are supported. :type filename: :class:`basestring` :param format: forces filename to buffer. ``format`` to help ImageMagick detect the file format. Used only in ``blob`` or ``file`` cases :type format: :class:`basestring` :param width: the width of new blank image or an image loaded from raw data. :type width: :class:`numbers.Integral` :param height: the height of new blank image or an image loaded from raw data. :type height: :class:`numbers.Integral` :param depth: the depth used when loading raw data. :type depth: :class:`numbers.Integral` :param background: an optional background color. default is transparent :type background: :class:`wand.color.Color` :param resolution: set a resolution value (dpi), useful for vectorial formats (like pdf) :type resolution: :class:`collections.abc.Sequence`, :Class:`numbers.Integral` :param colorspace: sets the stack's default colorspace value before reading any images. See :const:`COLORSPACE_TYPES`. :type colorspace: :class:`basestring` :param units: paired with ``resolution`` for defining an image's pixel density. See :const:`UNIT_TYPES`. :type units: :class:`basestring` .. versionadded:: 0.1.5 The ``file`` parameter. .. versionadded:: 0.1.1 The ``blob`` parameter. .. versionadded:: 0.2.1 The ``format`` parameter. .. versionadded:: 0.2.2 The ``width``, ``height``, ``background`` parameters. .. versionadded:: 0.3.0 The ``resolution`` parameter. .. versionadded:: 0.4.2 The ``depth`` parameter. .. versionchanged:: 0.4.2 The ``depth``, ``width`` and ``height`` parameters can be used with the ``filename``, ``file`` and ``blob`` parameters to load raw pixel data. .. versionadded:: 0.5.0 The ``pseudo`` parameter. .. versionchanged:: 0.5.4 Read constructor no longer sets "transparent" background by default. Use the ``background`` paramater to specify canvas color when reading in image. .. versionchanged:: 0.5.7 Added the ``colorspace`` & ``units`` parameter. .. versionchanged:: 0.6.3 Added ``sampling_factors`` parameter for working with YUV streams. .. describe:: [left:right, top:bottom] Crops the image by its ``left``, ``right``, ``top`` and ``bottom``, and then returns the cropped one. :: with img[100:200, 150:300] as cropped: # manipulated the cropped image pass Like other subscriptable objects, default is 0 or its width/height:: img[:, :] #--> just clone img[:100, 200:] #--> equivalent to img[0:100, 200:img.height] Negative integers count from the end (width/height):: img[-70:-50, -20:-10] #--> equivalent to img[width-70:width-50, height-20:height-10] :returns: the cropped image :rtype: :class:`Image` .. versionadded:: 0.1.2 Nc s|| ||f}|||f}tdd|Dr8|dk r8tdtdd||fDdkrftd|d||dkrt}tt| ||dk rt |t stdt |t |j}tt| |ntd d|Dr^|j|||| | | | | ||d |dk r|j|d n.|dk r4|j|d n|dk rJ|j|d t|jtdn^|dk r| dk r|dkr||| |n||| ||rt|j|}|s||dk r||_t||_t||_ddlm}|||_t||_WdQRX|dS)Ncss|]}|dk VqdS)Nr)rrWrrrr#sz!Image.__init__..z9blank image parameters can't be used with image parametercss|]}|dk VqdS)Nr)rrWrrrr#srz, zD and image parameters are exclusive each other; use only one at oncez/image must be a wand.image.Image instance, not css|]}|dk VqdS)Nr)rrWrrrr#s) rMrrDrPrr interlacerrr)file)r,)rr)r8) anyrrrallocaterrsuperrBrrr=rZCloneMagickWandr_preamble_readrMagickSetFormatr blankpseudorErrrEmetadatarH artifactsr r8rIprofiles)rr r,rrrrMrrDrPrrrrrrrnew_argsZ open_argsrrr8) __class__rrr#s\                  zImage.__init__cstt|jddS)Nz- {self.format!r} ({self.width}x{self.height}))r)rrBr)r)r"rrr#s zImage.__repr__c  Cs|rBt|trt|}tj|d|t|j|jWdQRX|dk rrtj t d|dt |} t |j| |dk rtj |dt|j||dk rtj|dt|jt||dk rtj|dt|jt|t|jdt||dk r(tj td |d t |} t|j| |dk rt|tjrbt|d krbtj|jf|n(t|tjrt|j||ntd | dk r| |_| dk r|dk rtj | |d t|j| |dS)a Set-up MagickWand properties before reading an image file. The properties are unique to the image decoder. :param background: Defines the default background color. :type background: :class:`Color`, :class:`basestring` :param colorspace: Defines what colorspace the decoder should operate in. See :const:`COLORSPACE_TYPES`. :type colorspace: :class:`basestring` :param depth: Bits per color sample. :type depth: :class:`numbers.Integral` :param extract: Only decode a sub-region of the image. :type extract: :class:`basestring` :param format: Defines the decoder image format. :type format: :class:`basestring` :param height: Defines how high a blank canvas should be. Only used if ``width`` is also defined. :type height: :class:`numbers.Integral` :param interlace: Defines the interlacing scheme for raw data streams. See :const:`INTERLACE_TYPES`. :type interlace: :class:`basestring` :param resolution: Defines the pixel density of a scalable formats. PDF & SVG as examples. :type resolution: :class:`collections.abc.Sequence`, :class:`numbers.Integral` :param sampling_factors: Defines how a YUV might be upsampled. :type sampling_factors: :class:`collections.abc.Sequence`, :class:`basestring` :param units: Unused. :type units: :class:`numbers.Integral` :param width: Defines how wide a blank canvas should be. Only used if ``height`` is also defined. :type width: :class:`numbers.Intragal` .. versionadded:: 0.6.3 )rMNzwand.image.COLORSPACE_TYPES)r)rD)rP)rsbuffer.zwand.image.INTERLACE_TYPES)rr^zBresolution must be a (x, y) pair or an real number of the same x/y)rr)rr rrrrr3rr2r#r#rpZMagickSetColorspacer0ZMagickSetDepthrRZMagickSetExtractr rrVr0ZMagickSetInterlaceSchemerr8rrrrrrr\)rrMrrDrPrrrrrrrZcolorspace_idxZ c_interlacerrrr#sV'          zImage._preamble_readc Cs|d }|SQRXdS)NrC)convertr)rrrrr _repr_png_+$s zImage._repr_png_c Cs^|j}|d}|d}|dkrjtdddddddddd d }x|D]}||kr@||}Pq@W|dkrjtd |dkrt|d kr|d dkrdd|d }qdd|d }nd}t|dr|jtj} n6t|dr|} n"t|dr| } n| d\} } t |} |dd \} } t }|t|}t |j| | t|| | }|sZ|||S)aCreate an image instance from a :mod:`numpy` array, or any other datatype that implements `__array_interface__`__ protocol. .. code:: import numpy from wand.image import Image matrix = numpy.random.rand(100, 100, 3) with Image.from_array(matrix) as img: img.save(filename='noise.png') Use the optional ``channel_map`` & ``storage`` arguments to specify the order of color channels & data size. If ``channel_map`` is omitted, this method will will guess ``"RGB"``, or ``"CMYK"`` based on array shape. If ``storage`` is omitted, this method will reference the array's ``typestr`` value, and raise a :class:`ValueError` if storage-type can not be mapped. Float values must be normalized between `0.0` and `1.0`, and signed integers should be converted to unsigned values between `0` and max value of type. Instances of :class:`Image` can also be exported to numpy arrays:: with Image(filename='rose:') as img: matrix = numpy.array(img) __ https://docs.scipy.org/doc/numpy/reference/arrays.interface.html :param array: Numpy array of pixel values. :type array: :class:`numpy.array` :param channel_map: Color channel layout. :type channel_map: :class:`basestring` :param storage: Datatype per pixel part. :type storage: :class:`basestring` :returns: New instance of an image. :rtype: :class:`~wand.image.Image` .. versionadded:: 0.5.3 .. versionchanged:: 0.6.0 Input ``array`` now expects the :attr:`shape` property to be defined as ```( 'height', 'width', 'channels' )```. rrTNrrrrrr) u1i1u2i2Zu4i4u8i8Zf4Zf8z!Unable to determine storage type.rr^rrBrZCMYKArrtobytestostringr)r"rrrhasattrrZdata_asrr,r-rr:rprrr=ZMagickConstituteImagerr r)rarrayrrCZarr_itrrrTZ storage_maptokenZdata_ptrrfZ storage_idxrrrinstancerrrr from_array/$sR.            zImage.from_arrayc Ks^d}|}|jf||dk rt|tr^ttdr^t|dr^t||j}t |j |}n&t t |ddsxt dn |}d}|dk rt|tjst dt|t|tsd|}t|j |t|}n|dk rt|}t|j |}|s |d}t|nN|d } | dk r&| |_t||_t||_d d l m!} | ||_ t"||_#|S) aPing image header into Image() object, but without any pixel data. This is useful for inspecting image meta-data without decoding the whole image. :param blob: reads an image from the ``blob`` byte array :type blob: :class:`bytes` :param file: reads an image from the ``file`` object :type file: file object :param filename: reads an image from the ``filename`` string :type filename: :class:`basestring` :param resolution: set a resolution value (DPI), useful for vector formats (like PDF) :type resolution: :class:`collections.abc.Sequence`, :class:`numbers.Integral` :param format: suggest image file format when reading from a ``blob``, or ``file`` property. :type format: :class:`basestring` .. versionadded:: 0.5.6 NfdopenrrzUfile must be a readable file object, but the given object does not have read() methodzblob must be iterable, not r"zMagickPingImage returns false, but did raise ImageMagick exception. This can occur when a delegate is missing, or returns EXIT_SUCCESS without generating a raster.rr)r8)$rrr r.rr3filenorrZMagickPingImageFilercallablerrrrrrr rZMagickPingImageBlobrr ZMagickPingImagerrrrrErrHrr r8rIr ) rrrr,rrr1fdrrr8rrrping$sF               z Image.pingcCs\t|tstdt|t|ts4tdt|t|j|j}|sP||t|S)a8Create a new stereogram image from two existing images. :see: Example of :ref:`stereogram`. :param left: Left-eye image. :type left: :class:`wand.image.Image` :param right: Right-eye image. :type right: :class:`wand.image.Image` .. versionadded:: 0.5.4 z8Left image must be in instance of wand.image.Image, not z9Right image must be in instance of wand.image.Image, not )rr=rrrZMagickStereoImagerr)rrr2rrrr stereogram$s    zImage.stereogramcCs"|jdk}t|j}|o |dkS)N)z image/gifz image/x-gifr)mimetyperr.r)rZis_gifframesrrrr*$s  zImage.animationcCs4d}tt|j}|r0tt|}t|}|S)z(:class:`basestring`) The MIME type of the image e.g. ``'image/jpeg'``, ``'image/png'``. .. versionadded:: 0.1.7 N)rZ MagickToMimer rrrrOr{)rmtyperprrrr9$s  zImage.mimetypec Csrtj||d|dkr td}nt|tr2t|}tj|d|&t|j|||j }|sd| WdQRX|S)aCreates blank image. :param width: the width of new blank image. :type width: :class:`numbers.Integral` :param height: the height of new blank image. :type height: :class:`numbers.Integral` :param background: an optional background color. default is transparent :type background: :class:`wand.color.Color` :returns: blank image :rtype: :class:`Image` .. versionadded:: 0.3.0 )rrNrU)rM) rr0rrr rrZMagickNewImagerr2r)rrrrMrrrrr$s    z Image.blankcCst|jdS)zClears resources associated with the image, leaving the image blank, and ready to be used with new image. .. versionadded:: 0.3.0 N)rZClearMagickWandr)rrrrr%sz Image.clearcCs |dS)zCloses the image explicitly. If you use the image object in :keyword:`with` statement, it was called implicitly so don't have to call it. .. note:: It has the same functionality of :attr:`destroy()` method. N)destroy)rrrrrm %s z Image.closecCst|tstdt||dkr*tdd}t|}tdkrPt |j |}n4tj rft |j |}ntj r|t |j |}nt d|s| tt|dS)aGenerates new images showing the delta pixels between layers. Similar pixels are converted to transparent. Useful for debugging complex animations. :: with img.compare_layers('compareany') as delta: delta.save(filename='framediff_%02d.png') .. note:: May not work as expected if animations are already optimized. :param method: Can be ``'compareany'``, ``'compareclear'``, or ``'compareoverlay'`` :type method: :class:`basestring` :returns: new image stack. :rtype: :class:`Image` .. versionadded:: 0.5.0 z5method must be a string from IMAGE_LAYER_METHOD, not )r1r2r3zDmethod can only be 'compareany', 'compareclear', or 'compareoverlay'Niz8MagickCompareImageLayers method not available on system.)r )rr rrrr.rprrZMagickCompareImagesLayersrZMagickCompareImageLayersrrrBr=)rrcrrprrrcompare_layers,%s"   zImage.compare_layerscCs|}||_|S)aConverts the image format with the original image maintained. It returns a converted image instance which is new. :: with img.convert('png') as converted: converted.save(filename='converted.png') :param format: image format to convert to :type format: :class:`basestring` :returns: a converted image :rtype: :class:`Image` :raises ValueError: when the given ``format`` is unsupported .. versionadded:: 0.1.6 )rr)rrrrrrr#V%sz Image.convertcCs.ddlm}|j}||}d|t|S)acGenerate a base64 `data-url`_ string from the loaded image. Useful for converting small graphics into ASCII strings for HTML/CSS web development. .. _data-url: https://en.wikipedia.org/wiki/Data_URI_scheme :returns: a data-url formated string. :rtype: :class:`basestring` .. versionadded:: 0.6.3 r) b64encodezdata:{0};base64,{1})base64r?r9rrr)rr?Z mime_typeZ base_bytesrrrdata_urlj%s  zImage.data_urlcCs"t|tstdt|j|jS)aCopies a given image on to the image stack. By default, the added image will be append at the end of the stack, or immediately after the current image iterator defined by :meth:`~BaseImage.iterator_set`. Use :meth:`~BaseImage.iterator_reset` before calling this method to insert the new image before existing images on the stack. :param image: raster to add. :type image: :class:`Image` .. versionadded:: 0.6.7 z*image must be instance of wand.image.Image)rrBrrrr)rr rrr image_add{%s zImage.image_addcCs(t|j}|s|dStt|S)zGenerate & return a clone of a single image at the current image-stack index. .. versionadded:: 0.6.7 N)rZMagickGetImagerrrBr=)rrrrr image_get%s  zImage.image_getcCs t|jS)zdRemove an image from the image-stack at the current index. .. versionadded:: 0.6.7 )rZMagickRemoveImager)rrrr image_remove%szImage.image_removecCs,t|tstddt|t|j|jS)zOverwrite current image on the image-stack with given image. :param image: Wand instance of images to write to stack. :type image: :class:`wand.image.Image` .. versionadded:: 0.6.7 z.image must be an instance of wand.image.Image,z not )rrBrrrZMagickSetImager)rr rrr image_set%s zImage.image_setc Cstj|dtj|d|}|||B}|||$}||||||WdQRXWdQRX||dS)a Swap two images on the image-stack. :param i: image index to replace with ``j`` :type i: :class:`numbers.Integral` :param j: image index to replace with ``i`` :type j: :class:`numbers.Integral` .. versionadded:: 0.6.7 )r))jN)rrArvr|rCrE)rr)rFrrWbrrr image_swap%s        zImage.image_swapc Cs|dk r"|| }|SQRXt|jt}d}t|jdkr`t|jt |}nt |jt |}|r|j rt ||j }t |}|S|dS)aBMakes the binary string of the image. :param format: the image format to write e.g. ``'png'``, ``'jpeg'``. it is omittable :type format: :class:`basestring` :returns: a blob (bytes) string :rtype: :class:`bytes` :raises ValueError: when ``format`` is invalid .. versionchanged:: 0.1.6 Removed a side effect that changes the image :attr:`format` silently. .. versionadded:: 0.1.5 The ``format`` parameter became optional. .. versionadded:: 0.1.1 Nr)r#rrr&rrrhr.ZMagickGetImagesBlobrr'r4rOrPr)rrZ convertedr*r+r,rrrr%s      zImage.make_blobxc:cCsXtj||dtj|dt|j||}|s6|t|jt|}|sT|dS)aCreates a new image from ImageMagick's internal protocol coders. :param width: Total columns of the new image. :type width: :class:`numbers.Integral` :param height: Total rows of the new image. :type height: :class:`numbers.Integral` :param pseudo: The protocol & arguments for the pseudo image. :type pseudo: :class:`basestring` .. versionadded:: 0.5.0 )rr)rN) rr0rRrr\rrMagickReadImager )rrrrrrrrr%s  z Image.pseudoc Cs,d}|j|||||| | | | |d |dk rt|trjttdrjt|drjt||j}t |j |}n&t t |ddst dn |}d}|dk rt|tjst dt|t|tsd|}t|j |t|}n|dk rt|}t|j |}|s|d }t|n| dk r(| |_dS) a Read new image into Image() object. :param blob: reads an image from the ``blob`` byte array :type blob: :class:`bytes` :param file: reads an image from the ``file`` object :type file: file object :param filename: reads an image from the ``filename`` string. Additional :ref:`read_mods` are supported. :type filename: :class:`basestring` :param background: set default background color. :type background: :class:`Color`, :class:`basestring` :param colorspace: set default colorspace. See :const:`COLORSPACE_TYPES`. :type colorspace: :class:`basestring` :param depth: sets bits per color sample. Usually ``8``, or ``16``. :type depth: :class:`numbers.Integral` :param format: sets which image decoder to read with. Helpful when reading ``blob`` data with ambiguous headers. :type format: :class:`basestring` :param height: used with ``width`` to define the canvas size. Useful for reading image streams. :type height: :class:`numbers.Integral` :param interlace: Defines the interlacing scheme for raw data streams. See :const:`INTERLACE_TYPES`. :type interlace: :class:`basestring` :param resolution: set a resolution value (DPI), useful for vectorial formats (like PDF) :type resolution: :class:`collections.abc.Sequence`, :class:`numbers.Integral` :param sampling_factors: set up/down stampling factors for YUV data stream. Usually ``"4:2:2"`` :type sampling_factors: :class:`collections.abc.Sequence`, :class:`basestring` :param units: used with ``resolution``, can either be ``'pixelperinch'``, or ``'pixelpercentimeter'``. :type units: :class:`basestring` :param width: used with ``height`` to define the canvas size. Useful for reading image streams. :type width: :class:`numbers.Integral` .. versionadded:: 0.3.0 .. versionchanged:: 0.5.7 Added ``units`` parameter. .. versionchanged:: 0.6.3 Added, or documented, optional pre-read parameters: ``background``, ``colorspace``, ``depth``, ``format``, ``height``, ``interlace``, ``sampling_factors``, & ``width``. N) rMrrDrPrrrrrrr3rrzUfile must be a readable file object, but the given object does not have read() methodzblob must be iterable, not r"zMagickReadImage returns false, but did not raise ImageMagick exception. This can occur when a delegate is missing, or returns EXIT_SUCCESS without generating a raster.)rrr r.rr3r4rrZMagickReadImageFilerr5rrrrrrr rZMagickReadImageBlobrr rJrrr)rrrr,rMrrDrPrrrrrrrrr6rrrrr&s>6        z Image.readcCs0x"|jjD]}t|dr |q Wg|j_dS)zRemove any previously allocated :class:`~wand.sequence.SingleImage` instances in :attr:`sequence` attribute. .. versionadded:: 0.6.0 r=N)r Z instancesr.r=)rr1rrrra&s  zImage.reset_sequenceTcCsj|dkr|dkrtdnJ|dk r8|dk r8tdn.|dk rt|trZtd|nt|trttdrt||j }t |j dkrt |j |}nt |j |}t||s|n.tt|ddstdt|||npt|tst|d std t|t|}t |j dkrJt |j ||}nt |j |}|sf|dS) aSaves the image into the ``file`` or ``filename``. It takes only one argument at a time. :param file: a file object to write to :type file: file object :param filename: a filename string to write to :type filename: :class:`basestring` :param adjoin: write all images to a single multi-image file. Only available if file format supports frames, layers, & etc. :type adjoin: :class:`bool` .. versionadded:: 0.1.1 .. versionchanged:: 0.1.5 The ``file`` parameter was added. .. versionchanged:: 6.0.0 The ``adjoin`` parameter was added. Nzexpected an argumentz*expected only one argument; but two passedz_file must be a writable file object, but {0!r} is a string; did you want .save(filename={0!r})?r3rwritezJfile must be a writable file object, but it does not have write() method: __fspath__zfilename must be a string, not )rrr rr r.rr3r4rrr.rZMagickWriteImagesFileZMagickWriteImageFileZfflushrr5rrrKrr ZMagickWriteImagesZMagickWriteImage)rrrZadjoinr6rrrrsavel&s<          z Image.save)NNNNNNNNNNNNNNNN) NNNNNNNNNNN)NN)NNN)N)N)rI)NNNNNNNNNNNNNN)NNT)&rrrr rrrrr rrrr$ classmethodr2r7r8rr*r9rrrmr>r#rArrBrCrDrErHrrrrrM __classcell__rr)r"rrB#sVd7  T \ @      *     '  \ rBc@sXeZdZdZejZejZej Z ej Z d ddZ ddZddZdd d ZeZd d ZdS)rDaRow iterator for :class:`Image`. It shouldn't be instantiated directly; instead, it can be acquired through :class:`Image` instance:: assert isinstance(image, wand.image.Image) iterator = iter(image) It doesn't iterate every pixel, but rows. For example:: for row in image: for col in row: assert isinstance(col, wand.color.Color) print(col) Every row is a :class:`collections.abc.Sequence` which consists of one or more :class:`wand.color.Color` values. :param image: the image to get an iterator :type image: :class:`Image` .. versionadded:: 0.1.3 Nc Cs|dk r|dk rtd|p|dk r\t|tsDtdt|t|j|_|j |_ n0t|t svtdt|t |j|_|j |_ WdQRX| d|_ dS)Nz$it takes only one argument at a timez*expected a wand.image.Image instance, not z-expected a wand.image.Iterator instance, not r)rrrrBrrZNewPixelIteratorrr2rrDZClonePixelIteratorrcursor)rr rrrrr&s       zIterator.__init__cCs|S)Nr)rrrrr &szIterator.__iter__cCsXtj|d||jkrtd||_|dkr:t|jnt|j|dsT| dS)N)rzcan not be greater than heightrr) rr[rrrPrZPixelSetFirstIteratorRowr2ZPixelSetIteratorRowr)rrrrrr&s  z Iterator.seekcCs|j|jkr|t|jd7_t}t|jt |}|dkrdg|j }x$t |j D]}t ||||<qdW|S|rt ||SdS)Nr)rPrr= StopIterationrrhrZPixelGetNextIteratorRowr2rr4rrr/)rrrpixelsZr_pixelsrrr__next__&s   zIterator.__next__cCst||dS)z#Clones the same iterator. )r)r)rrrrr&szIterator.clone)NN)N)rrrr rZIsPixelIteratorr ZDestroyPixelIteratorrZPixelGetIteratorExceptionrZPixelClearIteratorExceptionrrr rrSrrrrrrrD&s  rDc@s$eZdZdZddZeddZdS)rCzxThe mixin class to maintain a weak reference to the parent :class:`Image` object. .. versionadded:: 0.3.0 cCs*t|tstdt|t||_dS)Nz.expected a wand.image.BaseImage instance, not )rr=rrweakrefref_image)rr rrrr's  zImageProperty.__init__cCs&|}|dk r|Std|dS)aV(:class:`Image`) The parent image. It ensures that the parent :class:`Image`, which is held in a weak reference, still exists. Returns the dereferenced :class:`Image` if it does exist, or raises a :exc:`ClosedImageError` otherwise. :exc: `ClosedImageError` when the parent Image has been destroyed Nz(parent Image of {0!r} has been destroyed)rVr@r)rr rrrr  's zImageProperty.imageN)rrrr rrr rrrrrC&srCc@s8eZdZdZddZddZddZdd Zd d Zd S) rFa*Free-form mutable mapping of global internal settings. .. versionadded:: 0.3.0 .. versionchanged:: 0.5.0 Remove key check to :const:`OPTIONS`. Image properties are specific to vendor, and this library should not attempt to manage the 100+ options in a whitelist. cCsttS)N)rOPTIONS)rrrrr *'szOptionDict.__iter__cCsttS)N)rrW)rrrrr -'szOptionDict.__len__cCsNtj|dd}t|jjt|}|rBtt |}t |}nt ||S)N)rr") rrRrZMagickGetOptionr rr rrrOrPKeyError)rropt_strZopt_prrrr0's  zOptionDict.__getitem__cCs0tj||d|j}t|jt|t|dS)N)rr4)rrRr rr&rr )rrr4r rrrr;'szOptionDict.__setitem__cCs d||<dS)Nrr)rrrrr __delitem__@'szOptionDict.__delitem__N) rrrr r r rrrZrrrrrF's   rFcsHeZdZdZfddZddZddZdd Zd d Zd d Z Z S)rEazClass that implements dict-like read-only access to image metadata like EXIF or IPTC headers. Most WRITE encoders will ignore properties assigned here. :param image: an image instance :type image: :class:`Image` .. note:: You don't have to use this by yourself. Use :attr:`Image.metadata` property instead. .. versionadded:: 0.3.0 cs.t|tstdt|tt||dS)Nz*expected a wand.image.Image instance, not )rrBrrrrEr)rr )r"rrrU's  zMetadata.__init__cCsRtj|d|j}d}t|jt|}|rFtt |}t |}nt ||S)z :param k: Metadata header name string. :type k: :class:`basestring` :returns: a header value string :rtype: :class:`str` )rr") rrRr rrrr rrrOrPrX)rrer r4vprrrr['s  zMetadata.__getitem__cCs<tj||d|j}t|jt|t|}|s8||S)z :param k: Metadata header name string. :type k: :class:`basestring` :param v: Value to assign. :type v: :class:`basestring` .. versionadded: 0.5.0 )rr4)rrRr rrrr r)rrerr rrrrrm's zMetadata.__setitem__cCs4tj|d|j}t|jt|}|s0|dS)z} :param k: Metadata header name string. :type k: :class:`basestring` .. versionadded: 0.5.0 )rN)rrRr rZMagickDeleteImagePropertyrr r)rrer rrrrrZ}'s  zMetadata.__delitem__csH|j}t}t|jd|fddt|jD}tt |S)Nr"csg|]}tt|qSr)rrrO)rr))props_prrr%'sz%Metadata.__iter__..) r rrhrMagickGetImagePropertiesrrr4rPr)rr numpropsr)r\rr 's  zMetadata.__iter__cCs.|j}t}t|jd|}t|}|jS)Nr")r rrhrr]rrPr4)rr r^r\rrrr 's  zMetadata.__len__) rrrr rrrrZr r rOrr)r"rrED's  rEcsHeZdZdZfddZddZddZdd Zd d Zd d Z Z S)rHaCSplay tree to map image artifacts. Values defined here are intended to be used elseware, and will not be written to the encoded image. For example:: # Omit timestamp from PNG file headers. with Image(filename='input.png') as img: img.artifacts['png:exclude-chunks'] = 'tIME' img.save(filename='output.png') :param image: an image instance :type image: :class:`Image` .. note:: You don't have to use this by yourself. Use :attr:`Image.artifacts` property instead. .. versionadded:: 0.5.0 cs.t|tstdt|tt||dS)Nz*expected a wand.image.Image instance, not )rrBrrrrHr)rr )r"rrr's  zArtifactTree.__init__cCstj|d|j}d}t|jt|}|rDtt |}t |}t |dkrt |jt|}|rtt |}t |}nd}|S)z :param k: Metadata header name string. :type k: :class:`basestring` :returns: a header value string :rtype: :class:`str` .. versionadded: 0.5.0 )rr"rN) rrRr rZMagickGetImageArtifactrr rrrOrPrr)rrer vsr[rrrr's    zArtifactTree.__getitem__cCs<tj||d|j}t|jt|t|}|s8||S)z :param k: Metadata header name string. :type k: :class:`basestring` :param v: Value to assign. :type v: :class:`basestring` .. versionadded: 0.5.0 )rr4)rrRr rrrr r)rrerr rrrrr's zArtifactTree.__setitem__cCs4tj|d|j}t|jt|}|s0|dS)z} :param k: Metadata header name string. :type k: :class:`basestring` .. versionadded: 0.5.0 )rN)rrRr rZMagickDeleteImageArtifactrr r)rrer rrrrrZ's  zArtifactTree.__delitem__csJ|j}td}t|jd|fddt|jD}tt |S)Nrr"csg|]}tt|qSr)rrrO)rr))art_prrr%'sz)ArtifactTree.__iter__..) r rrhrMagickGetImageArtifactsrrr4rPr)rr r^r_r)rarr 's   zArtifactTree.__iter__cCs0|j}td}t|jd|}t|}|jS)Nrr")r rrhrrbrrPr4)rr r^rarrrr 's   zArtifactTree.__len__) rrrr rrrrZr r rOrr)r"rrH's  rHcsHeZdZdZfddZddZddZdd Zd d Zd d Z Z S)rIaThe mapping table of embedded image profiles. Use this to get, set, and delete whole profile payloads on an image. Each payload is a raw binary string. For example:: with Image(filename='photo.jpg') as img: # Extract EXIF with open('exif.bin', 'wb') as payload: payload.write(img.profiles['exif']) # Import ICC with open('color_profile.icc', 'rb') as payload: img.profiles['icc'] = payload.read() # Remove XMP del imp.profiles['xmp'] .. seealso:: `Embedded Image Profiles`__ for a list of supported profiles. __ https://imagemagick.org/script/formats.php#embedded .. versionadded:: 0.5.1 cs.t|tstdt|tt||dS)Nz*expected a wand.image.Image instance, not )rrBrrrrIr)rr )r"rrr(s  zProfileDict.__init__cCs:tj|dtd}t|jjt||}t |}dS)N)rr) rrRrrhrZMagickRemoveImageProfiler rr rP)rrer^ profile_prrrrZ(s     zProfileDict.__delitem__cCsVtj|dtd}d}t|jjt||}|j dkrRt ||j }t |}|S)N)rr) rrRrrhrZMagickGetImageProfiler rr r4rOrP)rrer^Zreturn_profilercrrrr$(s      zProfileDict.__getitem__csFtd}t|jjd|fddt|jD}tt |S)Nrr"csg|]}tt|qSr)rrrO)rr))proprrr%2(sz(ProfileDict.__iter__..) rrhrMagickGetImageProfilesr rrr4rPr)rr^r r)rdrr /(s   zProfileDict.__iter__cCs,td}t|jjd|}t|}|jS)Nrr")rrhrrer rrPr4)rr^Z profiles_prrrr 6(s  zProfileDict.__len__cCsTtj|dt|ts&tdt|t|jj t ||t |}|sP|j dS)N)rz#value must be a binary string, not ) rrRrr rrrZMagickSetImageProfiler rr rr)rrerrrrrr<(s   zProfileDict.__setitem__) rrrr rrZrr r rrOrr)r"rrI's  rIc@s(eZdZdZddZddZddZdS) r?a4The mapping table of separated images of the particular channel from the image. :param image: an image instance :type image: :class:`Image` .. note:: You don't have to use this by yourself. Use :attr:`Image.channel_images` property instead. .. versionadded:: 0.3.0 cCsttS)N)rr")rrrrr V(szChannelImageDict.__iter__cCsttS)N)rr")rrrrr Y(szChannelImageDict.__len__cCsjt|}|j}tjr(t|j|}nt|j|}|sfy |Wntk rd| YnX|S)N) r"r rrZMagickSeparateImageChannelrZMagickSeparateImagerrrm)rrrimgZ succeededrrrr\(s  zChannelImageDict.__getitem__N)rrrr r r rrrrrr?F(sr?c@s(eZdZdZddZddZddZdS) r>aThe mapping table of channels to their depth. :param image: an image instance :type image: :class:`Image` .. note:: You don't have to use this by yourself. Use :attr:`Image.channel_depths` property instead. .. versionadded:: 0.3.0 cCsttS)N)rr")rrrrr {(szChannelDepthDict.__iter__cCsttS)N)rr")rrrrr ~(szChannelDepthDict.__len__cCsjt|}tjr t|jj|}nBd}|dkrl(s r>c@s@eZdZdZddZddZddZdd Zd d Zd d Z dS)rAzSpecialized mapping object to represent color histogram. Keys are colors, and values are the number of pixels. :param image: the image to get its histogram :type image: :class:`BaseImage` .. versionadded:: 0.3.0 cCs,t|_t|jt|j|_d|_dS)N) rrhrrZMagickGetImageHistogramrrrRcounts)rr rrrr(s  zHistogramDict.__init__cCs|jrt|j|jj|_dS)N)rRrZDestroyPixelWandsrr4)rrrr__del__(szHistogramDict.__del__cCs|jdkr|jjSt|jS)N)rgrr4r)rrrrr (s zHistogramDict.__len__cCs|jdkr|t|jS)N)rg _build_countsr)rrrrr (s zHistogramDict.__iter__cCs:|jdkr|t|tr$t|}tj|d|j|S)N)r)rgrirr rrr)rrrrrr(s    zHistogramDict.__getitem__cCsJi|_x>t|jjD].}t|j|}t|j|}||j|<qWdS)N) rgrrr4rZPixelGetColorCountrRrr/)rr)Z color_countrrrrri(s zHistogramDict._build_countsN) rrrr rrhr r rrirrrrrA(s rAc@seZdZdZdZdZdZdZdZdZ dZ dZ dZ dZ dZdddZeddZeddZed d Zd d Zd dZddZdS)rJaGeneric Python wrapper to translate :c:type:`CCObjectInfo` structure into a class describing objects found within an image. This class is generated by :meth:`Image.connected_components() ` method. .. versionadded:: 0.5.5 .. versionchanged:: 0.6.3 Added :attr:`merge` & :attr:`metric` for ImageMagick 7.0.10 NcCs6t|tr||t|tr2||||dS)N)rrclone_from_cc_object_inforclone_from_extra_70A_info)r cc_objectrrrr(s     z!ConnectedComponentObject.__init__cCs |j|jfS)zT(:class:`tuple` (:attr:`width`, :attr:`height`)) Minimum bounding rectangle.)rr)rrrrr(szConnectedComponentObject.sizecCs |j|jfS)zd(:class:`tuple` (:attr:`left`, :attr:`top`)) Position of objects minimum bounding rectangle.)rr)rrrrr)szConnectedComponentObject.offsetcCs |j|jfS)zO(:class:`tuple` (:attr:`center_x`, :attr:`center_y`)) Center of object.)center_xcenter_y)rrrrcentroid )sz!ConnectedComponentObject.centroidcCs|j|_|jj|_|jj|_|jj|_|jj|_|jj|_ |jj|_ |j |_ t t}t |}t |t |j|t|d|_dS)zrArJr@rrrr s  ,  *!    1 " j -  / 5 " - $      |V"%VcI&#2r