QBitmap Class
La classe QBitmap fournit des cartes pixel monochromes (profondeur de 1 bit). Plus d'informations...
| En-tête : | #include <QBitmap> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake : | QT += gui |
| Héritages : | QPixmap |
- Liste de tous les membres, y compris les membres hérités
- Membres dépréciés
- QBitmap fait partie des classes de peinture 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 dispositif de peinture monochrome hors écran utilisé principalement pour créer des objets QCursor et QBrush personnalisés, 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 null qui ont une profondeur de 0. Si une pixmap avec une profondeur supérieure à 1 est assignée à une bitmap, la bitmap sera automatiquement réduite.
Utilisez les objets QColor Qt::color0 et Qt::color1 lorsque vous dessinez sur un objet QBitmap (ou un objet QPixmap avec une profondeur de 1).
Peindre avec Qt::color0 met les bits du bitmap à 0, et peindre avec Qt::color1 met les bits à 1. Pour un bitmap, les bits 0 indiquent l'arrière-plan (ou pixels transparents) et les bits 1 indiquent l'avant-plan (ou pixels opaques). Utilisez la fonction clear() pour mettre tous les bits à Qt::color0. Notez que l'utilisation des couleurs Qt::black et Qt::white n'a pas de sens car la valeur 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 traduire, mettre à l'échelle, cisailler et faire pivoter le bitmap. En outre, QBitmap fournit la fonction statique fromData() qui renvoie une image bitmap construite à partir des données uchar, et la fonction statique fromImage() qui renvoie une copie convertie d'un objet QImage.
Tout comme la classe QPixmap, QBitmap est optimisé par l'utilisation du partage implicite des données. Pour plus d'informations, voir la documentation sur le partage implicite des données.
Voir également QPixmap, QImage, QImageReader, et QImageWriter.
Documentation sur les fonctions membres
QBitmap::QBitmap()
Construit une image bitmap nulle.
Voir aussi QPixmap::isNull().
[explicit] QBitmap::QBitmap(const QSize &size)
Construit une image bitmap avec la valeur size. Les pixels du bitmap ne sont pas initialisés.
Voir aussi clear().
[explicit] QBitmap::QBitmap(const QString &fileName, const char *format = nullptr)
Construit une image bitmap à partir du fichier spécifié par l'adresse fileName. Si le fichier n'existe pas ou si son format est inconnu, le bitmap devient un bitmap nul.
Les paramètres fileName et format sont transmis à la fonction QPixmap::load(). Si le format du fichier utilise plus d'un bit par pixel, l'image bitmap résultante sera automatiquement réduite.
Voir également QPixmap::isNull() et QImageReader::imageFormat().
QBitmap::QBitmap(int width, int height)
Construit un bitmap avec les données width et height. Les pixels à l'intérieur ne sont pas initialisés.
Voir aussi clear().
void QBitmap::clear()
Efface l'image bitmap, en mettant tous ses bits à Qt::color0.
[static] QBitmap QBitmap::fromData(const QSize &size, const uchar *bits, QImage::Format monoFormat = QImage::Format_MonoLSB)
Construit une image bitmap avec les données fournies par size, et définit le contenu de l'image bitmap avec les données fournies par bits.
Les données bitmap doivent être alignées sur les octets et fournies dans l'ordre des bits spécifié par monoFormat. Le format mono doit être QImage::Format_Mono ou QImage::Format_MonoLSB. Utilisez QImage::Format_Mono pour spécifier des données au format XBM.
Voir aussi fromImage().
[static] QBitmap QBitmap::fromImage(const QImage &image, Qt::ImageConversionFlags flags = Qt::AutoColor)
Renvoie une copie du fichier image converti en bitmap à l'aide de la conversion d'image spécifiée flags.
Voir aussi fromData().
[static] QBitmap QBitmap::fromImage(QImage &&image, Qt::ImageConversionFlags flags = Qt::AutoColor)
Renvoie une copie du fichier image converti en image bitmap à l'aide de la conversion d'image spécifiée flags.
Il s'agit d'une fonction surchargée.
Voir aussi fromData().
[static, since 6.0] QBitmap QBitmap::fromPixmap(const QPixmap &pixmap)
Renvoie une copie du fichier pixmap converti en bitmap.
Si la pixmap a une profondeur supérieure à 1, la bitmap résultante sera automatiquement réduite.
Cette fonction a été introduite dans Qt 6.0.
Voir aussi QPixmap::depth().
void QBitmap::swap(QBitmap &other)
Remplace cette image bitmap par other. Cette opération est très rapide et n'échoue jamais.
QBitmap QBitmap::transformed(const QTransform &matrix) const
Renvoie une copie de cette image bitmap, transformée selon la valeur donnée matrix.
Voir aussi QPixmap::transformed().
QBitmap::operator QVariant() const
Renvoie la carte bitmap sous forme de 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.
