QBitmap Class
QBitmap 클래스는 단색(1비트 심도) 픽스맵을 제공합니다. 더 보기...
| 헤더: | #include <QBitmap> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| 상속: | QPixmap |
- 상속된 멤버를 포함한 모든 멤버 목록
- 사용 중단된 멤버
- QBitmap은 페인팅 클래스 및 암시적 공유 클래스의 일부입니다.
공개 함수
| 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 |
정적 공용 멤버
| 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) |
상세 설명
QBitmap 클래스는 주로 사용자 정의 QCursor 및 QBrush 객체를 생성하고, QRegion 객체를 구성하며, 픽스맵과 위젯에 마스크를 설정하는 데 사용되는 단색 오프스크린 페인팅 장치입니다.
QBitmap은 QPixmap 의 하위 클래스로, 깊이가 0인 null 객체를 제외하고 깊이가 1이 되도록 보장합니다. 깊이가 1보다 큰 픽스맵이 비트맵에 할당되면, 비트맵은 자동으로 디더링됩니다.
QBitmap 객체(또는 깊이가 1인 QPixmap 객체)에 그리기를 수행할 때는 QColor 객체인 Qt::color0 및 Qt::color1 을 사용하십시오.
Qt::color0 을 사용하여 그리면 비트맵 비트가 0으로 설정되고, Qt::color1 을 사용하여 그리면 비트가 1로 설정됩니다. 비트맵에서 0 비트는 배경(또는 투명한 픽셀)을 나타내고, 1 비트는 전경(또는 불투명한 픽셀)을 나타냅니다. clear() 함수를 사용하여 모든 비트를 Qt::color0 로 설정하십시오. QColor::pixel() 값이 검은색의 경우 반드시 0이고 흰색의 경우 반드시 1인 것은 아니므로, Qt::black 및 Qt::white 색상을 사용하는 것은 의미가 없다는 점에 유의하십시오.
QBitmap 클래스는 비트맵의 변환된 복사본을 반환하는 transformed() 함수를 제공합니다. QTransform 인수를 사용하여 비트맵을 이동, 확대/축소, 전단 및 회전할 수 있습니다. 또한, QBitmap은 주어진 uchar 데이터로 생성된 비트맵을 반환하는 정적 함수 fromData()과, QImage 객체의 변환된 복사본을 반환하는 정적 함수 fromImage()을 제공합니다.
QPixmap 클래스와 마찬가지로, QBitmap은 암시적 데이터 공유를 통해 최적화되어 있습니다. 자세한 내용은 암시적 데이터 공유 문서를 참조하십시오.
QPixmap, QImage, QImageReader 및 QImageWriter도 참조하십시오 .
멤버 함수 문서
QBitmap::QBitmap()
null 비트맵을 생성합니다.
QPixmap::isNull()도 참조하십시오 .
[explicit] QBitmap::QBitmap(const QSize &size)
지정된 ` size`를 사용하여 비트맵을 생성합니다. 비트맵의 픽셀은 초기화되지 않은 상태입니다.
clear()도 참조하십시오 .
[explicit] QBitmap::QBitmap(const QString &fileName, const char *format = nullptr)
지정된 ` fileName`로 표시된 파일로부터 비트맵을 생성합니다. 파일이 존재하지 않거나 형식을 알 수 없는 경우, 비트맵은 null 비트맵이 됩니다.
fileName 및 format 매개변수는 QPixmap::load() 함수로 전달됩니다. 파일 형식이 픽셀당 1비트 이상을 사용하는 경우, 결과 비트맵은 자동으로 디더링 처리됩니다.
QPixmap::isNull() 및 QImageReader::imageFormat()도 참조하십시오 .
QBitmap::QBitmap(int width, int height)
지정된 ` width ` 및 ` height`을 사용하여 비트맵을 생성합니다. 내부 픽셀은 초기화되지 않은 상태입니다.
clear()도 참조하십시오 .
void QBitmap::clear()
비트맵을 지우고, 모든 비트를 Qt::color0 로 설정합니다.
[static] QBitmap QBitmap::fromData(const QSize &size, const uchar *bits, QImage::Format monoFormat = QImage::Format_MonoLSB)
지정된 size 을 사용하여 비트맵을 생성하고, 내용을 제공된 bits 로 설정합니다.
비트맵 데이터는 바이트 정렬되어야 하며, monoFormat 에서 지정한 비트 순서로 제공되어야 합니다. mono 형식은 QImage::Format_Mono 또는 QImage::Format_MonoLSB 중 하나여야 합니다. XBM 형식의 데이터를 지정하려면 QImage::Format_Mono 를 사용하십시오.
fromImage()도 참조하십시오 .
[static] QBitmap QBitmap::fromImage(const QImage &image, Qt::ImageConversionFlags flags = Qt::AutoColor)
지정된 이미지 변환 flags 을 사용하여 주어진 image 의 복사본을 비트맵으로 변환하여 반환합니다.
fromData()도 참조하십시오 .
[static] QBitmap QBitmap::fromImage(QImage &&image, Qt::ImageConversionFlags flags = Qt::AutoColor)
지정된 이미지 변환 flags 을 사용하여 주어진 image 의 복사본을 비트맵으로 변환하여 반환합니다.
이 함수는 오버로드된 함수입니다.
fromData()도 참조하십시오 .
[static, since 6.0] QBitmap QBitmap::fromPixmap(const QPixmap &pixmap)
지정된 픽스맵( pixmap )을 비트맵으로 변환한 사본을 반환합니다.
pixmap의 색상 깊이가 1보다 크면, 결과 비트맵은 자동으로 디더링 처리됩니다.
이 함수는 Qt 6.0에서 도입되었습니다.
QPixmap::depth()도 참조하십시오 .
void QBitmap::swap(QBitmap &other)
이 비트맵을 other 와 교환합니다. 이 작업은 매우 빠르며 절대 실패하지 않습니다.
QBitmap QBitmap::transformed(const QTransform &matrix) const
주어진 matrix 에 따라 변환된 이 비트맵의 복사본을 반환합니다.
QPixmap::transformed()도 참조하십시오 .
QBitmap::operator QVariant() const
비트맵을 ` 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.