QBitmap Class
La clase QBitmap proporciona mapas de píxeles monocromáticos (profundidad de 1 bit). Más información...
| Encabezado: | #include <QBitmap> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Heredado de: | QPixmap |
- Lista de todos los miembros, incluidos los heredados
- Miembros obsoletos
- QBitmap forma parte de las clases de dibujo y de las clases compartidas implícitamente.
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 dibujo monocromo fuera de pantalla que se utiliza principalmente para crear objetos personalizados de tipo « QCursor » y « QBrush », construir objetos de tipo « QRegion » y establecer máscaras para mapas de píxeles y widgets.
QBitmap es una subclase de ` QPixmap ` que garantiza una profundidad de 1, salvo en el caso de los objetos nulos, que tienen una profundidad de 0. Si se asigna a un mapa de bits un mapa de píxeles con una profundidad superior a 1, el mapa de bits se someterá automáticamente a un proceso de difuminado.
Utilice los objetos ` QColor ` ` Qt::color0 ` y ` Qt::color1 ` al dibujar sobre un objeto `QBitmap` (o un objeto ` QPixmap ` con profundidad 1).
Al dibujar con ` Qt::color0 ` se establecen los bits del mapa de bits en 0, y al dibujar con ` Qt::color1 ` se establecen los bits en 1. En un mapa de bits, los bits 0 indican el fondo (o píxeles transparentes) y los bits 1 indican el primer plano (o píxeles opacos). Utiliza la función clear() para establecer todos los bits en Qt::color0. Ten en cuenta que no tiene sentido utilizar los colores Qt::black y Qt::white, ya que el valor de QColor::pixel() no es necesariamente 0 para el negro ni 1 para el blanco.
La clase QBitmap proporciona la función transformed() que devuelve una copia transformada del mapa de bits; utilice el argumento QTransform para trasladar, escalar, inclinar 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 uchar proporcionados, y la función estática fromImage() que devuelve una copia convertida de un objeto QImage.
Al igual que la clase QPixmap, QBitmap está optimizada mediante el uso del intercambio implícito de datos. Para obtener más información, consulta la documentación sobre el intercambio implícito de datos.
Véase también QPixmap, QImage, QImageReader y QImageWriter.
Documentación de las funciones miembro
QBitmap::QBitmap()
Crea un mapa de bits nulo.
Véase también QPixmap::isNull().
[explicit] QBitmap::QBitmap(const QSize &size)
Crea un mapa de bits con el size especificado. 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 por el parámetro ` 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 someterá automáticamente a un proceso de difuminado.
Véanse también QPixmap::isNull() y QImageReader::imageFormat().
QBitmap::QBitmap(int width, int height)
Crea un mapa de bits con los valores proporcionados en « width » y « height ». Los píxeles que contiene no están inicializados.
Véase también clear().
void QBitmap::clear()
Borra el mapa de bits, estableciendo todos sus bits en « Qt::color0 ».
[static] QBitmap QBitmap::fromData(const QSize &size, const uchar *bits, QImage::Format monoFormat = QImage::Format_MonoLSB)
Crea un mapa de bits con el size especificado y establece su contenido con el bits proporcionado.
Los datos del mapa de bits deben estar alineados por bytes y proporcionarse 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 objeto ` image ` proporcionado, convertido a un mapa de bits mediante 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 objeto ` image ` proporcionado, convertido a un mapa de bits mediante 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 del « pixmap » indicado, convertido a mapa de bits.
Si el mapa de píxeles tiene una profundidad superior a 1, el mapa de bits resultante se someterá automáticamente a un proceso de difuminado.
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 según el valor dado en matrix.
Véase también QPixmap::transformed().
QBitmap::operator QVariant() const
Devuelve el mapa de bits como un objeto ` 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.