← All types
PrepressOb Object

PreviewShapeNestingPayload

Validated nesting preview and optional rendering/cutting data, or field-addressable errors.

Implements

Fields

Whether the requested action completed successfully.

issues

[ActionIssue!]!Non-null

Blocking failures; empty on success.

Non-blocking diagnostics.

Why a valid planning preview cannot supply exact cutting data, when applicable.

Structured geometry for downstream cutting-operation setup; no batch or operation is created. Part IDs are caller-supplied traceability keys; source mappings are filled at rendering.

Version-1 shapeArtwork render envelope accepted by imposePdfInline and impose_pdf, present only with valid artworkJSON. Retains planning geometry, artwork frames/clips and logical page mappings. Shares the 2 MiB artifact limit.

Version-1 shapeNesting planning envelope containing the authoritative request, placements and algorithm version. Null on failure. Retain unchanged; not accepted by imposePdfInline.

sheetCount

Int!Non-null

Number of physical sheets represented by this result.

sheetSVGs

[String!]!Non-null

One dimensioned SVG planning preview per physical sheet in order. Blue planning polygons, orange bleed reservation and purple combined bleed/approximation reservation; not artwork or a cutter programme. Additional piece/edge clearances are not depicted. Empty on failure.

Version-1 shapeCutGeometry integrity manifest: SHA-256 of exact plan JSON and each ordered SVG, UTF-8 byte counts and placed-piece counts. Null unless cut export requested and successful. Checksums are not authentication or device certification.

One source-preserving cut geometry SVG per sheet when requested; empty otherwise or on failure. No kerf, cut order, machine settings, registration or physical certification. Not a cutter programme.

Number of placed part instances across all sheets.

Referenced by (1)
Exact type SDL
"""
Validated nesting preview and optional rendering/cutting data, or field-addressable errors.
"""
type PreviewShapeNestingPayload implements ActionResult {
  """Whether the requested action completed successfully."""
  success: Boolean!
  """Blocking failures; empty on success."""
  issues: [ActionIssue!]!
  """Non-blocking diagnostics."""
  warnings: [ActionIssue!]!
  """
  Why a valid planning preview cannot supply exact cutting data, when applicable.
  """
  cuttingDataUnavailableReason: String
  """
  Structured geometry for downstream cutting-operation setup; no batch or operation is created. Part IDs are caller-supplied traceability keys; source mappings are filled at rendering.
  """
  cuttingData: ImpositionCuttingData
  """
  Version-1 shapeArtwork render envelope accepted by imposePdfInline and impose_pdf, present only with valid artworkJSON. Retains planning geometry, artwork frames/clips and logical page mappings. Shares the 2 MiB artifact limit.
  """
  renderPlanJSON: String
  """
  Version-1 shapeNesting planning envelope containing the authoritative request, placements and algorithm version. Null on failure. Retain unchanged; not accepted by imposePdfInline.
  """
  planJSON: String
  """Number of physical sheets represented by this result."""
  sheetCount: Int!
  """
  One dimensioned SVG planning preview per physical sheet in order. Blue planning polygons, orange bleed reservation and purple combined bleed/approximation reservation; not artwork or a cutter programme. Additional piece/edge clearances are not depicted. Empty on failure.
  """
  sheetSVGs: [String!]!
  """
  Version-1 shapeCutGeometry integrity manifest: SHA-256 of exact plan JSON and each ordered SVG, UTF-8 byte counts and placed-piece counts. Null unless cut export requested and successful. Checksums are not authentication or device certification.
  """
  cutManifestJSON: String
  """
  One source-preserving cut geometry SVG per sheet when requested; empty otherwise or on failure. No kerf, cut order, machine settings, registration or physical certification. Not a cutter programme.
  """
  cutGeometrySVGs: [String!]!
  """Number of placed part instances across all sheets."""
  placedPieces: Int!
}