o Si&@sjddlZddlZddlmZmZddlmZddlmZm Z m Z m Z ddl Z ddlmZddlmZddlmZmZGdd d ed ZGd d d ed ZiZiZd e efddZddZddZded e efddZded e efddZded e efddZded e fddZ!eGdddeZ"eGd d!d!eZ#eGd"d#d#eZ$eGd$d%d%eZ%dS)&N)ABCMetaabstractmethod)Path)DictListTypeUnion)FileIO)Image)Pathlikeis_module_availablec@s>eZdZdZeedefddZededej fddZ dS) ImageReadera ``ImageReader`` defines the interface of how to load images from a particular storage backend. This backend could either be: - files on a local filesystem; - in-memory storage; - cloud storage; - etc. Each class inheriting from ``ImageReader`` must define: - the ``read()`` method, which defines the loading operation (accepts the ``key`` to locate the image in the storage and return it). - the ``name()`` property that is unique to this particular storage mechanism. returncCdSNselfrrC/home/ubuntu/.local/lib/python3.10/site-packages/lhotse/image/io.pynamezImageReader.namekeycCrrr)rrrrrread$szImageReader.readN) __name__ __module__ __qualname____doc__propertyrstrrnpndarrayrrrrrr sr ) metaclassc@seZdZdZeedefddZeedefddZedede j defd d Z dede ee j e fdefd d Zd dZddZdS) ImageWritera ``ImageWriter`` defines the interface of how to store images in a particular storage backend. This backend could either be: - files on a local filesystem; - in-memory storage; - cloud storage; - etc. Each class inheriting from ``ImageWriter`` must define: - the ``write()`` method, which defines the storing operation (accepts a ``key`` used to place the ``value`` image in the storage); - the ``storage_path()`` property, which is either a directory for the files, or empty string for in-memory storage. - the ``name()`` property that is unique to this particular storage mechanism. rcCrrrrrrrr?rzImageWriter.namecCrrrrrrr storage_pathDrzImageWriter.storage_pathrvaluecCrrrrrr$rrrwriteIzImageWriter.writecCstdsJdddl}t||jjrt|}n3t|tr(t|j|}n$t|tjr1|}nt|t rCt|jt |}n t dt ||jdd\}}|||}t|j|j|||dS)a Store an image in the underlying storage and return a manifest describing how to retrieve it. :param key: An ID that uniquely identifies the image. :param value: The image to be stored. Can be: - A path to an image file - A numpy array with shape (height, width, channels) - Raw bytes of an image file :return: A manifest of type :class:`~lhotse.image.Image` PIL9In order to store images, please run 'pip install pillow'rNzUnsupported image value type: ) storage_typer# storage_keywidthheight)r PIL.Image isinstancer rarrayropenr bytesioBytesIO ValueErrortypeshaper&rr#)rrr$r(imgr.r-r,rrr store_imageMs0     zImageWriter.store_imagecC|Srrrrrr __enter__|zImageWriter.__enter__cOrrrrargskwargsrrr__exit__r=zImageWriter.__exit__N)rrrrrrrrr#rr r&rr3r r:r<rArrrrr",s& / r"rcCsttttSr)sortedsetREADER_BACKENDS intersectionWRITER_BACKENDSrrrravailable_storage_backendssrGcC|t|j<|S)zK Decorator used to add a new ``ImageReader`` to Lhotse's registry. )rDrclsrrrregister_reader rKcCrH)zK Decorator used to add a new ``ImageWriter`` to Lhotse's registry. )rFrrIrrrregister_writerrLrMrcC,|tvrtd|dttt|S)z Find the available ``ImageReader`` implementation with the provided name. The name is the value of the ``name`` property in a concrete ``ImageReader`` implementation. z#No image reader backend with name '$' is available. Available backends: )rDr6listkeysrrrr get_reader rScCrN)z Find the available ``ImageWriter`` implementation with the provided name. The name is the value of the ``name`` property in a concrete ``ImageWriter`` implementation. z#No image writer backend with name 'rO)rFr6rPrQrRrrr get_writerrTrUcCs$t|}t|sJd|d|S)z] Find the available in-memory ``ImageWriter`` implementation with the provided name. zStorage type 'z' is not an in-memory storage.)rU is_in_memory)rwriterrrrget_memory_writersrXr+cCs|dkS)zR Determines whether a given storage_type represents an in-memory storage. pillow_memoryr)r+rrrrVsrVcsPeZdZdZdZdeffdd ZedefddZ dd ed e fd d Z Z S) PillowReaderz Reads image files using Pillow from a directory on the local filesystem. ``storage_path`` corresponds to the directory path; ``storage_key`` for each image is the name of the file in that directory. pillow_filesr#ctt||_dSrsuper__init__r r4rr#r?r@ __class__rrr_ zPillowReader.__init__rcC|jjSrr4r#rrrrr#zPillowReader.storage_pathFr as_pil_imagecCsptdsJdddl}|j|d\}}|j|}|Wdn1s*wY|r3|St|S)z3Read the image file and return it as a numpy array.r(8In order to load images, please run 'pip install pillow'rNr) r r/r4 open_fileobjr r2loadrr1)rrrgr(f input_pathr9rrrrs   zPillowReader.readF) rrrrrr r_rrr#boolr __classcell__rrrarrZsrZcsTeZdZdZdZdeffdd ZedefddZ d ed e j defd d Z Z S) PillowWriterz Writes image files using Pillow to a directory on the local filesystem. ``storage_path`` corresponds to the directory path; ``storage_key`` for each image is the name of the file in that directory. r[r#cr\rr]r`rarrr_rczPillowWriter.__init__rcCrdrrerrrrr#rfzPillowWriter.storage_pathrr$cCstdsJdddl}t|js|d}|j|}|jj|ddd\}}||Wdn1s6wY|jj sKd t|j d dS|S) z%Write a numpy array as an image file.r(r)rNz.pngwT) add_subdir/) r r/rsuffixr fromarrayr4rjsaveis_urljoinparts)rrr$r(r9rl output_pathrrrr&s   zPillowWriter.write)rrrrrr r_rrr#rr r&rprrrarrqs rqc@s6eZdZdZdZddZd dededej fd d Z d S) PillowInMemoryReaderz8 Reads images from memory storage using Pillow. rYcOrrrr>rrrr_r=zPillowInMemoryReader.__init__Fraw_datargrcCstdsJdddl}t|}t|tr(|jt |}|r#|St |St|t j r8|r6|j |S|St||jjrH|rC|St |Stdt|)z(Read the image from the bytes in memory.r(rhrNzUnsupported data type: )r r/pickleloadsr0r3r r2r4r5rr1r rwr6r7)rr~rgr(datar9rrrrs*      zPillowInMemoryReader.readNrn) rrrrrr_r3rorr rrrrrr}s r}c@s\eZdZdZdZddZedddZd ed e j de fd d Z dd dZ ddZddZdS)PillowInMemoryWriterz7 Writes images to memory storage using Pillow. rYcOrrrr>rrrr_@r=zPillowInMemoryWriter.__init__rNcCrrrrrrrr#Cr'z!PillowInMemoryWriter.storage_pathrr$cCs t|S)zU Store the image in memory. We're simply pickle-ing the numpy array. )rdumpsr%rrrr&Gs zPillowInMemoryWriter.writecCrrrrrrrcloseMr=zPillowInMemoryWriter.closecCr;rrrrrrr<Pr=zPillowInMemoryWriter.__enter__cCrrr)rexc_typeexc_valexc_tbrrrrASr=zPillowInMemoryWriter.__exit__)rN)rrrrrr_rr#rrr r3r&rr<rArrrrr8s   r)&r4rabcrrpathlibrtypingrrrrnumpyrlhotse.features.ior lhotse.image.imager lhotse.utilsr r r r"rDrFrrGrKrMrSrUrXrorVrZrqr}rrrrrs8   W   !('