QBitmap Class
La clase QBitmap proporciona pixmaps monocromos (1 bit de profundidad). Más...
| Cabecera: | #include <QBitmap> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Hereda: | QPixmap |
- Lista de todos los miembros, incluidos los heredados
- Miembros obsoletos
- QBitmap es parte de Painting Classes e Implicitly Shared Classes.
Funciones Públicas
| 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 |
Miembros Públicos Estáticos
| 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) |
Descripción Detallada
La clase QBitmap es un dispositivo de pintura monocromo fuera de pantalla utilizado principalmente para crear objetos QCursor y QBrush personalizados, construir objetos QRegion, y para establecer máscaras para pixmaps y widgets.
QBitmap es una subclase de QPixmap que garantiza una profundidad de 1, excepto para los objetos null, que tienen una profundidad de 0. Si se asigna un mapa de píxeles con una profundidad superior a 1 a un mapa de bits, éste se interpolará automáticamente.
Utilice los objetos QColor Qt::color0 y Qt::color1 cuando dibuje sobre un objeto QBitmap (o un objeto QPixmap con profundidad 1).
Pintar con Qt::color0 pone los bits del mapa de bits a 0, y pintar con Qt::color1 pone los bits a 1. Para un mapa de bits, 0 bits indican el fondo (o píxeles transparentes) y 1 bits indican el primer plano (o píxeles opacos). Utilice la función clear() para establecer todos los bits a Qt::color0. Tenga en cuenta que utilizar los colores Qt::black y Qt::white no tiene sentido porque el valor de QColor::pixel() no es necesariamente 0 para el negro y 1 para el blanco.
La clase QBitmap proporciona la función transformed() que devuelve una copia transformada del mapa de bits; utiliza el argumento QTransform para trasladar, escalar, cizallar y rotar el mapa de bits. Además, QBitmap proporciona la función estática fromData(), que devuelve un mapa de bits construido a partir de los datos de uchar, y la función estática fromImage(), que devuelve una copia convertida de un objeto QImage.
Al igual que la clase QPixmap, QBitmap se optimiza mediante el uso compartido implícito de datos. Para obtener más información, consulte la documentación sobre el uso compartido implícito de datos.
Véase también QPixmap, QImage, QImageReader, y QImageWriter.
Documentación de funciones miembro
QBitmap::QBitmap()
Construye un mapa de bits nulo.
Véase también QPixmap::isNull().
[explicit] QBitmap::QBitmap(const QSize &size)
Construye un mapa de bits con la dirección size. Los píxeles del mapa de bits no están inicializados.
Véase también clear().
[explicit] QBitmap::QBitmap(const QString &fileName, const char *format = nullptr)
Crea un mapa de bits a partir del archivo especificado en fileName. Si el archivo no existe o tiene un formato desconocido, el mapa de bits se convierte en un mapa de bits nulo.
Los parámetros fileName y format se pasan a la función QPixmap::load(). Si el formato del archivo utiliza más de 1 bit por píxel, el mapa de bits resultante se interpolará automáticamente.
Véase también QPixmap::isNull() y QImageReader::imageFormat().
QBitmap::QBitmap(int width, int height)
Construye un mapa de bits con width y height. Los píxeles del interior no se inicializan.
Véase también clear().
void QBitmap::clear()
Borra el mapa de bits, poniendo todos sus bits en Qt::color0.
[static] QBitmap QBitmap::fromData(const QSize &size, const uchar *bits, QImage::Format monoFormat = QImage::Format_MonoLSB)
Construye un mapa de bits con la dirección size y establece el contenido en la dirección bits proporcionada.
Los datos del mapa de bits tienen que estar alineados por bytes y suministrados en el orden de bits especificado por monoFormat. El formato mono debe ser QImage::Format_Mono o QImage::Format_MonoLSB. Utilice QImage::Format_Mono para especificar datos en formato XBM.
Véase también fromImage().
[static] QBitmap QBitmap::fromImage(const QImage &image, Qt::ImageConversionFlags flags = Qt::AutoColor)
Devuelve una copia del image dado convertido a un mapa de bits utilizando la conversión de imagen especificada flags.
Véase también fromData().
[static] QBitmap QBitmap::fromImage(QImage &&image, Qt::ImageConversionFlags flags = Qt::AutoColor)
Devuelve una copia del image dado convertido a un mapa de bits utilizando la conversión de imagen especificada flags.
Esta es una función sobrecargada.
Véase también fromData().
[static, since 6.0] QBitmap QBitmap::fromPixmap(const QPixmap &pixmap)
Devuelve una copia de pixmap convertida en mapa de bits.
Si el mapa de píxeles tiene una profundidad mayor que 1, el mapa de bits resultante se interpolará automáticamente.
Esta función se introdujo en Qt 6.0.
Véase también QPixmap::depth().
void QBitmap::swap(QBitmap &other)
Intercambia este mapa de bits con other. Esta operación es muy rápida y nunca falla.
QBitmap QBitmap::transformed(const QTransform &matrix) const
Devuelve una copia de este mapa de bits, transformada de acuerdo con la dirección matrix.
Véase también QPixmap::transformed().
QBitmap::operator QVariant() const
Devuelve el mapa de bits como 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.
