Instalación de Pillow

Antes de instalar Pillow, asegúrate de:

• Python 3.7 o superior (se recomienda la última versión)
• El administrador de paquetes pip (normalmente se instala con Python)
• Según la plataforma, pueden ser necesarias algunas bibliotecas del sistema y herramientas de desarrollo adicionales

Versión de Python

Pillow requiere Python 3.7 o superior.

Puedes verificar la versión de Python con el siguiente comando:

python --version
# o 
python3 --version

Herramienta pip

pip es el administrador de paquetes de Python y normalmente se instala junto con Python.

Comprueba si pip está disponible:

pip --version
# o 
pip3 --version

Si pip no está instalado, puedes consultarGuía oficial de instalación de pippara instalarlo.

---

Instalar Pillow

Método de instalación básico

La forma más sencilla es instalarlo con pip:

pip install pillow

O específicamente para Python 3:

pip3 install pillow

Si utilizas la distribución Anaconda de Python:

conda install -c anaconda pillow

Instalación de una versión específica

Si necesitas instalar una versión específica de Pillow:

pip install pillow==9.0.0

Instalar en un entorno virtual

Se recomienda instalar Pillow en un entorno virtual para evitar conflictos de dependencias:

# 创建虚拟环境
python -m venv pillow_env

# 激活虚拟环境
# Windows:
pillow_env\Scripts\activate

# 安装 Pillow
pip install Pillow

Instalar desde el código fuente

Para usuarios avanzados, puedes instalarlo desde el código fuente:

Descargar el código fuente:

git clone https://github.com/python-pillow/Pillow.git
cd Pillow

Instalar las dependencias:

pip install -r requirements.txt

Compilar e instalar:

python setup.py install

---

Verificar la instalación

Una vez completada la instalación, puedes verificar si Pillow se instaló correctamente de las siguientes maneras:

Método 1: Entorno interactivo de Python

Método 2: Verificación desde la línea de comandos

python3 -c "import PIL; print(PIL.__version__)"

Si la instalación fue exitosa, se mostrará el número de versión de Pillow.

---

Resolución de problemas comunes

1. Error de instalación

Posibles causas:

• Faltan bibliotecas de dependencias (por ejemplo, zlib, libjpeg, etc.)
• Problemas de permisos

Soluciones:

Los usuarios de Linux/macOS pueden necesitar instalar primero las dependencias del sistema:

Usa el parámetro --user para evitar problemas de permisos:

pip install --user pillow

2. Error de importación

Si te encuentras conImportError: cannot import name '_imaging' from 'PIL'errores de este tipo, intenta:

pip uninstall pillow
pip install --no-cache-dir pillow

3. Problemas de rendimiento

Para el procesamiento de imágenes grandes, puedes considerar instalar una versión optimizada:

pip install pillow-simd

---

Primer programa con Pillow

Después de instalar Pillow correctamente, puedes comenzar a explorar sus potentes funciones de procesamiento de imágenes:

Análisis del código:

1. Importar módulo

   • from PIL import Image→ Importar el módulo Image de Pillow

2. Abrir imagen

   • img = Image.open("example.jpg")→ Cargar el archivo de imagen de la ruta especificada

   • Formatos admitidos: JPG/PNG/GIF/BMP, etc.

3. Mostrar imagen

   • img.show()→ Abrir con el visor de imágenes predeterminado del sistema

   • Solo para depuración, no recomendado en entornos de producción.

4. Guardar imagen

   • img.save("example.png")→ Guardar como el formato especificado

   • El formato está determinado por la extensión del archivo (por ejemplo, .jpg/.png)

5. Ajustar tamaño

   • small_img = img.resize((100,100))→ Forzar el ajuste a 100×100 píxeles

   • Nota: cambiará la proporción de la imagen original.

6. Guardar nueva imagen

   • small_img.save("small_example.jpg")→ Guardar la imagen ajustada

   • Se puede agregar el parámetro quality para controlar la calidad JPEG.

Otras extensiones