QImage Class

Documentation des fonctions membres

[noexcept] QImage::QImage()

Construit une image nulle.

Voir aussi isNull().

[explicit] QImage::QImage(const char *const[] xpm)

Construit une image à partir de l'image xpm donnée.

Assurez-vous que l'image est une image XPM valide. Les erreurs sont ignorées silencieusement.

Notez qu'il est possible de réduire un peu la variable XPM en utilisant une déclaration inhabituelle :

static const char * const start_xpm[] = {
    "16 15 8 1",
    "a c #cec6bd",
    // etc.
};

Le const supplémentaire rend la définition entière en lecture seule, ce qui est légèrement plus efficace (par exemple, lorsque le code est dans une bibliothèque partagée) et peut être stocké en ROM avec l'application.

QImage::QImage(const QSize &size, QImage::Format format)

Construit une image avec les données size et format.

Une image null est renvoyée si la mémoire ne peut être allouée.

[explicit] QImage::QImage(const QString &fileName, const char *format = nullptr)

Construit une image et tente de charger l'image à partir du fichier avec l'adresse fileName.

Le chargeur tente de lire l'image à l'aide de l'adresse format. Si format n'est pas spécifié (ce qui est le cas par défaut), il est auto-détecté sur la base du suffixe et de l'en-tête du fichier. Pour plus de détails, voir {QImageReader::setAutoDetectImageFormat()}{QImageReader}.

Si le chargement de l'image a échoué, cet objet est une image nulle.

Le nom du fichier peut faire référence à un fichier réel sur le disque ou à l'une des ressources intégrées de l'application. Voir la vue d'ensemble du système de ressources pour plus de détails sur la manière d'intégrer des images et d'autres fichiers de ressources dans l'exécutable de l'application.

Voir également isNull() et Reading and Writing Image Files.

QImage::QImage(int width, int height, QImage::Format format)

Construit une image avec les données width, height et format.

Une image null sera renvoyée si la mémoire ne peut être allouée.

QImage::QImage(const uchar *data, int width, int height, QImage::Format format, QImageCleanupFunction cleanupFunction = nullptr, void *cleanupInfo = nullptr)

Construit une image avec les données width, height et format, qui utilise un tampon de mémoire en lecture seule existant, data. Les adresses width et height doivent être spécifiées en pixels, data doit être aligné sur 32 bits et chaque ligne de balayage des données de l'image doit également être alignée sur 32 bits.

Le tampon doit rester valide pendant toute la durée de vie de l'image QImage et de toutes les copies qui n'ont pas été modifiées ou détachées du tampon d'origine. L'image ne supprime pas le tampon lors de sa destruction. Vous pouvez fournir un pointeur de fonction cleanupFunction ainsi qu'un pointeur supplémentaire cleanupInfo qui sera appelé lorsque la dernière copie sera détruite.

Si format est un format de couleur indexé, la table des couleurs de l'image est initialement vide et doit être suffisamment étendue avec setColorCount() ou setColorTable() avant que l'image ne soit utilisée.

Contrairement au constructeur similaire de QImage qui prend un tampon de données non-const, cette version ne modifiera jamais le contenu du tampon. Par exemple, l'appel à QImage::bits() renverra une copie profonde de l'image, plutôt que le tampon transmis au constructeur. Cela permet de construire efficacement une QImage à partir de données brutes, sans que celles-ci puissent être modifiées.

QImage::QImage(uchar *data, int width, int height, QImage::Format format, QImageCleanupFunction cleanupFunction = nullptr, void *cleanupInfo = nullptr)

Construit une image avec les données width, height et format, qui utilise un tampon de mémoire existant, data. Les adresses width et height doivent être spécifiées en pixels, data doit être aligné sur 32 bits et chaque ligne de balayage des données de l'image doit également être alignée sur 32 bits.

Le tampon doit rester valide pendant toute la durée de vie de l'image QImage et de toutes les copies qui n'ont pas été modifiées ou détachées du tampon d'origine. L'image ne supprime pas le tampon lors de sa destruction. Vous pouvez fournir un pointeur de fonction cleanupFunction ainsi qu'un pointeur supplémentaire cleanupInfo qui sera appelé lorsque la dernière copie sera détruite.

Si format est un format de couleur indexé, la table des couleurs de l'image est initialement vide et doit être suffisamment étendue avec setColorCount() ou setColorTable() avant que l'image ne soit utilisée.

QImage::QImage(const uchar *data, int width, int height, qsizetype bytesPerLine, QImage::Format format, QImageCleanupFunction cleanupFunction = nullptr, void *cleanupInfo = nullptr)

Construit une image avec les données width, height et format, qui utilise un tampon de mémoire existant, data. Les adresses width et height doivent être spécifiées en pixels. bytesPerLine spécifie le nombre d'octets par ligne (stride).

Le tampon doit rester valide pendant toute la durée de vie de l'image QImage et de toutes les copies qui n'ont pas été modifiées ou détachées du tampon d'origine. L'image ne supprime pas le tampon lors de sa destruction. Vous pouvez fournir un pointeur de fonction cleanupFunction ainsi qu'un pointeur supplémentaire cleanupInfo qui sera appelé lorsque la dernière copie sera détruite.

Si format est un format de couleur indexé, la table des couleurs de l'image est initialement vide et doit être suffisamment étendue avec setColorCount() ou setColorTable() avant que l'image ne soit utilisée.

Contrairement au constructeur similaire de QImage qui prend un tampon de données non-const, cette version ne modifiera jamais le contenu du tampon. Par exemple, l'appel à QImage::bits() renverra une copie profonde de l'image, plutôt que le tampon transmis au constructeur. Cela permet de construire efficacement une QImage à partir de données brutes, sans que celles-ci puissent être modifiées.

QImage::QImage(uchar *data, int width, int height, qsizetype bytesPerLine, QImage::Format format, QImageCleanupFunction cleanupFunction = nullptr, void *cleanupInfo = nullptr)

Construit une image avec les données width, height et format, qui utilise un tampon de mémoire existant, data. Les adresses width et height doivent être spécifiées en pixels. bytesPerLine spécifie le nombre d'octets par ligne (stride).

Le tampon doit rester valide pendant toute la durée de vie de l'image QImage et de toutes les copies qui n'ont pas été modifiées ou détachées du tampon d'origine. L'image ne supprime pas le tampon lors de sa destruction. Vous pouvez fournir un pointeur de fonction cleanupFunction ainsi qu'un pointeur supplémentaire cleanupInfo qui sera appelé lorsque la dernière copie sera détruite.

Si format est un format de couleur indexé, la table des couleurs de l'image est initialement vide et doit être suffisamment étendue avec setColorCount() ou setColorTable() avant que l'image ne soit utilisée.

QImage::QImage(const QImage &image)

Construit une copie superficielle de l'adresse image donnée.

Pour plus d'informations sur les copies superficielles, voir la documentation sur le partage implicite des données.

Voir aussi copy().

[noexcept] QImage::QImage(QImage &&other)

Move-construit une instance de QImage, en la faisant pointer sur le même objet que celui vers lequel other pointait.

[virtual noexcept] QImage::~QImage()

Détruit l'image et nettoie.

bool QImage::allGray() const

Renvoie true si toutes les couleurs de l'image sont des nuances de gris (c'est-à-dire que leurs composantes rouge, verte et bleue sont égales), sinon false.

Notez que cette fonction est lente pour les images sans table des couleurs.

Voir aussi isGrayscale().

void QImage::applyColorTransform(const QColorTransform &transform)

Applique la transformation de couleur transform à tous les pixels de l'image.

[since 6.8] void QImage::applyColorTransform(const QColorTransform &transform, QImage::Format toFormat, Qt::ImageConversionFlags flags = Qt::AutoColor)

Applique la transformation des couleurs transform à tous les pixels de l'image et convertit le format de l'image en toFormat.

La conversion d'image spécifiée flags contrôle la manière dont les données de l'image sont traitées au cours du processus de conversion de format.

Cette fonction a été introduite dans Qt 6.8.

int QImage::bitPlaneCount() const

Renvoie le nombre de plans de bits dans l'image.

Le nombre de plans de bits est le nombre de bits d'informations de couleur et de transparence pour chaque pixel. Ce nombre est différent (c'est-à-dire plus petit) de la profondeur lorsque le format de l'image contient des bits inutilisés.

Voir également depth(), format() et Image Formats.

uchar *QImage::bits()

Renvoie un pointeur sur les données du premier pixel. Cela équivaut à scanLine(0).

Notez que QImage utilise un partage implicite des données. Cette fonction effectue une copie profonde des données de pixels partagées, garantissant ainsi que ce site QImage est le seul à utiliser la valeur de retour actuelle.

Voir également scanLine(), sizeInBytes() et constBits().

const uchar *QImage::bits() const

Notez que QImage utilise le partage implicite des données, mais cette fonction n' effectue pas de copie profonde des données de pixels partagées, car les données renvoyées sont constantes.

qsizetype QImage::bytesPerLine() const

Renvoie le nombre d'octets par ligne de balayage de l'image.

Ceci est équivalent à sizeInBytes() / height() si height() est différent de zéro.

Voir aussi scanLine().

qint64 QImage::cacheKey() const

Renvoie un nombre qui identifie le contenu de cet objet QImage. Des objets QImage distincts ne peuvent avoir la même clé que s'ils font référence au même contenu.

La clé change lorsque l'image est modifiée.

QRgb QImage::color(int i) const

Renvoie la couleur de la table des couleurs à l'index i. La première couleur est à l'index 0.

Les couleurs de la table des couleurs d'une image sont spécifiées sous forme de quadruplets ARGB (QRgb). Utilisez les fonctions qAlpha(), qRed(), qGreen() et qBlue() pour obtenir les composantes de la valeur de la couleur.

Voir également setColor(), pixelIndex() et Pixel Manipulation.

int QImage::colorCount() const

Renvoie la taille de la table des couleurs de l'image.

Notez que colorCount() renvoie 0 pour les images 32-bpp car ces images n'utilisent pas de tables de couleurs, mais encodent les valeurs des pixels sous forme de quadruplets ARGB.

Voir aussi setColorCount() et Image Information.

QColorSpace QImage::colorSpace() const

Renvoie l'espace couleur de l'image si un espace couleur est défini.

Voir aussi setColorSpace().

QList<QRgb> QImage::colorTable() const

Renvoie une liste des couleurs contenues dans la table des couleurs de l'image, ou une liste vide si l'image n'a pas de table des couleurs

Voir aussi setColorTable(), colorCount(), et color().

[since 6.4] QImage QImage::colorTransformed(const QColorTransform &transform) const &

Renvoie la couleur de l'image transformée en utilisant transform sur tous les pixels de l'image.

Cette fonction a été introduite dans Qt 6.4.

Voir aussi applyColorTransform().

[since 6.8] QImage QImage::colorTransformed(const QColorTransform &transform, QImage::Format toFormat, Qt::ImageConversionFlags flags = Qt::AutoColor) const &

Renvoie la couleur de l'image transformée à l'aide de transform sur tous les pixels de l'image, ce qui renvoie une image au format toFormat.

La conversion d'image spécifiée flags contrôle la manière dont les données de l'image sont traitées au cours du processus de conversion de format.

Cette fonction a été introduite dans Qt 6.8.

Voir aussi applyColorTransform().

[since 6.4] QImage QImage::colorTransformed(const QColorTransform &transform) &&

Renvoie la couleur de l'image transformée en utilisant transform sur tous les pixels de l'image.

Cette fonction a été introduite dans Qt 6.4.

Voir aussi applyColorTransform().

[since 6.8] QImage QImage::colorTransformed(const QColorTransform &transform, QImage::Format format, Qt::ImageConversionFlags flags = Qt::AutoColor) &&

Renvoie la couleur de l'image transformée en utilisant transform sur tous les pixels de l'image.

Cette fonction a été introduite dans Qt 6.8.

Voir aussi applyColorTransform().

const uchar *QImage::constBits() const

Renvoie un pointeur sur les données du premier pixel.

Notez que QImage utilise un partage implicite des données, mais cette fonction n' effectue pas de copie profonde des données de pixels partagées, car les données renvoyées sont constantes.

Voir aussi bits() et constScanLine().

const uchar *QImage::constScanLine(int i) const

Renvoie un pointeur sur les données du pixel à la ligne de balayage avec l'index i. La première ligne de balayage est à l'index 0.

Les données de la ligne de balayage sont alignées sur 32 bits au minimum. Pour les formats 64 bits, elles suivent l'alignement natif des entiers 64 bits (64 bits pour la plupart des plates-formes, mais surtout 32 bits sur i386).

Notez que QImage utilise un partage implicite des données, mais cette fonction n' effectue pas de copie profonde des données de pixels partagées, car les données renvoyées sont constantes.

Voir aussi scanLine() et constBits().

void QImage::convertTo(QImage::Format format, Qt::ImageConversionFlags flags = Qt::AutoColor)

Convertit l'image à l'endroit donné format, en la détachant si nécessaire.

La conversion d'image spécifiée flags contrôle la manière dont les données de l'image sont traitées au cours du processus de conversion.

Voir aussi convertedTo().

void QImage::convertToColorSpace(const QColorSpace &colorSpace)

Convertit l'image en colorSpace.

Si l'image n'a pas d'espace couleur valide, la méthode ne fait rien.

Voir également convertedToColorSpace() et setColorSpace().

[since 6.8] void QImage::convertToColorSpace(const QColorSpace &colorSpace, QImage::Format format, Qt::ImageConversionFlags flags = Qt::AutoColor)

Convertit l'image en colorSpace et format.

Si l'image n'a pas d'espace colorimétrique valide, la méthode ne fait rien, ni si l'espace colorimétrique n'est pas compatible avec le format.

La conversion d'image spécifiée flags contrôle la manière dont les données de l'image sont traitées au cours du processus de conversion de format.

Cette fonction a été introduite dans Qt 6.8.

Voir aussi convertedToColorSpace() et setColorSpace().

Renvoie une copie de l'image dans le fichier format.

La conversion d'image spécifiée flags contrôle la manière dont les données de l'image sont traitées au cours du processus de conversion.

Voir aussi convertTo() et Image Formats.

QImage QImage::convertToFormat(QImage::Format format, const QList<QRgb> &colorTable, Qt::ImageConversionFlags flags = Qt::AutoColor) const

Renvoie une copie de l'image convertie au format donné format, en utilisant le format spécifié colorTable.

La conversion des formats RVB en formats indexés est une opération lente et utilise une approche directe de la couleur la plus proche, sans tramage.

Renvoie une copie de l'image dans le fichier format.

Les fonctions de conversion d'image spécifiées flags contrôlent la manière dont les données d'image sont traitées au cours du processus de conversion.

Ces fonctions ont été introduites dans Qt 6.0.

Voir aussi convertTo() et Image Formats.

QImage QImage::convertedToColorSpace(const QColorSpace &colorSpace) const

Renvoie l'image convertie en colorSpace.

Si l'image n'a pas d'espace colorimétrique valide, une valeur null QImage est renvoyée.

Voir aussi convertToColorSpace() et colorTransformed().

Renvoie l'image convertie en colorSpace et format.

Si l'image n'a pas d'espace couleur valide, une valeur null QImage est renvoyée.

Les fonctions de conversion d'image spécifiées flags contrôlent la manière dont les données d'image sont traitées au cours du processus de conversion de format.

Ces fonctions ont été introduites dans Qt 6.8.

Voir aussi colorTransformed().

QImage QImage::copy(const QRect &rectangle = QRect()) const

Renvoie une sous-zone de l'image sous la forme d'une nouvelle image.

L'image renvoyée est copiée à partir de la position (rectangle.x(), rectangle.y()) dans cette image, et aura toujours la taille de la zone rectangle.

Dans les zones situées au-delà de cette image, les pixels sont mis à 0. Pour les images RVB 32 bits, cela signifie noir ; pour les images ARGB 32 bits, cela signifie noir transparent ; pour les images 8 bits, cela signifie la couleur avec l'index 0 dans la table des couleurs, qui peut être n'importe quoi ; pour les images 1 bit, cela signifie Qt::color0.

Si l'adresse rectangle est un rectangle nul, l'image entière est copiée.

Voir aussi QImage().

QImage QImage::copy(int x, int y, int width, int height) const

L'image renvoyée est copiée à partir de la position (x, y) dans cette image, et aura toujours les valeurs width et height. Dans les zones situées au-delà de cette image, les pixels sont mis à 0.

QImage QImage::createAlphaMask(Qt::ImageConversionFlags flags = Qt::AutoColor) const

Construit et renvoie un masque 1-bpp à partir du tampon alpha de cette image. Renvoie une image nulle si le format de l'image est QImage::Format_RGB32.

L'argument flags est un OU bit à bit de l'argument Qt::ImageConversionFlags, et contrôle le processus de conversion. En passant 0 pour les drapeaux, toutes les options par défaut sont activées.

L'image renvoyée a un ordre de bits little-endian (c'est-à-dire que le format de l'image est QImage::Format_MonoLSB), que vous pouvez convertir en big-endian (QImage::Format_Mono) à l'aide de la fonction convertToFormat().

Voir aussi createHeuristicMask() et Image Transformations.

QImage QImage::createHeuristicMask(bool clipTight = true) const

Crée et renvoie un masque heuristique de 1 bpp pour cette image.

La fonction fonctionne en sélectionnant une couleur dans l'un des coins, puis en éliminant les pixels de cette couleur en commençant par tous les bords. Les quatre coins votent pour la couleur à masquer. En cas de tirage au sort (ce qui signifie généralement que cette fonction n'est pas applicable à l'image), le résultat est arbitraire.

L'image renvoyée a un ordre de bits little-endian (c'est-à-dire que le format de l'image est QImage::Format_MonoLSB), que vous pouvez convertir en big-endian (QImage::Format_Mono) à l'aide de la fonction convertToFormat().

Si clipTight est vrai (par défaut), le masque est juste assez grand pour couvrir les pixels ; sinon, le masque est plus grand que les pixels de données.

Notez que cette fonction ne tient pas compte du tampon alpha.

Voir également createAlphaMask() et Image Transformations.

QImage QImage::createMaskFromColor(QRgb color, Qt::MaskMode mode = Qt::MaskInColor) const

Crée et renvoie un masque pour cette image sur la base de la valeur color donnée. Si la valeur mode est MaskInColor (valeur par défaut), tous les pixels correspondant à color seront des pixels opaques dans le masque. Si mode est MaskOutColor, tous les pixels correspondant à la couleur donnée seront transparents.

Voir également createAlphaMask() et createHeuristicMask().

int QImage::depth() const

Renvoie la profondeur de l'image.

La profondeur de l'image est le nombre de bits utilisés pour stocker un seul pixel, également appelé bits par pixel (bpp).

Les profondeurs prises en charge sont 1, 8, 16, 24, 32 et 64.

Voir aussi bitPlaneCount(), convertToFormat(), Image Formats, et Image Information.

[since 6.2] QSizeF QImage::deviceIndependentSize() const

Renvoie la taille de l'image en pixels indépendants du périphérique.

Cette valeur doit être utilisée lorsque la taille de l'image est utilisée pour calculer la taille de l'interface utilisateur.

La valeur de retour est équivalente à image.size() / image.devicePixelRatio().

Cette fonction a été introduite dans Qt 6.2.

qreal QImage::devicePixelRatio() const

Renvoie le rapport de pixels du périphérique pour l'image. Il s'agit du rapport entre les pixels du périphérique et les pixels indépendants du périphérique.

Utilisez cette fonction pour calculer la géométrie de la mise en page en fonction de la taille de l'image : QSize layoutSize = image.size() / image.devicePixelRatio()

La valeur par défaut est 1,0.

Voir également setDevicePixelRatio() et QImageReader.

int QImage::dotsPerMeterX() const

Renvoie le nombre de pixels qui tiennent horizontalement dans un mètre physique. Avec dotsPerMeterY(), ce nombre définit l'échelle et le rapport d'aspect de l'image.

Voir également setDotsPerMeterX() et Image Information.

int QImage::dotsPerMeterY() const

Renvoie le nombre de pixels qui tiennent verticalement dans un mètre physique. Avec dotsPerMeterX(), ce nombre définit l'échelle et le rapport d'aspect de l'image.

Voir également setDotsPerMeterY() et Image Information.

void QImage::fill(uint pixelValue)

Remplit l'ensemble de l'image avec l'adresse pixelValue.

Si la profondeur de cette image est de 1, seul le bit le plus bas est utilisé. Si vous dites fill(0), fill(2), etc., l'image est remplie de 0. Si vous dites fill(1), fill(3), etc., l'image est remplie de 1. Si la profondeur est de 8, les 8 bits les plus bas sont utilisés et si la profondeur est de 16, les 16 bits les plus bas sont utilisés.

Si la profondeur de l'image est supérieure à 32 bits, le résultat est indéfini.

Voir aussi depth() et Image Transformations.

void QImage::fill(Qt::GlobalColor color)

Remplit l'image avec la valeur color, décrite comme une couleur globale standard.

void QImage::fill(const QColor &color)

Remplit l'ensemble de l'image avec la valeur donnée color.

Si la profondeur de l'image est de 1, l'image sera remplie avec 1 si color est égal à Qt::color1; sinon elle sera remplie avec 0.

Si la profondeur de l'image est de 8, l'image sera remplie avec l'index correspondant à color dans la table des couleurs si elle est présente ; sinon, elle sera remplie avec 0.

[since 6.9] void QImage::flip(Qt::Orientations orient = Qt::Vertical)

Retourne ou reflète l'image dans le sens horizontal et/ou vertical en fonction de orient.

Cette fonction a été introduite dans Qt 6.9.

Voir aussi flipped(Qt::Orientations) et Image Transformations.

Renvoie une version inversée ou miroir de l'image, inversée dans le sens horizontal et/ou vertical selon orient.

Notez que l'image originale n'est pas modifiée.

Ces fonctions ont été introduites dans Qt 6.9.

Voir aussi flip(Qt::Orientations) et Image Transformations.

QImage::Format QImage::format() const

Renvoie le format de l'image.

Voir aussi Image Formats.

[static, since 6.2] QImage QImage::fromData(QByteArrayView data, const char *format = nullptr)

Construit une image à partir du fichier QByteArrayView data . Le chargeur tente de lire l'image en utilisant le format spécifié format. Si format n'est pas spécifié (ce qui est le cas par défaut), le chargeur recherche un en-tête dans les données pour deviner le format du fichier.

Si format est spécifié, il doit s'agir d'une des valeurs renvoyées par QImageReader::supportedImageFormats().

Si le chargement de l'image échoue, l'image renvoyée sera une image nulle.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi load(), save(), et Reading and Writing Image Files.

[static] QImage QImage::fromData(const QByteArray &data, const char *format = nullptr)

Construit un QImage à partir du QByteArray data donné.

[static] QImage QImage::fromData(const uchar *data, int size, const char *format = nullptr)

Construit un QImage à partir des premiers octets size du binaire data donné.

[static, since 6.0] QImage QImage::fromHBITMAP(HBITMAP hbitmap)

Renvoie une adresse QImage équivalente à l'adresse hbitmap.

HBITMAP ne stocke pas d'informations sur le canal alpha.

Dans le cas standard, le canal alpha est ignoré et une image totalement opaque est créée (typiquement au format QImage::Format_RGB32).

Il existe cependant des cas où le canal alpha est utilisé, par exemple pour les icônes d'application ou les icônes de la barre d'état système. Dans ce cas, reinterpretAsFormat(QImage::Format_ARGB32) doit être appelé sur l'image renvoyée pour s'assurer que le format est correct.

Cette fonction a été introduite dans Qt 6.0.

Voir aussi toHBITMAP() et reinterpretAsFormat().

[static, since 6.0] QImage QImage::fromHICON(HICON icon)

Retourne un QImage qui est équivalent au icon donné.

Cette fonction a été introduite dans Qt 6.0.

Voir aussi toHICON().

bool QImage::hasAlphaChannel() const

Renvoie true si l'image a un format qui respecte le canal alpha, sinon renvoie false.

Voir aussi Image Information.

int QImage::height() const

Renvoie la hauteur de l'image.

Voir aussi Image Information.

void QImage::invertPixels(QImage::InvertMode mode = InvertRgb)

Inverse toutes les valeurs des pixels de l'image.

L'inversion donnée à mode n'a de sens que si la profondeur de l'image est de 32. La valeur par défaut de mode est InvertRgb, ce qui laisse le canal alpha inchangé. Si mode est InvertRgba, les bits alpha sont également inversés.

Inverser une image 8 bits signifie remplacer tous les pixels utilisant l'indice de couleur i par un pixel utilisant l'indice de couleur 255 moins i. Il en va de même pour une image 1 bit. Notez que la table des couleurs n' est pas modifiée.

Si l'image possède un canal alpha prémultiplié, elle est d'abord convertie dans un format d'image non multiplié pour être inversée, puis reconvertie.

Voir aussi Image Transformations.

bool QImage::isGrayscale() const

Pour les images 32 bits, cette fonction est équivalente à allGray().

Pour les images indexées en couleur, cette fonction renvoie true si color(i) est QRgb(i, i, i) pour tous les index de la table des couleurs ; sinon, elle renvoie false.

Voir également allGray() et Image Formats.

bool QImage::isNull() const

Renvoie true s'il s'agit d'une image nulle, sinon renvoie false.

Une image nulle a tous les paramètres fixés à zéro et aucune donnée allouée.

bool QImage::load(const QString &fileName, const char *format = nullptr)

Charge une image à partir du fichier avec l'adresse fileName. Retourne true si l'image a été chargée avec succès ; sinon, invalide l'image et retourne false.

Le chargeur tente de lire l'image à l'aide de l'adresse format spécifiée, par exemple PNG ou JPG. Si format n'est pas spécifié (ce qui est le cas par défaut), il est auto-détecté sur la base du suffixe et de l'en-tête du fichier. Pour plus de détails, voir QImageReader::setAutoDetectImageFormat().

Le nom du fichier peut faire référence soit à un fichier réel sur le disque, soit à l'une des ressources intégrées de l'application. Voir la vue d'ensemble du système de ressources pour plus de détails sur la manière d'intégrer des images et d'autres fichiers de ressources dans l'exécutable de l'application.

Voir aussi Reading and Writing Image Files.

bool QImage::load(QIODevice *device, const char *format)

Cette fonction lit un QImage à partir du device donné. Elle peut, par exemple, être utilisée pour charger une image directement dans un QByteArray.

[since 6.2] bool QImage::loadFromData(QByteArrayView data, const char *format = nullptr)

Charge une image à partir du site QByteArrayView data . Retourne true si l'image a été chargée avec succès ; sinon, invalide l'image et retourne false.

Le chargeur tente de lire l'image à l'aide de l'adresse format spécifiée, par exemple PNG ou JPG. Si format n'est pas spécifié (ce qui est le cas par défaut), le chargeur recherche dans le fichier un en-tête permettant de deviner le format du fichier.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi Reading and Writing Image Files.

bool QImage::loadFromData(const QByteArray &data, const char *format = nullptr)

Charge une image à partir du site QByteArray data .

bool QImage::loadFromData(const uchar *data, int len, const char *format = nullptr)

Charge une image à partir des premiers len octets du fichier binaire donné data.

[since 6.0, until 6.13] void QImage::mirror(bool horizontal = false, bool vertical = true)

Cette fonction sera obsolète à partir de la version 6.13.

Utilisez flip(Qt::Orientations) à la place.

Miroir de l'image dans la direction horizontale et/ou verticale selon que horizontal et vertical sont réglés sur true ou false.

Cette fonction a été introduite dans Qt 6.0.

Voir aussi mirrored() et Image Transformations.

Cette fonction sera obsolète à partir de la version 6.13.

Utilisez flipped(Qt::Orientations) à la place.

Renvoie un miroir de l'image, dans le sens horizontal et/ou vertical, selon que horizontal et vertical sont réglés sur true ou false.

Notez que l'image originale n'est pas modifiée.

Voir aussi mirror() et Image Transformations.

QPoint QImage::offset() const

Renvoie le nombre de pixels dont l'image doit être décalée lors de son positionnement par rapport à d'autres images.

Voir aussi setOffset() et Image Information.

QRgb QImage::pixel(const QPoint &position) const

Renvoie la couleur du pixel à l'adresse position.

Si l'adresse position n'est pas valide, les résultats sont indéfinis.

Voir aussi setPixel(), valid(), constBits(), constScanLine() et Pixel Manipulation.

QRgb QImage::pixel(int x, int y) const

Renvoie la couleur du pixel aux coordonnées (x, y).

QColor QImage::pixelColor(const QPoint &position) const

Renvoie la couleur du pixel situé à l'endroit donné position sous la forme d'un QColor.

Si l'adresse position n'est pas valide, une adresse QColor invalide est renvoyée.

Voir aussi setPixelColor(), setPixel(), valid(), constBits(), constScanLine() et Pixel Manipulation.

QColor QImage::pixelColor(int x, int y) const

Renvoie la couleur du pixel aux coordonnées (x, y) sous forme de QColor.

[noexcept] QPixelFormat QImage::pixelFormat() const

Retourne le site QImage::Format sous la forme d'un QPixelFormat

int QImage::pixelIndex(const QPoint &position) const

Renvoie l'index du pixel à l'adresse position.

Si position n'est pas valide, ou si l'image n'est pas une image palettisée (depth() > 8), les résultats sont indéfinis.

Voir aussi valid(), depth(), et Pixel Manipulation.

int QImage::pixelIndex(int x, int y) const

Renvoie l'indice de pixel à (x, y).

QRect QImage::rect() const

Renvoie le rectangle englobant (0, 0, width(), height()) de l'image.

Voir aussi Image Information.

bool QImage::reinterpretAsFormat(QImage::Format format)

Change le format de l'image à format sans changer les données. Ne fonctionne qu'avec des formats de même profondeur.

Retourne true en cas de succès.

Cette fonction peut être utilisée pour changer des images avec des canaux alpha en leurs formats opaques correspondants si les données sont connues pour être uniquement opaques, ou pour changer le format d'un tampon d'image donné avant de l'écraser avec de nouvelles données.

Voir aussi hasAlphaChannel() et convertToFormat().

[since 6.0] void QImage::rgbSwap()

Intervertit les valeurs des composantes rouge et bleue de tous les pixels, convertissant ainsi une image RVB en une image BGR.

Cette fonction a été introduite dans Qt 6.0.

Voir aussi rgbSwapped() et Image Transformations.

Renvoie une page QImage dans laquelle les valeurs des composantes rouge et bleue de tous les pixels ont été échangées, convertissant ainsi une image RGB en une image BGR.

L'image originale QImage n'est pas modifiée.

Voir également rgbSwap() et Image Transformations.

bool QImage::save(const QString &fileName, const char *format = nullptr, int quality = -1) const

Enregistre l'image dans le fichier avec l'adresse fileName, en utilisant le fichier image format et le facteur quality. Si format est nullptr, QImage tentera de deviner le format en regardant le suffixe de fileName.

Le facteur quality doit être compris entre 0 et 100 ou -1. Spécifiez 0 pour obtenir de petits fichiers compressés, 100 pour de gros fichiers non compressés et -1 (par défaut) pour utiliser les paramètres par défaut.

Renvoie true si l'image a été enregistrée avec succès ; sinon, renvoie false.

Voir également Reading and Writing Image Files.

bool QImage::save(QIODevice *device, const char *format = nullptr, int quality = -1) const

Cette fonction écrit un QImage dans le device donné.

Elle peut, par exemple, être utilisée pour enregistrer une image directement dans un QByteArray:

QImage image;
QByteArray ba;
QBuffer buffer(&ba);
buffer.open(QIODevice::WriteOnly);
image.save(&buffer, "PNG"); // writes image into ba in PNG format

QImage QImage::scaled(const QSize &size, Qt::AspectRatioMode aspectRatioMode = Qt::IgnoreAspectRatio, Qt::TransformationMode transformMode = Qt::FastTransformation) const

Renvoie une copie de l'image mise à l'échelle d'un rectangle défini par size en fonction de aspectRatioMode et transformMode.

• Si aspectRatioMode est Qt::IgnoreAspectRatio, l'image est mise à l'échelle de size.
• Si aspectRatioMode est Qt::KeepAspectRatio, l'image est réduite à un rectangle aussi grand que possible à l'intérieur de size, en préservant le rapport hauteur/largeur.
• Si aspectRatioMode est Qt::KeepAspectRatioByExpanding, l'image est réduite à un rectangle aussi petit que possible à l'extérieur de size, en préservant le rapport hauteur/largeur.

Si size est vide, cette fonction renvoie une image nulle.

Voir aussi isNull() et Image Transformations.

QImage QImage::scaled(int width, int height, Qt::AspectRatioMode aspectRatioMode = Qt::IgnoreAspectRatio, Qt::TransformationMode transformMode = Qt::FastTransformation) const

Renvoie une copie de l'image mise à l'échelle d'un rectangle avec les données width et height en fonction des données aspectRatioMode et transformMode.

Si width ou height est nul ou négatif, cette fonction renvoie une image nulle.

QImage QImage::scaledToHeight(int height, Qt::TransformationMode mode = Qt::FastTransformation) const

Renvoie une copie à l'échelle de l'image. L'image renvoyée est mise à l'échelle de la valeur donnée height à l'aide de la transformation spécifiée mode.

Cette fonction calcule automatiquement la largeur de l'image afin que le rapport de l'image soit préservé.

Si height est égal à 0 ou négatif, l'image renvoyée est nulle.

Voir aussi Image Transformations.

QImage QImage::scaledToWidth(int width, Qt::TransformationMode mode = Qt::FastTransformation) const

Renvoie une copie à l'échelle de l'image. L'image renvoyée est mise à l'échelle sur le site width à l'aide de la transformation spécifiée mode.

Cette fonction calcule automatiquement la hauteur de l'image afin de préserver son rapport hauteur/largeur.

Si width est égal à 0 ou négatif, l'image renvoyée est nulle.

Voir aussi Image Transformations.

uchar *QImage::scanLine(int i)

Renvoie un pointeur sur les données du pixel à la ligne de balayage avec l'index i. La première ligne de balayage est à l'index 0.

Les données de la ligne de balayage sont alignées sur 32 bits au minimum. Pour les formats 64 bits, elles suivent l'alignement natif des entiers 64 bits (64 bits pour la plupart des plates-formes, mais notamment 32 bits sur i386).

Par exemple, pour supprimer la composante verte de chaque pixel d'une image :

for (int y = 0; y < image.height(); ++y) {
    QRgb *line = reinterpret_cast<QRgb*>(image.scanLine(y));
    for (int x = 0; x < image.width(); ++x) {
        QRgb &rgb = line[x];
        rgb = qRgba(qRed(rgb), qGreen(0), qBlue(rgb), qAlpha(rgb));
    }
}

Voir aussi bytesPerLine(), bits(), Pixel Manipulation, et constScanLine().

const uchar *QImage::scanLine(int i) const

void QImage::setAlphaChannel(const QImage &alphaChannel)

Définit le canal alpha de cette image à l'adresse alphaChannel.

Si alphaChannel est une image alpha 8 bits, les valeurs alpha sont utilisées directement. Sinon, alphaChannel est converti en niveaux de gris 8 bits et l'intensité des valeurs des pixels est utilisée.

Si l'image possède déjà un canal alpha, celui-ci est multiplié par le nouveau. Si l'image n'a pas de canal alpha, elle sera convertie dans un format qui en a un.

L'opération est similaire à l'application de alphaChannel comme image alpha sur cette image à l'aide de QPainter::CompositionMode_DestinationIn.

Voir aussi hasAlphaChannel(), Image Transformations, et Image Formats.

void QImage::setColor(int index, QRgb colorValue)

Définit la couleur à l'adresse index dans la table des couleurs, à l'adresse colorValue. La valeur de la couleur est un quadruplet ARGB.

Si index est en dehors de la taille actuelle de la table des couleurs, il est étendu avec setColorCount().

Voir aussi color(), colorCount(), setColorTable() et Pixel Manipulation.

void QImage::setColorCount(int colorCount)

Redimensionne la table des couleurs pour qu'elle contienne colorCount entrées.

Si la table des couleurs est étendue, toutes les couleurs supplémentaires seront définies comme transparentes (c'est-à-dire qRgba(0, 0, 0, 0)).

Lorsque l'image est utilisée, la table des couleurs doit être suffisamment grande pour contenir des entrées pour toutes les valeurs de pixel/index présentes dans l'image, sinon les résultats sont indéfinis.

Voir aussi colorCount(), colorTable(), setColor() et Image Transformations.

void QImage::setColorSpace(const QColorSpace &colorSpace)

Définit l'espace colorimétrique de l'image à colorSpace sans effectuer de conversion sur les données de l'image.

Voir aussi colorSpace().

void QImage::setColorTable(const QList<QRgb> &colors)

Définit la table des couleurs utilisée pour traduire les indices de couleur en valeurs QRgb, à l'adresse colors spécifiée.

Lorsque l'image est utilisée, la table des couleurs doit être suffisamment grande pour contenir des entrées pour toutes les valeurs de pixel/indice présentes dans l'image, sinon les résultats sont indéfinis.

Voir également colorTable(), setColor() et Image Transformations.

void QImage::setDevicePixelRatio(qreal scaleFactor)

Définit le rapport de pixels du périphérique pour l'image. Il s'agit du rapport entre les pixels de l'image et les pixels indépendants du périphérique.

La valeur par défaut de scaleFactor est 1,0. La définition d'une autre valeur a deux effets :

Les QPainters ouverts sur l'image seront mis à l'échelle. Par exemple, peindre sur une image de 200x200 avec un ratio de 2.0 donnera des limites de peinture effectives (indépendantes du périphérique) de 100x100.

Les chemins de code dans Qt XML qui calculent la géométrie de la disposition en fonction de la taille de l'image prendront le ratio en compte : QSize layoutSize = image.size() / image.devicePixelRatio() L'effet net de ceci est que l'image est affichée comme une image à haut DPI plutôt que comme une grande image (voir Drawing High Resolution Versions of Pixmaps and Images).

Voir également devicePixelRatio() et deviceIndependentSize().

void QImage::setDotsPerMeterX(int x)

Définit le nombre de pixels qui tiennent horizontalement dans un mètre physique, à x.

Avec dotsPerMeterY(), ce nombre définit l'échelle et le rapport hauteur/largeur de l'image et détermine l'échelle à laquelle QPainter dessinera les graphiques sur l'image. Il ne modifie pas l'échelle ou le rapport d'aspect de l'image lorsqu'elle est affichée sur d'autres dispositifs de peinture.

Voir également dotsPerMeterX() et Image Information.

void QImage::setDotsPerMeterY(int y)

Définit le nombre de pixels qui tiennent verticalement dans un mètre physique, à y.

Avec dotsPerMeterX(), ce nombre définit l'échelle et le rapport hauteur/largeur de l'image et détermine l'échelle à laquelle QPainter dessinera les graphiques sur l'image. Il ne modifie pas l'échelle ou le rapport d'aspect de l'image lorsqu'elle est affichée sur d'autres dispositifs de peinture.

Voir également dotsPerMeterY() et Image Information.

void QImage::setOffset(const QPoint &offset)

Définit le nombre de pixels dont l'image doit être décalée lors de son positionnement par rapport à d'autres images, à offset.

Voir également offset() et Image Information.

void QImage::setPixel(const QPoint &position, uint index_or_rgb)

Définit l'index ou la couleur du pixel à la valeur position donnée à index_or_rgb.

Si le format de l'image est monochrome ou palettisé, la valeur index_or_rgb doit être un index dans la table des couleurs de l'image, sinon le paramètre doit être une valeur QRgb.

Si position n'est pas une paire de coordonnées valide dans l'image, ou si index_or_rgb >= colorCount() dans le cas d'images monochromes et palettisées, le résultat est indéfini.

Voir également pixel() et Pixel Manipulation.

void QImage::setPixel(int x, int y, uint index_or_rgb)

Définit l'indice de pixel ou la couleur à (x, y) à index_or_rgb.

void QImage::setPixelColor(const QPoint &position, const QColor &color)

Définit la couleur à l'endroit donné position à color.

Si position n'est pas une paire de coordonnées valide dans l'image, ou si le format de l'image est monochrome ou palettisé, le résultat est indéfini.

Voir aussi pixelColor(), pixel(), bits(), scanLine() et Pixel Manipulation.

void QImage::setPixelColor(int x, int y, const QColor &color)

Fixe la couleur du pixel à (x, y) à color.

void QImage::setText(const QString &key, const QString &text)

Définit le texte de l'image à l'adresse text et l'associe à l'adresse key.

Si vous ne souhaitez stocker qu'un seul bloc de texte (c'est-à-dire un "commentaire" ou une simple description), vous pouvez soit passer une clé vide, soit utiliser une clé générique telle que "Description".

Le texte de l'image est intégré dans les données de l'image lorsque vous appelez save() ou QImageWriter::write().

Tous les formats d'image ne prennent pas en charge le texte intégré. Vous pouvez savoir si une image ou un format spécifique prend en charge l'incorporation de texte en utilisant QImageWriter::supportsOption(). Voici un exemple :

    QImageWriter writer ; writer.setFormat("png") ; if (writer.supportsOption(QImageIOHandler::Description))        qDebug() << "Png supports embedded text";

Vous pouvez utiliser QImageWriter::supportedImageFormats() pour connaître les formats d'image disponibles.

Voir également text() et textKeys().

QSize QImage::size() const

Renvoie la taille de l'image, c'est-à-dire ses width() et height().

Voir aussi Image Information et deviceIndependentSize().

qsizetype QImage::sizeInBytes() const

Renvoie la taille des données de l'image en octets.

Voir aussi bytesPerLine(), bits() et Image Information.

[noexcept] void QImage::swap(QImage &other)

Remplace cette image par other. Cette opération est très rapide et n'échoue jamais.

QString QImage::text(const QString &key = QString()) const

Renvoie le texte de l'image associée à l'adresse key. Si le key spécifié est une chaîne vide, le texte entier de l'image est renvoyé, chaque paire clé-texte étant séparée par une nouvelle ligne.

Voir aussi setText() et textKeys().

QStringList QImage::textKeys() const

Renvoie les clés de texte de cette image.

Vous pouvez utiliser ces clés avec text() pour lister le texte de l'image pour une certaine clé.

Voir aussi text().

CGImageRef QImage::toCGImage() const

Crée un CGImage équivalent à ce QImage, et renvoie un handle CGImageRef.

Le CGImageRef retourné participe au partage implicite de QImage et contient une référence aux données de QImage. CGImage est immuable et ne détachera jamais le QImage. L'écriture sur le QImage le détachera comme d'habitude.

Cette fonction est rapide et ne copie ni ne convertit les données de l'image.

Si le format de l'image ne peut pas être converti, un CGImageRef nul sera renvoyé. Les utilisateurs de cette fonction peuvent alors commencer par convertir l'image QImage dans un format supporté, par exemple Format_ARGB32_Premultiplied.

Si l'image n'a pas d'espace colorimétrique défini, l'espace colorimétrique CGImageRef résultant est défini sur l'espace colorimétrique sRGB.

[since 6.0] HBITMAP QImage::toHBITMAP() const

Crée un équivalent HBITMAP de QImage.

Renvoie l'identifiant HBITMAP.

Il incombe à l'appelant de libérer les données de HBITMAP après utilisation.

Pour une utilisation avec des appels GDI standard, tels que BitBlt(), l'image doit avoir le format QImage::Format_RGB32.

Lors de l'utilisation du HBITMAP résultant pour la fonction GDI AlphaBlend(), l'image doit avoir le format QImage::Format_ARGB32_Premultiplied (utiliser convertToFormat()).

Lors de l'utilisation du HBITMAP résultant comme icône d'application ou icône de la barre d'état système, l'image doit avoir le format QImage::Format_ARGB32.

Cette fonction a été introduite dans Qt 6.0.

Voir aussi fromHBITMAP() et convertToFormat().

[since 6.0] HICON QImage::toHICON(const QImage &mask = {}) const

Crée un équivalent HICON de QPixmap, en appliquant le masque mask.

Si mask n'est pas nul, il doit être au format QImage::Format_Mono. Renvoie l'identifiant HICON.

Il incombe à l'appelant de libérer les données de HICON après utilisation.

Cette fonction a été introduite dans Qt 6.0.

Voir aussi fromHICON().

[static noexcept] QImage::Format QImage::toImageFormat(QPixelFormat format)

Convertit format en un QImage::Format

[static noexcept] QPixelFormat QImage::toPixelFormat(QImage::Format format)

Convertit format en un QPixelFormat

QImage QImage::transformed(const QTransform &matrix, Qt::TransformationMode mode = Qt::FastTransformation) const

Renvoie une copie de l'image transformée à l'aide de la transformation matrix et de la transformation mode.

L'image renvoyée aura normalement le même {Formats d'image}{format} que l'image d'origine. Toutefois, une transformation complexe peut produire une image dont tous les pixels ne sont pas couverts par les pixels transformés de l'image d'origine. Dans ce cas, les pixels d'arrière-plan se verront attribuer une valeur de couleur transparente et l'image transformée se verra attribuer un format avec un canal alpha, même si l'image d'origine n'en disposait pas.

La transformation matrix est ajustée en interne pour compenser les translations non désirées ; c'est-à-dire que l'image produite est la plus petite image qui contient tous les points transformés de l'image originale. La fonction trueMatrix() permet de récupérer la matrice utilisée pour la transformation d'une image.

Contrairement à l'autre surcharge, cette fonction peut être utilisée pour effectuer des transformations de perspective sur des images.

Voir également trueMatrix() et Image Transformations.

[static] QTransform QImage::trueMatrix(const QTransform &matrix, int width, int height)

Renvoie la matrice réelle utilisée pour transformer une image avec les valeurs données width, height et matrix.

Lors de la transformation d'une image à l'aide de la fonction transformed(), la matrice de transformation est ajustée en interne pour compenser les translations indésirables, c'est-à-dire que transformed() renvoie la plus petite image contenant tous les points transformés de l'image originale. Cette fonction renvoie la matrice modifiée, qui représente correctement les points de l'image originale dans la nouvelle image.

Contrairement à l'autre surcharge, cette fonction crée des matrices de transformation qui peuvent être utilisées pour effectuer des transformations de perspective sur les images.

Voir aussi transformed() et Image Transformations.

bool QImage::valid(const QPoint &pos) const

Renvoie true si pos est une paire de coordonnées valide dans l'image ; sinon, renvoie false.

Voir aussi rect() et QRect::contains().

bool QImage::valid(int x, int y) const

Renvoie true si QPoint(x, y) est une paire de coordonnées valide dans l'image ; sinon, renvoie false.

int QImage::width() const

Renvoie la largeur de l'image.

Voir aussi Image Information.

QImage::operator QVariant() const

Retourne l'image sous forme de QVariant.

bool QImage::operator!=(const QImage &image) const

Renvoie true si cette image et l'image donnée image ont des contenus différents ; sinon, renvoie false.

La comparaison peut être lente, à moins qu'il n'y ait une différence évidente, comme des largeurs différentes, auquel cas la fonction renvoie rapidement.

Voir aussi operator=().

[noexcept] QImage &QImage::operator=(QImage &&other)

Move-assigne other à cette instance QImage.

QImage &QImage::operator=(const QImage &image)

Affecte à cette image une copie superficielle de l'adresse image donnée et renvoie une référence à cette image.

Pour plus d'informations sur les copies superficielles, voir la documentation sur le partage implicite des données.

Voir aussi copy() et QImage().

bool QImage::operator==(const QImage &image) const

Renvoie true si cette image et l'image donnée image ont le même contenu ; sinon, renvoie false.

La comparaison peut être lente, à moins qu'il n'y ait une différence évidente (par exemple, une taille ou un format différent), auquel cas la fonction renvoie rapidement.

Voir aussi operator=().