Skip to content
Topaz6.0 · Before release
Download

Search documentation

Specification 6.0 · Not released · Tested product 5.21.3

Use arrow keys to choose a result. Press Enter to open.

Type an API name, diagnostic number, rule, or project topic.

    Library · std.typeset

    LatinSpacing.maxLetterSpacingEm

    The maximum extra spacing per Latin letter gap, relative to the font size.

    LatinSpacing.maxLetterSpacingEm: Length<Em>
    Receiver
    LatinSpacing
    Minimum arity
    0
    Maximum arity
    0

    Declaration and parameters

    Link

    Availability

    Included by default: Pending

    Import std.typeset in language mode 5.21.

    The current compiler selects std/typeset.tpz for this language mode. Availability in other released editions and inclusion in each installed distribution are Pending.

    Source evidence

    Receiver

    LatinSpacing

    Parameter constraints

    Additional contracts are Pending.

    LatinSpacing stores minWordSpaceRatio and maxWordSpaceRatio as dimensionless float values, maxLetterSpacingEm as Length<Em>, and fontSizePt as Length<Pt>. There is no implicit scalar or cross-unit conversion.

    Record construction and field reads store and return the supplied values. They do not validate a paragraph policy or resolve the relative length. Field expressions follow ordinary source-order evaluation once.

    A paragraph validates every supplied LatinSpacing record before planning. This validation also applies in Unjustified mode and with the KnuthPlass cost model.

    minWordSpaceRatio must be finite and between 0.8 and 1.0 inclusive. maxWordSpaceRatio must be finite and between 1.0 and 1.33 inclusive. Invalid ratios return Err containing TypesetError.InvalidPolicy.

    maxLetterSpacingEm must be between 0em and 0.015em inclusive on the stored relative grid. The upper bound is 983 em ticks. A negative tick or 984 ticks returns Err containing TypesetError.InvalidPolicy.

    fontSizePt must have a strictly positive scaled-point count. A one-scaled-point font is valid even when the paragraph uses millipoints. Zero and negative fonts return Err containing TypesetError.InvalidPolicy, including when letter spacing is zero.

    InvalidPolicy carries explanatory text. Its exact message text and the order among independent invalid policy fields are not fixed by this contract.

    Resolve the stored maximum with maxLetterSpacingEm.resolve(fontSizePt). The stored relative count is multiplied by the physical font count and divided by 65,536 with one nearest-even rounding to scaled points. No ambient font is read.

    Convert the resolved result to the selected computation grid. ScaledPoint preserves its integer count. MilliPoint applies the shared nearest-even conversion. Every eligible gap receives this rounded bound before multiplication by the gap count.

    An eligible Latin letter gap lies between adjacent retained text units. Each unit must contain an alphabetic scalar and every scalar must be in U+0041 through U+024F, U+0300 through U+036F, or U+1E00 through U+1EFF. Paragraph trimming determines the retained units.

    The retained line uses this capacity path when it contains a CJK unit, or contains a Latin letter unit and no other alphabetic unit. A non-Latin unit containing an alphabetic scalar counts as another alphabetic unit. Paragraph classification determines CJK units.

    Let S be the sum of the grid widths of retained units whose text is U+0020. Word shrink capacity is floor(float(S) * (1.0 - minWordSpaceRatio)). Word stretch capacity is floor(float(S) * (maxWordSpaceRatio - 1.0)). Each expression keeps that binary64 evaluation order and its independent floor.

    The letter stretch contribution is the eligible gap count times the quantized relative limit. CJK capacity retains its separate floor rule. Combining these contributions does not repeat font resolution or round their total as one relative length.

    Unjustified mode does not apply spacing capacity. KnuthPlass obtains stretch and shrink from glue after the shared policy validation. FixedPoint uses the validated Latin spacing in its justification capacity and requires MilliPoint.

    Resolution, integer accumulation, and capacity arithmetic use their checked numeric contracts. Overflow stops with TPZ4004 and does not return InvalidPolicy. Validation and conversion perform no I/O and do not mutate the record.

    For 0.01em at 12pt, 655 relative ticks resolve to 7,860 scaled points and then 120 millipoints. For 0.0078125em at 24pt, each gap receives 188 millipoints. Two such gaps provide 376 millipoints.

    Related rule: Resolve relative letter spacing through Length

    Result

    Additional contracts are Pending.

    The declared result type is Length<Em>.

    Effects

    Pending

    Failures

    Pending

    Result and effects

    Link

    Select this field from a value of its named type without call parentheses.

    Store a relative length from 0em through 0.015em inclusive. Resolve it with fontSizePt before each gap receives the nearest-even grid bound. Invalid bounds return TypesetError.InvalidPolicy at paragraph admission.

    Why

    Link

    A font-relative distance uses the same Length type and explicit resolution as other relative lengths. A separate float multiplier would add a second unit-conversion rule for the same quantity.

    Related entries

    Link

    std.typeset

    Resolve relative letter spacing through Length

    Link
    Ruletopaz.stdlib.contract.latin-spacing-em.rule

    Resolve relative letter spacing through Length

    LatinSpacing stores minWordSpaceRatio and maxWordSpaceRatio as dimensionless float values, maxLetterSpacingEm as Length<Em>, and fontSizePt as Length<Pt>. There is no implicit scalar or cross-unit conversion.

    Record construction and field reads store and return the supplied values. They do not validate a paragraph policy or resolve the relative length. Field expressions follow ordinary source-order evaluation once.

    A paragraph validates every supplied LatinSpacing record before planning. This validation also applies in Unjustified mode and with the KnuthPlass cost model.

    minWordSpaceRatio must be finite and between 0.8 and 1.0 inclusive. maxWordSpaceRatio must be finite and between 1.0 and 1.33 inclusive. Invalid ratios return Err containing TypesetError.InvalidPolicy.

    maxLetterSpacingEm must be between 0em and 0.015em inclusive on the stored relative grid. The upper bound is 983 em ticks. A negative tick or 984 ticks returns Err containing TypesetError.InvalidPolicy.

    fontSizePt must have a strictly positive scaled-point count. A one-scaled-point font is valid even when the paragraph uses millipoints. Zero and negative fonts return Err containing TypesetError.InvalidPolicy, including when letter spacing is zero.

    InvalidPolicy carries explanatory text. Its exact message text and the order among independent invalid policy fields are not fixed by this contract.

    Resolve the stored maximum with maxLetterSpacingEm.resolve(fontSizePt). The stored relative count is multiplied by the physical font count and divided by 65,536 with one nearest-even rounding to scaled points. No ambient font is read.

    Convert the resolved result to the selected computation grid. ScaledPoint preserves its integer count. MilliPoint applies the shared nearest-even conversion. Every eligible gap receives this rounded bound before multiplication by the gap count.

    An eligible Latin letter gap lies between adjacent retained text units. Each unit must contain an alphabetic scalar and every scalar must be in U+0041 through U+024F, U+0300 through U+036F, or U+1E00 through U+1EFF. Paragraph trimming determines the retained units.

    The retained line uses this capacity path when it contains a CJK unit, or contains a Latin letter unit and no other alphabetic unit. A non-Latin unit containing an alphabetic scalar counts as another alphabetic unit. Paragraph classification determines CJK units.

    Let S be the sum of the grid widths of retained units whose text is U+0020. Word shrink capacity is floor(float(S) * (1.0 - minWordSpaceRatio)). Word stretch capacity is floor(float(S) * (maxWordSpaceRatio - 1.0)). Each expression keeps that binary64 evaluation order and its independent floor.

    The letter stretch contribution is the eligible gap count times the quantized relative limit. CJK capacity retains its separate floor rule. Combining these contributions does not repeat font resolution or round their total as one relative length.

    Unjustified mode does not apply spacing capacity. KnuthPlass obtains stretch and shrink from glue after the shared policy validation. FixedPoint uses the validated Latin spacing in its justification capacity and requires MilliPoint.

    Resolution, integer accumulation, and capacity arithmetic use their checked numeric contracts. Overflow stops with TPZ4004 and does not return InvalidPolicy. Validation and conversion perform no I/O and do not mutate the record.

    For 0.01em at 12pt, 655 relative ticks resolve to 7,860 scaled points and then 120 millipoints. For 0.0078125em at 24pt, each gap receives 188 millipoints. Two such gaps provide 376 millipoints.

    Why

    One relative length model gives a letter-spacing limit an explicit font and unit. Validating the stored policy before planning separates field construction from recoverable policy errors. Per-gap quantization makes the permitted adjustment reproducible.

    Examples Store a relative spacing length and an explicit point font sizeResolve the stored spacing before converting to the computation gridApply nearest-even rounding at each typed value boundaryReject an untyped multiplier in the relative-length fieldReject a physical length where an em length is requiredReject treating the stored relative length as a floatAdmit the inclusive ratio and font boundsReject ratios just outside every allowed endpointReject negative spacing and nonpositive fontsRead a stored policy before paragraph validationFill a line using a rounded bound for every letter gap

    Diagnostics TPZ5001

    Source evidence

    Store a relative spacing length and an explicit point font size

    Link

    check · checking · Verification: not-run

    main.tpzStore a relative spacing length and an explicit point font sizeOpen in Playground
    1. import std.typeset as ts
    2. let value = ts.LatinSpacing {
    3. minWordSpaceRatio: 0.8,
    4. maxWordSpaceRatio: 1.33,
    5. maxLetterSpacingEm: 0.01em,
    6. fontSizePt: 12pt
    7. }
    8. let relative: Length<Em> = value.maxLetterSpacingEm
    9. let physical: Length<Pt> = relative.resolve(value.fontSizePt)
    Expected outputexit 0
    No stdout.
    $ topaz check main.tpz --format json · target product 5.21.3
    Expected result

    Expected result

    Checking accepts the program. Exit code 0.

    No stderr.

    No stdout.

    This exact example has not been executed.

    Source evidence

    Resolve the stored spacing before converting to the computation grid

    Link

    run · running · Verification: not-run

    main.tpzResolve the stored spacing before converting to the computation gridOpen in Playground
    1. import std.typeset as ts
    2. import std.io
    3. let spacing = ts.LatinSpacing {
    4. minWordSpaceRatio: 0.8,
    5. maxWordSpaceRatio: 1.33,
    6. maxLetterSpacingEm: 0.01em,
    7. fontSizePt: 12pt
    8. }
    9. let limit = spacing.maxLetterSpacingEm.resolve(spacing.fontSizePt)
    10. let exact = limit == ts.fromScaledPoints(7860)
    11. let millipoints = limit.toMilliPoints()
    12. io.writeLine("{exact}|{millipoints}")
    Expected outputexit 0
    true|120
    $ topaz run main.tpz · target product 5.21.3
    Expected result

    Expected result

    Execution completes. Exit code 0.

    No stderr.

    Expected stdout
    1. true|120

    This exact example has not been executed.

    Source evidence

    Apply nearest-even rounding at each typed value boundary

    Link

    run · running · Verification: not-run

    main.tpzApply nearest-even rounding at each typed value boundaryOpen in Playground
    1. import std.typeset as ts
    2. import std.io
    3. let lowTie = (0.5em).resolve(ts.fromScaledPoints(3)) == ts.fromScaledPoints(2)
    4. let highTie = (0.5em).resolve(ts.fromScaledPoints(5)) == ts.fromScaledPoints(2)
    5. let literalGrid = (0.01em).resolve(12pt) == ts.fromScaledPoints(7860)
    6. let gridLow = (0.5em).resolve(0.125pt).toMilliPoints()
    7. let gridHigh = (0.5em).resolve(0.375pt).toMilliPoints()
    8. io.writeLine("{lowTie}|{highTie}|{literalGrid}|{gridLow}|{gridHigh}")
    Expected outputexit 0
    true|true|true|62|188
    $ topaz run main.tpz · target product 5.21.3
    Expected result

    Expected result

    Execution completes. Exit code 0.

    No stderr.

    Expected stdout
    1. true|true|true|62|188

    This exact example has not been executed.

    Source evidence

    Reject an untyped multiplier in the relative-length field

    Link

    reject · checking · Verification: not-run

    main.tpzReject an untyped multiplier in the relative-length fieldOpen in Playground
    1. import std.typeset as ts
    2. let spacing = ts.LatinSpacing {
    3. minWordSpaceRatio: 0.8,
    4. maxWordSpaceRatio: 1.33,
    5. maxLetterSpacingEm: 0.01,
    6. fontSizePt: 12pt
    7. }
    Expected outputNonzero exit
    No stdout.
    $ topaz check main.tpz --format json · target product 5.21.3
    Expected result

    Expected result

    Rejection during check. Nonzero exit.

    • TPZ5001 stdlib-relative-distance-requires-em at main.tpz:5:23

    No stdout.

    This exact example has not been executed.

    Source evidence

    Reject a physical length where an em length is required

    Link

    reject · checking · Verification: not-run

    main.tpzReject a physical length where an em length is requiredOpen in Playground
    1. import std.typeset as ts
    2. let spacing = ts.LatinSpacing {
    3. minWordSpaceRatio: 0.8,
    4. maxWordSpaceRatio: 1.33,
    5. maxLetterSpacingEm: 0.12pt,
    6. fontSizePt: 12pt
    7. }
    Expected outputNonzero exit
    No stdout.
    $ topaz check main.tpz --format json · target product 5.21.3
    Expected result

    Expected result

    Rejection during check. Nonzero exit.

    • TPZ5001 stdlib-relative-distance-requires-em at main.tpz:5:23

    No stdout.

    This exact example has not been executed.

    Source evidence

    Reject treating the stored relative length as a float

    Link

    reject · checking · Verification: not-run

    main.tpzReject treating the stored relative length as a floatOpen in Playground
    1. import std.typeset as ts
    2. function multiplier(value: ts.LatinSpacing) -> float {
    3. value.maxLetterSpacingEm
    4. }
    Expected outputNonzero exit
    No stdout.
    $ topaz check main.tpz --format json · target product 5.21.3
    Expected result

    Expected result

    Rejection during check. Nonzero exit.

    • TPZ5001 stdlib-relative-distance-is-not-float at main.tpz:3:3

    No stdout.

    This exact example has not been executed.

    Source evidence

    Admit the inclusive ratio and font bounds

    Link

    run · running · Verification: not-run

    main.tpzAdmit the inclusive ratio and font boundsOpen in Playground
    1. import std.typeset as ts
    2. import std.io
    4. function paragraph(grid: ts.DistanceGrid, spacing: Option<ts.LatinSpacing>) -> ts.Paragraph {
    5. ts.Paragraph {
    6. grid: grid,
    7. items: [
    8. ts.Item.BoxItem(ts.Box { unitIndex: 0, text: "abc", width: 10pt, trackingAfter: 0pt }),
    9. ts.Item.PenaltyItem(ts.Penalty {
    10. unitEnd: 1, width: 0pt, rule: ts.BreakRule.Forced(),
    11. kind: ts.BreakKind.ForcedEnd(), flagged: false
    12. })
    13. ],
    14. geometry: ts.LineGeometry {
    15. bodyTarget: 10pt, firstTarget: 10pt, dropCapSpan: 0, dropCapInset: 0pt
    16. },
    17. justification: ts.JustificationPolicy {
    18. mode: ts.JustificationMode.Unjustified(),
    19. minGapCount: 0, minLineWidthRatioM: 0, minFinalLineWidthRatioM: None(),
    20. maxAdjustment: 0pt, maxGapAdjustment: 0pt, maxGapRatioR: 0,
    21. latinSpacing: spacing, cjkStretchRatio: 0.0
    22. },
    23. costModel: ts.CostModel.FixedPoint(),
    24. knuthPlass: ts.KnuthPlassPolicy {
    25. toleranceR: 100000000, linePenalty: 10, fitnessDemerit: 0,
    26. flaggedDemerit: 0, finalFlaggedDemerit: 0
    27. }
    28. }
    29. }
    31. for value in ([ts.LatinSpacing { minWordSpaceRatio: 0.8, maxWordSpaceRatio: 1.0, maxLetterSpacingEm: 0em, fontSizePt: ts.fromScaledPoints(1) },
    32. ts.LatinSpacing { minWordSpaceRatio: 1.0, maxWordSpaceRatio: 1.33, maxLetterSpacingEm: 0.015em, fontSizePt: 12pt }]) {
    33. match (ts.breakParagraph(paragraph(ts.DistanceGrid.MilliPoint(), Some(value)))) {
    34. case Ok(_) => io.writeLine("valid policy")
    35. case Err(_) => io.writeLine("unexpected error")
    36. }
    37. }
    Expected outputexit 0
    valid policy
valid policy
    $ topaz run main.tpz · target product 5.21.3
    Expected result

    Expected result

    Execution completes. Exit code 0.

    No stderr.

    Expected stdout
    1. valid policy
    2. valid policy

    This exact example has not been executed.

    Source evidence

    Reject ratios just outside every allowed endpoint

    Link

    run · running · Verification: not-run

    main.tpzReject ratios just outside every allowed endpointOpen in Playground
    1. import std.typeset as ts
    2. import std.io
    4. function paragraph(grid: ts.DistanceGrid, spacing: Option<ts.LatinSpacing>) -> ts.Paragraph {
    5. ts.Paragraph {
    6. grid: grid,
    7. items: [
    8. ts.Item.BoxItem(ts.Box { unitIndex: 0, text: "abc", width: 10pt, trackingAfter: 0pt }),
    9. ts.Item.PenaltyItem(ts.Penalty {
    10. unitEnd: 1, width: 0pt, rule: ts.BreakRule.Forced(),
    11. kind: ts.BreakKind.ForcedEnd(), flagged: false
    12. })
    13. ],
    14. geometry: ts.LineGeometry {
    15. bodyTarget: 10pt, firstTarget: 10pt, dropCapSpan: 0, dropCapInset: 0pt
    16. },
    17. justification: ts.JustificationPolicy {
    18. mode: ts.JustificationMode.Unjustified(),
    19. minGapCount: 0, minLineWidthRatioM: 0, minFinalLineWidthRatioM: None(),
    20. maxAdjustment: 0pt, maxGapAdjustment: 0pt, maxGapRatioR: 0,
    21. latinSpacing: spacing, cjkStretchRatio: 0.0
    22. },
    23. costModel: ts.CostModel.FixedPoint(),
    24. knuthPlass: ts.KnuthPlassPolicy {
    25. toleranceR: 100000000, linePenalty: 10, fitnessDemerit: 0,
    26. flaggedDemerit: 0, finalFlaggedDemerit: 0
    27. }
    28. }
    29. }
    31. for value in ([ts.LatinSpacing { minWordSpaceRatio: 0.7999, maxWordSpaceRatio: 1.0, maxLetterSpacingEm: 0em, fontSizePt: 12pt },
    32. ts.LatinSpacing { minWordSpaceRatio: 1.0001, maxWordSpaceRatio: 1.0, maxLetterSpacingEm: 0em, fontSizePt: 12pt },
    33. ts.LatinSpacing { minWordSpaceRatio: 1.0, maxWordSpaceRatio: 0.9999, maxLetterSpacingEm: 0em, fontSizePt: 12pt },
    34. ts.LatinSpacing { minWordSpaceRatio: 1.0, maxWordSpaceRatio: 1.3301, maxLetterSpacingEm: 0em, fontSizePt: 12pt }]) {
    35. match (ts.breakParagraph(paragraph(ts.DistanceGrid.MilliPoint(), Some(value)))) {
    36. case Err(InvalidPolicy(_)) => io.writeLine("invalid ratio")
    37. case _ => io.writeLine("unexpected result")
    38. }
    39. }
    Expected outputexit 0
    invalid ratio
invalid ratio
invalid ratio
invalid ratio
    $ topaz run main.tpz · target product 5.21.3
    Expected result

    Expected result

    Execution completes. Exit code 0.

    No stderr.

    Expected stdout
    1. invalid ratio
    2. invalid ratio
    3. invalid ratio
    4. invalid ratio

    This exact example has not been executed.

    Source evidence

    Reject negative spacing and nonpositive fonts

    Link

    run · running · Verification: not-run

    main.tpzReject negative spacing and nonpositive fontsOpen in Playground
    1. import std.typeset as ts
    2. import std.io
    4. function paragraph(grid: ts.DistanceGrid, spacing: Option<ts.LatinSpacing>) -> ts.Paragraph {
    5. ts.Paragraph {
    6. grid: grid,
    7. items: [
    8. ts.Item.BoxItem(ts.Box { unitIndex: 0, text: "abc", width: 10pt, trackingAfter: 0pt }),
    9. ts.Item.PenaltyItem(ts.Penalty {
    10. unitEnd: 1, width: 0pt, rule: ts.BreakRule.Forced(),
    11. kind: ts.BreakKind.ForcedEnd(), flagged: false
    12. })
    13. ],
    14. geometry: ts.LineGeometry {
    15. bodyTarget: 10pt, firstTarget: 10pt, dropCapSpan: 0, dropCapInset: 0pt
    16. },
    17. justification: ts.JustificationPolicy {
    18. mode: ts.JustificationMode.Unjustified(),
    19. minGapCount: 0, minLineWidthRatioM: 0, minFinalLineWidthRatioM: None(),
    20. maxAdjustment: 0pt, maxGapAdjustment: 0pt, maxGapRatioR: 0,
    21. latinSpacing: spacing, cjkStretchRatio: 0.0
    22. },
    23. costModel: ts.CostModel.FixedPoint(),
    24. knuthPlass: ts.KnuthPlassPolicy {
    25. toleranceR: 100000000, linePenalty: 10, fitnessDemerit: 0,
    26. flaggedDemerit: 0, finalFlaggedDemerit: 0
    27. }
    28. }
    29. }
    31. for value in ([ts.LatinSpacing { minWordSpaceRatio: 1.0, maxWordSpaceRatio: 1.0, maxLetterSpacingEm: -0.0000152587890625em, fontSizePt: 12pt },
    32. ts.LatinSpacing { minWordSpaceRatio: 1.0, maxWordSpaceRatio: 1.0, maxLetterSpacingEm: 0.0150146484375em, fontSizePt: 12pt },
    33. ts.LatinSpacing { minWordSpaceRatio: 1.0, maxWordSpaceRatio: 1.0, maxLetterSpacingEm: 0em, fontSizePt: 0pt },
    34. ts.LatinSpacing { minWordSpaceRatio: 1.0, maxWordSpaceRatio: 1.0, maxLetterSpacingEm: 0em, fontSizePt: -12pt }]) {
    35. match (ts.breakParagraph(paragraph(ts.DistanceGrid.MilliPoint(), Some(value)))) {
    36. case Err(InvalidPolicy(_)) => io.writeLine("invalid length policy")
    37. case _ => io.writeLine("unexpected result")
    38. }
    39. }
    Expected outputexit 0
    invalid length policy
invalid length policy
invalid length policy
invalid length policy
    $ topaz run main.tpz · target product 5.21.3
    Expected result

    Expected result

    Execution completes. Exit code 0.

    No stderr.

    Expected stdout
    1. invalid length policy
    2. invalid length policy
    3. invalid length policy
    4. invalid length policy

    This exact example has not been executed.

    Source evidence

    Read a stored policy before paragraph validation

    Link

    run · running · Verification: not-run

    main.tpzRead a stored policy before paragraph validationOpen in Playground
    1. import std.typeset as ts
    2. import std.io
    3. let value = ts.LatinSpacing { minWordSpaceRatio: 0.0, maxWordSpaceRatio: 2.0, maxLetterSpacingEm: 1em, fontSizePt: 0pt }
    4. io.writeLine("{value.minWordSpaceRatio == 0.0}|{value.maxWordSpaceRatio == 2.0}|{value.maxLetterSpacingEm == 1em}|{value.fontSizePt == 0pt}")
    Expected outputexit 0
    true|true|true|true
    $ topaz run main.tpz · target product 5.21.3
    Expected result

    Expected result

    Execution completes. Exit code 0.

    No stderr.

    Expected stdout
    1. true|true|true|true

    This exact example has not been executed.

    Source evidence

    Fill a line using a rounded bound for every letter gap

    Link

    run · running · Verification: not-run

    main.tpzFill a line using a rounded bound for every letter gapOpen in Playground
    1. import std.typeset as ts
    2. import std.io
    4. import std.test
    6. function paragraph(grid: ts.DistanceGrid, spacing: Option<ts.LatinSpacing>) -> ts.Paragraph {
    7. ts.Paragraph {
    8. grid: grid,
    9. items: [
    10. ts.Item.BoxItem(ts.Box { unitIndex: 0, text: "a", width: 1pt, trackingAfter: 0pt }),
    11. ts.Item.BoxItem(ts.Box { unitIndex: 1, text: "b", width: 1pt, trackingAfter: 0pt }),
    12. ts.Item.BoxItem(ts.Box { unitIndex: 2, text: "c", width: 1pt, trackingAfter: 0pt }),
    13. ts.Item.PenaltyItem(ts.Penalty {
    14. unitEnd: 3, width: 0pt, rule: ts.BreakRule.Forced(),
    15. kind: ts.BreakKind.LatinSpace(), flagged: false
    16. }),
    17. ts.Item.BoxItem(ts.Box { unitIndex: 3, text: "xyz", width: 3.376pt, trackingAfter: 0pt }),
    18. ts.Item.PenaltyItem(ts.Penalty {
    19. unitEnd: 4, width: 0pt, rule: ts.BreakRule.Forced(),
    20. kind: ts.BreakKind.ForcedEnd(), flagged: false
    21. })
    22. ],
    23. geometry: ts.LineGeometry {
    24. bodyTarget: 3.376pt, firstTarget: 3.376pt, dropCapSpan: 0, dropCapInset: 0pt
    25. },
    26. justification: ts.JustificationPolicy {
    27. mode: ts.JustificationMode.LatinWordSpace(),
    28. minGapCount: 0, minLineWidthRatioM: 0, minFinalLineWidthRatioM: None(),
    29. maxAdjustment: 0pt, maxGapAdjustment: 0pt, maxGapRatioR: 0,
    30. latinSpacing: spacing, cjkStretchRatio: 0.0
    31. },
    32. costModel: ts.CostModel.FixedPoint(),
    33. knuthPlass: ts.KnuthPlassPolicy {
    34. toleranceR: 100000000, linePenalty: 10, fitnessDemerit: 0,
    35. flaggedDemerit: 0, finalFlaggedDemerit: 0
    36. }
    37. }
    38. }
    40. let value = ts.LatinSpacing { minWordSpaceRatio: 1.0, maxWordSpaceRatio: 1.0, maxLetterSpacingEm: 0.0078125em, fontSizePt: 24pt }
    41. let result = test.assertOk(ts.breakParagraph(paragraph(ts.DistanceGrid.MilliPoint(), Some(value))))
    42. let filled = match (result.optimized.boundedFillFeasible) {
    43. case Some(value) => value
    44. case None() => false
    45. }
    46. io.writeLine("{filled}|{result.optimized.lines.length}|{result.optimized.lines[0].target == 3.376pt}")
    Expected outputexit 0
    true|2|true
    $ topaz run main.tpz · target product 5.21.3
    Expected result

    Expected result

    Execution completes. Exit code 0.

    No stderr.

    Expected stdout
    1. true|2|true

    This exact example has not been executed.

    Source evidence

    Diagnostics

    Link

    TPZ5001

    Menu

    Download