QImage Class

멤버 함수 문서

지정된 format 에 있는 이미지의 복사본을 반환합니다.

지정된 이미지 변환 flags 은 변환 프로세스 중에 이미지 데이터가 처리되는 방식을 제어합니다.

convertTo() 및 Image Formats도 참조하세요 .

지정된 format 에 있는 이미지의 복사본을 반환합니다.

지정된 이미지 변환 flags 은 변환 과정에서 이미지 데이터가 처리되는 방식을 제어합니다.

이 함수는 Qt 6.0에 도입되었습니다.

convertTo() 및 Image Formats도 참조하십시오 .

이 함수는 버전 6.13에서 더 이상 사용되지 않을 예정입니다.

대신 flipped(Qt::Orientations)를 사용하세요.

horizontal 및 vertical 이 참 또는 거짓으로 설정되었는지 여부에 따라 가로 및/또는 세로 방향으로 미러링된 이미지의 미러를 반환합니다.

원본 이미지는 변경되지 않습니다.

mirror() 및 Image Transformations도 참조하세요 .

orient 에 따라 가로 및/또는 세로 방향으로 미러링된 이미지의 뒤집힌 버전 또는 미러 버전을 반환합니다.

원본 이미지는 변경되지 않습니다.

이 함수는 Qt 6.9에 도입되었습니다.

flip(Qt::Orientations) 및 Image Transformations 를참조하십시오 .

모든 픽셀의 빨간색과 파란색 구성 요소의 값이 바뀌어 RGB 이미지를 BGR 이미지로 효과적으로 변환한 QImage 을 반환합니다.

원본 QImage 은 변경되지 않습니다.

rgbSwap() 및 Image Transformations 을참조하세요 .

colorSpace 및 format 로 변환된 이미지를 반환합니다.

이미지에 유효한 색 공간이 없는 경우 null QImage 이 반환됩니다.

지정된 이미지 변환 flags 은 형식 변환 프로세스 중에 이미지 데이터가 처리되는 방식을 제어합니다.

이 함수는 Qt 6.8에 도입되었습니다.

colorTransformed()도 참조하세요 .

[noexcept] QImage::QImage()

널 이미지를 생성합니다.

isNull()도 참조하세요 .

[explicit] QImage::QImage(const char *const[] xpm)

주어진 xpm 이미지에서 이미지를 생성합니다.

이미지가 유효한 XPM 이미지인지 확인합니다. 오류는 자동으로 무시됩니다.

특이한 선언을 사용하여 XPM 변수를 약간 압축할 수 있습니다:

static const char * const start_xpm[] = {
    "16 15 8 1",
    "a c #cec6bd",
    // etc.
};

const 을 추가하면 전체 정의가 읽기 전용이 되므로 약간 더 효율적이며(예: 코드가 공유 라이브러리에 있는 경우) 애플리케이션과 함께 ROM에 저장할 수 있습니다.

QImage::QImage(const QSize &size, QImage::Format format)

주어진 size 와 format 로 이미지를 생성합니다.

메모리를 할당할 수 없는 경우 null 이미지가 반환됩니다.

[explicit] QImage::QImage(const QString &fileName, const char *format = nullptr)

이미지를 생성하고 지정된 fileName 을 사용하여 파일에서 이미지를 로드하려고 시도합니다.

로더는 지정된 format 을 사용하여 이미지를 읽으려고 시도합니다. format 을 지정하지 않으면(기본값) 파일의 접미사 및 헤더를 기준으로 자동 감지됩니다. 자세한 내용은 {QImageReader::setAutoDetectImageFormat()}{QImageReader}을 참조하세요.

이미지 로딩에 실패한 경우 이 객체는 null 이미지입니다.

파일 이름은 디스크의 실제 파일을 참조하거나 애플리케이션의 임베디드 리소스 중 하나를 참조할 수 있습니다. 애플리케이션 실행 파일에 이미지 및 기타 리소스 파일을 임베드하는 방법에 대한 자세한 내용은 리소스 시스템 개요를 참조하세요.

isNull() 및 Reading and Writing Image Files 을참조하세요 .

QImage::QImage(int width, int height, QImage::Format format)

주어진 width, height 및 format 로 이미지를 생성합니다.

메모리를 할당할 수 없는 경우 null 이미지가 반환됩니다.

QImage::QImage(const uchar *data, int width, int height, QImage::Format format, QImageCleanupFunction cleanupFunction = nullptr, void *cleanupInfo = nullptr)

주어진 width, height 및 format 로 기존 읽기 전용 메모리 버퍼인 data 를 사용하는 이미지를 생성합니다. width 및 height 은 픽셀 단위로 지정되어야 하고 data 은 32비트 정렬되어야 하며 이미지의 각 데이터 스캔 라인도 32비트 정렬되어야 합니다.

버퍼는 QImage의 수명 기간 동안 유효해야 하며 원본 버퍼에서 수정되거나 분리되지 않은 모든 복사본이 유효해야 합니다. 이미지가 소멸될 때 버퍼는 삭제되지 않습니다. 함수 포인터 cleanupFunction 와 함께 마지막 복사본이 소멸될 때 호출되는 추가 포인터 cleanupInfo 를 제공할 수 있습니다.

format 이 색인된 색상 형식인 경우 이미지 색상 테이블은 처음에 비어 있으며 이미지를 사용하기 전에 setColorCount() 또는 setColorTable()로 충분히 확장해야 합니다.

컨스트가 아닌 데이터 버퍼를 취하는 유사한 QImage 생성자와 달리 이 버전은 버퍼의 내용을 변경하지 않습니다. 예를 들어 QImage::bits()를 호출하면 생성자에 전달된 버퍼가 아니라 이미지의 딥 카피가 반환됩니다. 따라서 원시 데이터가 변경될 가능성 없이 원시 데이터에서 QImage를 효율적으로 구성할 수 있습니다.

QImage::QImage(uchar *data, int width, int height, QImage::Format format, QImageCleanupFunction cleanupFunction = nullptr, void *cleanupInfo = nullptr)

주어진 width, height 및 format 로 기존 메모리 버퍼인 data 를 사용하는 이미지를 생성합니다. width 및 height 은 픽셀 단위로 지정되어야 하고 data 은 32비트 정렬되어야 하며 이미지의 각 데이터 스캔 라인도 32비트 정렬되어야 합니다.

버퍼는 QImage의 수명 기간 동안 유효해야 하며 원본 버퍼에서 수정되거나 분리되지 않은 모든 복사본이 유효해야 합니다. 이미지가 소멸될 때 버퍼는 삭제되지 않습니다. 함수 포인터 cleanupFunction 와 함께 마지막 복사본이 소멸될 때 호출되는 추가 포인터 cleanupInfo 를 제공할 수 있습니다.

format 이 색인된 색상 형식인 경우 이미지 색상 테이블은 처음에 비어 있으며 이미지를 사용하기 전에 setColorCount() 또는 setColorTable()로 충분히 확장해야 합니다.

QImage::QImage(const uchar *data, int width, int height, qsizetype bytesPerLine, QImage::Format format, QImageCleanupFunction cleanupFunction = nullptr, void *cleanupInfo = nullptr)

주어진 width, height 및 format 로 기존 메모리 버퍼인 data 을 사용하는 이미지를 생성합니다. width 와 height 은 픽셀 단위로 지정해야 합니다. bytesPerLine 은 줄당 바이트 수(보폭)를 지정합니다.

버퍼는 QImage의 수명 동안 유효해야 하며, 원본 버퍼에서 수정되거나 분리되지 않은 모든 복사본이 유효해야 합니다. 이미지가 소멸될 때 버퍼는 삭제되지 않습니다. 함수 포인터 cleanupFunction 와 함께 마지막 복사본이 소멸될 때 호출되는 추가 포인터 cleanupInfo 를 제공할 수 있습니다.

format 이 색인된 색상 형식인 경우 이미지 색상 테이블은 처음에 비어 있으며 이미지를 사용하기 전에 setColorCount() 또는 setColorTable()로 충분히 확장해야 합니다.

컨스트가 아닌 데이터 버퍼를 취하는 유사한 QImage 생성자와 달리 이 버전은 버퍼의 내용을 변경하지 않습니다. 예를 들어 QImage::bits()를 호출하면 생성자에 전달된 버퍼가 아니라 이미지의 딥 카피가 반환됩니다. 따라서 원시 데이터가 변경될 가능성 없이 원시 데이터에서 QImage를 효율적으로 구성할 수 있습니다.

QImage::QImage(uchar *data, int width, int height, qsizetype bytesPerLine, QImage::Format format, QImageCleanupFunction cleanupFunction = nullptr, void *cleanupInfo = nullptr)

주어진 width, height 및 format 로 기존 메모리 버퍼인 data 을 사용하는 이미지를 생성합니다. width 와 height 은 픽셀 단위로 지정해야 합니다. bytesPerLine 은 줄당 바이트 수(보폭)를 지정합니다.

버퍼는 QImage의 수명 동안 유효해야 하며, 원본 버퍼에서 수정되거나 분리되지 않은 모든 복사본이 유효해야 합니다. 이미지가 소멸될 때 버퍼는 삭제되지 않습니다. 함수 포인터 cleanupFunction 와 함께 마지막 복사본이 소멸될 때 호출되는 추가 포인터 cleanupInfo 를 제공할 수 있습니다.

format 이 색인된 색상 형식인 경우 이미지 색상 테이블은 처음에 비어 있으며 이미지를 사용하기 전에 setColorCount() 또는 setColorTable()로 충분히 확장해야 합니다.

QImage::QImage(const QImage &image)

주어진 image 의 얕은 복사본을 생성합니다.

얕은 복사본에 대한 자세한 내용은 암시적 데이터 공유 문서를 참조하세요.

copy()도 참조하세요 .

[noexcept] QImage::QImage(QImage &&other)

Move - QImage 인스턴스를 생성하여 other 이 가리키고 있던 것과 동일한 객체를 가리키도록 합니다.

[virtual noexcept] QImage::~QImage()

이미지를 삭제하고 정리합니다.

bool QImage::allGray() const

이미지의 모든 색상이 회색 음영인 경우(즉, 빨간색, 녹색 및 파란색 구성 요소가 동일할 경우) true 을 반환하고, 그렇지 않으면 false를 반환합니다.

이 함수는 색상표가 없는 이미지의 경우 속도가 느립니다.

isGrayscale()도 참조하세요 .

void QImage::applyColorTransform(const QColorTransform &transform)

이미지의 모든 픽셀에 색상 변환 transform 을 적용합니다.

[since 6.8] void QImage::applyColorTransform(const QColorTransform &transform, QImage::Format toFormat, Qt::ImageConversionFlags flags = Qt::AutoColor)

이미지의 모든 픽셀에 색상 변환 transform 을 적용하고 이미지의 형식을 toFormat 으로 변환합니다.

지정된 이미지 변환 flags 은 포맷 변환 과정에서 이미지 데이터가 처리되는 방식을 제어합니다.

이 함수는 Qt 6.8에 도입되었습니다.

int QImage::bitPlaneCount() const

이미지의 비트 평면 수를 반환합니다.

비트 평면 수는 각 픽셀에 대한 색상 및 투명도 정보의 비트 수입니다. 이미지 형식에 사용되지 않는 비트가 포함된 경우 심도와는 다릅니다(즉, 이보다 작습니다).

depth(), format() 및 Image Formats 를참조하세요 .

uchar *QImage::bits()

첫 번째 픽셀 데이터에 대한 포인터를 반환합니다. 이는 scanLine(0)에 해당합니다.

QImage 은 암시적 데이터 공유를 사용합니다. 이 함수는 공유 픽셀 데이터의 딥 카피를 수행하므로 QImage 이 현재 반환값을 사용하는 유일한 함수가 됩니다.

scanLine(), sizeInBytes() 및 constBits()도 참조하세요 .

const uchar *QImage::bits() const

이 함수는 오버로드된 함수입니다.

QImage 은 암시적 데이터 공유를 사용하지만 이 함수는 반환되는 데이터가 const이므로 공유 픽셀 데이터의 딥 카피를 수행하지 않습니다.

qsizetype QImage::bytesPerLine() const

이미지 스캔 라인당 바이트 수를 반환합니다.

height()가 0이 아닌 경우 sizeInBytes() / height()에 해당합니다.

scanLine()도 참조하세요 .

qint64 QImage::cacheKey() const

이 QImage 객체의 콘텐츠를 식별하는 숫자를 반환합니다. 고유한 QImage 객체는 동일한 콘텐츠를 참조하는 경우에만 동일한 키를 가질 수 있습니다.

이미지가 변경되면 키가 변경됩니다.

QRgb QImage::color(int i) const

색인 색표의 색상을 반환합니다 i. 첫 번째 색은 인덱스 0에 있습니다.

이미지 색상표의 색상은 ARGB 사중색(QRgb)으로 지정됩니다. qAlpha (), qRed(), qGreen() 및 qBlue() 함수를 사용하여 색상 값 구성 요소를 가져옵니다.

setColor(), pixelIndex() 및 Pixel Manipulation 를참조하세요 .

int QImage::colorCount() const

이미지에 대한 색상표의 크기를 반환합니다.

이러한 이미지에서는 컬러 테이블을 사용하지 않고 픽셀 값을 ARGB 4분할로 인코딩하므로 32pp 이미지의 경우 colorCount()가 0을 반환합니다.

setColorCount() 및 Image Information 을참조하세요 .

QColorSpace QImage::colorSpace() const

색 공간이 정의된 경우 이미지의 색 공간을 반환합니다.

setColorSpace()도 참조하세요 .

QList<QRgb> QImage::colorTable() const

이미지의 색상표에 포함된 색상 목록을 반환하거나 이미지에 색상표가 없는 경우 빈 목록을 반환합니다.

setColorTable(), colorCount() 및 color()도 참조하세요 .

[since 6.4] QImage QImage::colorTransformed(const QColorTransform &transform) const &

이미지의 모든 픽셀에 transform 을 사용하여 변환된 이미지 색상을 반환합니다.

이 함수는 Qt 6.4에 도입되었습니다.

applyColorTransform()도 참조하세요 .

[since 6.8] QImage QImage::colorTransformed(const QColorTransform &transform, QImage::Format toFormat, Qt::ImageConversionFlags flags = Qt::AutoColor) const &

이미지의 모든 픽셀에 transform 을 사용하여 변환된 이미지 색상을 반환하여 toFormat 형식의 이미지를 반환합니다.

지정된 이미지 변환 flags 은 형식 변환 프로세스 중에 이미지 데이터가 처리되는 방식을 제어합니다.

이 함수는 Qt 6.8에 도입되었습니다.

applyColorTransform()도 참조하십시오 .

[since 6.4] QImage QImage::colorTransformed(const QColorTransform &transform) &&

이 함수는 오버로드된 함수입니다.

이미지의 모든 픽셀에 transform 을 사용하여 변환된 이미지 색상을 반환합니다.

이 함수는 Qt 6.4에 도입되었습니다.

applyColorTransform()도 참조하세요 .

[since 6.8] QImage QImage::colorTransformed(const QColorTransform &transform, QImage::Format format, Qt::ImageConversionFlags flags = Qt::AutoColor) &&

이 함수는 오버로드된 함수입니다.

이미지의 모든 픽셀에 transform 을 사용하여 변환된 이미지 색상을 반환합니다.

이 함수는 Qt 6.8에 도입되었습니다.

applyColorTransform()도 참조하세요 .

const uchar *QImage::constBits() const

첫 번째 픽셀 데이터에 대한 포인터를 반환합니다.

QImage 은 암시적 데이터 공유를 사용하지만, 반환되는 데이터가 const이므로 이 함수는 공유 픽셀 데이터의 딥 카피를 수행하지 않습니다.

bits() 및 constScanLine()도 참조하세요 .

const uchar *QImage::constScanLine(int i) const

인덱스가 i 인 스캔라인의 픽셀 데이터에 대한 포인터를 반환합니다. 첫 번째 스캔라인은 인덱스 0에 있습니다.

스캔라인 데이터는 최소 32비트 정렬됩니다. 64비트 형식의 경우 64비트 정수의 기본 정렬을 따릅니다(대부분의 플랫폼에서 64비트, 특히 i386에서는 32비트).

QImage 함수는 암시적 데이터 공유를 사용하지만, 반환되는 데이터가 const이므로 공유 픽셀 데이터의 딥 카피는 수행하지 않습니다.

scanLine() 및 constBits()도 참조하세요 .

void QImage::convertTo(QImage::Format format, Qt::ImageConversionFlags flags = Qt::AutoColor)

이미지를 지정된 format 제자리에서 변환하고 필요한 경우 분리합니다.

지정된 이미지 변환 flags 은 변환 프로세스 중에 이미지 데이터가 처리되는 방식을 제어합니다.

convertedTo()도 참조하세요 .

void QImage::convertToColorSpace(const QColorSpace &colorSpace)

이미지를 colorSpace 로 변환합니다.

이미지에 유효한 색 공간이 없는 경우 이 메서드는 아무 작업도 수행하지 않습니다.

convertedToColorSpace() 및 setColorSpace()도 참조하세요 .

[since 6.8] void QImage::convertToColorSpace(const QColorSpace &colorSpace, QImage::Format format, Qt::ImageConversionFlags flags = Qt::AutoColor)

이미지를 colorSpace 및 format 로 변환합니다.

이미지에 유효한 색 공간이 없는 경우나 색 공간이 형식과 호환되지 않는 경우 이 메서드는 아무 작업도 수행하지 않습니다.

지정된 이미지 변환 flags 은 형식 변환 프로세스 중에 이미지 데이터가 처리되는 방식을 제어합니다.

이 함수는 Qt 6.8에 도입되었습니다.

convertedToColorSpace() 및 setColorSpace()도 참조하세요 .

QImage QImage::convertToFormat(QImage::Format format, const QList<QRgb> &colorTable, Qt::ImageConversionFlags flags = Qt::AutoColor) const

이 함수는 오버로드된 함수입니다.

지정된 colorTable 을 사용하여 지정된 format 으로 변환된 이미지 사본을 반환합니다.

RGB 형식에서 색인된 형식으로 변환하는 것은 느린 작업이며 디더링 없이 가장 가까운 색을 사용하는 간단한 접근 방식을 사용합니다.

QImage QImage::convertedToColorSpace(const QColorSpace &colorSpace) const

colorSpace 로 변환된 이미지를 반환합니다.

이미지에 유효한 색 공간이 없는 경우 null QImage 이 반환됩니다.

convertToColorSpace() 및 colorTransformed()도 참조하세요 .

QImage QImage::copy(const QRect &rectangle = QRect()) const

이미지의 하위 영역을 새 이미지로 반환합니다.

반환된 이미지는 이 이미지의 위치(rectangle.x(), rectangle.y())에서 복사되며, 항상 지정된 rectangle 의 크기를 갖습니다.

이 이미지 이외의 영역에서는 픽셀이 0으로 설정됩니다. 32비트 RGB 이미지의 경우 검은색, 32비트 ARGB 이미지의 경우 투명한 검은색, 8비트 이미지의 경우 색상 표에서 인덱스가 0인 색(무엇이든 가능)을 의미하며 1비트 이미지의 경우 Qt::color0 을 의미합니다.

주어진 rectangle 이 널 사각형이면 전체 이미지가 복사됩니다.

QImage()도 참조하세요 .

QImage QImage::copy(int x, int y, int width, int height) const

이 함수는 오버로드된 함수입니다.

반환된 이미지는 이 이미지의 위치(x, y)에서 복사되며 항상 지정된 width 및 height 을 갖습니다. 이 이미지 이외의 영역에서는 픽셀이 0으로 설정됩니다.

QImage QImage::createAlphaMask(Qt::ImageConversionFlags flags = Qt::AutoColor) const

이 이미지의 알파 버퍼에서 1-bpp 마스크를 빌드하고 반환합니다. 이미지 형식이 QImage::Format_RGB32 인 경우 null 이미지를 반환합니다.

flags 인수는 Qt::ImageConversionFlags 의 비트 단위 OR이며 변환 프로세스를 제어합니다. 플래그에 0을 전달하면 모든 기본 옵션이 설정됩니다.

반환된 이미지는 리틀 엔디안 비트 순서(즉, 이미지 형식이 QImage::Format_MonoLSB)이며, convertToFormat() 함수를 사용하여 빅 엔디안(QImage::Format_Mono)으로 변환할 수 있습니다.

createHeuristicMask() 및 Image Transformations 을참조하세요 .

QImage QImage::createHeuristicMask(bool clipTight = true) const

이 이미지에 대한 1-bpp 휴리스틱 마스크를 생성하고 반환합니다.

이 함수는 모서리 중 하나에서 색상을 선택한 다음 모든 가장자리부터 해당 색상의 픽셀을 잘라내는 방식으로 작동합니다. 네 모서리는 어떤 색상을 마스킹할지 투표합니다. 무승부인 경우(일반적으로 이 함수를 이미지에 적용할 수 없음을 의미) 결과는 임의로 결정됩니다.

반환된 이미지는 리틀엔디안 비트 순서(즉, 이미지 형식은 QImage::Format_MonoLSB)이며, convertToFormat() 함수를 사용하여 빅엔디안(QImage::Format_Mono)으로 변환할 수 있습니다.

clipTight (기본값)이 참이면 마스크는 픽셀을 덮을 만큼만 커지고, 그렇지 않으면 마스크가 데이터 픽셀보다 커집니다.

이 함수는 알파 버퍼를 무시한다는 점에 유의하세요.

createAlphaMask() 및 Image Transformations 을참조하세요 .

QImage QImage::createMaskFromColor(QRgb color, Qt::MaskMode mode = Qt::MaskInColor) const

주어진 color 값을 기반으로 이 이미지에 대한 마스크를 생성하고 반환합니다. mode 가 MaskInColor(기본값)인 경우 color 와 일치하는 모든 픽셀은 마스크에서 불투명 픽셀이 됩니다. mode 가 MaskOutColor인 경우 지정된 색상과 일치하는 모든 픽셀이 투명해집니다.

createAlphaMask() 및 createHeuristicMask()도 참조하세요 .

int QImage::depth() const

이미지의 깊이를 반환합니다.

이미지 심도는 단일 픽셀을 저장하는 데 사용되는 비트 수로, 픽셀당 비트 수(bpp)라고도 합니다.

지원되는 심도는 1, 8, 16, 24, 32, 64입니다.

bitPlaneCount(), convertToFormat(), Image Formats, 및 Image Information 을참조하세요 .

[since 6.2] QSizeF QImage::deviceIndependentSize() const

이미지의 크기를 디바이스 독립 픽셀 단위로 반환합니다.

이 값은 사용자 인터페이스 크기 계산에 이미지 크기를 사용할 때 사용해야 합니다.

반환 값은 image.size() / image.devicePixelRatio()와 동일합니다.

이 함수는 Qt 6.2에 도입되었습니다.

qreal QImage::devicePixelRatio() const

이미지의 디바이스 픽셀 비율을 반환합니다. 이 비율은 디바이스 픽셀과 디바이스 독립 픽셀 사이의 비율입니다.

이미지 크기를 기준으로 레이아웃 지오메트리를 계산할 때 이 함수를 사용합니다: QSize layoutSize = image.size() / image.devicePixelRatio()

기본값은 1.0입니다.

setDevicePixelRatio() 및 QImageReader 을참조하세요 .

int QImage::dotsPerMeterX() const

실제 미터에 가로로 맞는 픽셀 수를 반환합니다. 이 숫자는 dotsPerMeterY()와 함께 이미지의 의도된 배율과 종횡비를 정의합니다.

setDotsPerMeterX() 및 Image Information 을참조하세요 .

int QImage::dotsPerMeterY() const

실제 미터에 세로로 맞는 픽셀 수를 반환합니다. 이 숫자는 dotsPerMeterX()와 함께 이미지의 의도된 배율과 종횡비를 정의합니다.

setDotsPerMeterY() 및 Image Information도 참조하세요 .

void QImage::fill(uint pixelValue)

주어진 pixelValue 으로 전체 이미지를 채웁니다.

이 이미지의 깊이가 1이면 가장 낮은 비트만 사용됩니다. fill(0), fill(2) 등을 말하면 이미지가 0으로 채워집니다. fill(1), fill(3) 등을 말하면 이미지가 1초로 채워집니다. 깊이가 8이면 가장 낮은 8비트가 사용되고, 깊이가 16이면 가장 낮은 16비트가 사용됩니다.

이미지 깊이가 32비트보다 높으면 결과가 정의되지 않습니다.

depth() 및 Image Transformations도 참조하세요 .

void QImage::fill(Qt::GlobalColor color)

이 함수는 오버로드된 함수입니다.

주어진 color, 표준 전역 색상으로 설명된 이미지로 이미지를 채웁니다.

void QImage::fill(const QColor &color)

이 함수는 과부하가 걸린 함수입니다.

주어진 color 으로 전체 이미지를 채웁니다.

이미지의 깊이가 1인 경우 color 이 Qt::color1 과 같으면 이미지가 1로 채워지고, 그렇지 않으면 0으로 채워집니다.

이미지의 깊이가 8인 경우 이미지에 색상 표의 color 에 해당하는 인덱스가 있는 경우 해당 인덱스로 이미지를 채우고 그렇지 않으면 0으로 채웁니다.

[since 6.9] void QImage::flip(Qt::Orientations orient = Qt::Vertical)

orient 에 따라 이미지를 가로 및/또는 세로 방향으로 뒤집거나 미러링합니다.

이 함수는 Qt 6.9에 도입되었습니다.

flipped(Qt::Orientations) 및 Image Transformations 를참조하십시오 .

QImage::Format QImage::format() const

이미지의 형식을 반환합니다.

Image Formats도 참조하세요 .

[static, since 6.2] QImage QImage::fromData(QByteArrayView data, const char *format = nullptr)

주어진 QByteArrayView data 에서 이미지를 생성합니다. 로더는 지정된 format 을 사용하여 이미지를 읽으려고 시도합니다. format 이 지정되지 않은 경우(기본값), 로더는 데이터에서 헤더를 검사하여 파일 형식을 추측합니다.

format 을 지정한 경우 QImageReader::supportedImageFormats()에서 반환한 값 중 하나이어야 합니다.

이미지 로딩에 실패하면 반환되는 이미지는 널 이미지가 됩니다.

이 함수는 Qt 6.2에 도입되었습니다.

load(), save() 및 Reading and Writing Image Files 를참조하십시오 .

[static] QImage QImage::fromData(const QByteArray &data, const char *format = nullptr)

이 함수는 오버로드된 함수입니다.

주어진 QByteArray data 에서 QImage 을 생성합니다.

[static] QImage QImage::fromData(const uchar *data, int size, const char *format = nullptr)

이 함수는 오버로드된 함수입니다.

주어진 바이너리 data 의 첫 번째 size 바이트에서 QImage 를 생성합니다.

[static, since 6.0] QImage QImage::fromHBITMAP(HBITMAP hbitmap)

주어진 hbitmap 과 동일한 QImage 을 반환합니다.

HBITMAP은 알파 채널에 대한 정보를 저장하지 않습니다.

표준의 경우 알파 채널은 무시되고 완전히 불투명한 이미지가 생성됩니다(일반적으로 QImage::Format_RGB32 형식).

하지만 애플리케이션 아이콘이나 시스템 아이콘 등 알파 채널이 사용되는 경우도 있습니다. 이 경우 반환된 이미지에서 reinterpretAsFormat(QImage::Format_ARGB32) 을 호출하여 형식이 올바른지 확인해야 합니다.

이 함수는 Qt 6.0에 도입되었습니다.

toHBITMAP() 및 reinterpretAsFormat()도 참조하세요 .

[static, since 6.0] QImage QImage::fromHICON(HICON icon)

주어진 icon 과 동일한 QImage 을 반환합니다.

이 함수는 Qt 6.0에 도입되었습니다.

toHICON()도 참조하십시오 .

bool QImage::hasAlphaChannel() const

이미지에 알파 채널을 존중하는 형식이 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

Image Information 를참조하세요 .

int QImage::height() const

이미지의 높이를 반환합니다.

Image Information도 참조하세요 .

void QImage::invertPixels(QImage::InvertMode mode = InvertRgb)

이미지의 모든 픽셀 값을 반전합니다.

주어진 인버트 mode 는 이미지의 깊이가 32일 때만 의미가 있습니다. 기본값 mode 은 InvertRgb 으로 알파 채널은 변경되지 않습니다. mode 이 InvertRgba 인 경우 알파 비트도 반전됩니다.

8비트 이미지를 반전한다는 것은 색상 인덱스 i를 사용하는 모든 픽셀을 색상 인덱스 255에서 i를 뺀 픽셀로 바꾸는 것을 의미하며, 1비트 이미지의 경우도 마찬가지입니다. 색상 표는 변경되지 않습니다.

이미지에 미리 곱셈된 알파 채널이 있는 경우 이미지가 먼저 곱셈되지 않은 이미지 형식으로 변환되어 반전된 다음 다시 변환됩니다.

Image Transformations 을참조하세요 .

bool QImage::isGrayscale() const

32비트 이미지의 경우 이 함수는 allGray()와 동일합니다.

색상 색인 이미지의 경우 이 함수는 색상 테이블의 모든 색인에 대해 color(i)가 QRgb(i, i, i)인 경우 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

allGray() 및 Image Formats도 참조하십시오 .

bool QImage::isNull() const

널 이미지인 경우 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

널 이미지는 모든 파라미터가 0으로 설정되어 있고 할당된 데이터가 없습니다.

bool QImage::load(const QString &fileName, const char *format = nullptr)

주어진 fileName 으로 파일에서 이미지를 로드합니다. 이미지가 성공적으로 로드되면 true 을 반환하고, 그렇지 않으면 이미지를 무효화하고 false 을 반환합니다.

로더는 지정된 format 를 사용하여 이미지를 읽으려고 시도합니다(예: PNG 또는 JPG). format 이 지정되지 않은 경우(기본값) 파일의 접미사 및 헤더에 따라 자동으로 감지됩니다. 자세한 내용은 QImageReader::setAutoDetectImageFormat()를 참조하세요.

파일 이름은 디스크의 실제 파일 또는 애플리케이션의 임베디드 리소스 중 하나를 참조할 수 있습니다. 애플리케이션의 실행 파일에 이미지 및 기타 리소스 파일을 임베드하는 방법에 대한 자세한 내용은 리소스 시스템 개요를 참조하세요.

Reading and Writing Image Files 를참조하세요 .

bool QImage::load(QIODevice *device, const char *format)

이 함수는 오버로드된 함수입니다.

이 함수는 주어진 device 에서 QImage 을 읽습니다. 예를 들어 이미지를 QByteArray 에 직접 로드하는 데 사용할 수 있습니다.

[since 6.2] bool QImage::loadFromData(QByteArrayView data, const char *format = nullptr)

주어진 QByteArrayView data 에서 이미지를 로드합니다. 이미지가 성공적으로 로드되면 true 을 반환하고, 그렇지 않으면 이미지를 무효화하고 false 을 반환합니다.

로더는 지정된 format 를 사용하여 이미지를 읽으려고 시도합니다(예: PNG 또는 JPG). format 이 지정되지 않은 경우(기본값), 로더는 파일에서 헤더를 검사하여 파일 형식을 추측합니다.

이 함수는 Qt 6.2에 도입되었습니다.

Reading and Writing Image Files 를참조하십시오 .

bool QImage::loadFromData(const QByteArray &data, const char *format = nullptr)

이 함수는 과부하된 함수입니다.

주어진 QByteArray data 에서 이미지를 로드합니다.

bool QImage::loadFromData(const uchar *data, int len, const char *format = nullptr)

이 함수는 오버로드된 함수입니다.

주어진 바이너리 data 의 첫 번째 len 바이트에서 이미지를 로드합니다.

[since 6.0, until 6.13] void QImage::mirror(bool horizontal = false, bool vertical = true)

이 함수는 버전 6.13에서 더 이상 사용되지 않을 예정입니다.

대신 flip(Qt::Orientations)을 사용하세요.

horizontal 및 vertical 이 참 또는 거짓으로 설정되어 있는지 여부에 따라 이미지를 가로 및/또는 세로 방향으로 미러링합니다.

이 함수는 Qt 6.0에 도입되었습니다.

mirrored() 및 Image Transformations 을참조하십시오 .

QPoint QImage::offset() const

다른 이미지와 비교하여 위치를 지정할 때 이미지가 오프셋될 픽셀 수를 반환합니다.

setOffset() 및 Image Information 을참조하세요 .

QRgb QImage::pixel(const QPoint &position) const

주어진 position 에서 픽셀의 색을 반환합니다.

position 이 유효하지 않으면 결과가 정의되지 않습니다.

setPixel(), valid(), constBits(), constScanLine() 및 Pixel Manipulation도 참조하세요 .

QRgb QImage::pixel(int x, int y) const

이 함수는 오버로드된 함수입니다.

좌표에서 픽셀의 색을 반환합니다(x, y).

QColor QImage::pixelColor(const QPoint &position) const

주어진 position 에서 픽셀의 색을 QColor 으로 반환합니다.

position 이 유효하지 않으면 유효하지 않은 QColor 이 반환됩니다.

setPixelColor(), setPixel(), valid(), constBits(), constScanLine() 및 Pixel Manipulation 를참조하세요 .

QColor QImage::pixelColor(int x, int y) const

이 함수는 오버로드된 함수입니다.

좌표(x, y)에서 픽셀의 색을 QColor 로 반환합니다.

[noexcept] QPixelFormat QImage::pixelFormat() const

QImage::Format 를 QPixelFormat

int QImage::pixelIndex(const QPoint &position) const

주어진 position 에서 픽셀 인덱스를 반환합니다.

position 이 유효하지 않거나 이미지가 팔레트 이미지가 아닌 경우(depth() > 8) 결과는 정의되지 않습니다.

valid(), depth() 및 Pixel Manipulation 를참조하세요 .

int QImage::pixelIndex(int x, int y) const

이 함수는 오버로드된 함수입니다.

(x, y)에서 픽셀 인덱스를 반환합니다.

QRect QImage::rect() const

이미지의 둘러싸는 사각형(0, 0, width(), height())을 반환합니다.

Image Information 를참조하세요 .

bool QImage::reinterpretAsFormat(QImage::Format format)

데이터는 변경하지 않고 이미지 형식을 format 로 변경합니다. 동일한 깊이의 형식 간에만 작동합니다.

성공하면 true 을 반환합니다.

이 함수는 데이터가 불투명 전용으로 알려진 경우 알파 채널이 있는 이미지를 해당 불투명 포맷으로 변경하거나 새 데이터로 덮어쓰기 전에 지정된 이미지 버퍼의 포맷을 변경하는 데 사용할 수 있습니다.

hasAlphaChannel() 및 convertToFormat()도 참조하세요 .

[since 6.0] void QImage::rgbSwap()

모든 픽셀의 빨간색과 파란색 구성 요소의 값을 바꾸어 RGB 이미지를 BGR 이미지로 효과적으로 변환합니다.

이 기능은 Qt 6.0에 도입되었습니다.

rgbSwapped() 및 Image Transformations 을참조하십시오 .

bool QImage::save(const QString &fileName, const char *format = nullptr, int quality = -1) const

주어진 이미지 파일 format 및 quality 인자를 사용하여 주어진 fileName 으로 이미지를 파일에 저장합니다. format 가 nullptr 인 경우 QImage 는 fileName 의 접미사를 보고 형식을 추측하려고 시도합니다.

quality 계수는 0~100 또는 -1 범위여야 합니다. 작은 압축 파일을 얻으려면 0, 큰 비압축 파일을 얻으려면 100, 기본 설정을 사용하려면 -1(기본값)을 지정합니다.

이미지가 성공적으로 저장되면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

Reading and Writing Image Files 를참조하세요 .

bool QImage::save(QIODevice *device, const char *format = nullptr, int quality = -1) const

이 함수는 오버로드된 함수입니다.

이 함수는 주어진 device 에 QImage 을 씁니다.

예를 들어 이미지를 QByteArray 에 직접 저장하는 데 사용할 수 있습니다:

QImage image;
QByteArray ba;
QBuffer buffer(&ba);
buffer.open(QIODevice::WriteOnly);
image.save(&buffer, "PNG"); // writes image into ba in PNG format

QImage QImage::scaled(const QSize &size, Qt::AspectRatioMode aspectRatioMode = Qt::IgnoreAspectRatio, Qt::TransformationMode transformMode = Qt::FastTransformation) const

주어진 aspectRatioMode 과 transformMode 에 따라 주어진 size 에 정의된 사각형으로 스케일링된 이미지 사본을 반환합니다.

• aspectRatioMode 가 Qt::IgnoreAspectRatio 인 경우 이미지의 크기가 size 로 조정됩니다.
• aspectRatioMode 가 Qt::KeepAspectRatio 인 경우 이미지의 가로 세로 비율을 유지하면서 size 내에서 가능한 한 큰 직사각형으로 크기가 조정됩니다.
• aspectRatioMode 이 Qt::KeepAspectRatioByExpanding 인 경우 이미지가 size 외부에서 가능한 한 작은 직사각형으로 축소되어 가로 세로 비율을 유지합니다.

주어진 size 이 비어 있으면 이 함수는 null 이미지를 반환합니다.

isNull() 및 Image Transformations 을참조하세요 .

QImage QImage::scaled(int width, int height, Qt::AspectRatioMode aspectRatioMode = Qt::IgnoreAspectRatio, Qt::TransformationMode transformMode = Qt::FastTransformation) const

이 함수는 오버로드된 함수입니다.

주어진 aspectRatioMode 및 transformMode 에 따라 주어진 width 및 height 을 사용하여 직사각형으로 크기 조정된 이미지 사본을 반환합니다.

width 또는 height 이 0이거나 음수인 경우 이 함수는 null 이미지를 반환합니다.

QImage QImage::scaledToHeight(int height, Qt::TransformationMode mode = Qt::FastTransformation) const

이미지의 크기 조정된 복사본을 반환합니다. 반환된 이미지는 지정된 변환을 사용하여 지정된 height 에 맞게 크기가 조정됩니다 mode.

이 함수는 이미지의 비율이 유지되도록 이미지의 너비를 자동으로 계산합니다.

지정된 height 이 0이거나 음수이면 null 이미지가 반환됩니다.

Image Transformations도 참조하세요 .

QImage QImage::scaledToWidth(int width, Qt::TransformationMode mode = Qt::FastTransformation) const

이미지의 크기 조정된 복사본을 반환합니다. 반환된 이미지는 지정된 변환 mode 을 사용하여 지정된 width 으로 크기가 조정됩니다.

이 함수는 이미지의 가로 세로 비율이 유지되도록 이미지의 높이를 자동으로 계산합니다.

지정된 width 이 0이거나 음수이면 null 이미지가 반환됩니다.

Image Transformations도 참조하세요 .

uchar *QImage::scanLine(int i)

인덱스가 i 인 스캔라인의 픽셀 데이터에 대한 포인터를 반환합니다. 첫 번째 스캔라인은 인덱스 0에 있습니다.

스캔라인 데이터는 최소 32비트 정렬됩니다. 64비트 형식의 경우 64비트 정수의 기본 정렬을 따릅니다(대부분의 플랫폼에서 64비트, 특히 i386의 경우 32비트).

예를 들어 이미지에서 각 픽셀의 녹색 구성 요소를 제거합니다:

for (int y = 0; y < image.height(); ++y) {
    QRgb *line = reinterpret_cast<QRgb*>(image.scanLine(y));
    for (int x = 0; x < image.width(); ++x) {
        QRgb &rgb = line[x];
        rgb = qRgba(qRed(rgb), qGreen(0), qBlue(rgb), qAlpha(rgb));
    }
}

bytesPerLine(), bits(), Pixel Manipulation, constScanLine()도 참조하세요 .

const uchar *QImage::scanLine(int i) const

과부하가 걸린 기능입니다.

void QImage::setAlphaChannel(const QImage &alphaChannel)

이 이미지의 알파 채널을 주어진 alphaChannel 으로 설정합니다.

alphaChannel 이 8비트 알파 이미지인 경우 알파 값이 직접 사용됩니다. 그렇지 않으면 alphaChannel 이 8비트 회색조로 변환되고 픽셀 값의 강도가 사용됩니다.

이미지에 이미 알파 채널이 있는 경우 기존 알파 채널에 새 알파 채널이 곱해집니다. 이미지에 알파 채널이 없는 경우 알파 채널이 있는 형식으로 변환됩니다.

이 작업은 QPainter::CompositionMode_DestinationIn 을 사용하여 alphaChannel 을 이 이미지 위에 알파 이미지로 칠하는 것과 유사합니다.

hasAlphaChannel(), Image Transformations, Image Formats 를참조하세요 .

void QImage::setColor(int index, QRgb colorValue)

색상 표의 지정된 index 에 있는 색상을 지정된 colorValue 에 있는 색상으로 설정합니다. 색상 값은 ARGB 4중색입니다.

index 이 색상표의 현재 크기를 벗어나는 경우 setColorCount()로 확장됩니다.

color(), colorCount(), setColorTable() 및 Pixel Manipulation 를참조하세요 .

void QImage::setColorCount(int colorCount)

colorCount 항목을 포함하도록 색상표의 크기를 조정합니다.

색상표가 확장되면 모든 추가 색상이 투명으로 설정됩니다(예: qRgba(0, 0, 0, 0)).

이미지를 사용하는 경우 색상표는 이미지에 있는 모든 픽셀/색인 값에 대한 항목이 포함될 수 있을 만큼 충분히 커야 하며, 그렇지 않으면 결과가 정의되지 않습니다.

colorCount(), colorTable(), setColor() 및 Image Transformations 을참조하세요 .

void QImage::setColorSpace(const QColorSpace &colorSpace)

이미지 데이터에 대한 변환을 수행하지 않고 이미지 색 공간을 colorSpace 로 설정합니다.

colorSpace()도 참조하세요 .

void QImage::setColorTable(const QList<QRgb> &colors)

색상 인덱스를 QRgb 값으로 변환하는 데 사용되는 색상 표를 지정된 colors 으로 설정합니다.

이미지를 사용하는 경우 색상 테이블은 이미지에 있는 모든 픽셀/색인 값에 대한 항목을 포함할 수 있을 만큼 충분히 커야 하며, 그렇지 않으면 결과가 정의되지 않습니다.

colorTable(), setColor() 및 Image Transformations 를참조하세요 .

void QImage::setDevicePixelRatio(qreal scaleFactor)

이미지의 디바이스 픽셀 비율을 설정합니다. 이미지 픽셀과 디바이스 독립 픽셀 간의 비율입니다.

기본값 scaleFactor 은 1.0입니다. 다른 값으로 설정하면 두 가지 효과가 있습니다:

이미지에 열려 있는 Q페인터의 크기가 조정됩니다. 예를 들어 비율이 2.0인 경우 200x200 이미지에 페인팅하면 (기기와 무관한) 유효 페인팅 바운드는 100x100이 됩니다.

이미지 크기를 기반으로 레이아웃 지오메트리를 계산하는 Qt의 코드 경로는 비율을 고려합니다: QSize layoutSize = image.size() / image.devicePixelRatio() 이로 인한 순 효과는 이미지가 큰 이미지가 아닌 높은 DPI 이미지로 표시된다는 것입니다( Drawing High Resolution Versions of Pixmaps and Images 참조).

devicePixelRatio() 및 deviceIndependentSize()도 참조하세요 .

void QImage::setDotsPerMeterX(int x)

실제 미터에 가로로 맞는 픽셀 수를 x 로 설정합니다.

이 숫자는 dotsPerMeterY()와 함께 이미지의 의도된 배율 및 종횡비를 정의하고 QPainter 이 이미지에 그래픽을 그리는 배율을 결정합니다. 다른 페인트 장치에서 렌더링할 때 이미지의 배율이나 종횡비는 변경되지 않습니다.

dotsPerMeterX() 및 Image Information 을참조하세요 .

void QImage::setDotsPerMeterY(int y)

실제 미터에 세로로 맞는 픽셀 수를 y 로 설정합니다.

이 숫자는 dotsPerMeterX()와 함께 이미지의 의도된 배율 및 종횡비를 정의하고 QPainter 이 이미지에 그래픽을 그리는 배율을 결정합니다. 다른 페인트 장치에서 렌더링할 때 이미지의 배율이나 종횡비는 변경되지 않습니다.

dotsPerMeterY() 및 Image Information 을참조하세요 .

void QImage::setOffset(const QPoint &offset)

다른 이미지와 비교하여 위치를 지정할 때 이미지가 오프셋될 픽셀 수를 offset 으로 설정합니다.

offset() 및 Image Information 을참조하세요 .

void QImage::setPixel(const QPoint &position, uint index_or_rgb)

주어진 position 에서 픽셀 인덱스 또는 색상을 index_or_rgb 으로 설정합니다.

이미지 형식이 흑백이거나 팔레트인 경우 지정된 index_or_rgb 값은 이미지 색상 표의 인덱스여야 하며, 그렇지 않은 경우 매개변수는 QRgb 값이어야 합니다.

position 이 이미지의 유효한 좌표 쌍이 아니거나 흑백 및 팔레트 이미지의 경우 index_or_rgb >= colorCount()인 경우 결과는 정의되지 않은 값입니다.

pixel() 및 Pixel Manipulation 을참조하세요 .

void QImage::setPixel(int x, int y, uint index_or_rgb)

이 함수는 오버로드된 함수입니다.

픽셀 인덱스 또는 색상을 (x, y)에서 index_or_rgb 로 설정합니다.

void QImage::setPixelColor(const QPoint &position, const QColor &color)

주어진 position 의 색상을 color 으로 설정합니다.

position 이 이미지의 유효한 좌표 쌍이 아니거나 이미지의 형식이 흑백 또는 팔레트인 경우 결과는 정의되지 않습니다.

pixelColor(), pixel(), bits(), scanLine() 및 Pixel Manipulation도 참조하세요 .

void QImage::setPixelColor(int x, int y, const QColor &color)

이 함수는 과부하된 함수입니다.

(x, y)에서 픽셀 색상을 color 로 설정합니다.

void QImage::setText(const QString &key, const QString &text)

이미지 텍스트를 지정된 text 으로 설정하고 지정된 key 과 연결합니다.

단일 텍스트 블록(예: "댓글" 또는 설명)만 저장하려는 경우 빈 키를 전달하거나 "설명"과 같은 일반 키를 사용할 수 있습니다.

save() 또는 QImageWriter::write()을 호출하면 이미지 텍스트가 이미지 데이터에 포함됩니다.

모든 이미지 형식이 임베드된 텍스트를 지원하는 것은 아닙니다. QImageWriter::supportsOption ()를 사용하여 특정 이미지 또는 형식이 텍스트 임베딩을 지원하는지 확인할 수 있습니다. 예를 들어 보겠습니다:

    QImageWriter writer; writer.setFormat("png"); if (writer.supportsOption(QImageIOHandler::설명))        qDebug() << "Png supports embedded text";

QImageWriter::supportedImageFormats()를 사용하여 사용 가능한 이미지 형식을 확인할 수 있습니다.

text() 및 textKeys()도 참조하세요 .

QSize QImage::size() const

이미지의 크기, 즉 width() 및 height()를 반환합니다.

Image Information 및 deviceIndependentSize()도 참조하세요 .

qsizetype QImage::sizeInBytes() const

이미지 데이터 크기를 바이트 단위로 반환합니다.

bytesPerLine(), bits() 및 Image Information 를참조하세요 .

[noexcept] void QImage::swap(QImage &other)

이 이미지를 other 로 바꿉니다. 이 작업은 매우 빠르며 실패하지 않습니다.

QString QImage::text(const QString &key = QString()) const

지정된 key 과 연관된 이미지 텍스트를 반환합니다. 지정된 key 이 빈 문자열이면 각 키-텍스트 쌍이 개행으로 구분된 전체 이미지 텍스트가 반환됩니다.

setText() 및 textKeys()도 참조하세요 .

QStringList QImage::textKeys() const

이 이미지의 텍스트 키를 반환합니다.

이 키를 text()와 함께 사용하여 특정 키의 이미지 텍스트를 나열할 수 있습니다.

text()도 참조하세요 .

CGImageRef QImage::toCGImage() const

QImage 에 해당하는 CGImage 을 생성하고 CGImageRef 핸들을 반환합니다.

반환된 CGImageRef는 QImage 암시적 공유에 참여하며 QImage 데이터에 대한 참조를 보유합니다. CGImage는 변경 불가능하며 QImage 을 분리하지 않습니다. QImage 에 쓰면 평소처럼 분리됩니다.

이 함수는 속도가 빠르며 이미지 데이터를 복사하거나 변환하지 않습니다.

지원되는 이미지 형식은 다음과 같으며 해당 네이티브 이미지 유형에 매핑됩니다:

다른 형식은 지원되지 않으며, 이 함수는 이러한 경우 null CGImageRef를 반환합니다. 이 함수의 사용자는 QImage 를 지원되는 형식(예: Format_ARGB32_Premultiplied)으로 먼저 변환할 수 있습니다.

CGImageRef 색 공간은 sRGB 색 공간으로 설정됩니다.

[since 6.0] HBITMAP QImage::toHBITMAP() const

QImage 에 해당하는 HBITMAP 을 만듭니다.

HBITMAP 핸들을 반환합니다.

사용 후 HBITMAP 데이터를 해제하는 것은 호출자의 책임입니다.

BitBlt() 와 같은 표준 GDI 호출에 사용하는 경우 이미지의 형식은 QImage::Format_RGB32 이어야 합니다.

AlphaBlend() GDI 함수에 결과 HBITMAP을 사용하는 경우 이미지의 형식은 QImage::Format_ARGB32_Premultiplied ( convertToFormat() 사용)이어야 합니다.

결과 HBITMAP을 애플리케이션 아이콘 또는 시스템 아이콘으로 사용하는 경우, 이미지의 형식은 QImage::Format_ARGB32 이어야 합니다.

이 기능은 Qt 6.0에 도입되었습니다.

fromHBITMAP() 및 convertToFormat()도 참조하십시오 .

[since 6.0] HICON QImage::toHICON(const QImage &mask = {}) const

QPixmap 에 해당하는 HICON 을 생성하고 mask 마스크를 적용합니다.

mask 이 null이 아닌 경우 QImage::Format_Mono 형식이어야 합니다. HICON 핸들을 반환합니다.

사용 후 HICON 데이터를 해제하는 것은 호출자의 책임입니다.

이 함수는 Qt 6.0에 도입되었습니다.

fromHICON()도 참조하십시오 .

[static noexcept] QImage::Format QImage::toImageFormat(QPixelFormat format)

format 를 QImage::Format

[static noexcept] QPixelFormat QImage::toPixelFormat(QImage::Format format)

format 를 QPixelFormat

QImage QImage::transformed(const QTransform &matrix, Qt::TransformationMode mode = Qt::FastTransformation) const

주어진 변환 matrix 과 변환 mode 을 사용하여 변환된 이미지의 복사본을 반환합니다.

반환된 이미지는 일반적으로 원본 이미지와 동일한 {이미지 형식}{형식}을 갖습니다. 그러나 복잡한 변환을 사용하면 모든 픽셀이 원본 이미지의 변환된 픽셀로 덮이지 않는 이미지가 생성될 수 있습니다. 이러한 경우 이러한 배경 픽셀에는 투명한 색상 값이 할당되고 원본 이미지에는 알파 채널이 없더라도 변환된 이미지에는 알파 채널이 있는 형식이 지정됩니다.

matrix 변환은 원치 않는 변환을 보정하기 위해 내부적으로 조정됩니다. 즉, 생성된 이미지는 원본 이미지의 모든 변환된 점을 포함하는 가장 작은 이미지입니다. trueMatrix () 함수를 사용하여 이미지 변환에 사용된 실제 행렬을 검색합니다.

다른 오버로드와 달리 이 함수는 이미지에 원근 변환을 수행하는 데 사용할 수 있습니다.

trueMatrix() 및 Image Transformations 을참조하세요 .

[static] QTransform QImage::trueMatrix(const QTransform &matrix, int width, int height)

주어진 width, height 및 matrix 로 이미지를 변환하는 데 사용된 실제 행렬을 반환합니다.

transformed() 함수를 사용하여 이미지를 변환할 때 원치 않는 변환을 보정하기 위해 변환 행렬이 내부적으로 조정됩니다. 즉, transformed()은 원본 이미지의 모든 변환된 점을 포함하는 가장 작은 이미지를 반환합니다. 이 함수는 원본 이미지의 점을 새 이미지에 올바르게 매핑하는 수정된 행렬을 반환합니다.

다른 오버로드와 달리 이 함수는 이미지에서 원근 변환을 수행하는 데 사용할 수 있는 변환 행렬을 생성합니다.

transformed() 및 Image Transformations 을참조하세요 .

bool QImage::valid(const QPoint &pos) const

pos 이 이미지 내에서 유효한 좌표 쌍이면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

rect() 및 QRect::contains()도 참조하세요 .

bool QImage::valid(int x, int y) const

이 함수는 오버로드된 함수입니다.

QPoint(x, y)이 이미지 내에서 유효한 좌표 쌍이면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

int QImage::width() const

이미지의 너비를 반환합니다.

Image Information도 참조하세요 .

QVariant QImage::operator QVariant() const

이미지를 QVariant 로 반환합니다.

bool QImage::operator!=(const QImage &image) const

이 이미지와 주어진 image 의 내용이 다르면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

너비가 다른 등 명백한 차이가 없는 한 비교가 느릴 수 있으며, 이 경우 함수는 빠르게 반환합니다.

operator=()도 참조하세요 .

[noexcept] QImage &QImage::operator=(QImage &&other)

이동-이 other 인스턴스를 QImage 인스턴스에 할당합니다.

QImage &QImage::operator=(const QImage &image)

주어진 image 의 얕은 복사본을 이 이미지에 할당하고 이 이미지에 대한 참조를 반환합니다.

얕은 복사본에 대한 자세한 내용은 암시적 데이터 공유 문서를 참조하세요.

copy() 및 QImage()도 참조하세요 .

bool QImage::operator==(const QImage &image) const

이 이미지와 주어진 image 의 내용이 같으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

명백한 차이(예: 크기나 형식이 다른 경우)가 없는 한 비교가 느릴 수 있으며, 이 경우 함수는 빠르게 반환합니다.

operator=()도 참조하세요 .