Perspective Crop GTK

Perspective Crop GTK es una herramienta nativa para Linux basada en GTK 4 y OpenCV que permite recortar imágenes corrigiendo su perspectiva. Está diseñada para ofrecer un flujo de trabajo rápido, sin depender de Wine, PhotoImpact ni software propietario.

---

Características

• Interfaz nativa GTK 4.
• Zoom mediante la rueda del ratón.
• Selección de cuatro puntos para aplicar la corrección de perspectiva.
• Corrección automática mediante homografía (cv2.getPerspectiveTransform).
• Botón "Cancelar" que restaura la imagen original.
• Rotación izquierda y derecha.
• Guardado del resultado en formatos comunes (PNG, JPG, etc.).
• Sin dependencias externas no estándar: funciona con Python, GTK y OpenCV.

---

Requisitos

Ubuntu 24.04 o 25.04 (o distribuciones equivalentes).

Instalación de dependencias:

sudo apt install python3-opencv python3-gi gir1.2-gtk-4.0 python3-pil

Si es necesario, también se puede instalar NumPy en un entorno virtual:

python3 -m venv .venv
source .venv/bin/activate
pip install numpy

---

Instalación del programa

1. Clonar el repositorio:

   git clone https://github.com/Walter98garcia/PerspectiveCrop.git
   cd PerspectiveCrop

2. Ejecutar el instalador:

   chmod +x install.sh
   ./install.sh

3. Una vez instalado, el programa estará disponible en el menú de Ubuntu como “Perspective Crop” o puede ejecutarse desde terminal:

   perspective_crop_gtk.py

---

Estructura del proyecto

PerspectiveCrop/
├── perspective_crop_gtk.py     # Código principal (GTK + OpenCV + Pillow)
├── install.sh                   # Script de instalación en /opt y .desktop
├── icon.png                     # Ícono del programa
├── Screenshot.png               # Captura de pantalla de ejemplo
└── README.md                    # Este archivo

---

Uso básico

1. Abrir imagen Seleccione cualquier fotografía o escaneo con distorsión de perspectiva.

2. Marcar cuatro puntos Haga clic en las cuatro esquinas del área que desea enderezar. La corrección se aplica automáticamente al cuarto clic.

3. Opciones disponibles

   • Girar a la izquierda o a la derecha.
   • Cancelar para restaurar la imagen original.
   • Guardar para exportar el resultado corregido.

4. Zoom Utilice la rueda del ratón para acercar o alejar.

---

Tecnologías utilizadas

Componente	Función
GTK 4 (PyGObject)	Interfaz gráfica moderna y nativa de Linux
OpenCV	Cálculo de la homografía y corrección de perspectiva
Pillow (PIL)	Guardado de imágenes
NumPy	Operaciones matriciales y manipulación de puntos

---

Captura de pantalla

---

Autor

Walter García Estelí, Nicaragua Autor de la suite Synapse Languages y otros proyectos nativos para Linux.

---

Licencia

Este proyecto se distribuye bajo la MIT License. Se permite su uso, modificación y distribución, siempre que se mantenga la atribución correspondiente.