### 使用 QImage 编写代码示例 #### 创建和初始化 QImage 对象 为了使用 `QImage` 进行图像处理，首先需要导入 PyQt5 库中的相关模块，并创建一个 `QImage` 实例。 ```python from PyQt5.QtGui import QImage, QColor # 创建一个新的空白图像，宽度为 100 像素，高度为 100 像素，颜色深度为 32 bpp (bits per pixel) image = QImage(100, 100, QImage.Format_RGB32) # 设置背景色为白色 color_white = QColor(255, 255, 255) for y in range(image.height()): for x in range(image.width()): image.setPixelColor(x, y, color_white) ``` #### 加载现有图片文件到 QImage 中 如果要加载现有的图片文件至 `QImage`，可以通过指定路径完成此操作： ```python path_to_image = "example.png" loaded_image = QImage(path_to_image) if loaded_image.isNull(): print("Failed to load the image.") else: print(f"Loaded {path_to_image} successfully with size: {loaded_image.size()}") ``` #### 绘制图形元素到 QImage 上 由于 `QImage` 是 `QPaintDevice` 的子类[^2]，因此可以直接在其上使用 `QPainter` 来绘制各种形状和其他视觉效果。 ```python from PyQt5.QtWidgets import QApplication, QLabel from PyQt5.QtGui import QPainter, QPixmap app = QApplication([]) label = QLabel() pixmap = QPixmap.fromImage(image) label.setPixmap(pixmap) painter = QPainter(&image) # 注意这里的语法适用于 C++ 版本，在 Python 中应调整为如下形式 with QPainter(image) as painter: pen_color = QColor('red') brush_color = QColor('blue') painter.setPen(pen_color) painter.setBrush(brush_color) # 在图像中心位置画圆圈 center_x = int(image.width()/2) center_y = int(image.height()/2) radius = min(center_x, center_y)-10 painter.drawEllipse(center_x-radius//2, center_y-radius//2, radius, radius) label.show() app.exec_() ``` 请注意上述例子中关于 `QPainter` 构造函数的部分；对于 Python 用户来说，应该采用上下文管理器的方式(`with`)来确保资源被正确释放。 #### 将 QImage 保存成不同格式的文件 最后一步通常是将修改后的 `QImage` 存储回磁盘上的某个文件。支持多种常见的图像格式如 PNG、JPG 等。 ```python save_path = 'output.bmp' success = image.save(save_path, format='BMP') if success: print(f'Successfully saved modified image at "{save_path}".') else: print('Saving failed.') ```