public class SpreadValues(
public val left: Dp = 0.dp,
public val top: Dp = 0.dp,
public val right: Dp = 0.dp,
public val bottom: Dp = 0.dp,
)
Per-edge Dp spread applied to a text range's bounding boxes during the draw phase.
Spread applies to the per-line boxes returned by TextLayoutResult.getBoundingBoxesForRange, rather than to each glyph individually:
- Neighboring characters on the same line whose horizontal bounds touch or overlap are merged
- Multi-line ranges and bidirectional text ranges that split into separate visual runs on the
into a single box spanning the line's `top, bottom`.
same line produce one box per run.
By default (SpreadValues.Zero), each box spans the full line height (`top, bottom) and fits tightly around the glyphs horizontally. Configure BackgroundAnnotation.spread with SpreadValues` to adjust those bounds at draw time without shifting text layout:
- Positive horizontal spread (for example,
SpreadValues(horizontal = 4.dp)) expands the - Negative vertical spread (for example,
SpreadValues(vertical = (-2).dp)): when - Positive vertical spread expands the top and bottom edges outward past the line bounds (on
left and right edges outward to add space between the first or last glyph and a pill's border or rounded corners. If horizontal expansion causes two separate boxes on the same line to touch or overlap, they are merged into a single box.
BackgroundAnnotation.mergeLines is false, shrinks each per-line box's top and bottom edges inward from the line bounds so pills on consecutive lines have a vertical gap instead of touching; when BackgroundAnnotation.mergeLines is true, shrinks only the outer top of the first line and outer bottom of the last line of each merged stack while inner line seams remain joined as a continuous contour.
each per-line box when mergeLines = false, or on the outer top and bottom of each merged stack when mergeLines = true).
If negative spread values reduce a box's width or height (or a merged line stack's height) to <= 0, that box or stack is omitted and not drawn.
Functions
equals
override fun equals(other: Any?): Boolean
Creates SpreadValues with all four edges spread by the same amount.
hashCode
override fun hashCode(): Int
Members
Companion
public companion object
Properties
Zero
public val Zero: SpreadValues = SpreadValues(0.dp, 0.dp, 0.dp, 0.dp)
A SpreadValues with 0.dp spread on all four edges.