U Pe2@@sdZdZddlmZddlmZddlmZddl m Z m Z m Z m Z mZmZmZmZddlmZdaGd d d eZGd d d eZdS) a0 Image ===== The :class:`Image` widget is used to display an image:: Example in python:: wimg = Image(source='mylogo.png') Kv Example:: Image: source: 'mylogo.png' size: self.texture_size Asynchronous Loading -------------------- To load an image asynchronously (for example from an external webserver), use the :class:`AsyncImage` subclass:: aimg = AsyncImage(source='http://mywebsite.com/logo.png') This can be useful as it prevents your application from waiting until the image is loaded. If you want to display large images or retrieve them from URL's, using :class:`AsyncImage` will allow these resources to be retrieved on a background thread without blocking your application. Alignment --------- By default, the image is centered inside the widget bounding box. Adjustment ---------- To control how the image should be adjusted to fit inside the widget box, you should use the :attr:`~kivy.uix.image.Image.fit_mode` property. Available options include: - ``"scale-down"``: maintains aspect ratio without stretching. - ``"fill"``: stretches to fill widget, may cause distortion. - ``"contain"``: maintains aspect ratio and resizes to fit inside widget. - ``"cover"``: maintains aspect ratio and stretches to fill widget, may clip image. For more details, refer to the :attr:`~kivy.uix.image.Image.fit_mode`. You can also inherit from Image and create your own style. For example, if you want your image to be greater than the size of your widget, you could do:: class FullImage(Image): pass And in your kivy language file:: <-FullImage>: canvas: Color: rgb: (1, 1, 1) Rectangle: texture: self.texture size: self.width + 20, self.height + 20 pos: self.x - 10, self.y - 10 )Image AsyncImage)Widget)r) resource_find)StringPropertyObjectProperty ListProperty AliasPropertyBooleanPropertyNumericProperty ColorPropertyOptionProperty)LoggerNcs eZdZdZedZedddZeddgZ ddZ e dZ e e d dd Zed d d d gZe ddd Ze ddd Zed d dddgdZe dZedZedZe dZddZe eddd ZfddZddZddZddZddZ d d!Z!d"d#Z"d$d%Z#d&d'Z$d(d)Z%d*d+Z&Z'S),rz;Image class, see module documentation for more information.NT)Z allownonercCs|jr|jjt|jjSdS)Ng?)texturewidthfloatheightselfr2/tmp/pip-unpacked-wheel-xzebddm3/kivy/uix/image.pyget_image_ratio}szImage.get_image_ratioF)r)bindcache) deprecated scale-downfillcontaincover)optionsg?c Cs|jst|jS|j}|j\}}|jj\}}|jdkrn|td|}||kr\||||gS||||gSn,|jdkr||gS|jdkr|}n t||}||}||kr|jdkr|}n t||}||}||gS)Nrrrr)rlistsize image_ratiofit_modemaxmin) rZratiowhZtwthZ widget_ratioiwZihrrrget_norm_image_size s,         zImage.get_norm_image_size)rr"r#r$c sVd|_d|_|j}|j}|d||d||d|j|d|jtjf|dS)Nrsourcemipmap keep_ratio allow_stretch) _coreimage_loopstexture_updatefbind_update_fit_modesuper__init__)rkwargsupdater3 __class__rrr6As    zImage.__init__cGsF|j}|j}|s|r|r$|s$d|_n|s4|r4d|_n|rB|rBd|_dS)Nrrr)r.r/r$)rargsr.r/rrrr4NszImage._update_fit_modecGs||jdSN)set_texture_from_resourcer,rlargsrrrr2[szImage.texture_updatecCs|s|dSt|}|s6td||dS|jrL|jj|jdz$t||j|j |j |j d|_}Wn0t k rtd|||j}YnX|r|j |jd|j|_dS)NzImage: Not found <%s> on_texture)r- anim_delay keep_datanocachezImage: Error loading <%s>)_clear_core_imagerrerrorr0unbind_on_tex_change CoreImager-rBrCrD Exceptionrr)rresourcer,imagerrrr=^s2 zImage.set_texture_from_resourcecCs.|jdkrdS||j_|dkr*|jddS)NrF)r0rB anim_resetrinstancevaluerrr on_anim_delayys  zImage.on_anim_delaycCs|r |jnddg|_dS)Nr)r" texture_sizerNrrrrAszImage.on_texturecCs,|jr|jj|jdd|_d|_d|_dS)Nr@r)r0rGrHrr1rrrrrEs zImage._clear_core_imagecGsZ|jj|_|j}|jrV|jt|jjdkrV|jd7_|j|jkrV|dd|_dS)NrFr) r0r anim_loopZ _anim_indexlenZ_imageZtexturesr1rM)rr?cirrrrHs   zImage._on_tex_changecCs||j}d|_||_dS)aAReload image from disk. This facilitates re-loading of images from disk in case the image content changes. .. versionadded:: 1.3.0 Usage:: im = Image(source = '1.jpg') # -- do something -- im.reload() # image will be re-loaded from disk N)remove_from_cacher,)rZ old_sourcerrrreloadsz Image.reloadcCs|jr|jdS)zBRemove image from cache. .. versionadded:: 2.0.0 N)r0rWrrrrrWszImage.remove_from_cachecGs |jr||jrd|j_dS)NT)rDrWr0Z_nocacherr;rrr on_nocacheszImage.on_nocache)(__name__ __module__ __qualname____doc__rr,rrrrRrr r-r r#r colorr/r.r r$rCr rBrSrDr+Znorm_image_sizer6r4r2r=rQrArErHrXrWrZ __classcell__rrr9rr[sF     #    !   rcs~eZdZdZdZfddZddZddZdd d Zd d Z ddZ ddZ fddZ ddZ ddZfddZZS)ra0Asynchronous Image class. See the module documentation for more information. .. note:: The AsyncImage is a specialized form of the Image class. You may want to refer to the :mod:`~kivy.loader` documentation and in particular, the :class:`~kivy.loader.ProxyImage` for more detail on how to handle events around asynchronous image loading. .. note:: AsyncImage currently does not support properties :attr:`anim_loop` and :attr:`mipmap` and setting those properties will have no effect. )on_erroron_loadc s<d|_d|_tsddlma|d|jtjf|dS)Nr)Loaderr,) _found_sourcer0rcZ kivy.loaderr3 _load_sourcer5r6)rr7r9rrr6s  zAsyncImage.__init__cGs|j}|s|dS||sHt|}|sHtd|j|dS||_tj||j |j |j d|_ }|j |j|j|jd|j|_dS)NzAsyncImage: Not found <%s>)rDr-rB)rbrarA)r,rEis_urirrrFrdrcrLrDr-rBr0r_on_source_load_on_source_errorrHr)rr;r,rLrrrres.  zAsyncImage._load_sourcecCs&|jj}|sdS|j|_|ddS)Nrb)r0rLrdispatch)rrPrLrrrrgs zAsyncImage._on_source_loadNcCs|d|dS)Nra)ri)rrOrFrrrrhszAsyncImage._on_source_errorcCsdSr<r)rrFrrrraszAsyncImage.on_errorcGsdSr<rrYrrrrbszAsyncImage.on_loadcCs|ddd}|dkS)Nz://rr)httphttpsftpsmb)split)rfilenameprotorrrrfszAsyncImage.is_urics*|jr|jj|jdtd|_dS)N)rb)r0rGrgr5rErdrr9rrrEs zAsyncImage._clear_core_imagecGs|jr|jj|_dSr<)r0rr>rrrrHszAsyncImage._on_tex_changecGsdSr<rr>rrrr2 szAsyncImage.texture_updatecs |jrt|jtdSr<)rdrcrWr5rr9rrrW s zAsyncImage.remove_from_cache)N)r[r\r]r^Z __events__r6rergrhrarbrfrErHr2rWr`rrr9rrs   r)r^__all__Zkivy.uix.widgetrZkivy.core.imagerrIZkivy.resourcesrZkivy.propertiesrrrr r r r r Z kivy.loggerrrcrrrrrsE   ( ]