# DimensionBuilders

# DimensionBuilders

Artifact:[androidx.wear.protolayout:protolayout](https://developer.android.com/jetpack/androidx/releases/wear-protolayout)  
[View Source](https://cs.android.com/search?q=file:androidx/wear/protolayout/DimensionBuilders.java+class:androidx.wear.protolayout.DimensionBuilders)  
Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/wear-protolayout#1.0.0)

*** ** * ** ***

Kotlin\|[Java](https://developer.android.com/reference/androidx/wear/protolayout/DimensionBuilders "View this page in Java")

<br />

```
class DimensionBuilders
```

<br />

*** ** * ** ***

Builders for dimensions for layout elements.

## Summary

|                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         ### Nested types                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `@`[RequiresSchemaVersion](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/RequiresSchemaVersion)`(major = 1, minor = 500)` `interface `[DimensionBuilders.AngularDimension](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.AngularDimension) Interface defining the length of an arc element.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `@`[RequiresSchemaVersion](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/RequiresSchemaVersion)`(major = 1, minor = 200)` `class `[DimensionBuilders.AngularLayoutConstraint](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.AngularLayoutConstraint) A type for specifying layout constraints when using[DegreesProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.DegreesProp)on a data bindable layout element.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `class `[DimensionBuilders.AngularLayoutConstraint.Builder](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.AngularLayoutConstraint.Builder) Builder for[AngularLayoutConstraint](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.AngularLayoutConstraint).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `@`[RequiresSchemaVersion](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/RequiresSchemaVersion)`(major = 1, minor = 400)` `class `[DimensionBuilders.BoundingBoxRatio](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.BoundingBoxRatio)` : `[DimensionBuilders.PivotDimension](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.PivotDimension)`, `[DimensionBuilders.OffsetDimension](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.OffsetDimension) Provide a position representation proportional to the bounding box width/height.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `class `[DimensionBuilders.BoundingBoxRatio.Builder](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.BoundingBoxRatio.Builder) Builder for[BoundingBoxRatio](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.BoundingBoxRatio).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `@`[RequiresSchemaVersion](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/RequiresSchemaVersion)`(major = 1, minor = 0)` `interface `[DimensionBuilders.ContainerDimension](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.ContainerDimension) Interface defining a dimension that can be applied to a container.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `@`[RequiresSchemaVersion](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/RequiresSchemaVersion)`(major = 1, minor = 0)` `class `[DimensionBuilders.DegreesProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.DegreesProp)` : `[DimensionBuilders.AngularDimension](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.AngularDimension) A type for angular dimensions, measured in degrees.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `class `[DimensionBuilders.DegreesProp.Builder](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.DegreesProp.Builder) Builder for[DegreesProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.DegreesProp)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `@`[RequiresSchemaVersion](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/RequiresSchemaVersion)`(major = 1, minor = 0)` `class `[DimensionBuilders.DpProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.DpProp)` : `[DimensionBuilders.AngularDimension](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.AngularDimension)`, `[DimensionBuilders.ContainerDimension](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.ContainerDimension)`, `[DimensionBuilders.ImageDimension](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.ImageDimension)`, `[DimensionBuilders.SpacerDimension](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.SpacerDimension)`, `[DimensionBuilders.ExtensionDimension](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.ExtensionDimension)`, `[DimensionBuilders.PivotDimension](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.PivotDimension)`, `[DimensionBuilders.OffsetDimension](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.OffsetDimension) A type for linear dimensions, measured in dp. |
| `class `[DimensionBuilders.DpProp.Builder](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.DpProp.Builder) Builder for[DpProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.DpProp).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `@`[RequiresSchemaVersion](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/RequiresSchemaVersion)`(major = 1, minor = 0)` `class `[DimensionBuilders.EmProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.EmProp) A type for font spacing, measured in em.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `class `[DimensionBuilders.EmProp.Builder](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.EmProp.Builder) Builder for[EmProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.EmProp)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `@`[RequiresSchemaVersion](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/RequiresSchemaVersion)`(major = 1, minor = 0)` `class `[DimensionBuilders.ExpandedDimensionProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.ExpandedDimensionProp)` : `[DimensionBuilders.ContainerDimension](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.ContainerDimension)`, `[DimensionBuilders.ImageDimension](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.ImageDimension)`, `[DimensionBuilders.SpacerDimension](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.SpacerDimension) A type for a dimension that fills all the space it can (i.e. MATCH_PARENT in Android parlance).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `class `[DimensionBuilders.ExpandedDimensionProp.Builder](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.ExpandedDimensionProp.Builder) Builder for[ExpandedDimensionProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.ExpandedDimensionProp).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `@`[RequiresSchemaVersion](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/RequiresSchemaVersion)`(major = 1, minor = 0)` `@`[ExperimentalProtoLayoutExtensionApi](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/ExperimentalProtoLayoutExtensionApi) `interface `[DimensionBuilders.ExtensionDimension](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.ExtensionDimension) Interface defining a dimension that can be applied to a[androidx.wear.protolayout.LayoutElementBuilders.ExtensionLayoutElement](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/LayoutElementBuilders.ExtensionLayoutElement)element.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `@`[RequiresSchemaVersion](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/RequiresSchemaVersion)`(major = 1, minor = 200)` `class `[DimensionBuilders.HorizontalLayoutConstraint](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.HorizontalLayoutConstraint) A type for specifying horizontal layout constraints when using[DpProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.DpProp)on a data bindable layout element.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `class `[DimensionBuilders.HorizontalLayoutConstraint.Builder](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.HorizontalLayoutConstraint.Builder)` : `[DimensionBuilders.DpPropLayoutConstraint.Builder](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.DpPropLayoutConstraint.Builder) Builder for[HorizontalLayoutConstraint](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.HorizontalLayoutConstraint).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `@`[RequiresSchemaVersion](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/RequiresSchemaVersion)`(major = 1, minor = 0)` `interface `[DimensionBuilders.ImageDimension](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.ImageDimension) Interface defining a dimension that can be applied to an image.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `@`[RequiresSchemaVersion](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/RequiresSchemaVersion)`(major = 1, minor = 500)` `interface `[DimensionBuilders.OffsetDimension](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.OffsetDimension) Interface defining a dimension that represents an offset relative to the element's position.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `@`[RequiresSchemaVersion](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/RequiresSchemaVersion)`(major = 1, minor = 400)` `interface `[DimensionBuilders.PivotDimension](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.PivotDimension) Interface defining a dimension that can be applied to a pivot location for scale and rotate transformations.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `@`[RequiresSchemaVersion](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/RequiresSchemaVersion)`(major = 1, minor = 0)` `class `[DimensionBuilders.ProportionalDimensionProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.ProportionalDimensionProp)` : `[DimensionBuilders.ImageDimension](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.ImageDimension) A type for a dimension that scales itself proportionally to another dimension such that the aspect ratio defined by the given width and height values is preserved.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `class `[DimensionBuilders.ProportionalDimensionProp.Builder](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.ProportionalDimensionProp.Builder) Builder for[ProportionalDimensionProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.ProportionalDimensionProp).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `@`[RequiresSchemaVersion](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/RequiresSchemaVersion)`(major = 1, minor = 0)` `class `[DimensionBuilders.SpProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.SpProp) A type for font sizes, measured in sp.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `class `[DimensionBuilders.SpProp.Builder](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.SpProp.Builder) Builder for[SpProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.SpProp)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `@`[RequiresSchemaVersion](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/RequiresSchemaVersion)`(major = 1, minor = 0)` `interface `[DimensionBuilders.SpacerDimension](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.SpacerDimension) Interface defining a dimension that can be applied to a spacer.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `@`[RequiresSchemaVersion](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/RequiresSchemaVersion)`(major = 1, minor = 200)` `class `[DimensionBuilders.VerticalLayoutConstraint](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.VerticalLayoutConstraint) A type for specifying vertical layout constraints when using[DpProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.DpProp)on a data bindable layout element.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `class `[DimensionBuilders.VerticalLayoutConstraint.Builder](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.VerticalLayoutConstraint.Builder)` : `[DimensionBuilders.DpPropLayoutConstraint.Builder](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.DpPropLayoutConstraint.Builder) Builder for[VerticalLayoutConstraint](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.VerticalLayoutConstraint).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `@`[RequiresSchemaVersion](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/RequiresSchemaVersion)`(major = 1, minor = 0)` `class `[DimensionBuilders.WrappedDimensionProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.WrappedDimensionProp)` : `[DimensionBuilders.ContainerDimension](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.ContainerDimension) A type for a dimension that sizes itself to the size of its children (i.e. WRAP_CONTENT in Android parlance).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `class `[DimensionBuilders.WrappedDimensionProp.Builder](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.WrappedDimensionProp.Builder) Builder for[WrappedDimensionProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.WrappedDimensionProp).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |

|                                                                           ### Public functions                                                                            |
|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `java-static `[DimensionBuilders.DegreesProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.DegreesProp)                     | `@`[RequiresSchemaVersion](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/RequiresSchemaVersion)`(major = 1, minor = 0)` [degrees](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders#degrees(float))`(valueDegrees: `[Float](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html)`)` Shortcut for building an[DegreesProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.DegreesProp)using a measurement in degrees.                                                                                                                                      |
| `java-static `[DimensionBuilders.DpProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.DpProp)                               | `@`[RequiresSchemaVersion](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/RequiresSchemaVersion)`(major = 1, minor = 0)` [dp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders#dp(float))`(valueDp: @`[Dimension](https://developer.android.com/reference/kotlin/androidx/annotation/Dimension)`(unit = 0) `[Float](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html)`)` Shortcut for building a[DpProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.DpProp)using a measurement in DP.                                                              |
| `java-static `[DimensionBuilders.EmProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.EmProp)                               | `@`[RequiresSchemaVersion](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/RequiresSchemaVersion)`(major = 1, minor = 0)` [em](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders#em(float))`(valueEm: `[Float](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html)`)` Shortcut for building a[EmProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.EmProp)using a measurement in EM.                                                                                                                                                                     |
| `java-static `[DimensionBuilders.EmProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.EmProp)                               | `@`[RequiresSchemaVersion](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/RequiresSchemaVersion)`(major = 1, minor = 0)` [em](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders#em(int))`(valueEm: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`)` Shortcut for building a[EmProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.EmProp)using a measurement in EM.                                                                                                                                                                           |
| `java-static `[DimensionBuilders.ExpandedDimensionProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.ExpandedDimensionProp) | `@`[RequiresSchemaVersion](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/RequiresSchemaVersion)`(major = 1, minor = 0)` [expand](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders#expand())`()` Shortcut for building an[ExpandedDimensionProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.ExpandedDimensionProp)that will expand to the size of its parent.                                                                                                                                                                                                            |
| `java-static `[DimensionBuilders.SpProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.SpProp)                               | `@`[RequiresSchemaVersion](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/RequiresSchemaVersion)`(major = 1, minor = 0)` [sp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders#sp(float))`(valueSp: @`[Dimension](https://developer.android.com/reference/kotlin/androidx/annotation/Dimension)`(unit = 2) `[Float](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html)`)` Shortcut for building a[SpProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.SpProp)using a measurement in SP.                                                              |
| `java-static `[DimensionBuilders.ExpandedDimensionProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.ExpandedDimensionProp) | `@`[RequiresSchemaVersion](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/RequiresSchemaVersion)`(major = 1, minor = 300)` [weight](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders#weight(float))`(weight: @`[FloatRange](https://developer.android.com/reference/kotlin/androidx/annotation/FloatRange)`(from = 0.0) `[Float](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html)`)` Shortcut for building an[ExpandedDimensionProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.ExpandedDimensionProp)with weight (a dimensionless scalar value). |
| `java-static `[DimensionBuilders.WrappedDimensionProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.WrappedDimensionProp)   | `@`[RequiresSchemaVersion](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/RequiresSchemaVersion)`(major = 1, minor = 0)` [wrap](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders#wrap())`()` Shortcut for building an[WrappedDimensionProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.WrappedDimensionProp)that will shrink to the size of its children.                                                                                                                                                                                                                |

## Public functions

### degrees

Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/wear-protolayout#1.0.0)  

```
@RequiresSchemaVersion(major = 1, minor = 0)
java-static fun degrees(valueDegrees: Float): DimensionBuilders.DegreesProp
```

Shortcut for building an[DegreesProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.DegreesProp)using a measurement in degrees.  

### dp

Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/wear-protolayout#1.0.0)  

```
@RequiresSchemaVersion(major = 1, minor = 0)
java-static fun dp(valueDp: @Dimension(unit = 0) Float): DimensionBuilders.DpProp
```

Shortcut for building a[DpProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.DpProp)using a measurement in DP.  

### em

Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/wear-protolayout#1.0.0)  

```
@RequiresSchemaVersion(major = 1, minor = 0)
java-static fun em(valueEm: Float): DimensionBuilders.EmProp
```

Shortcut for building a[EmProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.EmProp)using a measurement in EM.  

### em

Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/wear-protolayout#1.0.0)  

```
@RequiresSchemaVersion(major = 1, minor = 0)
java-static fun em(valueEm: Int): DimensionBuilders.EmProp
```

Shortcut for building a[EmProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.EmProp)using a measurement in EM.  

### expand

Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/wear-protolayout#1.0.0)  

```
@RequiresSchemaVersion(major = 1, minor = 0)
java-static fun expand(): DimensionBuilders.ExpandedDimensionProp
```

Shortcut for building an[ExpandedDimensionProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.ExpandedDimensionProp)that will expand to the size of its parent.  

### sp

Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/wear-protolayout#1.0.0)  

```
@RequiresSchemaVersion(major = 1, minor = 0)
java-static fun sp(valueSp: @Dimension(unit = 2) Float): DimensionBuilders.SpProp
```

Shortcut for building a[SpProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.SpProp)using a measurement in SP.  

### weight

Added in[1.1.0](https://developer.android.com/jetpack/androidx/releases/wear-protolayout#1.1.0)  

```
@RequiresSchemaVersion(major = 1, minor = 300)
java-static fun weight(weight: @FloatRange(from = 0.0) Float): DimensionBuilders.ExpandedDimensionProp
```

Shortcut for building an[ExpandedDimensionProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.ExpandedDimensionProp)with weight (a dimensionless scalar value).

This will only affect the width of children of a[androidx.wear.protolayout.LayoutElementBuilders.Row](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/LayoutElementBuilders.Row)or the height of children of a[androidx.wear.protolayout.LayoutElementBuilders.Column](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/LayoutElementBuilders.Column), otherwise it will expand to the size of its parent. Where applicable, the remaining space in the width or height left from the children with fixed or wrapped dimension will be proportionally split across children with expand dimension, meaning that the width or height of the element is proportional to the sum of the weights of its weighted siblings. For the siblings that don't have weight set, but they are expanded, defaults to 1.  

### wrap

Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/wear-protolayout#1.0.0)  

```
@RequiresSchemaVersion(major = 1, minor = 0)
java-static fun wrap(): DimensionBuilders.WrappedDimensionProp
```

Shortcut for building an[WrappedDimensionProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/DimensionBuilders.WrappedDimensionProp)that will shrink to the size of its children.