PreviewShapeNestingPayload
Validated nesting preview and optional rendering/cutting data, or field-addressable errors.
Implements
Fields
Whether the requested action completed successfully.
Blocking failures; empty on success.
Non-blocking diagnostics.
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.
Number of physical sheets represented by this result.
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!
}