# `Color.AppleRGB`

Apple RGB color space, using the Lindbloom Apple RGB working space
(primaries from the original Apple 13" RGB display, D65 reference
white) and simple gamma companding with `γ = 1.8`.

Apple RGB is a legacy working space from classic Mac OS — it
approximates the gamut of Apple's early colour displays. Most modern
work should use sRGB, Display P3, or Rec. 2020 instead; `Color.AppleRGB`
is primarily useful for reading or writing assets produced with legacy
Mac software.

Channels `r`, `g` and `b` are unit floats in the nominal range `[0, 1]`.

# `t`

```elixir
@type t() :: %Color.AppleRGB{
  alpha: number() | nil,
  b: number() | nil,
  g: number() | nil,
  r: number() | nil
}
```

# `from_xyz`

```elixir
@spec from_xyz(Color.XYZ.t()) :: {:ok, t()}
```

Converts a CIE `XYZ` color (assumed D65/2°) to Apple RGB.

### Arguments

* `xyz` is a `Color.XYZ` struct.

### Returns

* A `Color.AppleRGB` struct.

### Examples

    iex> xyz = %Color.XYZ{x: 0.95047, y: 1.0, z: 1.08883, illuminant: :D65, observer_angle: 2}
    iex> {:ok, apple} = Color.AppleRGB.from_xyz(xyz)
    iex> {Float.round(apple.r, 3), Float.round(apple.g, 3), Float.round(apple.b, 3)}
    {1.0, 1.0, 1.0}

# `to_xyz`

```elixir
@spec to_xyz(t()) :: {:ok, Color.XYZ.t()}
```

Converts an Apple RGB color to a CIE `XYZ` color.

### Arguments

* `apple` is a `Color.AppleRGB` struct with unit-range channels.

### Returns

* A `Color.XYZ` struct tagged with D65/2°, `Y ∈ [0, 1]`.

### Examples

    iex> {:ok, xyz} = Color.AppleRGB.to_xyz(%Color.AppleRGB{r: 1.0, g: 1.0, b: 1.0})
    iex> {Float.round(xyz.x, 4), Float.round(xyz.y, 4), Float.round(xyz.z, 4)}
    {0.9505, 1.0, 1.0888}

---

*Consult [api-reference.md](api-reference.md) for complete listing*