o
    ôjŽ1  ã                   @   s(  d dl mZ d dlmZmZ d dlmZ d dlZddlm	Z	 ddl
mZ ze	dƒ W n eefyF Z zed	e› d
�ƒ W Y dZ[ndZ[ww G dd„ deƒZdedejfdd„Zdedejddfdd„Zejdfdejdededejfdd„Zd3dejdedejfdd„Zd3dejdedefdd „Zejd!dfdejded"ededejf
d#d$„Z	%d4deejeej f d&edeejeej f fd'd(„Zd4dejded&efd)d*„Zejdfdejdededejfd+d,„Zejdfdedededejfd-d.„Zejfdededejfd/d0„Zdejdejfd1d2„Z dS )5é    )ÚEnum)ÚListÚUnion)ÚwarnNé   )Ú_load_library)Ú_log_api_usage_onceÚimagez(Failed to load image Python extension: 'zü'If you don't plan on using image functionality from `torchvision.io`, you can ignore this warning. Otherwise, there might be something wrong with your environment. Did you have `libjpeg` or `libpng` installed before building `torchvision` from source?c                   @   s$   e Zd ZdZdZdZdZdZdZdS )ÚImageReadModeaV  
    Support for various modes while reading images.

    Use ``ImageReadMode.UNCHANGED`` for loading the image as-is,
    ``ImageReadMode.GRAY`` for converting to grayscale,
    ``ImageReadMode.GRAY_ALPHA`` for grayscale with transparency,
    ``ImageReadMode.RGB`` for RGB and ``ImageReadMode.RGB_ALPHA`` for
    RGB with transparency.
    r   é   r   é   é   N)	Ú__name__Ú
__module__Ú__qualname__Ú__doc__Ú	UNCHANGEDZGRAYZ
GRAY_ALPHAÚRGBZ	RGB_ALPHA© r   r   úe/var/www/html/academy/tools/voices/clone/sv-venv/lib/python3.10/site-packages/torchvision/io/image.pyr
      s    
r
   ÚpathÚreturnc                 C   s2   t j ¡ st j ¡ sttƒ t jj t| ƒ¡}|S )zÙ
    Reads and outputs the bytes contents of a file as a uint8 Tensor
    with one dimension.

    Args:
        path (str or ``pathlib.Path``): the path to the file to be read

    Returns:
        data (Tensor)
    )	ÚtorchÚjitÚis_scriptingÚ
is_tracingr   Ú	read_fileÚopsr	   Ústr)r   Údatar   r   r   r   (   s   r   Úfilenamer   c                 C   s4   t j ¡ st j ¡ sttƒ t jj t| ƒ|¡ dS )zñ
    Writes the contents of an uint8 tensor with one dimension to a
    file.

    Args:
        filename (str or ``pathlib.Path``): the path to the file to be written
        data (Tensor): the contents to be written to the output file
    N)	r   r   r   r   r   Ú
write_filer   r	   r   )r    r   r   r   r   r!   9   s   	r!   FÚinputÚmodeÚapply_exif_orientationc                 C   s6   t j ¡ st j ¡ sttƒ t jj | |jd|¡}|S )aö  
    Decodes a PNG image into a 3 dimensional RGB or grayscale Tensor.
    Optionally converts the image to the desired format.
    The values of the output tensor are uint8 in [0, 255].

    Args:
        input (Tensor[1]): a one dimensional uint8 tensor containing
            the raw bytes of the PNG image.
        mode (ImageReadMode): the read mode used for optionally
            converting the image. Default: ``ImageReadMode.UNCHANGED``.
            See `ImageReadMode` class for more information on various
            available modes.
        apply_exif_orientation (bool): apply EXIF orientation transformation to the output tensor.
            Default: False.

    Returns:
        output (Tensor[image_channels, image_height, image_width])
    F)	r   r   r   r   r   Ú
decode_pngr   r	   Úvalue©r"   r#   r$   Úoutputr   r   r   r%   G   s   r%   é   Úcompression_levelc                 C   s0   t j ¡ st j ¡ sttƒ t jj | |¡}|S )a	  
    Takes an input tensor in CHW layout and returns a buffer with the contents
    of its corresponding PNG file.

    Args:
        input (Tensor[channels, image_height, image_width]): int8 image tensor of
            ``c`` channels, where ``c`` must 3 or 1.
        compression_level (int): Compression factor for the resulting file, it must be a number
            between 0 and 9. Default: 6

    Returns:
        Tensor[1]: A one dimensional int8 tensor that contains the raw bytes of the
            PNG file.
    )r   r   r   r   r   Ú
encode_pngr   r	   )r"   r*   r(   r   r   r   r+   d   s   r+   c                 C   s4   t j ¡ st j ¡ sttƒ t| |ƒ}t||ƒ dS )aÖ  
    Takes an input tensor in CHW layout (or HW in the case of grayscale images)
    and saves it in a PNG file.

    Args:
        input (Tensor[channels, image_height, image_width]): int8 image tensor of
            ``c`` channels, where ``c`` must be 1 or 3.
        filename (str or ``pathlib.Path``): Path to save the image.
        compression_level (int): Compression factor for the resulting file, it must be a number
            between 0 and 9. Default: 6
    N)r   r   r   r   r   Ú	write_pngr+   r!   )r"   r    r*   r(   r   r   r   r,   y   s   
r,   ÚcpuÚdevicec                 C   s`   t j ¡ st j ¡ sttƒ t  |¡}|jdkr$t jj	 
| |j|¡}|S t jj	 | |j|¡}|S )a  
    Decodes a JPEG image into a 3 dimensional RGB or grayscale Tensor.
    Optionally converts the image to the desired format.
    The values of the output tensor are uint8 between 0 and 255.

    Args:
        input (Tensor[1]): a one dimensional uint8 tensor containing
            the raw bytes of the JPEG image. This tensor must be on CPU,
            regardless of the ``device`` parameter.
        mode (ImageReadMode): the read mode used for optionally
            converting the image. The supported modes are: ``ImageReadMode.UNCHANGED``,
            ``ImageReadMode.GRAY`` and ``ImageReadMode.RGB``
            Default: ``ImageReadMode.UNCHANGED``.
            See ``ImageReadMode`` class for more information on various
            available modes.
        device (str or torch.device): The device on which the decoded image will
            be stored. If a cuda device is specified, the image will be decoded
            with `nvjpeg <https://developer.nvidia.com/nvjpeg>`_. This is only
            supported for CUDA version >= 10.1

            .. betastatus:: device parameter

            .. warning::
                There is a memory leak in the nvjpeg library for CUDA versions < 11.6.
                Make sure to rely on CUDA 11.6 or above before using ``device="cuda"``.
        apply_exif_orientation (bool): apply EXIF orientation transformation to the output tensor.
            Default: False. Only implemented for JPEG format on CPU.

    Returns:
        output (Tensor[image_channels, image_height, image_width])
    Úcuda)r   r   r   r   r   Údecode_jpegr.   Útyper   r	   Zdecode_jpeg_cudar&   )r"   r#   r.   r$   r(   r   r   r   r0   ‹   s   %

ÿr0   éK   Úqualityc                    s®   t j ¡ st j ¡ sttƒ ˆ dk sˆ dkrtdƒ‚t| tƒr>| s%tdƒ‚| d j	j
dkr5t jj | ˆ ¡S ‡ fdd„| D ƒS | j	j
dkrOt jj | gˆ ¡d S t jj | ˆ ¡S )	a-  
    Takes a (list of) input tensor(s) in CHW layout and returns a (list of) buffer(s) with the contents
    of the corresponding JPEG file(s).

    .. note::
        Passing a list of CUDA tensors is more efficient than repeated individual calls to ``encode_jpeg``.
        For CPU tensors the performance is equivalent.

    Args:
        input (Tensor[channels, image_height, image_width] or List[Tensor[channels, image_height, image_width]]):
            (list of) uint8 image tensor(s) of ``c`` channels, where ``c`` must be 1 or 3
        quality (int): Quality of the resulting JPEG file(s). Must be a number between
            1 and 100. Default: 75

    Returns:
        output (Tensor[1] or list[Tensor[1]]): A (list of) one dimensional uint8 tensor(s) that contain the raw bytes of the JPEG file.
    r   éd   z;Image quality should be a positive number between 1 and 100zDencode_jpeg requires at least one input tensor when a list is passedr   r/   c                    s   g | ]
}t jj |ˆ ¡‘qS r   )r   r   r	   Úencode_jpeg)Ú.0r	   ©r3   r   r   Ú
<listcomp>Ø   s    zencode_jpeg.<locals>.<listcomp>)r   r   r   r   r   r5   Ú
ValueErrorÚ
isinstanceÚlistr.   r1   r   r	   Zencode_jpegs_cuda)r"   r3   r   r7   r   r5   º   s   
r5   c                 C   sD   t j ¡ st j ¡ sttƒ t| |ƒ}t|t jƒsJ ‚t	||ƒ dS )a�  
    Takes an input tensor in CHW layout and saves it in a JPEG file.

    Args:
        input (Tensor[channels, image_height, image_width]): int8 image tensor of ``c``
            channels, where ``c`` must be 1 or 3.
        filename (str or ``pathlib.Path``): Path to save the image.
        quality (int): Quality of the resulting JPEG file, it must be a number
            between 1 and 100. Default: 75
    N)
r   r   r   r   r   Ú
write_jpegr5   r:   ÚTensorr!   )r"   r    r3   r(   r   r   r   r<   à   s
   
r<   c                 C   s4   t j ¡ st j ¡ sttƒ t jj | |j|¡}|S )a{  
    Detect whether an image is a JPEG, PNG or GIF and performs the appropriate
    operation to decode the image into a 3 dimensional RGB or grayscale Tensor.

    Optionally converts the image to the desired format.
    The values of the output tensor are uint8 in [0, 255].

    Args:
        input (Tensor): a one dimensional uint8 tensor containing the raw bytes of the
            PNG or JPEG image.
        mode (ImageReadMode): the read mode used for optionally converting the image.
            Default: ``ImageReadMode.UNCHANGED``.
            See ``ImageReadMode`` class for more information on various
            available modes. Ignored for GIFs.
        apply_exif_orientation (bool): apply EXIF orientation transformation to the output tensor.
            Ignored for GIFs. Default: False.

    Returns:
        output (Tensor[image_channels, image_height, image_width])
    )	r   r   r   r   r   Údecode_imager   r	   r&   r'   r   r   r   r>   ò   s   r>   c                 C   s2   t j ¡ st j ¡ sttƒ t| ƒ}t|||d�S )a  
    Reads a JPEG, PNG or GIF image into a 3 dimensional RGB or grayscale Tensor.
    Optionally converts the image to the desired format.
    The values of the output tensor are uint8 in [0, 255].

    Args:
        path (str or ``pathlib.Path``): path of the JPEG, PNG or GIF image.
        mode (ImageReadMode): the read mode used for optionally converting the image.
            Default: ``ImageReadMode.UNCHANGED``.
            See ``ImageReadMode`` class for more information on various
            available modes. Ignored for GIFs.
        apply_exif_orientation (bool): apply EXIF orientation transformation to the output tensor.
            Ignored for GIFs. Default: False.

    Returns:
        output (Tensor[image_channels, image_height, image_width])
    )r$   )r   r   r   r   r   Ú
read_imager   r>   )r   r#   r$   r   r   r   r   r?     s   r?   c                 C   s   t | ƒ}tjj ||jd¡S )NT)r   r   r   r	   r%   r&   )r   r#   r   r   r   r   Ú_read_png_16-  s   r@   c                 C   s*   t j ¡ st j ¡ sttƒ t jj | ¡S )a&  
    Decode a GIF image into a 3 or 4 dimensional RGB Tensor.

    The values of the output tensor are uint8 between 0 and 255.
    The output tensor has shape ``(C, H, W)`` if there is only one image in the
    GIF, and ``(N, C, H, W)`` if there are ``N`` images.

    Args:
        input (Tensor[1]): a one dimensional contiguous uint8 tensor containing
            the raw bytes of the GIF image.

    Returns:
        output (Tensor[image_channels, image_height, image_width] or Tensor[num_images, image_channels, image_height, image_width])
    )r   r   r   r   r   Ú
decode_gifr   r	   )r"   r   r   r   rA   2  s   rA   )r)   )r2   )!Úenumr   Útypingr   r   Úwarningsr   r   Ú	extensionr   Úutilsr   ÚImportErrorÚOSErrorÚer
   r   r=   r   r!   r   Úboolr%   Úintr+   r,   r0   r5   r<   r>   r?   r@   rA   r   r   r   r   Ú<module>   sš    
ÿ€ÿ	ýÿþý
üüÿþýü
û0ÿÿÿ
þ&ýÿþý
ü!ýÿþý
ü