Length
A linear measurement with preserved unit provenance. Equality and ordering compare by canonical millimetres, but the original unit is round-tripped through the API and storage.
Fields
The stored numeric value, in unit. Use this together with unit if you need to render in the user's original unit.
The unit the value was originally supplied in.
Possible values (5)
UMMicrometres (µm). 1 µm = 1/1000 mm.
MMMillimetres. The internal canonical unit for arithmetic-equivalence.
CMCentimetres. 1 cm = 10 mm.
INInternational inches. 1 in = 25.4 mm exactly.
PTPostScript / DTP points. 72 pt = 1 in.
The value re-expressed in micrometres.
The value re-expressed in millimetres. This is the canonical unit for arithmetic-equivalence.
The value re-expressed in centimetres.
The value re-expressed in inches.
The value re-expressed in PostScript / DTP points.
The value re-expressed in any supported unit. Convenience for clients that want to honour a user-chosen display preference.
Arguments (1)
The unit to re-express the value in.
Possible values (5)
UMMicrometres (µm). 1 µm = 1/1000 mm.
MMMillimetres. The internal canonical unit for arithmetic-equivalence.
CMCentimetres. 1 cm = 10 mm.
INInternational inches. 1 in = 25.4 mm exactly.
PTPostScript / DTP points. 72 pt = 1 in.
Referenced by (202)
- BleedSpec.top
- BleedSpec.right
- BleedSpec.bottom
- BleedSpec.left
- BookCoverBlock.trimWidth
- BookCoverBlock.trimHeight
- BookCoverConstructionSettings.addedThickness
- BookCoverConstructionSettings.spineAdjustment
- BookCoverConstructionSettings.frontWidthDelta
- BookCoverConstructionSettings.backWidthDelta
- BookCoverConstructionSettings.heightDelta
- BookCoverConstructionSettings.frontJoint
- BookCoverConstructionSettings.backJoint
- BookCoverConstructionSettings.leftTurnIn
- BookCoverConstructionSettings.rightTurnIn
- BookCoverConstructionSettings.bottomTurnIn
- BookCoverConstructionSettings.topTurnIn
- BookCoverConstructionSettings.bleed
- BookCoverContribution.caliper
- BookCoverContribution.trimWidth
- BookCoverContribution.trimHeight
- BookCoverEstimate.uncompressedThickness
- BookCoverEstimate.blockThickness
- BookCoverEstimate.spineWidth
- BookCoverEstimate.frontWidth
- BookCoverEstimate.backWidth
- BookCoverEstimate.height
- BookCoverGeometry.artworkWidth
- BookCoverGeometry.artworkHeight
- BookCoverGeometry.trimWidth
- BookCoverGeometry.trimHeight
- BookCoverLayer.caliper
- ColorBarSpec.x
- ColorBarSpec.y
- ColorBarSpec.cellWidth
- ColorBarSpec.cellHeight
- CropMarkSpec.x
- CropMarkSpec.y
- CropMarkSpec.length
- CropMarkSpec.offset
- CropMarkSpec.lineWidth
- EyeMarkSpec.x
- EyeMarkSpec.y
- EyeMarkSpec.cellWidth
- EyeMarkSpec.cellHeight
- FinishingSpec.depth
- FoldLine.position
- FoldLineSpec.position
- FoldLineSpec.start
- FoldLineSpec.end
- FoldLineSpec.lineWidth
- FoldLineSpec.dashPattern
- FoldPacketGeometry.width
- FoldPacketGeometry.height
- FoldPattern.maxSheetThickness
- GangingPlan.gutterH
- GangingPlan.gutterV
- ImposingSettings.gutter
- ImposingSettings.gripEdge
- ImposingSettings.bleed
- ImposingSettings.trimTolerance
- ImpositionSpecState.gutterH
- ImpositionSpecState.gutterV
- LayoutAllowance.top
- LayoutAllowance.right
- LayoutAllowance.bottom
- LayoutAllowance.left
- LayoutBox.x
- LayoutBox.y
- LayoutBox.width
- LayoutBox.height
- LayoutDimension.width
- LayoutDimension.height
- LengthConstraint.exact
- LengthRange.min
- LengthRange.max
- LengthTolerance.target
- LengthTolerance.tolerance
- Media.width
- Media.height
- Media.thickness
- PlacedCell.x
- PlacedCell.y
- PlacedCell.width
- PlacedCell.height
- PlacedCell.trimX
- PlacedCell.trimY
- PlacedCell.trimWidth
- PlacedCell.trimHeight
- PrintMarkTransformView.e
- PrintMarkTransformView.f
- PrintOperationProductSpecification.nestingCalipers
- ProductionReportState.widthPrinted
- ProductionReportState.lengthPrinted
- ProductionReportState.substrateWidth
- ProductionReportState.substrateLength
- ProductionReportState.substrateThickness
- RegMarkSpec.cx
- RegMarkSpec.cy
- RegMarkSpec.radius
- RegMarkSpec.armLength
- RegMarkSpec.lineWidth
- RollLabelDeliveryItemSetup.maximumPrintedLengthPerRoll
- RollLabelDeliveryItemSetup.coreInsideDiameter
- RollLabelDeliveryItemSetup.addedLeaderLength
- RollLabelDeliveryItemSetup.addedTrailerLength
- RollLabelItemSpacing.gapAround
- RollLabelProductionSetup.webWidth
- RollLabelProductionSetup.repeatLength
- RollLabelProductionSetup.leftMargin
- RollLabelProductionSetup.rightMargin
- RollLabelProductionSetup.gapAcross
- RollLabelProductionSetup.leaderLength
- RollLabelProductionSetup.trailerLength
- RollLabelResolvedItem.trimWidth
- RollLabelResolvedItem.trimHeight
- RollLabelResolvedItem.bleed
- RollLabelWindingSetup.coreOutsideDiameter
- RollLabelWindingSetup.maximumOutsideDiameter
- RollLabelWindingSetup.effectiveWoundCaliper
- SheetCreepCompensation.caliper
- SheetCreepCompensation.offset
- SheetLayout.sheetWidth
- SheetLayout.sheetHeight
- SheetLayout.finishedWidth
- SheetLayout.finishedHeight
- SheetLayout.bleed
- SheetLayout.gripEdge
- SheetLayout.tailEdge
- SheetLayout.sideMargin
- SheetLayout.gutterH
- SheetLayout.gutterV
- SheetMedia.thickness
- SignatureParams.trimHead
- SignatureParams.trimFoot
- SignatureParams.trimFace
- SignatureParams.frontOverfold
- SignatureParams.backOverfold
- SignatureParams.spine
- SignatureParams.millingDepth
- SignatureParams.bleedHead
- SignatureParams.bleedFoot
- SignatureParams.bleedFace
- SignatureParams.bleedSpine
- SignatureSeparationCut.position
- SignatureSeparationStepResult.position
- SlugLineSpec.x
- SlugLineSpec.y
- SlugLineSpec.fontSize
- SubstrateInput.width
- SubstrateInput.height
- SubstrateInput.thickness
- SubstrateState.width
- SubstrateState.height
- SubstrateState.thickness
- SuppliedArtworkPlacementView.width
- SuppliedArtworkPlacementView.height
- TrimMark.position
- TypedBookCoverPanel.x
- TypedBookCoverPanel.y
- TypedBookCoverPanel.width
- TypedBookCoverPanel.height
- TypedRollLabelDelivery.totalPrintedStripLength
- TypedRollLabelDelivery.totalAddedLeaderStripLength
- TypedRollLabelDelivery.totalAddedTrailerStripLength
- TypedRollLabelDelivery.totalWoundStripLength
- TypedRollLabelDeliveryLane.addedLeaderLength
- TypedRollLabelDeliveryLane.addedTrailerLength
- TypedRollLabelDeliveryLane.printedStripLength
- TypedRollLabelDeliveryLane.totalWoundStripLength
- TypedRollLabelDeliveryRoll.sourceStockStart
- TypedRollLabelDeliveryRoll.printedLength
- TypedRollLabelDeliveryRoll.addedLeaderLength
- TypedRollLabelDeliveryRoll.addedTrailerLength
- TypedRollLabelDeliveryRoll.totalWoundLength
- TypedRollLabelLane.trimX
- TypedRollLabelLane.trimY
- TypedRollLabelLane.pitch
- TypedRollLabelPlan.printedLength
- TypedRollLabelPlan.stockLength
- WebPressProfile.webWidth
- WebPressProfile.cutoff
- WideFormatRegion.x
- WideFormatRegion.y
- WideFormatRegion.width
- WideFormatRegion.height
- WideFormatRequirements.width
- WideFormatRequirements.height
- WideFormatRequirements.maxPanelWidth
- WideFormatRequirements.maxPanelHeight
- WideFormatRequirements.overlapX
- WideFormatRequirements.overlapY
- WideFormatRequirements.minPanelWidth
- WideFormatRequirements.minPanelHeight
- WideFormatRequirements.seamsX
- WideFormatRequirements.seamsY
- WorkMaterialContext.width
- WorkMaterialContext.height
- WorkMaterialContext.thickness
- WorkMaterialContext.spineWidth
- WorkMaterialContext.finishedWidth
- WorkMaterialContext.finishedHeight
Exact type SDL
"""
A linear measurement with preserved unit provenance. Equality and ordering compare by canonical millimetres, but the original unit is round-tripped through the API and storage.
"""
type Length {
"""
The stored numeric value, in `unit`. Use this together with `unit` if you need to render in the user's original unit.
"""
raw: Float!
"""The unit the value was originally supplied in."""
unit: LengthUnit!
"""The value re-expressed in micrometres."""
micrometers: Float!
"""
The value re-expressed in millimetres. This is the canonical unit for arithmetic-equivalence.
"""
millimeters: Float!
"""The value re-expressed in centimetres."""
centimeters: Float!
"""The value re-expressed in inches."""
inches: Float!
"""The value re-expressed in PostScript / DTP points."""
points: Float!
"""
The value re-expressed in any supported unit. Convenience for clients that want to honour a user-chosen display preference.
"""
value(
"""The unit to re-express the value in."""
unit: LengthUnit!
): Float!
}