自动化脚本

自动化脚本是一段 JavaScript，它可以在不打开应用窗口的情况下打开、修改和保存图纸：例如，为每个订单生成图纸的订单或数据库系统、将一个文件夹的图纸转换为 DXF 文件的批处理作业，或者每晚向切割台导出文件。它使用与扩展相同的绘图 API，并增加了打开和保存图纸、运行库中的参数化设计、导出图纸以及读写文件的函数。

// orders.js: a box for each order, as a PDF for the customer and a DXF for the sample table
const box = runDesign("Packaging › FEFCO 0201 Regular slotted container", { L: 400, W: 300, D: 250 });
box.setNote("order", args[0]);
box.export("pdf", "out/" + args[0] + ".pdf");
box.export("dxf", "out/" + args[0] + ".dxf");
box.save("out/" + args[0] + ".piq");
log(args[0], "blank", box.info().totals.width, "×", box.info().totals.height);

运行脚本

从命令行运行，使用应用的程序和 run 一词：

PiQ run orders.js A-1017
PiQ run --folder D:\Orders --timeout 120 orders.js A-1017

选项放在脚本之前；脚本之后的每个词都作为 args 传给脚本（args[0] 为 "A-1017"）。脚本记录的内容写入输出，失败原因写入错误输出。运行到结束时退出代码为 0，失败时为 1，命令行有误时为 2——这样运行它的系统就能判断结果。不会打开任何窗口。

从应用中运行：文件 › 扩展 › 运行脚本… 会询问脚本及其参数（以空格分隔，含空格的参数用双引号括起来），并在后台运行。脚本可以使用其所在文件夹及其子文件夹中的文件。它记录的内容显示在当前打开图纸的交互窗口中，结束时会说明运行情况。show(drawing) 会在应用中打开它生成的图纸，以便查看或继续处理。请将脚本放在您存放其所处理文件的位置；应用在其 Extensions\Automation 文件夹中自带一个示例。

与在应用中一样，保存和导出需要可用的许可证：没有许可证时，脚本可以打开和读取图纸，而 save 和 export 会失败并说明原因。

图纸

选择项的值是选项的名称（"B flute"）或其在列表中的位置（从 0 开始）。文件中没有的变量会被拒绝。

当前图纸

绘图 API——vars.L、newPoint、line、circle、command("…")、drawingInfo()、setNote、classify……——作用于当前图纸：最后打开或生成的图纸，或 use(drawing) 所选的图纸。修改的方式与交互窗口相同，因此所绘制的内容是参数化的。

const panel = newDrawing({ units: "in", industry: "SignMaking", name: "Panel" });
setVariable("W", 48);
setVariable("H", 24);
const a = newPoint("[0,0]");
const b = newPoint("[W,0]");
const c = newPoint("[W,H]");
const d = newPoint("[0,H]");
polyline([a, b, c, d], true);
panel.save("panel.piq");

图纸的函数

openDrawing、newDrawing 和 runDesign 返回一张图纸，它具有以下函数：

导出

format 是导出格式的名称，不区分大小写——pdf、svg、eps、ai、png、jpeg、webp、dxf、gcode、hpgl、cf2、ddes、lightburn、laserSvg、aamaDxf、tiledPdf、projectorPdf、wrapTemplatePdf、printCutPdf、printCutEps、gpgl、cuttingSvg、matCutterDxf、matCutterHpgl、dielinePdf、dstv、ifc、bendDxf、step、piq（exportFormats() 会列出它们）——或者文件扩展名（jpg、plt、nc、dd3、lbrn2、nc1、stp）；null 表示使用路径的扩展名。参见文件格式。如果 path 是文件夹（已存在，或以 / 结尾），则文件以图纸名称保存在其中。每种格式都以其常用设置写出；options 可以给出：

文件

脚本只能在其文件夹（--folder，或在应用中为脚本所在的文件夹）中读写文件；不完整的路径从第一个文件夹读取。其他任何访问都会被拒绝。

在文件夹中写入文件时会创建该文件夹。再次写入的文件会被替换。

错误

出错的情况——文件不被允许或不存在、图纸中没有的变量、无法执行的语句、无法识别的格式——都是 JavaScript 错误，带有说明原因的消息。可以用 try … catch 捕获它以继续运行，或者让它停止脚本：此时会给出脚本的名称和行号（orders.js, line 12: …），退出代码为 1。batch 会捕获每个项目的错误。

for (const file of listFiles("in", "*.piq")) {
  try {
    const d = openDrawing(file);
    d.export("dxf", "dxf/");
    d.close();
  } catch (e) {
    log("Not exported:", file, e.message);
  }
}

示例：为 CSV 文件的每一行生成一个盒子

应用的 Extensions\Automation 文件夹中的 box-sizes.js（附带一个用于试用的 box-sizes.csv）为每一行盒子尺寸（名称、L、W、D 和纸板）生成一个普通开槽箱，将其写为 PDF 和 DXF 并保存，再写出 made.csv，其中包含每个展开料的尺寸和切割长度，供订单系统读回：

PiQ run box-sizes.js box-sizes.csv out

const made = batch(readCsv(args[0]), row => {
  const values = { L: row.L, W: row.W, D: row.D };
  if (row.board) values.T = row.board;
  const box = runDesign("Packaging › FEFCO 0201 Regular slotted container", values);
  box.export("pdf", joinPath(args[1], row.name + ".pdf"));
  box.export("dxf", joinPath(args[1], row.name + ".dxf"));
  box.save(joinPath(args[1], row.name + ".piq"));
  return box.info().totals;
});
writeCsv(joinPath(args[1], "made.csv"),
  made.map(m => ({ name: m.item.name, ok: m.ok, width: m.ok ? m.result.width : "", error: m.error ?? "" })));

说明

• 脚本没有窗口，也不询问任何内容：格式在应用中会询问的内容，都使用其常用设置。机器配置文件提供其格式、图层、文件名和后处理器；配置文件中保存的格式选项（来自格式的选项页面）尚未使用：使用的是格式的常用设置。
• 无论有多少条语句，脚本最多运行十分钟（--timeout）；Date 和 Math.random() 照常工作。它无法访问其他程序、其文件夹以外的文件或 Web（从允许的主机打开图纸除外）。
• 脚本保存的图纸会在其文件头中注明由脚本生成，与应用保存的图纸一样。
• 要将保存的每张图纸记录到数据库中，请编写保存扩展：它也会对脚本保存的图纸运行，其返回内容位于 save 的 records 中。

另请参阅：扩展、绘图 API、运行参数化、文件格式、机器配置文件。