Embroidermodder 开源项目教程

1. 项目介绍

Embroidermodder 是一款免费的开源机器刺绣软件。最新版本 Embroidermodder 2 能够提供以下功能：

• 编辑和创建刺绣设计
• 估算刺绣设计所需的线和机器时间
• 将刺绣文件转换为多种格式
• 放大或缩小设计
• 在 Windows、Mac 和 Linux 上运行

Embroidermodder 使用 C 和 C++ 语言开发，采用了 Qt 框架，支持 OpenGL，为用户提供了一个跨平台的刺绣设计工具。

2. 项目快速启动

以下是 Embroidermodder 的快速启动指南。

环境准备

在开始之前，请确保安装以下依赖项：

• Embroidermodder 2 源代码。
• Qt（版本 >= 6.0）。
• OpenGL（版本 >= 2.0）。

可选依赖项：

• KDE（用于缩略图生成）。
• Valgrind（用于调试）。
• CMake（版本 >= 2.0，如果无法使用 CMake，请参考下文的“无需 CMake 的构建”）。

对于 Ubuntu 用户，可以通过以下命令安装依赖项：

sudo apt-get install git build-essential qt6-dev-tools libqt6-opengl-dev valgrind cmake

对于 Fedora 用户，可以通过以下命令安装依赖项：

sudo yum install git gdb gcc-c++ qt-devel kdelibs-devel valgrind

构建项目

使用脚本构建

在项目文件夹中打开终端，并输入以下命令：

bash build.sh -b

无需 Bash 的构建

1. 克隆仓库：

git clone https://github.com/embroidermodder/embroidermodder.git
cd embroidermodder

2. 创建构建目录并进入：

mkdir build
cd build

3. 使用 CMake 配置项目：

cmake ..

4. 构建项目：

cmake --build .

5. 运行程序：

./embroidermodder2

无需 CMake 的构建

我们正在开发一个适用于没有 CMake 的系统的单行命令。以下是当前未完成的命令：

$(CC) -o embroidermodder2 src/*.c src/*/*.c src/*.h src/*/*.h -lglfw -lGL -lm

3. 应用案例和最佳实践

Embroidermodder 的应用案例包括但不限于：

• 个人刺绣设计创作
• 工业刺绣设计的修改和优化
• 刺绣文件的格式转换和缩放

最佳实践建议：

• 在设计前规划好刺绣的线程颜色和顺序
• 利用 Embroidermodder 的估算功能，预判项目所需时间和材料
• 针对不同的刺绣机进行设计调整以获得最佳效果

4. 典型生态项目

Embroidermodder 作为开源项目，其生态中包括以下典型项目：

• libembroidery：一个用于处理刺绣文件的库，支持多种格式。
• embroidery-patterns：开源刺绣设计集合。
• Embroidermodder 插件：由社区贡献的扩展插件，增强软件的功能。

以上是 Embroidermodder 的开源项目教程，希望对您的使用和开发有所帮助。