Nota

¡Ayúdanos a traducir la documentación oficial de Python al Español! Puedes encontrar más información en Como contribuir. Ayuda a acercar Python a más personas de habla hispana.

imghdr — Determinar el tipo de imagen

Código fuente: Lib/imghdr.py

Deprecated since version 3.11, will be removed in version 3.13: The imghdr module is deprecated (see PEP 594 for details and alternatives).


El módulo imghdr determina el tipo de imagen contenida en un archivo o secuencia de bytes.

El módulo imghdr define la siguiente función:

imghdr.what(file, h=None)

Prueba los datos de imagen contenidos en el archivo nombrado por file y retorna una cadena que describe el tipo de imagen. Si se proporciona h opcional, se ignora el argumento file y se supone que h contiene el flujo de bytes para probar.

Distinto en la versión 3.6: Acepta un path-like object.

Se reconocen los siguientes tipos de imagen, enumerados a continuación con el valor devuelto de what():

Valor

Formato de imagen

'rgb'

Archivos SGI ImgLib

'gif'

Archivos GIF 87a y 89a

'pbm'

Archivos Portable Bitmap

'pgm'

Archivos Portable Graymap

'ppm'

Archivos Portable Pixmap

'tiff'

Archivos TIFF

'rast'

Archivos Sun Raster

'xbm'

Archivos X Bitmap

'jpeg'

Datos JPEG en formatos JFIF o Exif

'bmp'

Archivos BMP

'png'

Portable Network Graphics

'webp'

Archivos WebP

'exr'

Archivos OpenEXR

Nuevo en la versión 3.5: Se añadieron los formatos exr y webp.

Puede ampliar la lista de tipos de archivo que imghdr puede reconocer agregándolos a esta variable:

imghdr.tests

Una lista de funciones que realizan las comprobaciones individuales. Cada función toma dos argumentos: la secuencia de bytes y un objeto abierto de tipo archivo. Cuando what() es llamada con una secuencia de bytes, el objeto de tipo archivo será None.

La función de comprobación debería retornar una cadena de caracteres que describa el tipo de imagen si la comprobación se realizó correctamente o “”Ninguno”” si ha fallado.

Ejemplo:

>>> import imghdr
>>> imghdr.what('bass.gif')
'gif'