En esta página

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

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.