Back to

package unit

v0.0.0 (278e9bc)
Latest Go to latest
Published: Jun 3, 2020 | Licenses: MIT, Unlicense | Module:


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.


type Converter

type Converter interface {
	Px(v Value) int

Converter converts Values to pixels.

type Unit

type Unit uint8

Unit represents a unit for a Value.

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.
	// UnitSp is like UnitDp but for font sizes.

func (Unit) String

func (u Unit) String() string

type Value

type Value struct {
	V float32
	U Unit

Value is a value with a unit.

func Add

func Add(c Converter, values ...Value) Value

Add a list of Values.

func Dp

func Dp(v float32) Value

Dp returns the Value for v device independent pixels.

func Max

func Max(c Converter, values ...Value) Value

Max returns the maximum of a list of Values.

func Px

func Px(v float32) Value

Px returns the Value for v device pixels.

func Sp

func Sp(v float32) Value

Sp returns the Value for v scaled dps.

func (Value) Scale

func (v Value) Scale(s float32) Value

Scale returns the value scaled by s.

func (Value) String

func (v Value) String() string
Documentation was rendered with GOOS=linux and GOARCH=amd64.

Jump to identifier

Keyboard shortcuts

? : This menu
f or F : Jump to identifier