Android
```kotlin
public value class Meter(public val value: Float) : Comparable
```
Represents a dimension value in meters within 3D space.
This is the standard unit used by the system for representing size and distance in 3D
environments.
## Functions
plus
```kotlin
public inline operator fun plus(other: Meter): Meter
```
Adds another [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) value to this one.
#### Parameters
| | |
| --- | --- |
| other | the [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) value to add. |
#### Returns
| | |
| --- | --- |
| | a new [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) representing the sum of the two values. |
minus
```kotlin
public inline operator fun minus(other: Meter): Meter
```
Subtracts another [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) value from this one.
#### Parameters
| | |
| --- | --- |
| other | the [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) value to subtract. |
#### Returns
| | |
| --- | --- |
| | a new [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) representing the difference between the two values. |
times
```kotlin
public inline operator fun times(other: Int): Meter
```
Multiplies this [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) value by an `Int` factor.
#### Parameters
| | |
| --- | --- |
| other | the integer factor to multiply by. |
#### Returns
| | |
| --- | --- |
| | a new [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) representing the product. |
times
```kotlin
public inline operator fun times(other: Float): Meter
```
Multiplies this [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) value by a `Float` factor.
#### Parameters
| | |
| --- | --- |
| other | the float factor to multiply by. |
#### Returns
| | |
| --- | --- |
| | a new [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) representing the product. |
times
```kotlin
public inline operator fun times(other: Double): Meter
```
Multiplies this [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) value by a `Double` factor.
#### Parameters
| | |
| --- | --- |
| other | the double factor to multiply by. |
#### Returns
| | |
| --- | --- |
| | a new [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) representing the product. |
div
```kotlin
public inline operator fun div(other: Int): Meter
```
Divides this [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) value by an `Int` factor.
#### Parameters
| | |
| --- | --- |
| other | the `Int` factor to divide by. |
#### Returns
| | |
| --- | --- |
| | a new [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) representing the quotient. |
div
```kotlin
public inline operator fun div(other: Float): Meter
```
Divides this [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) value by a `Float` factor.
#### Parameters
| | |
| --- | --- |
| other | the `Float` factor to divide by. |
#### Returns
| | |
| --- | --- |
| | a new [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) representing the quotient. |
div
```kotlin
public inline operator fun div(other: Double): Meter
```
Divides this [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) value by a `Double` factor.
#### Parameters
| | |
| --- | --- |
| other | the `Double` factor to divide by. |
#### Returns
| | |
| --- | --- |
| | a new [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) representing the quotient. |
toMm
```kotlin
public inline fun toMm(): Float
```
Converts this [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) value to `Float` millimeters.
#### Returns
| | |
| --- | --- |
| | the equivalent value in millimeters as a `Float`. |
toCm
```kotlin
public inline fun toCm(): Float
```
Converts this [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) value to `Float` centimeters.
#### Returns
| | |
| --- | --- |
| | the equivalent value in centimeters as a `Float`. |
toM
```kotlin
public inline fun toM(): Float
```
Converts this [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) value to `Float` meters.
#### Returns
| | |
| --- | --- |
| | the equivalent value in meters as a `Float`. |
toPx
```kotlin
public inline fun toPx(density: Density): Float
```
Converts this [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) value to an approximate number of pixels it contains.
#### Returns
| | |
| --- | --- |
| | the approximate equivalent value in pixels as a `Float`. |
roundToPx
```kotlin
public inline fun roundToPx(density: Density): Int
```
Converts this [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) value to the nearest `Int` number of pixels, taking into account
[density](/jetpack-compose/androidx.compose.ui/ui-unit/interfaces/Density).
#### Returns
| | |
| --- | --- |
| | the rounded equivalent value in pixels as an `Int`. |
toDp
```kotlin
public inline fun toDp(): Dp
```
Converts this [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) value to the [Dp](/jetpack-compose/androidx.compose.ui/ui-unit/classes/Dp) number of density-independent pixels it contains.
#### Returns
| | |
| --- | --- |
| | the equivalent value in [Dp](/jetpack-compose/androidx.compose.ui/ui-unit/classes/Dp). |
## Companion Object
#### Properties
Android
```kotlin
public val Infinity: Meter
```
Represents an infinite distance in meters.
Android
```kotlin
public val NaN: Meter
```
Represents an undefined or unrepresentable distance in meters.
Android
```kotlin
public val Int.millimeters: Meter
```
Creates a [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) from the `Int` millimeter value.
Android
```kotlin
public val Float.millimeters: Meter
```
Creates a [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) from the `Float` millimeter value.
Android
```kotlin
public val Double.millimeters: Meter
```
Creates a [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) from the `Double` millimeter value.
Android
```kotlin
public val Int.centimeters: Meter
```
Creates a [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) from the `Int` centimeter value.
Android
```kotlin
public val Float.centimeters: Meter
```
Creates a [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) from the `Float` centimeter value.
Android
```kotlin
public val Double.centimeters: Meter
```
Creates a [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) from the `Double` centimeter value.
Android
```kotlin
public val Int.meters: Meter
```
Creates a [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) from the `Int` meter value.
Android
```kotlin
public val Float.meters: Meter
```
Creates a [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) from the `Float` meter value.
Android
```kotlin
public val Double.meters: Meter
```
Creates a [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) from the `Double` meter value.
#### Methods
fromPixel
Android
```kotlin
public inline fun fromPixel(px: Float, density: Density): Meter
```
Creates a [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) value from a given number of pixels.
#### Parameters
| | |
| --- | --- |
| px | the number of pixels. |
| density | The pixel density of the display. |
#### Returns
| | |
| --- | --- |
| | a [Meter](/jetpack-compose/androidx.xr.compose/compose/classes/Meter) value representing the equivalent distance in meters. |