Класс QBitmap

Класс QBitmap предоставляет монохромные (1-битная глубина) растровые изображения. Подробнее...

Заголовок:	#include <QBitmap>
qmake:	QT += gui
Наследует:	QPixmap

Открытые функции

	QBitmap()
	QBitmap(const QPixmap &pixmap)
	QBitmap(int width, int height)
	QBitmap(const QSize &size)
	QBitmap(const QString &fileName, const char *format = nullptr)
	QBitmap(const QBitmap &other)
virtual	~QBitmap()
void	clear()
void	swap(QBitmap &other)
QBitmap	transformed(const QTransform &matrix) const
QVariant	operator QVariant() const
QBitmap &	operator=(const QBitmap &other)
QBitmap &	operator=(QBitmap &&other)
QBitmap &	operator=(const QPixmap &pixmap)

42 открытых функции унаследованные от QPixmap
14 открытых функций унаследованные от QPaintDevice

Статические открытые члены

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)

6 статических открытых членов унаследованные от QPixmap

Дополнительные унаследованные члены

1 защищённая функция унаследованная от QPaintDevice

Подробное описание

Класс QBitmap предоставляет монохромные (1-битная глубина) растровые изображения.

Класс QBitmap — это монохромное автономное устройство рисования, используемое в основном для создания настраиваемых объектов QCursor и QBrush, построения объектов QRegion и для установки масок для растровых изображений и виджетов.

QBitmap — это подкласс QPixmap, обеспечивающий глубину 1, за исключением нулевых объектов, у которых глубина 0. Если растровому изображению с глубиной больше 1 назначен битмап, битмап будет автоматически пороговым.

Используйте объекты QColor Qt::color0 и Qt::color1 при рисовании на объекте QBitmap (или объекте QPixmap с глубиной 1).

Рисование с помощью Qt::color0 устанавливает биты битмапа в 0, а рисование с помощью Qt::color1 устанавливает биты в 1. Для битмапа биты 0 указывают фон (или прозрачные пиксели), а биты 1 указывают передний план (или непрозрачные пиксели). Используйте функцию clear() для установки всех битов в Qt::color0. Обратите внимание, что использование цветов Qt::black и Qt::white не имеет смысла, так как значение QColor::pixel() не обязательно равно 0 для чёрного и 1 для белого.

Класс QBitmap предоставляет функцию transformed() для получения преобразованной копии битмапа; используйте аргумент QTransform для трансляции, масштабирования, наклона и поворота битмапа. Кроме того, QBitmap предоставляет статическую функцию fromData(), которая возвращает битмап, построенный из предоставленных uchar данных, и статическую функцию fromImage(), которая возвращает преобразованную копию объекта QImage.

Как и класс QPixmap, QBitmap оптимизирован с помощью неявно разделяемых данных. Дополнительную информацию см. в документации по Неявной совместной работе данных.

См. также QPixmap, QImage, QImageReader и QImageWriter.

Документация по функциям-членам

QBitmap::QBitmap()

Создаёт нулевой битмап.

См. также QPixmap::isNull().

QBitmap::QBitmap(const QPixmap &pixmap)

Создаёт битмап, являющийся копией заданного pixmap.

Если у растрового изображения глубина больше 1, результирующий битмап будет автоматически пороговым.

См. также QPixmap::depth(), fromImage() и fromData().

QBitmap::QBitmap(int width, int height)

Создаёт битмап заданной width и height. Пиксели внутри не инициализированы.

См. также clear().

QBitmap::QBitmap(const QSize &size)

Создаёт битмап заданного size. Пиксели в битмапе не инициализированы.

См. также clear().

QBitmap::QBitmap(const QString &fileName, const char **format* = nullptr)

Создаёт битмап из файла, указанного заданным fileName. Если файл не существует или имеет неизвестный формат, битмап становится нулевым.

Параметры fileName и format передаются функции QPixmap::load(). Если формат файла использует более 1 бита на пиксель, результирующий битмап будет автоматически пороговым.

См. также QPixmap::isNull() и QImageReader::imageFormat().

QBitmap::QBitmap(const QBitmap &other)

Создаёт экземпляр QBitmap по умолчанию.

`[virtual]` QBitmap::~QBitmap()

Удаляет битмап.

void QBitmap::clear()

Очищает битмап, устанавливая все его биты в Qt::color0.

`[static]` QBitmap QBitmap::fromData(const QSize &size, const uchar **bits, QImage::Format monoFormat* = QImage::Format_MonoLSB)

Создаёт битмап заданного size и устанавливает содержимое в предоставленные bits.

Данные битмапа должны быть выровнены по байтам и предоставлены в порядке бит, указанном monoFormat. Формат моно должен быть либо QImage::Format_Mono, либо QImage::Format_MonoLSB. Используйте QImage::Format_Mono для указания данных в формате XBM.

См. также fromImage().

`[static]` QBitmap QBitmap::fromImage(const QImage &image, Qt::ImageConversionFlags flags = Qt::AutoColor)

Возвращает копию заданного image, преобразованного в битмап с использованием указанных флагов преобразования изображений flags.

См. также fromData().

`[static]` QBitmap QBitmap::fromImage(QImage &&image, Qt::ImageConversionFlags flags = Qt::AutoColor)

Это перегруженный метод.

Возвращает копию заданного изображения image, преобразованного в растровое изображение с указанными флагами преобразования изображений flags.

Этот метод был добавлен в Qt 5.12.

См. также fromData().

void QBitmap::swap(QBitmap &other)

Меняет местами растровое изображение other с этим растровым изображением. Эта операция очень быстрая и никогда не завершается ошибкой.

Этот метод был добавлен в Qt 4.8.

QBitmap QBitmap::transformed(const QTransform &matrix) const

Возвращает копию этого растрового изображения, преобразованного в соответствии с заданной матрицей matrix.

См. также QPixmap::transformed().

QVariant QBitmap::operator QVariant() const

Возвращает растровое изображение как QVariant.

QBitmap &QBitmap::operator=(const QBitmap &other)

Оператор присваивания копированием.

QBitmap &QBitmap::operator=(QBitmap &&other)

Оператор присваивания перемещением.

QBitmap &QBitmap::operator=(const QPixmap &pixmap)