课程代码仓库初始化：Part1 (144) + Part3 (29) 全量生成与验证

把川大 wiki「02.Qt方向」课程代码整理为 CMake 管理的可编译运行项目。 Part1 C/C++ 强化 (p01/, 144 目标, host gcc/g++ 构建, 全绿): - 修复全部编译失败：补 <cstring>/<fstream>/<iomanip>/<vector> 等缺失头 (common_fix + infer_stl_includes 自动检测注入)、修正 pause() 壳注入 (改检测已转换后的 pause 调用)、namespace 提升出函数体、const 成员函数正确性、dedupe 不再破坏函数重载集、K&R 隐式 int / 动态异常规范等 C++17 移除特性的可编译等价改写。 - 目录采用深缩写 p01/ch04/s03/ (原 part1_cpp/ch04_class_object/03_ctor_dtor)。 Part3 Qt 桌面 (p03/, 29 目标, 隔离 Qt 5.14.2 构建, 全绿): - gen_part3.py: Qt 外壳模板 (main+QApplication+show, QTimer 自动退出便于 offscreen 验证)、AUTOMOC + .moc include、rewrite_* 处理散文混入/重载/ 资源依赖、生成占位 png/gif + .qrc + rundata 样例数据。 - 修正 QLable 笔误、全角分号、.→->、Windows 路径、QApplication 阻塞事件循环改为 QCoreApplication 等。任务1 概念/版本验证: - tools/std_probe.py: 跨 -std= 编译探针 (--pedantic-errors 让已废除特性硬失败)。 - tools/demo_versions/: K&R 隐式 int、三目左值、void* 转换、enum 赋整、 const 经指针、动态异常规范共 6 个跨版本演示。 - docs/VERSION_NOTES.md: 每条「原文说法→C17/C++17 是否成立→何版本成立→已验证」。文档: 顶层 README、docs/SOURCE_PAGES.md (页面→目录映射)、 docs/ERRATA.md (Part1 修正)、docs/ERRATA_part3.md (Part3 修正)。另修复 tools/run.sh / run_qt.sh 的 ${1:?...} 引号语法 bug。隔离 Qt 验证: ldd 0 系统 Qt 引用; 173/173 目标全绿; p03 offscreen 运行通过。
2026-06-30 14:16:55 +08:00
commit 13b3ebbe14
287 changed files with 16532 additions and 0 deletions
@@ -0,0 +1,22 @@
+# Auto-generated by tools/gen_part3.py — do not edit by hand.
+# 章节：p03/ch10
+set(CMAKE_AUTOMOC ON)
+set(CMAKE_AUTORCC ON)
+add_executable(qpainter_basic qpainter_basic.cpp)
+set_target_properties(qpainter_basic PROPERTIES CXX_STANDARD 17 CXX_STANDARD_REQUIRED ON CXX_EXTENSIONS OFF AUTOMOC ON)
+target_link_libraries(qpainter_basic PRIVATE Qt5::Core Qt5::Gui Qt5::Widgets)
+target_compile_options(qpainter_basic PRIVATE -Wall -Wextra)
+qt5_add_resources(RES paint_device_pixmaps.qrc)
+add_executable(paint_device_pixmaps paint_device_pixmaps.cpp ${RES})
+set_target_properties(paint_device_pixmaps PROPERTIES CXX_STANDARD 17 CXX_STANDARD_REQUIRED ON CXX_EXTENSIONS OFF AUTOMOC ON)
+target_link_libraries(paint_device_pixmaps PRIVATE Qt5::Core Qt5::Gui Qt5::Widgets)
+target_compile_options(paint_device_pixmaps PRIVATE -Wall -Wextra)
+add_executable(paint_device_qimage paint_device_qimage.cpp)
+set_target_properties(paint_device_qimage PROPERTIES CXX_STANDARD 17 CXX_STANDARD_REQUIRED ON CXX_EXTENSIONS OFF AUTOMOC ON)
+target_link_libraries(paint_device_qimage PRIVATE Qt5::Core Qt5::Gui Qt5::Widgets)
+target_compile_options(paint_device_qimage PRIVATE -Wall -Wextra)
+add_executable(qpicture_io qpicture_io.cpp)
+set_target_properties(qpicture_io PROPERTIES CXX_STANDARD 17 CXX_STANDARD_REQUIRED ON CXX_EXTENSIONS OFF AUTOMOC ON)
+target_link_libraries(qpicture_io PRIVATE Qt5::Core Qt5::Gui Qt5::Widgets)
+target_compile_options(qpicture_io PRIVATE -Wall -Wextra)
+add_custom_target(all_p03_ch10 DEPENDS qpainter_basic paint_device_pixmaps paint_device_qimage qpicture_io)
@@ -0,0 +1,34 @@
+# p03/ch10 — Qt 示例
+
+## 可运行示例
+
+| 目标 | 源文件 | 说明 |
+|---|---|---|
+| `qpainter_basic` | `qpainter_basic.cpp` | 构建运行见顶层 README；离屏验证 `QT_QPA_PLATFORM=offscreen tools/run_qt.sh qpainter_basic` |
+| `paint_device_pixmaps` | `paint_device_pixmaps.cpp` | 构建运行见顶层 README；离屏验证 `QT_QPA_PLATFORM=offscreen tools/run_qt.sh paint_device_pixmaps` |
+| `paint_device_qimage` | `paint_device_qimage.cpp` | 构建运行见顶层 README；离屏验证 `QT_QPA_PLATFORM=offscreen tools/run_qt.sh paint_device_qimage` |
+| `qpicture_io` | `qpicture_io.cpp` | 构建运行见顶层 README；离屏验证 `QT_QPA_PLATFORM=offscreen tools/run_qt.sh qpicture_io` |
+
+## 参考片段（签名/伪代码，未单独建目标）
+
+### [block 1] .1 QPainter
+
+```cpp
+PaintedWidget::PaintedWidget(QWidget *parent) :
+QWidget(parent)
+{
+resize(800, 600);
+setWindowTitle(tr("Paint Demo"));
+}
+void PaintedWidget::paintEvent(QPaintEvent *)
+{
+QPainter painter(this);
+painter.drawLine(80, 100, 650, 500);
+painter.setPen(Qt::red);
+painter.drawRect(10, 10, 100, 400);
+painter.setPen(QPen(Qt::green, 5));
+painter.setBrush(Qt::blue);
+painter.drawEllipse(50, 150, 400, 200);
+}
+```
+
@@ -0,0 +1,44 @@
+// ============================================================================
+//  paint_device_pixmaps  —  Qt 桌面示例
+//  来源：川大 C++/LinuxC wiki「02.Qt方向」
+//  原文片段：[58954548:2]
+//  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
+//        外壳、include、修正笔误）。详见 docs/ERRATA.md。
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+// ============================================================================
+
+#include <QApplication>
+#include <QWidget>
+#include <QPainter>
+#include <QPaintEvent>
+#include <QPixmap>
+#include <QBitmap>
+#include <QTimer>
+
+class PaintWidget : public QWidget {
+    Q_OBJECT
+public:
+    PaintWidget(QWidget* parent = nullptr) : QWidget(parent) { setFixedSize(360, 200); }
+protected:
+    void paintEvent(QPaintEvent*) override {
+        QPainter painter(this);
+        QPixmap pix(":/Image/butterfly.png");   // 从资源加载图片
+        painter.drawPixmap(10, 10, pix);
+        QPixmap pix1(":/Image/butterfly1.png");
+        painter.drawPixmap(180, 10, pix1);
+        // QBitmap 是 QPixmap 子类，仅 1 位深度（黑白掩码）
+        QBitmap bmp = pix.mask();
+        painter.drawPixmap(10, 110, bmp);
+    }
+};
+
+int main(int argc, char* argv[]) {
+    QApplication app(argc, argv);
+    PaintWidget w;
+    w.show();
+    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
+    QTimer::singleShot(200, &app, &QApplication::quit);
+    return app.exec();
+}
+
+#include "paint_device_pixmaps.moc"
@@ -0,0 +1,6 @@
+<RCC>
+    <qresource>
+        <file alias="/Image/butterfly.png">assets/image_butterfly.png</file>
+        <file alias="/Image/butterfly1.png">assets/image_butterfly1.png</file>
+    </qresource>
+</RCC>
@@ -0,0 +1,44 @@
+// ============================================================================
+//  paint_device_qimage  —  Qt 桌面示例
+//  来源：川大 C++/LinuxC wiki「02.Qt方向」
+//  原文片段：[58954548:3]
+//  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
+//        外壳、include、修正笔误）。详见 docs/ERRATA.md。
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+// ============================================================================
+
+#include <QApplication>
+#include <QWidget>
+#include <QPainter>
+#include <QPaintEvent>
+#include <QImage>
+#include <QTimer>
+
+class PaintWidget : public QWidget {
+    Q_OBJECT
+public:
+    PaintWidget(QWidget* parent = nullptr) : QWidget(parent) { setFixedSize(200, 200); }
+protected:
+    void paintEvent(QPaintEvent*) override {
+        QPainter painter(this);
+        QImage image(100, 100, QImage::Format_RGB32);
+        // QImage 可直接逐像素操作（QPixmap 不行）
+        for (int y = 0; y < image.height(); ++y) {
+            for (int x = 0; x < image.width(); ++x) {
+                image.setPixel(x, y, qRgb((x * 2) % 256, (y * 2) % 256, 128));
+            }
+        }
+        painter.drawImage(10, 10, image);
+    }
+};
+
+int main(int argc, char* argv[]) {
+    QApplication app(argc, argv);
+    PaintWidget w;
+    w.show();
+    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
+    QTimer::singleShot(200, &app, &QApplication::quit);
+    return app.exec();
+}
+
+#include "paint_device_qimage.moc"
@@ -0,0 +1,40 @@
+// ============================================================================
+//  qpainter_basic  —  Qt 桌面示例
+//  来源：川大 C++/LinuxC wiki「02.Qt方向」
+//  原文片段：[58954548:0]
+//  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
+//        外壳、include、修正笔误）。详见 docs/ERRATA.md。
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+// ============================================================================
+
+#include <QApplication>
+#include <QWidget>
+#include <QPainter>
+#include <QPaintEvent>
+#include <QTimer>
+
+class PaintedWidget : public QWidget {
+    Q_OBJECT
+public:
+    PaintedWidget(QWidget* parent = nullptr) : QWidget(parent) {
+        setFixedSize(300, 200);
+    }
+protected:
+    void paintEvent(QPaintEvent*) override {
+        QPainter painter(this);
+        painter.drawLine(QLine(10, 10, 200, 10));     // 画线
+        painter.drawRect(QRect(10, 30, 100, 50));     // 画矩形
+        painter.drawEllipse(QRect(150, 30, 100, 80)); // 画椭圆
+    }
+};
+
+int main(int argc, char* argv[]) {
+    QApplication app(argc, argv);
+    PaintedWidget w;
+    w.show();
+    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
+    QTimer::singleShot(200, &app, &QApplication::quit);
+    return app.exec();
+}
+
+#include "qpainter_basic.moc"
@@ -0,0 +1,49 @@
+// ============================================================================
+//  qpicture_io  —  Qt 桌面示例
+//  来源：川大 C++/LinuxC wiki「02.Qt方向」
+//  原文片段：[58954548:4]
+//  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
+//        外壳、include、修正笔误）。详见 docs/ERRATA.md。
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+// ============================================================================
+
+#include <QApplication>
+#include <QWidget>
+#include <QPainter>
+#include <QPaintEvent>
+#include <QPicture>
+#include <QDebug>
+#include <QTimer>
+
+class PaintWidget : public QWidget {
+    Q_OBJECT
+public:
+    PaintWidget(QWidget* parent = nullptr) : QWidget(parent) { setFixedSize(200, 200); }
+protected:
+    void paintEvent(QPaintEvent*) override {
+        // QPicture 记录并回放绘图指令
+        QPicture picture;
+        QPainter painter;
+        painter.begin(&picture);            // 把绘图记录到 picture
+        painter.drawLine(10, 10, 100, 100);
+        painter.end();
+        picture.save("drawing.pic");       // 保存（用相对路径，跨平台）
+
+        QPicture picture2;
+        picture2.load("drawing.pic");      // 回放
+        QPainter p2(this);
+        p2.drawPicture(10, 10, picture2);
+        qDebug() << "QPicture saved & replayed";
+    }
+};
+
+int main(int argc, char* argv[]) {
+    QApplication app(argc, argv);
+    PaintWidget w;
+    w.show();
+    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
+    QTimer::singleShot(200, &app, &QApplication::quit);
+    return app.exec();
+}
+
+#include "qpicture_io.moc"