一、描述

QImage 類提供了一種獨立于硬件的圖像表示，允許直接訪問像素數據，并且可以用作繪圖設備。

QImage 是為 I/O 和直接像素訪問和操作而設計和優化的，

因為 QImage 是 QPaintDevice 的子類，所以 QPainter 可用于直接在圖像上繪圖。在 QImage 上使用 QPainter 時，可以在當前 GUI 線程之外的另一個線程中執行繪畫。

QImage 對象可以通過值傳遞，因為 QImage 類使用隱式數據共享。QImage 對象也可以流式傳輸和比較。

1.1、像素操作

用于處理圖像像素的函數取決于圖像格式。原因是單色和 8 位圖像基于索引并使用顏色查找表，而 32 位圖像直接存儲 ARGB 值。

對于 32 位圖像，setPixel() 函數可用于將給定坐標處的像素顏色更改為指定為 ARGB 四元組的任何其他顏色。要生成合適的 QRgb 值，使用 qRgb()（將默認 alpha 分量添加到給定的 RGB 值，即創建不透明顏色）或 qRgba() 函數。例如：

對于 8 位和單色圖像，像素值只是圖像顏色表中的索引。因此 setPixel() 函數只能用于將給定坐標處的像素顏色更改為圖像顏色表中預定義的顏色，即它只能更改像素的索引值。要更改或添加顏色到圖像的顏色表，使用 setColor() 函數。

顏色表中的條目是編碼為 QRgb 值的 ARGB 四元組。使用 qRgb() 和 qRgba() 函數來生成合適的 QRgb 值以與 setColor() 函數一起使用。例如：

1.2、QRgb

#AARRGGBB 格式的 ARGB 四元組，等效于無符號整數。

該類型還保存 alpha 通道的值。默認的 alpha 通道是 ff，即不透明。?

創建 QRgb 值的一些示例：

const QRgb rgb1 = 0x88112233; const QRgb rgb2 = QColor("red").rgb(); const QRgb rgb3 = qRgb(qRed(rgb1), qGreen(rgb2), qBlue(rgb2)); const QRgb rgb4 = qRgba(qRed(rgb1), qGreen(rgb2), qBlue(rgb2), qAlpha(rgb1));

使用 qAlpha()、qRed()、qGreen() 和 qBlue() 函數獲取顏色值分量。

1.3、圖像格式

存儲在 QImage 中的每個像素都由一個整數表示。整數的大小因格式而異。QImage 支持由 Format 枚舉描述的幾種圖像格式。

• 單色圖像：使用 1 位索引存儲到最多具有兩種顏色的顏色表中。有兩種不同類型的單色圖像：大端（MSB 優先）或小端（LSB 優先）位順序。
• 8 位圖像：使用 8 位索引存儲到顏色表中，即它們每個像素有一個字節。顏色表是一個 QList<QRgb>。
• 32 位圖像：沒有顏色表，每個像素都包含一個 QRgb 值。

二、類型成員

1、enum QImage::Format：在 Qt 中可用的圖像格式。略。

注意：

• 不支持?Format_Indexed8 格式的繪制。
• 使用 QPainter 繪制的最佳格式為 Format_RGB32 和 Format_ARGB32_Premultiplied 格式，其次是 Format_RGB16、Format_RGBX8888、Format_RGBA8888_Premultiplied、Format_RGBX64 和 Format_RGBA64_Premultiplied 格式。其他格式不建議使用?QPainter 繪制（繪制效果不佳）。

2、enum QImage::InvertMode：此枚舉用于描述如何在 invertPixels() 函數中反轉像素值。

• InvertRgb：僅反轉 RGB 值并保持 Alpha 通道不變。
• InvertRgba：反轉所有通道，包括 alpha 通道。

三、部分成員函數

1、QImage rgbSwapped()

返回一個 QImage，其中所有像素的紅色和藍色分量的值已被交換，有效地將 RGB 圖像轉換為 BGR 圖像。原始的 QImage 沒有改變。

??????void rgbSwap()

交換所有像素的紅色和藍色分量的值，將 RGB 圖像轉換為 BGR 圖像。?

#include <QApplication> #include <QLabel> #include <QHBoxLayout>int main(int argc, char *argv[]) {QApplication a(argc, argv);QWidget w;QImage img("D:/6.png");QLabel src;src.setPixmap(QPixmap::fromImage(img));QLabel dst;dst.setPixmap(QPixmap::fromImage(img.rgbSwapped()));QHBoxLayout hb(&w);hb.addWidget(&src);hb.addWidget(&dst);w.show();return a.exec(); }

2、QImage mirrored(bool horizontal = false, bool vertical = true)

返回圖像的鏡像，在水平和/或垂直方向上鏡像。原始圖像不會更改。

??????void mirror(bool horizontal = false, bool vertical = true)

圖像在水平和/或垂直方向上鏡像。?

dst.setPixmap(QPixmap::fromImage(img.mirrored(0,1)));

dst.setPixmap(QPixmap::fromImage(img.mirrored(1,0)));

dst.setPixmap(QPixmap::fromImage(img.mirrored(1,1)));

3、QImage convertedTo(QImage::Format format, Qt::ImageConversionFlags flags = Qt::AutoColor)

?????QImage convertToFormat(QImage::Format format, Qt::ImageConversionFlags flags = Qt::AutoColor)

格式轉換，返回轉換后的圖像副本。參數2控制在轉換過程中如何處理圖像數據。

4、QImage(const QString &fileName, const char *format = nullptr)

構造一個圖像并嘗試從具有給定文件名的文件中加載圖像。

嘗試使用指定格式讀取圖像。如果未指定格式，則會根據文件的后綴和標題自動檢測。

如果圖像加載失敗，則此對象為空圖像。

5、QImage(const char *const [] xpm)

從給定的 xpm 圖像構造圖像?？蓞⒖?。

6、bool allGray() const

圖像中的所有顏色是否都是灰色（即它們的R、G、B分量相等）。

對于沒有顏色表的圖像，此功能很慢。

7、uchar * bits()

返回指向第一個像素數據的指針。

8、QImage copy(const QRect &rectangle = QRect())

將圖像的子區域作為新圖像返回。（深拷貝）

返回的圖像是從該圖像中的位置 (rectangle.x(), rectangle.y()) 復制的，并且始終具有給定矩形的大小。

在此圖像之外的區域，像素設置為 0：

• 對于 32 位 RGB 圖像，這意味著黑色
• 對于 32 位 ARGB 圖像，這意味著透明黑色
• 對于 8 位圖像，這意味著顏色表中索引為 0 的顏色可以是任何顏色
• 對于 1 位圖像，這意味著 Qt::color0。

如果參數的矩形是空矩形，則復制整個圖像。

9、int depth()

圖像的深度。圖像深度是用于存儲單個像素的位數，也稱為每像素位數 (bpp)。

支持的深度為 1、8、16、24、32 和 64。

10、void fill(const QColor &color)

用給定的顏色填充整個圖像。?

11、【static】QImage fromData(const QByteArray &data, const char *format = nullptr)

從給定的 QByteArray 數據構造圖像。將嘗試使用指定格式讀取圖像。如果未指定格式，則會探測數據以查找標頭以猜測文件格式。

如果指定了格式，它必須是 QImageReader::supportedImageFormats() 返回的值之一。

如果圖片加載失敗，則返回的圖片為空圖片。

12、bool hasAlphaChannel()

圖像是否具有 alpha 通道的格式。

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

反轉圖像中的所有像素值。

給定的反轉模式僅在圖像深度為 32 時才有意義。

反轉 8 位圖像意味著將使用顏色索引 i 的所有像素替換為使用顏色索引 255 減去 i 的像素。 1 位圖像的情況也是如此。

#include <QApplication> #include <QLabel> #include <QHBoxLayout> #include <QColorTransform>int main(int argc, char *argv[]) {QApplication a(argc, argv);QWidget w;QImage img("D:/6.png");QLabel src;src.setPixmap(QPixmap::fromImage(img));QLabel dst;img.invertPixels();dst.setPixmap(QPixmap::fromImage(img));QHBoxLayout hb(&w);hb.addWidget(&src);hb.addWidget(&dst);w.show();return a.exec(); }

14、bool load(const QString &fileName, const char *format = nullptr)

從具有給定文件名的文件中加載圖像。返回是否加載成功。

加載器嘗試使用指定的格式讀取圖像，例如 PNG 或 JPG。 如果未指定格式，則會根據文件的后綴和標題自動檢測。

??????bool load(QIODevice *device, const char *format)

此函數從給定設備讀取 QImage。 例如，這可以用于將圖像直接加載到 QByteArray 中。

15、bool loadFromData(const QByteArray &data, const char *format = nullptr)

從給定的數據加載圖像。返回是否加載成功。

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

使用給定的圖像文件格式和質量因子將圖像保存到具有給定文件名的文件中。如果 format 為 nullptr，QImage 將嘗試通過查看 fileName 的后綴來猜測格式。

質量因子必須在 0 到 100 或 -1 的范圍內。指定 0 獲取小壓縮文件，指定 100 獲取大未壓縮文件，指定 -1（默認值）使用默認設置。

返回圖像是否保存成功。

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

此函數將 QImage 寫入給定設備。

例如，這可以用于將圖像直接保存到 QByteArray 中：

QImage image; QByteArray ba; QBuffer buffer(&ba); buffer.open(QIODevice::WriteOnly); image.save(&buffer, "PNG");

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

返回縮放為 size 的圖像副本。

enum Qt::AspectRatioMode：此枚舉類型定義了縮放矩形時長寬比發生的變化。

• Qt::IgnoreAspectRatio：自由縮放，不保留縱橫比。
• Qt::KeepAspectRatio：縮放到給定矩形內盡可能大的矩形，保持縱橫比。
• Qt::KeepAspectRatioByExpanding：縮放到給定矩形外盡可能小的矩形，保持縱橫比。

?

enum Qt::TransformationMode：此枚舉類型定義圖像轉換是否應該平滑。

• Qt::FastTransformation：轉換快速執行，沒有平滑。
• Qt::SmoothTransformation：使用雙線性過濾轉換生成的圖像。

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

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

返回的圖像使用指定的轉換模式縮放到給定的高度 / 寬度。

會自動計算圖像的寬度 / 高度，以便保留圖像的比例。

19、uchar * 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));} }

?20、void ?setAlphaChannel (const QImage & alphaChannel )

將此圖像的 alpha 通道設置為給定的alphaChannel。

如果alphaChannel是 8 位 alpha 圖像，則直接使用 alpha 值。否則，將 alphaChannel轉換為 8 位灰度圖像。

如果圖像已有 Alpha 通道，則現有的 Alpha 通道將與新通道相乘。如果圖像沒有 alpha 通道，它將被轉換為有的格式。

該操作類似于使用?QPainter::CompositionMode_DestinationIn。

21、qsizetype sizeInBytes()

返回圖像數據大小（以字節為單位）。

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

返回使用給定變換矩陣和變換模式變換的圖像的副本。

23、QTransform trueMatrix(const QTransform &matrix, int width, int height)

返回用于轉換具有給定寬度、高度和矩陣的圖像的實際矩陣。

24、bool valid(const QPoint &pos)

pos 是否圖像中的有效坐標。

25、QVariant operator QVariant()

將圖像作為 QVariant 返回。

26、bool operator==(const QImage &image)

比較圖像是否具有相同的內容。

比較可能會很慢，除非有一些明顯的差異（例如不同的大小或格式）。

總結

以上是生活随笔為你收集整理的QImage的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。