← API reference
CANONICAL TYPE REFERENCE

PreviewImpositionInput

Input for preview/estimate imposition. All geometry is provided directly (no persisted component needed). At least one substrate ID is required.

Finished (trim) width in mm

Finished (trim) height in mm

Total content pages

Bleed offset in mm (default 3.0)

Print run quantity (enables total sheet calculation)

Layout mode: signature, ganging, or web (default signature)

Binding side of the upright reader page. Constrains signature geometry and artwork orientation; omitted preserves legacy fitting.

Binding type that determines page ordering (saddleStitch, perfectBound, etc.)

substrateIds[String!]!

Substrate IDs to consider (at least one required)

Fold pattern IDs to allow, e.g. ["f8", "f16", "f32"]. Nil = all.

Maximum pages-up cap

Preferred imposition scheme

Horizontal gutter in mm (default 0)

Vertical gutter in mm (default 0)

Gripper margin in mm (default 10)

Tail margin in mm (default 5)

Side margins in mm (default 5)

Explicit row count for ganging (nil = auto)

Explicit column count for ganging (nil = auto)

Web press profile (required for web mode)

Objective weight for waste minimisation (default 1.0)

Objective weight for sheet utilisation (default 1.0)

Objective weight for signature count (default 0.5)

Objective weight for fold uniformity (default 0.3)

View exact SDL
"""
Input for preview/estimate imposition. All geometry is provided directly (no persisted component needed). At least one substrate ID is required.
"""
input PreviewImpositionInput {
  """Finished (trim) width in mm"""
  finishedWidth: LengthInput!
  """Finished (trim) height in mm"""
  finishedHeight: LengthInput!
  """Total content pages"""
  totalPages: Int!
  """Bleed offset in mm (default 3.0)"""
  bleed: LengthInput
  """Print run quantity (enables total sheet calculation)"""
  quantity: Int
  """Layout mode: signature, ganging, or web (default signature)"""
  mode: ImposingMode
  """
  Binding side of the upright reader page. Constrains signature geometry and artwork orientation; omitted preserves legacy fitting.
  """
  bindingSide: BindingSide
  """
  Binding type that determines page ordering (saddleStitch, perfectBound, etc.)
  """
  bindingType: BindingType
  """Substrate IDs to consider (at least one required)"""
  substrateIds: [String!]!
  """Fold pattern IDs to allow, e.g. ["f8", "f16", "f32"]. Nil = all."""
  permittedFolds: [String!]
  """Maximum pages-up cap"""
  maxPagesUp: Int
  """Preferred imposition scheme"""
  scheme: ImpositionScheme
  """Horizontal gutter in mm (default 0)"""
  gutterH: LengthInput
  """Vertical gutter in mm (default 0)"""
  gutterV: LengthInput
  """Gripper margin in mm (default 10)"""
  gripEdge: LengthInput
  """Tail margin in mm (default 5)"""
  tailEdge: LengthInput
  """Side margins in mm (default 5)"""
  sideMargin: LengthInput
  """Explicit row count for ganging (nil = auto)"""
  gangingRows: Int
  """Explicit column count for ganging (nil = auto)"""
  gangingCols: Int
  """Web press profile (required for web mode)"""
  webPressProfile: WebPressProfileInput
  """Objective weight for waste minimisation (default 1.0)"""
  wasteWeight: Float
  """Objective weight for sheet utilisation (default 1.0)"""
  utilisationWeight: Float
  """Objective weight for signature count (default 0.5)"""
  sigCountWeight: Float
  """Objective weight for fold uniformity (default 0.3)"""
  foldUniformityWeight: Float
}

One stable address across all schema views. Follow a field’s type to explore connections between domains.