详解Qt之QImageWriter与QImageReader

---

前言

在图形应用程序开发中，图像的读写是一个非常重要的功能。Qt 提供了 QImageWriter 和 QImageReader 类，分别用于写入和读取图像文件。通过这些类，开发者可以轻松地处理不同格式的图像文件。本文将详细介绍 QImageWriter 和 QImageReader 的概念、作用及其基本用法，并逐一讲解其所有函数，最后通过一个示例代码来巩固所学内容。

---

QImageWriter 与 QImageReader 概念

QImageWriter 是 Qt 提供的一个类，用于将 QImage 对象保存为各种格式的图像文件。QImageReader 则用于从图像文件中读取数据并创建 QImage 对象。它们支持多种常见的图像格式，如 PNG、JPEG、BMP、GIF 等。

作用

QImageWriter 和 QImageReader 的主要作用是简化图像文件的读写操作，使开发者能够方便地处理不同格式的图像文件。具体来说，它们可以：

• 将 QImage 对象保存为指定格式的图像文件
• 从图像文件中读取数据并创建 QImage 对象
• 支持多种常见的图像格式

为什么需要它们

在图形应用程序中，处理图像文件是一个常见的需求。如果开发者需要手动实现图像文件的读写，将面临较大的工作量和复杂性。QImageWriter 和 QImageReader 提供了一个统一的接口，简化了图像文件的读写操作，提高了开发效率。

基本用法

QImageWriter 基本用法

使用 QImageWriter 将 QImage 对象保存为图像文件的主要步骤如下：

1. 创建一个 QImageWriter 对象，并指定输出文件路径或设备。
2. 设置图像格式和其他相关参数。
3. 调用 write 方法将 QImage 对象写入文件。

以下是一个简单的示例：

#include <QImage>
#include <QImageWriter>

int main() {
    QImage image(100, 100, QImage::Format_RGB32);
    image.fill(Qt::white);

    QImageWriter writer("output.png");
    writer.setFormat("png");
    if (!writer.write(image)) {
        qWarning("Failed to write image: %s", qPrintable(writer.errorString()));
    }

    return 0;
}

QImageReader 基本用法

使用 QImageReader 从图像文件中读取数据并创建 QImage 对象的主要步骤如下：

1. 创建一个 QImageReader 对象，并指定输入文件路径或设备。
2. 设置图像格式和其他相关参数。
3. 调用 read 方法读取图像数据并创建 QImage 对象。

以下是一个简单的示例：

#include <QImage>
#include <QImageReader>

int main() {
    QImageReader reader("input.png");
    reader.setFormat("png");
    QImage image;
    if (!reader.read(&image)) {
        qWarning("Failed to read image: %s", qPrintable(reader.errorString()));
    }

    return 0;
}

函数介绍

QImageWriter 函数介绍

QImageWriter::QImageWriter()

作用

构造一个默认的 QImageWriter 对象。

参数

无。

返回值

无。

QImageWriter::QImageWriter(const QString &fileName, const char *format = nullptr)

作用

构造一个 QImageWriter 对象，并指定输出文件路径和图像格式。

参数

• fileName: 输出文件路径。
• format: 图像格式，默认为 nullptr。

返回值

无。

QImageWriter::QImageWriter(QIODevice *device, const char *format = nullptr)

作用

构造一个 QImageWriter 对象，并指定输出设备和图像格式。

参数

• device: 输出设备。
• format: 图像格式，默认为 nullptr。

返回值

无。

bool QImageWriter::write(const QImage &image)

作用

将 QImage 对象写入文件或设备。

参数

• image: 需要写入的 QImage 对象。

返回值

如果成功写入图像，返回 true；否则返回 false。

void QImageWriter::setFormat(const QByteArray &format)

作用

设置图像格式。

参数

• format: 图像格式。

返回值

无。

QString QImageWriter::errorString() const

作用

返回最后一次错误的描述。

参数

无。

返回值

错误描述字符串。

QImageReader 函数介绍

QImageReader::QImageReader()

作用

构造一个默认的 QImageReader 对象。

参数

无。

返回值

无。

QImageReader::QImageReader(const QString &fileName, const char *format = nullptr)

作用

构造一个 QImageReader 对象，并指定输入文件路径和图像格式。

参数

• fileName: 输入文件路径。
• format: 图像格式，默认为 nullptr。

返回值

无。

QImageReader::QImageReader(QIODevice *device, const char *format = nullptr)

作用

构造一个 QImageReader 对象，并指定输入设备和图像格式。

参数

• device: 输入设备。
• format: 图像格式，默认为 nullptr。

返回值

无。

bool QImageReader::read(QImage *image)

作用

从文件或设备中读取图像数据，并创建 QImage 对象。

参数

• image: 指向将创建的 QImage 对象的指针。

返回值

如果成功读取图像，返回 true；否则返回 false。

void QImageReader::setFormat(const QByteArray &format)

作用

设置图像格式。

参数

• format: 图像格式。

返回值

无。

QString QImageReader::errorString() const

作用

返回最后一次错误的描述。

参数

无。

返回值

错误描述字符串。

示例代码

以下是一个完整的示例代码，展示了如何使用 QImageWriter 和 QImageReader 类进行图像的读写操作：

#include <QImage>
#include <QImageWriter>
#include <QImageReader>
#include <QDebug>

int main() {
    // 创建并保存图像
    QImage image(100, 100, QImage::Format_RGB32);
    image.fill(Qt::white);

    QImageWriter writer("output.png");
    writer.setFormat("png");
    if (!writer.write(image)) {
        qWarning("Failed to write image: %s", qPrintable(writer.errorString()));
    } else {
        qDebug() << "Image written successfully.";
    }

    // 读取图像
    QImageReader reader("output.png");
    reader.setFormat("png");
    QImage readImage;
    if (!reader.read(&readImage)) {
        qWarning("Failed to read image: %s", qPrintable(reader.errorString()));
    } else {
        qDebug() << "Image read successfully.";
    }

    return 0;
}

---

总结

QImageWriter 和 QImageReader 是两个非常有用的工具，可以帮助开发者轻松实现图像文件的读写操作。通过 QImageWriter，可以将 QImage 对象保存为多种格式的图像文件；通过 QImageReader，可以从图像文件中读取数据并创建 QImage 对象。本文详细介绍了 QImageWriter 和 QImageReader 的概念、作用及其基本用法，并逐一讲解了所有函数，希望能为您的开发工作提供帮助。