QBitmap Class
Die Klasse QBitmap liefert monochrome (1-Bit-Tiefe) Pixmaps. Mehr...
| Kopfzeile: | #include <QBitmap> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Vererbt: | QPixmap |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- Veraltete Mitglieder
- QBitmap ist Teil von Painting Classes und Implicitly Shared Classes.
Öffentliche Funktionen
| 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 |
| QVariant | operator QVariant() const |
Statische öffentliche Mitglieder
| 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) |
Detaillierte Beschreibung
Die Klasse QBitmap ist ein monochromes Offscreen-Painting-Gerät, das hauptsächlich zum Erstellen von benutzerdefinierten QCursor und QBrush Objekten, zum Konstruieren von QRegion Objekten und zum Festlegen von Masken für Pixmaps und Widgets verwendet wird.
QBitmap ist eine QPixmap -Unterklasse, die eine Tiefe von 1 gewährleistet, mit Ausnahme von Null-Objekten, die eine Tiefe von 0 haben. Wenn eine Pixmap mit einer Tiefe von mehr als 1 einer Bitmap zugewiesen wird, wird die Bitmap automatisch gedithert.
Verwenden Sie die QColor Objekte Qt::color0 und Qt::color1, wenn Sie auf ein QBitmap-Objekt (oder ein QPixmap Objekt mit Tiefe 1) zeichnen.
Malen mit Qt::color0 setzt die Bitmap-Bits auf 0, und Malen mit Qt::color1 setzt die Bits auf 1. Bei einer Bitmap stehen 0-Bits für den Hintergrund (oder transparente Pixel) und 1-Bits für den Vordergrund (oder undurchsichtige Pixel). Verwenden Sie die Funktion clear(), um alle Bits auf Qt::color0 zu setzen. Beachten Sie, dass die Verwendung der Farben Qt::black und Qt::white keinen Sinn macht, da der Wert von QColor::pixel() nicht unbedingt 0 für Schwarz und 1 für Weiß ist.
Die Klasse QBitmap bietet die Funktion transformed(), die eine transformierte Kopie der Bitmap zurückgibt; verwenden Sie das Argument QTransform, um die Bitmap zu übersetzen, zu skalieren, zu scheren und zu rotieren. Darüber hinaus bietet QBitmap die statische Funktion fromData(), die eine aus den angegebenen uchar Daten konstruierte Bitmap zurückgibt, und die statische Funktion fromImage(), die eine konvertierte Kopie eines QImage Objekts zurückgibt.
Genau wie die Klasse QPixmap wird QBitmap durch die Verwendung von implizitem Data-Sharing optimiert. Weitere Informationen finden Sie in der Dokumentation Implicit Data Sharing.
Siehe auch QPixmap, QImage, QImageReader, und QImageWriter.
Dokumentation der Mitgliedsfunktionen
QBitmap::QBitmap()
Konstruiert eine Null-Bitmap.
Siehe auch QPixmap::isNull().
[explicit] QBitmap::QBitmap(const QSize &size)
Konstruiert eine Bitmap mit der angegebenen size. Die Pixel in der Bitmap sind uninitialisiert.
Siehe auch clear().
[explicit] QBitmap::QBitmap(const QString &fileName, const char *format = nullptr)
Konstruiert eine Bitmap aus der durch die angegebene fileName angegebenen Datei. Wenn die Datei nicht existiert oder ein unbekanntes Format hat, wird die Bitmap zu einer Null-Bitmap.
Die Parameter fileName und format werden an die Funktion QPixmap::load() weitergegeben. Wenn das Dateiformat mehr als 1 Bit pro Pixel verwendet, wird die resultierende Bitmap automatisch gedithert.
Siehe auch QPixmap::isNull() und QImageReader::imageFormat().
QBitmap::QBitmap(int width, int height)
Konstruiert eine Bitmap mit den angegebenen width und height. Die Pixel darin sind nicht initialisiert.
Siehe auch clear().
void QBitmap::clear()
Löscht die Bitmap und setzt alle Bits auf Qt::color0.
[static] QBitmap QBitmap::fromData(const QSize &size, const uchar *bits, QImage::Format monoFormat = QImage::Format_MonoLSB)
Konstruiert eine Bitmap mit der angegebenen size und setzt den Inhalt auf die angegebene bits.
Die Bitmap-Daten müssen byte-ausgerichtet sein und in der von monoFormat angegebenen Bitreihenfolge geliefert werden. Das Monoformat muss entweder QImage::Format_Mono oder QImage::Format_MonoLSB sein. Verwenden Sie QImage::Format_Mono, um Daten im XBM-Format anzugeben.
Siehe auch fromImage().
[static] QBitmap QBitmap::fromImage(const QImage &image, Qt::ImageConversionFlags flags = Qt::AutoColor)
Gibt eine Kopie des angegebenen image zurück, die mit der angegebenen Bildkonvertierung flags in ein Bitmap konvertiert wurde.
Siehe auch fromData().
[static] QBitmap QBitmap::fromImage(QImage &&image, Qt::ImageConversionFlags flags = Qt::AutoColor)
Dies ist eine überladene Funktion.
Gibt eine Kopie des angegebenen image zurück, die mit der angegebenen Bildkonvertierung flags in ein Bitmap konvertiert wurde.
Siehe auch fromData().
[static, since 6.0] QBitmap QBitmap::fromPixmap(const QPixmap &pixmap)
Gibt eine in eine Bitmap konvertierte Kopie der angegebenen pixmap zurück.
Wenn die Pixmap eine Tiefe größer als 1 hat, wird die resultierende Bitmap automatisch gedithert.
Diese Funktion wurde in Qt 6.0 eingeführt.
Siehe auch QPixmap::depth().
void QBitmap::swap(QBitmap &other)
Tauscht diese Bitmap mit other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.
QBitmap QBitmap::transformed(const QTransform &matrix) const
Gibt eine Kopie dieser Bitmap zurück, transformiert gemäß der angegebenen matrix.
Siehe auch QPixmap::transformed().
QVariant QBitmap::operator QVariant() const
Gibt die Bitmap als QVariant zurück.
© 2025 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.
