PEmbroider库使用教程

PEmbroider库使用教程

PEmbroider Embroidery Library for Processing 项目地址: https://gitcode.com/gh_mirrors/pe/PEmbroider

项目介绍

PEmbroider 是一个专为计算刺绣设计而生的开源库，它以 Processing 创意编码环境的Java版本为目标。该库由Golan Levin, Lingdong Huang 和 Tatyana Mustakos在CMU的Frank-Ratchye STUDIO for Creative Inquiry于2020年Endless March期间开发，并得到了匿名捐助者及University of Denver的Clinic for Open Source Arts (COSA)的支持。PEmbroider旨在通过创意编码的方式，简化复杂的刺绣设计过程，让艺术家、手工艺人、教育工作者等群体能够利用Processing的强大功能进行生成性和计算性设计。

PEmbroider支持生成DST、EXP、JEF等多种工业级绣花机所需的文件格式，并且还能导出PDF、SVG、TSV和GCODE等，适用于CNC路由器、AxiDraw绘图仪等设备。此库的特点还包括优化路径生成，减少刺绣时间和材料浪费，并具备从SVG和黑白位图文件生成刺绣设计的能力。

项目快速启动

环境要求

确保您的系统上安装了 Processing 4.0a6 或更高版本。对于仍在使用Processing 3的用户，请使用特定的链接下载兼容版本。

安装步骤

1. 自动安装: 在Processing IDE中，依次点击 Sketch -> Import Library -> Add External Library, 在贡献管理器中查找并安装PEmbroider。

2. 手动安装:

   • 下载PEmbroider的ZIP文件，解压后将整个PEmbroider目录复制到您Processing的“libraries”目录下。
   • 重启Processing IDE。

示例运行

• 下载预编译的库或正确配置后，在Processing中打开PEmbroider目录下的示例程序。例如，简单的启动流程包括引入PEmbroider库，并调用其基本函数来生成刺绣文件：

import pe.api.*;

void setup() {
  size(400, 400);
  PEmbroidery.beginDrawing(this);
  // 绘制示例图形
  fill(255);
  ellipse(width/2, height/2, 150, 150);
  PEmbroidery.endDraw(); // 结束绘制并准备导出
  PEmbroidery.optimize(); // 优化针迹路径
  // 指定输出文件格式和路径，例如 DST 格式
  PEmbroidery.save("example.dst");
}

注意：optimize()可能需要一些时间执行，务必在保存文件之前调用。

应用案例与最佳实践

PEmbroider被广泛应用于艺术创作、个性化定制商品以及教育项目中。通过结合Processing的视觉编程能力，使用者可以创造出独一无二的图案和文字刺绣效果。例如，通过调整线条宽度、填充模式和颜色变化，开发者可以实现传统与现代相结合的刺绣风格，非常适合个性化礼品制作和小型艺术展览。

示例代码片段（动态图案）

void draw() {
  background(0);
  float density = map(mouseX, 0, width, 5, 50); // 鼠标位置控制密度
  PEmbroidery.hatchFill(0, 0, width, height, density, 90); // 使用hatchFill生成填充效果
  PEmbroidery.optimize();
  if(keyPressed && key == 's') { // 按'S'键保存当前设计
    PEmbroidery.save("dynamic_design.dst");
  }
}

典型生态项目

由于PEmbroider设计初衷是集成进Processing生态系统，它自然地融入了许多创意和艺术项目中。用户可以通过Processing社区的作品分享平台发现更多基于PEmbroider的创新应用。这些应用不仅限于传统意义上的刺绣，还涵盖了互动装置艺术、数据可视化中的物理化表示等领域。开发者和艺术家们通过PEmbroider与其他 Processing 库的协同工作，创造了跨领域的作品，展示了技术与艺术结合的可能性。

为了探索更多的生态项目，建议访问Processing官网的论坛和GitHub上的项目仓库，那里有大量基于PEmbroider或其他相似理念库的项目实例，供学习和灵感启发。

---

本教程提供了一个基础框架，帮助快速入门PEmbroider库。深入挖掘这个库，你会发现更多的可能性和创造力的空间等待着每一个热爱创意编码的你。

PEmbroider Embroidery Library for Processing 项目地址: https://gitcode.com/gh_mirrors/pe/PEmbroider