Класс QBitmap

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

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

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

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

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

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

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

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

Рисование с помощью 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(const QString &fileName, const char *format = nullptr)

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

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

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

QBitmap::QBitmap(int width, int height)

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

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

QBitmap::QBitmap()

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

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

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, since 5.12] QBitmap QBitmap::fromImage(QImage &&image, Qt::ImageConversionFlags flags = Qt::AutoColor)

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

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

Эта функция была добавлена в Qt 5.12.

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

[static] QBitmap QBitmap::fromPixmap(const QPixmap &pixmap)

Возвращает копию заданного pixmap, преобразованного в битмап.

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

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

void QBitmap::swap(QBitmap &other)

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

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

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

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

QVariant QBitmap::operator QVariant() const

Возвращает битмап как QVariant.