Module ImageQt de Pillow

ImageQt est un module important de la bibliothèque de traitement d'images Python Pillow. Il fournit des fonctionnalités pour convertir les objets d'image Pillow en formats compatibles avec Qt. Ce module est particulièrement utile lorsque vous devez afficher des images traitées par Pillow dans des applications Qt.

Le rôle principal du module ImageQt est de créer un pont entre Pillow et Qt, permettant aux développeurs d'afficher et de manipuler facilement des images traitées par Pillow dans des interfaces Qt.

Comment importer le module ImageQt :

from PIL import ImageQt

Méthodes principales expliquées

Le module ImageQt fournit plusieurs méthodes clés. Voici leurs descriptions détaillées :

Méthodes principales

Méthode Description Parameters Valeur de retour
ImageQt.ImageQt(image) Convertir une image Pillow en un objet image Qt image : objet PIL.Image objet QImage ou QPixmap
ImageQt.toqimage(image) Convertir une image Pillow en un objet QImage image : objet PIL.Image Objet QImage
ImageQt.fromqimage(qimage) Reconvertir un objet QImage en image Pillow qimage : objet QImage Objet PIL.Image

Méthodes utilitaires

Méthode Description Parameters Valeur de retour
ImageQt.rgb(r, g, b, a=255) Créer une valeur de couleur RGBA r,g,b,a : valeurs entières de 0 à 255 Valeur RGBA 32 bits
ImageQt.fromqpixmap(qpixmap) Reconvertir un objet QPixmap en image Pillow qpixmap : objet QPixmap Objet PIL.Image

Exemples d'utilisation

Exemple de conversion de base

Exemple

from PIL import Image
from PIL.ImageQt import ImageQt
from PyQt5.QtWidgets import QApplication, QLabel

# Charger l'image
img = Image.open("example.jpg")

# Convertir en image Qt
qimage = ImageQt(img)

# Afficher dans Qt
app = QApplication([])
label = QLabel()
label.setPixmap(qimage)
label.show()
app.exec_()

Exemple de conversion bidirectionnelle

Exemple

from PIL import Image
from PIL.ImageQt import fromqimage, toqimage
from PyQt5.QtGui import QImage

# Créer QImage
qimg = QImage(100, 100, QImage.Format_RGB32)
qimg.fill(Qt.white)

# Convertir en image PIL
pil_img = fromqimage(qimg)

# Modifier l'image
pil_img = pil_img.rotate(45)

# Reconvertir en QImage
new_qimg = toqimage(pil_img)

Notes

  1. Compatibilité des versions de Qt: ImageQt prend en charge PyQt5 et PySide2. Assurez-vous que la liaison Qt que vous utilisez correspond à votre projet.

  2. Formats d'image: Tous les modes d'image Pillow ne prennent pas en charge la conversion en images Qt. Les modes couramment pris en charge incluent :

    • "L" (pixels 8 bits, niveaux de gris)
    • "RGB" (pixels 3x8 bits, couleur vraie)
    • "RGBA" (pixels 4x8 bits, couleur vraie avec transparence)
  3. Considérations de performance: Les conversions fréquentes entre les formats d'image Pillow et Qt peuvent affecter les performances, vous devez donc minimiser le nombre de conversions.

  4. Gestion de la mémoire: Les objets d'image Qt convertis doivent être gérés par le système de gestion de mémoire de Qt ; ne les supprimez pas manuellement.


Utilisation avancée

Gestion de la transparence

Exemple

# Charger une image avec transparence
img = Image.open("transparent.png").convert("RGBA")
qimg = ImageQt(img)  # Gérer automatiquement la transparence

Conversion personnalisée

Exemple

# Traitement personnalisé des couleurs
from PIL import ImageOps

img = Image.open("photo.jpg")
img = ImageOps.colorize(img.convert("L"), "black", "gold")
qimg = ImageQt(img)

En maîtrisant le module ImageQt, vous pouvez facilement intégrer les puissantes capacités de traitement d'image de Pillow dans les applications Qt, offrant ainsi aux utilisateurs une riche expérience de manipulation d'images.

Autres extensions