QSchematic 项目教程

1. 项目目录结构及介绍

QSchematic 项目的目录结构如下：

QSchematic/
├── CMakeLists.txt
├── LICENSE.txt
├── README.md
├── docs/
│   └── screenshots/
├── github/
│   └── workflows/
├── qschematic/
│   ├── commands/
│   ├── items/
│   ├── netlist/
│   ├── utils/
│   ├── wire_system/
│   ├── scene.hpp
│   ├── settings.hpp
│   ├── types.hpp
│   ├── view.hpp
│   └── ...
└── demo/
    └── ...

目录介绍：

• CMakeLists.txt: 项目的 CMake 构建文件。
• LICENSE.txt: 项目的 MIT 许可证文件。
• README.md: 项目的介绍和使用说明。
• docs/: 包含项目的文档，如截图等。
• github/workflows/: 包含 GitHub Actions 的工作流配置文件。
• qschematic/: 核心代码目录，包含项目的各个模块。
  • commands/: 包含与命令相关的类和函数。
  • items/: 包含项目中的各种图形项（如节点、线等）的实现。
  • netlist/: 包含与网络列表生成相关的类和函数。
  • utils/: 包含项目的各种工具类和函数。
  • wire_system/: 包含与线系统相关的类和函数。
  • scene.hpp: 场景类的定义。
  • settings.hpp: 项目设置类的定义。
  • types.hpp: 项目中使用的各种类型的定义。
  • view.hpp: 视图类的定义。
• demo/: 包含项目的演示应用程序代码。

2. 项目启动文件介绍

QSchematic 项目的启动文件主要是 demo/ 目录下的文件。这些文件用于构建和运行项目的演示应用程序。

主要启动文件：

• demo/main.cpp: 这是演示应用程序的主入口文件，包含了 main() 函数，负责初始化和启动应用程序。

启动流程：

1. 初始化 Qt 应用程序: 在 main.cpp 中，首先初始化 Qt 应用程序对象。
2. 创建主窗口: 创建并显示主窗口，主窗口中包含 QSchematic 的场景和视图。
3. 运行应用程序: 调用 QApplication::exec() 进入事件循环，启动应用程序。

3. 项目的配置文件介绍

QSchematic 项目的配置文件主要是 CMakeLists.txt 和 qschematic/settings.hpp。

CMakeLists.txt

CMakeLists.txt 是项目的构建配置文件，定义了项目的构建目标、依赖项和编译选项。

qschematic/settings.hpp

qschematic/settings.hpp 定义了项目的全局设置类 Settings，用于管理项目的各种配置参数。

配置文件内容：

• CMakeLists.txt:

  • 定义了项目的构建目标，如 qschematic-static 和 qschematic-shared。
  • 指定了项目的依赖项，如 Qt 和 GPDS。
  • 配置了编译选项和编译器要求。

• qschematic/settings.hpp:

  • 定义了 Settings 类，包含项目的各种配置参数，如场景的默认设置、线系统的配置等。
  • 提供了接口用于读取和修改这些配置参数。

通过这些配置文件，开发者可以自定义项目的构建和运行行为，以满足不同的需求。