QBitmap Class
La classe QBitmap permet de créer des images bitmap monochromes (profondeur de 1 bit). En savoir plus...
| En-tête : | #include <QBitmap> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake : | QT += gui |
| Hérite de : | QPixmap |
- Liste de tous les membres, y compris les membres hérités
- Membres obsolètes
- QBitmap fait partie des classes de dessin et des classes implicitement partagées.
Fonctions publiques
| QBitmap() | |
| QBitmap(const QSize &size) | |
| QBitmap(const QString &fileName, const char *format = nullptr) | |
| QBitmap(int width, int height) | |
| void | clear() |
| void | swap(QBitmap &other) |
| QBitmap | transformed(const QTransform &matrix) const |
| operator QVariant() const |
Membres publics statiques
| QBitmap | fromData(const QSize &size, const uchar *bits, QImage::Format monoFormat = QImage::Format_MonoLSB) |
| QBitmap | fromImage(const QImage &image, Qt::ImageConversionFlags flags = Qt::AutoColor) |
| QBitmap | fromImage(QImage &&image, Qt::ImageConversionFlags flags = Qt::AutoColor) |
(since 6.0) QBitmap | fromPixmap(const QPixmap &pixmap) |
Description détaillée
La classe QBitmap est un périphérique de dessin hors écran monochrome utilisé principalement pour créer des objets personnalisés de type « QCursor » et « QBrush », pour construire des objets « QRegion », et pour définir des masques pour les pixmaps et les widgets.
QBitmap est une sous-classe de QPixmap garantissant une profondeur de 1, à l’exception des objets nuls qui ont une profondeur de 0. Si une image bitmap d’une profondeur supérieure à 1 est attribuée à un bitmap, celui-ci sera automatiquement tramé.
Utilisez les objets ` QColor ` ` Qt::color0 ` et ` Qt::color1 ` lorsque vous dessinez sur un objet `QBitmap` (ou un objet ` QPixmap ` de profondeur 1).
Le dessin avec ` Qt::color0 ` définit les bits du bitmap à 0, tandis que le dessin avec ` Qt::color1 ` définit les bits à 1. Pour un bitmap, les bits à 0 indiquent l'arrière-plan (ou les pixels transparents) et les bits à 1 indiquent le premier plan (ou les pixels opaques). Utilisez la fonction ` clear()` pour définir tous les bits à la valeur ` Qt::color0`. Notez que l’utilisation des couleurs ` Qt::black ` et ` Qt::white ` n’a aucun sens, car la valeur de `QColor::pixel()` n’est pas nécessairement 0 pour le noir et 1 pour le blanc.
La classe QBitmap fournit la fonction transformed() qui renvoie une copie transformée du bitmap ; utilisez l’argument QTransform pour translater, mettre à l’échelle, incliner et faire pivoter le bitmap. De plus, QBitmap fournit la fonction statique fromData() qui renvoie un bitmap construit à partir des données uchar fournies, ainsi que la fonction statique fromImage() qui renvoie une copie convertie d’un objet QImage.
Tout comme la classe QPixmap, QBitmap est optimisée grâce au partage implicite des données. Pour plus d’informations, consultez la documentation sur le partage implicite des données.
Voir également QPixmap, QImage, QImageReader et QImageWriter.
Documentation sur les fonctions membres
QBitmap::QBitmap()
Crée un bitmap nul.
Voir aussi QPixmap::isNull().
[explicit] QBitmap::QBitmap(const QSize &size)
Crée un bitmap à partir de l'size on fournie. Les pixels du bitmap ne sont pas initialisés.
Voir aussi clear().
[explicit] QBitmap::QBitmap(const QString &fileName, const char *format = nullptr)
Crée une image bitmap à partir du fichier spécifié par l'fileName. Si le fichier n'existe pas ou si son format est inconnu, l'image bitmap devient une image bitmap nulle.
Les paramètres ` fileName ` et ` format ` sont transmis à la fonction ` QPixmap::load()`. Si le format du fichier utilise plus d’un bit par pixel, le bitmap résultant sera automatiquement soumis à un tramage.
Voir également QPixmap::isNull() et QImageReader::imageFormat().
QBitmap::QBitmap(int width, int height)
Crée un bitmap à partir des paramètres width et height fournis. Les pixels qu'il contient ne sont pas initialisés.
Voir aussi clear().
void QBitmap::clear()
Efface le bitmap en définissant tous ses bits sur « Qt::color0 ».
[static] QBitmap QBitmap::fromData(const QSize &size, const uchar *bits, QImage::Format monoFormat = QImage::Format_MonoLSB)
Crée un bitmap avec l'size spécifiée et définit son contenu à l'aide de l'bits fournie.
Les données du bitmap doivent être alignées sur un octet et fournies dans l’ordre des bits spécifié par ` monoFormat`. Le format mono doit être soit ` QImage::Format_Mono `, soit ` QImage::Format_MonoLSB`. Utilisez ` QImage::Format_Mono ` pour spécifier les données au format XBM.
Voir également fromImage().
[static] QBitmap QBitmap::fromImage(const QImage &image, Qt::ImageConversionFlags flags = Qt::AutoColor)
Renvoie une copie de l'image on fournie, convertie en image bitmap à l'aide de l'flags de conversion d'image spécifiée.
Voir aussi fromData().
[static] QBitmap QBitmap::fromImage(QImage &&image, Qt::ImageConversionFlags flags = Qt::AutoColor)
Renvoie une copie de l'image e fournie, convertie en image bitmap à l'aide de l'flags de conversion d'image spécifiée.
Il s'agit d'une fonction surchargée.
Voir aussi fromData().
[static, since 6.0] QBitmap QBitmap::fromPixmap(const QPixmap &pixmap)
Renvoie une copie de l'pixmap e fournie, convertie en image bitmap.
Si la profondeur de la carte de pixels est supérieure à 1, l'image bitmap résultante sera automatiquement tramée.
Cette fonction a été introduite dans Qt 6.0.
Voir aussi QPixmap::depth().
void QBitmap::swap(QBitmap &other)
Permute cette image bitmap avec celle de other. Cette opération est très rapide et ne rencontre jamais d'échec.
QBitmap QBitmap::transformed(const QTransform &matrix) const
Renvoie une copie de ce bitmap, transformée selon l'matrix.
Voir aussi QPixmap::transformed().
QBitmap::operator QVariant() const
Renvoie le bitmap sous la forme d'un objet ` QVariant`.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
