Módulo ImageDraw de Pillow

ImageDraw es un módulo de Pillow (una rama de PIL), la biblioteca de procesamiento de imágenes de Python, que se utiliza para dibujar diversos gráficos y texto en imágenes.

ImageDraw ofrece funciones de dibujo enriquecidas, que incluyen líneas, rectángulos, círculos, polígonos, texto, etc., adecuadas para el etiquetado de imágenes, la generación de gráficos o el diseño gráfico simple.

ImageDrawLas características principales del módulo incluyen:

  • Compatibilidad con dibujo sobre imágenes existentes
  • Puede crear un lienzo en blanco completamente nuevo
  • Proporciona múltiples primitivas de dibujo (puntos, líneas, rectángulos, elipses, etc.)
  • Admite dibujo de texto y configuración de fuentes
  • Permite personalizar colores y estilos de dibujo

Uso básico de ImageDraw

Crear un objeto Draw

Antes de usar ImageDraw, primero debes crear unImageDraw.Drawobjeto, pasando unImageobjeto como base para el dibujo.

Ejemplo

from PIL import Image, ImageDraw

# Crea una imagen en blanco (fondo blanco)
image = Image.new("RGB", (400, 300), "white")

# Crea un objeto Draw
draw = ImageDraw.Draw(image)

Dibujar formas básicas

ImageDraw admite varios métodos de dibujo, por ejemplo:

  • Dibujar líneas:line()
  • Dibujar rectángulos:rectangle()
  • Dibujar círculos/elipses:ellipse()
  • Dibujar polígonos:polygon()
  • Dibujar texto:text()

Métodos comunes de ImageDraw

Método Descripción Ejemplo
line(xy, fill=None, width=1) Dibuja una línea,xyes una tupla de coordenadas ((x1, y1, x2, y2)) draw.line([(10, 10), (100, 50)], fill="red", width=2)
rectangle(xy, fill=None, outline=None, width=1) Dibuja un rectángulo,xyson las coordenadas de la esquina superior izquierda e inferior derecha draw.rectangle([(50, 50), (150, 150)], fill="blue", outline="black")
ellipse(xy, fill=None, outline=None, width=1) Dibuja una elipse o círculo draw.ellipse([(100, 100), (200, 200)], fill="green")
polygon(xy, fill=None, outline=None) Dibuja un polígono draw.polygon([(50, 50), (100, 20), (150, 50)], fill="yellow")
text(xy, text, fill=None, font=None) Dibuja texto en la imagen draw.text((50, 50), "Hello Pillow!", fill="black")
arc(xy, start, end, fill=None, width=1) Dibuja un arco draw.arc([(50, 50), (150, 150)], 0, 90, fill="red")
chord(xy, start, end, fill=None, outline=None) Dibuja una cuerda (arco + línea de conexión) draw.chord([(50, 50), (150, 150)], 0, 180, fill="blue")
pieslice(xy, start, end, fill=None, outline=None) Dibuja un sector circular draw.pieslice([(50, 50), (150, 150)], 0, 90, fill="green")
textbbox() Se utiliza para calcular el cuadro delimitador que ocupa un texto dado al dibujarlo en la imagen. draw.textbbox((50, 50), "Hello Pillow!", font=font)

Ejemplo completo

El siguiente es un ejemplo completo que muestra cómo usar ImageDraw para dibujar varias formas y texto:

Ejemplo

from PIL import Image, ImageDraw, ImageFont

# Crea una imagen en blanco
image = Image.new("RGB", (500, 400), "white")
draw = ImageDraw.Draw(image)

# Dibuja líneas
draw.line([(10, 10), (490, 10)], fill="red", width=3)

# Dibuja rectángulos
draw.rectangle([(50, 50), (150, 150)], fill="blue", outline="black")

# Dibuja círculos
draw.ellipse([(200, 50), (300, 150)], fill="green")

# Dibuja polígonos
draw.polygon([(350, 50), (400, 100), (450, 50), (400, 150)], fill="yellow")

# Dibuja texto
font = ImageFont.load_default()
draw.text((50, 200), "Hello Pillow!", fill="black", font=font)

# Guarda la imagen
image.save("draw_example.png")

Después de ejecutarlo, se generará un archivo de imagen que contiene múltiples formas.draw_example.png。


Resumen

ImageDraw es un módulo de dibujo muy práctico en Pillow, adecuado para:

  • Anotación de imágenes (como agregar texto, flechas)
  • Generar gráficos o diagramas simples
  • Dibujo de formas personalizadas

Al dominarline()、rectangle()、ellipse()、text()y otros métodos, puedes implementar fácilmente diversas necesidades de dibujo.

Si necesitas funciones de dibujo más avanzadas, puedes combinarImageFont(configuración de fuentes) oImageFilter(efectos de filtro) para ampliar aún más las funciones.

¡Esperamos que este tutorial te ayude a comenzar rápidamente con el módulo ImageDraw de Pillow!

Otras extensiones