HOWTO · Python
Invertir una imagen usando el módulo OpenCV en Python
Aprenda a invertir una imagen usando el módulo OpenCV en Python
En esta página
Invierte una imagen en Python aplicando cv2.bitwise_not() a un arreglo devuelto por OpenCV. Para canales de imagen de 8 bits sin signo, cada valor v se convierte en 255 - v. Las secciones siguientes explican el comportamiento de los canales, muestran el cálculo con datos de píxeles de ejemplo y enseñan a procesar y guardar imágenes en color o en escala de grises.
Requisitos previos y carga de una imagen
Instala Python y OpenCV en el entorno donde se ejecutará el script. El paquete se llama opencv-python, aunque en el código de Python se importa como cv2. Si aún no está disponible, instálalo con pip install opencv-python. La alternativa con NumPy también requiere NumPy, que se instala como dependencia del paquete estándar de OpenCV para Python.
Asigna a input_path la ruta de un archivo de imagen que se pueda leer. De forma predeterminada, OpenCV carga las imágenes en color con los canales en orden BGR. Para cargar una imagen, asigna image = cv2.imread(input_path) y comprueba que image is not None antes de procesarla, ya que imread devuelve None si el archivo no existe o no se puede leer. Los ejemplos siguientes usan valores de canal de 8 bits, la representación habitual de los archivos de imagen comunes.
Cómo funciona la inversión de una imagen
La inversión convierte cada valor de canal en su complemento. Para valores sin signo de 8 bits, entre 0 y 255, el negro se vuelve blanco, el blanco se vuelve negro y un valor como 40 se convierte en 215. La operación se aplica por separado a cada canal, así que invierte los valores azul, verde y rojo de cada píxel en color. De forma predeterminada, el arreglo de color de OpenCV usa el orden BGR, no RGB; la inversión conserva ese orden de canales y, por tanto, no intercambia los colores.
Invertir una imagen con OpenCV
cv2.bitwise_not() de OpenCV aplica una operación NOT bit a bit a cada elemento del arreglo. En datos de imagen de 8 bits sin signo, el resultado es el mismo que restar cada valor de 255. Este pequeño ejemplo, que solo usa la biblioteca estándar, permite ver el cálculo de los píxeles sin necesitar un archivo de imagen ni un paquete de procesamiento de imágenes. Úsalo para entender los valores; con un arreglo de imagen de OpenCV, llama a cv2.bitwise_not(image) después de comprobar que la carga se realizó correctamente.
Ejecuta este ejemplo:
El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.
pixel = [10, 40, 200]
inverted_pixel = [255 - value for value in pixel]
print("original:", pixel)
print("inverted:", inverted_pixel)
original: [10, 40, 200]
inverted: [245, 215, 55]
Para trabajar con archivos, asigna a input_path y output_path la ruta de tu imagen y la del destino, y luego ejecuta este ejemplo. Instala OpenCV primero. Las rutas siguientes son marcadores explícitos que debes reemplazar por las de los archivos de tu equipo; el programa informa de un problema de carga o escritura sin intentar procesar una imagen que no se haya podido cargar.
try:
import cv2
except ImportError:
print("Install opencv-python to run this example.")
else:
input_path = "input.png"
output_path = "inverted.png"
image = cv2.imread(input_path)
if image is None:
print(f"Could not read {input_path}")
else:
inverted = cv2.bitwise_not(image)
written = cv2.imwrite(output_path, inverted)
if not written:
print(f"Could not write {output_path}")
show_preview = False
if show_preview:
cv2.imshow("Original", image)
cv2.imshow("Inverted", inverted)
cv2.waitKey(0)
cv2.destroyAllWindows()
El arreglo de color cargado y su resultado invertido se guardan en image y inverted. De forma predeterminada, OpenCV devuelve los canales de color en orden BGR; esta operación invierte cada canal sin cambiar su orden. El cálculo de píxeles de ejemplo anterior ilustra el mismo resultado para datos de 8 bits sin signo.
Invertir una imagen en escala de grises
Una imagen en escala de grises tiene un valor de intensidad por píxel, en lugar de tres canales de color. Cárgala directamente con cv2.IMREAD_GRAYSCALE, comprueba que gray_image is not None y aplica la misma operación bit a bit. El resultado sigue siendo un arreglo bidimensional de un solo canal y se puede guardar con cv2.imwrite().
El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.
try:
import cv2
except ImportError:
print("Install opencv-python to run this example.")
else:
input_path = "input.png"
gray_output_path = "inverted-gray.png"
gray_image = cv2.imread(input_path, cv2.IMREAD_GRAYSCALE)
if gray_image is None:
print(f"Could not read {input_path} as grayscale")
else:
inverted_gray = cv2.bitwise_not(gray_image)
written = cv2.imwrite(gray_output_path, inverted_gray)
if not written:
print(f"Could not write {gray_output_path}")
Invertir una imagen con NumPy
NumPy ofrece numpy.invert como alternativa cuando los datos de imagen ya están en un arreglo de NumPy. Esta función aplica NOT bit a bit a cada elemento; para valores de 8 bits sin signo, produce el mismo complemento de canal que OpenCV. Este ejemplo lee una imagen en color de 8 bits, aplica la inversión de NumPy y comprueba el resultado guardado. La interpretación 255 - v se limita aquí a datos de 8 bits sin signo: no la generalices a arreglos de enteros con signo o de mayor anchura, para los que NumPy sigue realizando un complemento bit a bit.
El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.
try:
import cv2
import numpy as np
except ImportError:
print("Install opencv-python and numpy to run this example.")
else:
input_path = "input.png"
numpy_output_path = "inverted-numpy.png"
image = cv2.imread(input_path)
if image is None:
print(f"Could not read {input_path}")
else:
inverted_numpy = np.invert(image)
written = cv2.imwrite(numpy_output_path, inverted_numpy)
if not written:
print(f"Could not write {numpy_output_path}")
Para archivos de imagen habituales de 8 bits, cv2.bitwise_not(image) y numpy.invert(image) producen el mismo resultado en cada canal. Elige la operación de OpenCV si el resto del flujo de trabajo ya usa OpenCV; usa la función de NumPy cuando necesites específicamente esa operación sobre arreglos.
Guardar y mostrar la imagen invertida
Escribe el arreglo correspondiente a la imagen que invertiste: usa cv2.imwrite(output_path, inverted) para el resultado en color o cv2.imwrite(gray_output_path, inverted_gray) para la imagen en escala de grises. Comprueba el valor booleano que devuelve la función: False significa que OpenCV no pudo escribir el archivo, por ejemplo, porque la ruta de destino no está disponible o el formato no es compatible. Los ejemplos comprueban este resultado con written e informan si la escritura falla.
El ejemplo de OpenCV incluye un bloque opcional de vista previa. Asigna True a show_preview para abrir ambas ventanas. La visualización con interfaz gráfica requiere un entorno gráfico y quizá no esté disponible en una sesión sin pantalla. Guardar con cv2.imwrite() no requiere abrir una ventana. Los ejemplos con archivos de imagen de OpenCV y NumPy están pensados para un entorno que tenga esos paquetes y un archivo input.png legible; la evidencia de ejecución proporcionada para este artículo solo abarca el pequeño cálculo de píxeles anterior.