Класс QBitmap

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

• Список всех членов, включая наследуемые
• Устаревшие члены

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

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

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

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

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

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

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

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

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

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

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

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

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

Подобно классу QPixmap, QBitmap оптимизирован за счёт использования неявного совместного использования данных. Более подробная информация приведена в документации по Неявное совместное использование данных.

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

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

QBitmap::QBitmap()

Создаёт пустую bitmap.

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

QBitmap::QBitmap(const QPixmap &pixmap)

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

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

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

QBitmap::QBitmap(int width, int height)

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

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

QBitmap::QBitmap(const QSize &size)

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

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

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

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

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

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

QBitmap::QBitmap(const QBitmap &other)

Конструктор копирования.

QBitmap::~QBitmap()

Удаляет bitmap.

void QBitmap::clear()

Очищает bitmap, устанавливая все её биты в Qt::color0.

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

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

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

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

QBitmap QBitmap::fromImage(const QImage &image, Qt::ImageConversionFlags flags = Qt::AutoColor)

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

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

void QBitmap::swap(QBitmap &other)

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

Функция была добавлена в Qt 4.8.

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

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

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

QBitmap::operator QVariant() const

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

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

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

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

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

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

Это перегруженная функция.

Присваивает заданное pixmap этому растровому изображению и возвращает ссылку на это растровое изображение.

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

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