# .normalizedHue and .rounded(to:)

Wrap any angle into 0° to 360° and round numbers the way the library stores every hue.

Keep hues you compute in range with `normalizedHue`: it wraps any angle into 0° to 360° and rounds it to 0.01°, the way the library stores every hue. `rounded(to:)` rounds a number to the decimal places you pass:

```swift
let brandHue = 166.99
let oppositeHue = (brandHue + 180).normalizedHue   // 346.99
let backHue = (-30.0).normalizedHue                // 330
let shortHue = 166.98765.rounded(to: 2)            // 166.99
```

## Comparing hues

The library stores hues this way, so compare a hue you computed with one you read only after normalizing it:

```swift
let hue = Color(hex: "#00B386").toOKLCH().h   // 166.99
hue == (166.99 + 360).normalizedHue           // true
```

You don't need it for values you pass in: `OKLCHColor`, `LCHColor` and the ramp generator wrap hues themselves, so `OKLCHColor(l: 0.5, c: 0.1, h: 370).h` is `10`.

## How it behaves

Both work on `Double` and `CGFloat`. `normalizedHue` turns 360 into 0. `rounded(to:)` rounds halves away from zero, so `0.125.rounded(to: 2)` is `0.13`.

## API

```swift
public extension Double {   // and CGFloat
    var normalizedHue: Double { get }         // wrapped to 0 to 360, rounded to 0.01°
    func rounded(to places: Int) -> Double
}
```

| Parameter | Type  | What it does            |
| --------- | ----- | ----------------------- |
| `places`  | `Int` | Decimal places to keep. |

`normalizedHue` returns the angle in 0 to 360; `rounded(to:)` returns the number rounded to `places` decimal places.

## Sources

- [Double+Ext.swift](https://github.com/metasidd/ColorTokensKit-Swift/blob/main/Sources/ColorTokensKit/Utils/Double+Ext.swift) and [CGFloat+Ext.swift](https://github.com/metasidd/ColorTokensKit-Swift/blob/main/Sources/ColorTokensKit/Utils/CGFloat+Ext.swift), which define both.

## See also

- [.toOKLCH()](https://colortokenskit.com/api/to-oklch/index.md): Read a color's lightness, chroma and hue the way the palette sees them, to compare or adjust it.
- [ProTheme](https://colortokenskit.com/api/protheme/index.md): Make a theme from a hex, a hue or OKLCH numbers, and every stop and token keeps its contrast.
- [.rotateHue(by:)](https://colortokenskit.com/api/rotate-hue/index.md): Make an accent or a whole second theme from your brand color, at the same lightness.
- [.lerp(\_:t:)](https://colortokenskit.com/api/lerp/index.md): Find the color partway between two others, for your own blends, chart scales or animations.

---

From ColorTokensKit, by Penguin Design Ventures: https://colortokenskit.com/api/normalized-hue/ (updated September 26, 2026).