Export:以文件形式导出图纸
POST /export/{format} 使用给定的值运行模板,并以路径中指定的格式将图纸作为文件返回:
| 格式 | 文件 |
|---|---|
pdf |
PDF:图层作为可选内容,刀线图层作为专色。 |
svg |
SVG。 |
eps |
Encapsulated PostScript。 |
ai |
Adobe Illustrator。 |
png、jpeg、webp |
图片。 |
gcode |
G-code,用于切割机或雕刻机。 |
hpgl |
HP-GL,用于绘图仪或切割台。 |
cf2、ddes |
CF2 或 DDES3,用于刀模制作商(以及自动弯刀机:参见弯刀机)。 |
lightburn |
LightBurn 项目(.lbrn2):每个图层成为一个 LightBurn 图层,按其内容进行切割、划线或雕刻。参见 LightBurn。 |
lasersvg |
用于 Glowforge 和 xTool 的 SVG:尺寸以毫米为单位,切割为红色,划线为蓝色,雕刻填充为黑色。参见用于 Glowforge 和 xTool 的 SVG。 |
dstv |
用于钢结构加工机床的 DSTV NC(.nc1):切割图层上切出的每个构件,及其孔、零件标记和划线;多个构件以包含多个 .nc1 文件的 ZIP 文件返回。参见 DSTV NC 和 Formats。 |
ifc |
IFC4 钢结构模型(.ifc):每块板为一个 IfcPlate,每段型材为一个带截面的 IfcBeam,圆孔和切口作为开洞,并附有编号、材质等级、数量和重量。参见 IFC 钢结构模型。 |
benddxf |
带折弯数据、供折弯机使用的钣金展开料 DXF R12:轮廓、孔和折弯线使用 Inventor 的图层名称,每道折弯的方向、角度、半径和顺序以 XDATA 和注释形式给出。参见带折弯数据的 DXF。 |
step |
折叠成形的图纸(每道折弯按其注释中的角度折弯),作为以毫米为单位的 STEP AP214 小平面实体。参见 STEP 折弯零件。 |
glb |
做成 3D 的图纸(按 ParametrIQ 3D 视图的方式折叠、拉伸 …),作为二进制 glTF 模型:实际尺寸,以米为单位,Y 向上,折叠立起,使用其外观的材质并带有图稿,以及“Fold”动画。用于网页查看器和增强现实(WebXR、Android 的 Scene Viewer、<model-viewer>)。参见 glTF 和增强现实。 |
usdz |
做成 3D 的图纸,作为供 iPhone 和 iPad 上 AR 快速查看使用的 USDZ 模型:实际尺寸,立在地面上,打开时折叠成形。参见 AR 校样(USDZ)。 |
matcutterdxf、matcutterhpgl |
用于电脑卡纸切割机的卡纸,DXF R12 格式(图层 STRAIGHT、BEVEL、VGROOVE、PEN)或 HP-GL 格式(每种切割一支笔),按切割顺序排列。参见卡纸切割机 DXF 和卡纸切割机 HP-GL。 |
dielinepdf |
供印刷厂和包装设计师使用的可直接印刷的刀模线 PDF:切割线使用专色(Dieline 或 CutContour),压痕线使用 Crease,叠印;出血和安全区参考线;裁切框和出血框。参见刀模线 PDF。 |
specsheetpdf |
供客户批准的规格书:一页 A4 横向页面,包含刀模线及其总尺寸、折叠后的图片、尺寸、纸板、展开料、折叠尺寸和托盘码放方式(specPallet),给出 specGrammage 和 specEdgeCrush 时还包括纸板重量和纸箱强度,以及修订记录表和批准栏(specCustomer、specReference)。请参阅规格书。 |
printcutpdf、printcuteps |
供 RIP 使用的打印切割 PDF 或 EPS:图稿使用印刷四色,切割图层为 CutContour 专色的细线(叠印),对位标记以黑色印刷。参见打印切割 PDF 和 EPS。 |
gpgl |
用于 Graphtec 切割绘图仪的 GP-GL:各切割图层每层一遍,步距 0.1 mm。参见 GP-GL。 |
cuttingsvg |
用于 Cricut Design Space 和 Silhouette Studio 的 SVG:以毫米为单位的实际尺寸,每个图层一个编组和一种颜色。参见用于 Cricut 和 Silhouette 的 SVG。 |
aamadxf |
供服装 CAD 和裁剪车间使用的 AAMA/ASTM D6673 纸样文件(DXF R12):每个纸样裁片(切割图层上的一个闭合轮廓)为一个块,包含其边界、剪口、布纹线、内部线和缝线、钻孔、名称和数量,使用图纸的单位,单一尺码。参见 AAMA/ASTM DXF。 |
tiledpdf |
分页拼贴打印:将图纸按 1:1 尺寸分布在多张纸上(A4,英寸图纸为 Letter,除非 tilePaper 另行指定),带有搭接、对齐十字和页面标签,并附一张带测试方块的封面页,按 100% 打印。参见分页拼贴打印。 |
projectorpdf |
投影仪 PDF:图纸按 1:1 尺寸放在一页上,黑底浅色粗线,每个图层作为可选内容,并附测试方块。参见投影仪 PDF。 |
wraptemplatepdf |
缠绕式样板:图纸中的管道样板(两端和三条四分线,彼此相隔周长的四分之一)按 1:1 尺寸分布在多张纸上,方式与分页拼贴打印相同(tilePaper、tileOrientation、tileOverlap),每个样板标有绕管道的角度、象限刻度、中心线、搭接条及其周长。参见缠绕式样板。 |
dxf |
DXF(AutoCAD 2013),用于其他 CAD 程序。 |
piq |
图纸本身,仍保持参数化。 |
Formats 列出了这些格式及其媒体类型和文件扩展名。
请求正文为一个模板(作为 template 发送,或作为 source 从您的某个存储中读取)以及其带标签变量的 values,详见 API 页面。 文件的生成方式可在 options 中设置:
| 选项 | |
|---|---|
margin |
页面上图纸四周的留白,单位为点(1/72 英寸),0 到 1000。未给出时为 18。 |
spotColours |
PDF、EPS 和 AI:将刀线图层(切割线、压痕线 …)作为以图层命名的专色。未给出时为 true。 |
textAsOutlines |
将文字绘制为图形而不是文本。 |
width |
图片:横向像素数(高度按比例),最多 8000;为 0 时按 dpi 使用图纸自身的尺寸。 |
dpi |
图片:每英寸像素数,1 到 1200,在 width 为 0 时使用。未给出时为 150。 |
quality |
JPEG 和 WebP 的质量,1 到 100。未给出时为 90。 |
transparent |
PNG 和 WebP:使用透明背景而不是白色背景。 |
title |
写入文件的标题(如果该格式支持)。 |
dielineCutSpot |
刀模线 PDF:切割线所用的专色:未给出时为 Dieline;打印切割 RIP 使用 CutContour,或使用印刷厂要求的名称。 |
dielineCreaseSpot |
刀模线 PDF:压痕线所用的专色。未给出时为 Crease。 |
dielineBleed |
刀模线 PDF:在每个展开料的切割轮廓外侧此距离处绘制出血参考线,单位为图纸单位;出血框为裁切框向外扩大此距离。未给出时为 0(无)。 |
dielineSafe |
刀模线 PDF:在每个面板内侧此距离处绘制安全区参考线,单位为图纸单位。未给出时为 0(无)。 |
embedDesign |
刀模线 PDF 和与 PDF 兼容的 AI:在文件中附带图纸(附件和 XMP 元数据),返回的图稿可在 ParametrIQ CAD 中重新作为设计打开。未给出时为 true。 |
designName |
附带设计的文件名(box.piq)。未给出时为 design.piq。 |
tilePaper |
分页拼贴打印:纸张尺寸,A4、A3、Letter、Legal 或 Tabloid。未给出时为 A4,英寸图纸为 Letter。 |
tileOrientation |
分页拼贴打印:页面方向,Portrait、Landscape 或 Automatic(取页数较少的方向;页数相同时为纵向)。未给出时为 Automatic。 |
appearance |
glb 和 usdz:外观,即 GET /appearances 中某个外观的 id("corrugated-bc-kraft"、"stainless-brushed" …)。未给出时使用图纸材料对应的外观。 |
animate |
glb 和 usdz:带折叠动画(从展平到折叠);为 false 时模型只以折叠状态立着。未给出时为 true。 |
tileOverlap |
分页拼贴打印:每页与下一页(右侧和下方)重复的图纸宽度,用于粘贴胶带,单位为图纸单位。未给出时为 10 mm(英寸图纸为 0.4 in);最多 100 mm,且不超过页面可打印区域的一半。 |
这些选项适用于 PDF、SVG、EPS、AI 和图片,以某种格式命名的选项(刀模线 PDF 的、分页拼贴打印的)适用于该格式;其他格式按原样写入。宽度或高度超过
8000 像素的图片会被拒绝(400):请提供 width,或使用较低的 dpi。
示例
POST /export/pdf
X-API-KEY: your-api-key
Content-Type: application/json
{
"template": "L=400,\"Length\"\nW=300,\"Width\"\nP1=[L,0]\nP2=[L,W]\nP3=[0,W]\nPOLYLINE @1,[P0,P1,P2,P3],TRUE,0",
"values": { "L": 500, "W": 250 },
"options": { "margin": 18, "spotColours": true }
}
响应即文件本身,带有其媒体类型(此处为 application/pdf)和文件名(drawing.pdf)。X-PiQ-Warnings 标头表示有多少内容无法按原样导出(例如该格式无法写入的图元):全部导出成功时为 0。
未知格式会返回 400。如需将文件保存在您自己的存储中而不是下载,请使用
Save。