Export: el dibujo como archivo

POST /export/{format} ejecuta la plantilla con los valores dados y devuelve el dibujo como archivo, en el formato indicado en la ruta:

Formato	Archivo
`pdf`	PDF: capas como contenido opcional, capas de línea de troquel como colores directos.
`svg`	SVG.
`eps`	PostScript encapsulado.
`ai`	Adobe Illustrator.
`png`, `jpeg`, `webp`	Una imagen.
`gcode`	G-code, para una máquina de corte o de fresado.
`hpgl`	HP-GL, para un trazador o una mesa de corte.
`cf2`, `ddes`	CF2 o DDES3, para fabricantes de troqueles (y dobladoras automáticas de fleje: consulte Dobladoras de fleje).
`lightburn`	Un proyecto de LightBurn (`.lbrn2`): cada capa, una capa de LightBurn, cortada, marcada o grabada según lo que sea. Consulte LightBurn.
`lasersvg`	SVG para Glowforge y xTool: tamaño en milímetros, cortes en rojo, marcados en azul, grabado relleno en negro. Consulte SVG para Glowforge y xTool.
`dstv`	DSTV NC (`.nc1`) para máquinas de fabricación de estructuras de acero: cada pieza recortada en la capa Corte, con sus agujeros, su marca de pieza y sus líneas de marcado; varias piezas llegan como un archivo ZIP de archivos `.nc1`. Consulte DSTV NC y Formats.
`ifc`	Un modelo de acero IFC4 (`.ifc`): cada chapa, un IfcPlate; cada pieza de un perfil, un IfcBeam con su sección, con los agujeros redondos y los despatillados como aberturas, y con la marca, la calidad, la cantidad y los pesos adjuntos. Consulte Modelo de acero IFC.
`benddxf`	El desarrollo de una pieza de chapa como DXF R12 con sus datos de doblez para plegadoras: contorno, agujeros y líneas de doblez en los nombres de capa de Inventor, y el sentido, el ángulo, el radio y el orden de cada doblez como XDATA y como nota. Consulte DXF con datos de doblez.
`step`	El dibujo plegado (cada doblez al ángulo de su nota) como sólido facetado STEP AP214 en milímetros. Consulte STEP (pieza plegada).
`glb`	El dibujo convertido en 3D (plegado, extruido … como lo hace la vista 3D de ParametrIQ) como modelo glTF binario: a tamaño real en metros, con Y hacia arriba, de pie y plegado, con los materiales de su apariencia y el arte, y la animación "Fold". Para visores web y realidad aumentada (WebXR, Scene Viewer de Android, `<model-viewer>`). Consulte glTF y Realidad aumentada.
`usdz`	El dibujo convertido en 3D como modelo USDZ para AR Quick Look en iPhone y iPad: a tamaño real, apoyado en el suelo, plegándose al abrirse. Consulte Pruebas RA (USDZ).
`matcutterdxf`, `matcutterhpgl`	Un paspartú para una cortadora de paspartús computerizada, como DXF R12 (capas STRAIGHT, BEVEL, VGROOVE, PEN) o como HP-GL (una plumilla para cada tipo de corte), en orden de corte. Consulte DXF para cortadora de paspartú y HP-GL para cortadora de paspartú.
`dielinepdf`	El PDF de plano de troquel listo para imprimir, para imprentas y diseñadores de envases: el corte en un color directo (`Dieline` o `CutContour`), los hendidos en `Crease`, con sobreimpresión; guías de sangrado y de zona segura; cajas de recorte y de sangrado. Consulte PDF de plano de troquel.
`specsheetpdf`	Una hoja de especificaciones para que el cliente la apruebe: una página A4 apaisada con la línea de troquel y sus tamaños totales, una imagen plegada, sus tamaños, cartón, plancha, tamaño plegado y patrón de palé (`specPallet`), el peso del cartón y la resistencia de la caja si se indican `specGrammage` y `specEdgeCrush`, una tabla de revisiones y un recuadro de aprobación (`specCustomer`, `specReference`). Consulte Hoja de especificaciones.
`printcutpdf`, `printcuteps`	PDF o EPS de impresión y corte para un RIP: la ilustración en colores de cuatricromía, las capas de corte como líneas finas en el color directo `CutContour` (con sobreimpresión), las marcas de registro impresas en negro. Consulte PDF y EPS de impresión y corte.
`gpgl`	GP-GL para un plóter de corte Graphtec: las capas de corte, una pasada cada una, en pasos de 0,1 mm. Consulte GP-GL.
`cuttingsvg`	SVG para Cricut Design Space y Silhouette Studio: tamaño real en milímetros, un grupo y un color por capa. Consulte SVG para Cricut y Silhouette.
`aamadxf`	Un archivo de patrones AAMA/ASTM D6673 (DXF R12) para CAD de confección y salas de corte: cada pieza del patrón (un contorno cerrado en la capa Corte), un bloque con su contorno, piquetes, línea de hilo, líneas interiores y de costura, agujeros taladrados, nombre y cantidad, en las unidades del dibujo, en una talla. Consulte DXF AAMA/ASTM.
`tiledpdf`	Una impresión en mosaico: el dibujo a tamaño real en hojas de papel (A4, o Letter para un dibujo en pulgadas, salvo que `tilePaper` indique otra cosa) con solapes, cruces de alineación y etiquetas de página, y una portada con un cuadrado de prueba, para imprimir al 100 %. Consulte Impresión en mosaico.
`projectorpdf`	Un PDF para proyector: el dibujo a tamaño real en una sola página, líneas gruesas claras sobre negro, cada capa como contenido opcional, con un cuadrado de prueba. Consulte PDF para proyector.
`wraptemplatepdf`	Plantillas envolventes: las plantillas de tubería que hay en el dibujo (dos extremos y tres líneas de cuarto, separadas un cuarto del perímetro) a tamaño real en hojas de papel como la impresión en mosaico (`tilePaper`, `tileOrientation`, `tileOverlap`), cada una marcada con sus ángulos alrededor del tubo, marcas de cuadrante, ejes, una franja de solape y su perímetro. Consulte Plantillas envolventes.
`dxf`	DXF (AutoCAD 2013), para otros programas CAD.
`piq`	El propio dibujo, todavía paramétrico.

Formats los enumera con sus tipos de medio y extensiones de nombre de archivo.

El cuerpo es una plantilla (como template, o como source desde uno de sus almacenamientos) y values para sus variables etiquetadas, tal como se describe en la página API. La forma de generar el archivo puede ajustarse en options:

Opción
`margin`	Espacio alrededor del dibujo en la página, en puntos (1/72 de pulgada), de 0 a 1000. 18 si no se indica.
`spotColours`	PDF, EPS y AI: capas de línea de troquel (corte, hendido …) como colores directos con su nombre. True si no se indica.
`textAsOutlines`	El texto se dibuja como formas en lugar de como texto.
`width`	Imágenes: píxeles de ancho (el alto, en proporción), hasta 8000; 0 para el tamaño propio del dibujo a `dpi`.
`dpi`	Imágenes: píxeles por pulgada, de 1 a 1200, cuando `width` es 0. 150 si no se indica.
`quality`	Calidad de JPEG y WebP, de 1 a 100. 90 si no se indica.
`transparent`	PNG y WebP: un fondo transparente en lugar de blanco.
`title`	El título que se escribe en el archivo, si el formato lo admite.
`dielineCutSpot`	PDF de plano de troquel: el color directo en el que van las líneas de corte: `Dieline` si no se indica; `CutContour` para los RIP de impresión y corte, o el nombre que pida la imprenta.
`dielineCreaseSpot`	PDF de plano de troquel: el color directo en el que van los hendidos. `Crease` si no se indica.
`dielineBleed`	PDF de plano de troquel: una guía de sangrado a esta distancia por fuera del contorno de corte de cada plancha, en las unidades del dibujo; la caja de sangrado es la de recorte agrandada en esta medida. 0 (ninguna) si no se indica.
`dielineSafe`	PDF de plano de troquel: una guía de zona segura a esta distancia por dentro de cada panel, en las unidades del dibujo. 0 (ninguna) si no se indica.
`embedDesign`	PDF de plano de troquel y AI compatible con PDF: el dibujo incluido en el archivo (un adjunto y metadatos XMP), de modo que el arte que vuelve se abre de nuevo en ParametrIQ CAD como el diseño. True si no se indica.
`designName`	El nombre de archivo que recibe el diseño incluido (`box.piq`). `design.piq` si no se indica.
`tilePaper`	Impresión en mosaico: el tamaño del papel, `A4`, `A3`, `Letter`, `Legal` o `Tabloid`. A4 si no se indica, o Letter para un dibujo en pulgadas.
`tileOrientation`	Impresión en mosaico: la orientación de las páginas, `Portrait` (vertical), `Landscape` (horizontal) o `Automatic` (la que necesite menos páginas; vertical si son las mismas). `Automatic` si no se indica.
`tileOverlap`	Impresión en mosaico: cuánto del dibujo repite cada página de la siguiente (a la derecha y debajo), para pegarlas con cinta, en las unidades del dibujo. 10 mm si no se indica (0,4 in para un dibujo en pulgadas); como máximo 100 mm, y no más de la mitad del área impresa de una página.
`appearance`	`glb` y `usdz`: el aspecto, el id de una apariencia de `GET /appearances` (`"corrugated-bc-kraft"`, `"stainless-brushed"` …). Si no se indica, la apariencia del material del dibujo.
`animate`	`glb` y `usdz`: con la animación de plegado (de plano a plegado); `false` para el modelo solo de pie y plegado. True si no se indica.

Las opciones son para PDF, SVG, EPS, AI e imágenes, y las que llevan el nombre de un formato (las del PDF de plano de troquel, las de la impresión en mosaico), para ese formato; los demás formatos se escriben tal cual. Una imagen que superaría los 8000 píxeles de ancho o de alto se rechaza (400): indique un width o un dpi menor.

Ejemplo

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 }
}

La respuesta es el propio archivo, con su tipo de medio (aquí, application/pdf) y un nombre de archivo (drawing.pdf). El encabezado X-PiQ-Warnings indica cuántas cosas no pudieron exportarse tal cual (por ejemplo, un elemento que el formato no puede escribir): 0 cuando se exportó todo.

Un formato desconocido se responde con 400. Para guardar el archivo en su propio almacenamiento en lugar de descargarlo, use Save.

Consulte también: API, Save, Preview, Clientes.