// SPDX-License-Identifier: Unlicense OR MIT /* Package unit implements device independent units and values. A Value is a value with a Unit attached. Device independent pixel, or dp, is the unit for sizes independent of the underlying display device. Scaled pixels, or sp, is the unit for text sizes. An sp is like dp with text scaling applied. Finally, pixels, or px, is the unit for display dependent pixels. Their size vary between platforms and displays. To maintain a constant visual size across platforms and displays, always use dps or sps to define user interfaces. Only use pixels for derived values. */ package unit import ( "fmt" "math" ) // Value is a value with a unit. type Value struct { V float32 U Unit } // Unit represents a unit for a Value. type Unit uint8 // Metric converts Values to device-dependent pixels, px. The zero // value represents a 1-to-1 scale from dp, sp to pixels. type Metric struct { // PxPerDp is the device-dependent pixels per dp. PxPerDp float32 // PxPerSp is the device-dependent pixels per sp. PxPerSp float32 } const ( // UnitPx represent device pixels in the resolution of // the underlying display. UnitPx Unit = iota // UnitDp represents device independent pixels. 1 dp will // have the same apparent size across platforms and // display resolutions. UnitDp // UnitSp is like UnitDp but for font sizes. UnitSp ) // Px returns the Value for v device pixels. func Px(v float32) Value { return Value{V: v, U: UnitPx} } // Dp returns the Value for v device independent // pixels. func Dp(v float32) Value { return Value{V: v, U: UnitDp} } // Sp returns the Value for v scaled dps. func Sp(v float32) Value { return Value{V: v, U: UnitSp} } // Scale returns the value scaled by s. func (v Value) Scale(s float32) Value { v.V *= s return v } func (v Value) String() string { return fmt.Sprintf("%g%s", v.V, v.U) } func (u Unit) String() string { switch u { case UnitPx: return "px" case UnitDp: return "dp" case UnitSp: return "sp" default: panic("unknown unit") } } // Add a list of Values. func Add(c Metric, values ...Value) Value { var sum Value for _, v := range values { sum, v = compatible(c, sum, v) sum.V += v.V } return sum } // Max returns the maximum of a list of Values. func Max(c Metric, values ...Value) Value { var max Value for _, v := range values { max, v = compatible(c, max, v) if v.V > max.V { max.V = v.V } } return max } func (c Metric) Px(v Value) int { var r float32 switch v.U { case UnitPx: r = v.V case UnitDp: s := c.PxPerDp if s == 0 { s = 1 } r = s * v.V case UnitSp: s := c.PxPerSp if s == 0 { s = 1 } r = s * v.V default: panic("unknown unit") } return int(math.Round(float64(r))) } func compatible(c Metric, v1, v2 Value) (Value, Value) { if v1.U == v2.U { return v1, v2 } if v1.V == 0 { v1.U = v2.U return v1, v2 } if v2.V == 0 { v2.U = v1.U return v1, v2 } return Px(float32(c.Px(v1))), Px(float32(c.Px(v2))) }