QSchematic 项目使用教程

1. 项目介绍

QSchematic 是一个用于在 Qt 应用程序中绘制图表和原理图的 C++ 库。它基于 Qt 的图形视图框架，提供了用于创建节点、连线和连接器等对象的基础类。QSchematic 支持添加、删除、移动和调整节点大小，连接节点，以及撤销/重做操作。此外，它还提供了网络列表生成器和内存模板生成器，支持将图表序列化为 XML 或 YAML 格式。

2. 项目快速启动

2.1 环境准备

确保你已经安装了以下依赖：

• C++20 编译器
• Qt5 (>= 5.15) 或 Qt6
• GPDS (用于序列化)

2.2 下载与构建

首先，克隆 QSchematic 仓库：

git clone https://github.com/simulton/QSchematic.git
cd QSchematic

然后，使用 CMake 进行构建：

cmake -B build
cmake --build build

2.3 集成到项目中

使用 CMake 集成

在你的 CMake 项目中，可以使用 FetchContent 来集成 QSchematic：

include(FetchContent)

FetchContent_Declare(
    qschematic
    GIT_REPOSITORY https://github.com/simulton/QSchematic
    GIT_TAG master
)

FetchContent_MakeAvailable(qschematic)

target_link_libraries(your_app PRIVATE qschematic-static)

使用 find_package 集成

如果你已经构建并安装了 QSchematic，可以使用 find_package 来集成：

find_package(QSchematic REQUIRED)

add_executable(your_application "")
target_link_libraries(your_application qschematic::qschematic-static)

3. 应用案例和最佳实践

3.1 创建自定义节点

QSchematic 允许你通过继承 Item 类来创建自定义节点。以下是一个简单的示例：

#include <qschematic/items/node.h>

class CustomNode : public QSchematic::Node
{
public:
    CustomNode(QPointF position = QPointF(), QGraphicsItem* parent = nullptr)
        : QSchematic::Node(position, parent)
    {
        // 初始化自定义节点
    }

    void paint(QPainter* painter, const QStyleOptionGraphicsItem* option, QWidget* widget) override
    {
        // 自定义绘制逻辑
        painter->setBrush(Qt::blue);
        painter->drawEllipse(-10, -10, 20, 20);
    }
};

3.2 连接节点

你可以使用 Wire 类来连接两个节点：

QSchematic::Wire* wire = new QSchematic::Wire(node1, node2);
scene->addItem(wire);

4. 典型生态项目

QSchematic 可以与其他基于 Qt 的项目集成，例如：

• Qt Creator: 用于开发 Qt 应用程序的集成开发环境。
• GPDS: 一个通用的数据序列化库，用于与 QSchematic 一起进行数据序列化和反序列化。

通过这些集成，你可以构建复杂的工程图表和原理图应用程序。