Specs

complementary_color(t()) :: t()

Calculates the complementary of the given RGB color.

Example

iex> Tint.RGB.complementary_color(%Tint.RGB{red: 255, green: 0, blue: 0})
#Tint.RGB<0,255,255 (#00FFFF)>

Specs

euclidean_distance(Tint.color(), Tint.color(), Keyword.t()) :: float()

Calculates the Euclidean distance of two colors.

Options

• :weights - A tuple defining the weights for the red, green and blue color channels. Defaults to {1, 1, 1}.

Specs

from_hex(String.t()) :: {:ok, t()} | :error

Builds a new RGB color from the given hex code.

Examples

iex> Tint.RGB.from_hex("#FF7F1E")
{:ok, %Tint.RGB{red: 255, green: 127, blue: 30}}

iex> Tint.RGB.from_hex("F00")
{:ok, %Tint.RGB{red: 255, green: 0, blue: 0}}

iex> Tint.RGB.from_hex("invalid")
:error

Specs

from_hex!(String.t()) :: t() | no_return()

Builds a new RGB color from the given hex code. Raises when the given hex code is invalid.

Examples

iex> Tint.RGB.from_hex!("#FF7F1E")
#Tint.RGB<255,127,30 (#FF7F1E)>

iex> Tint.RGB.from_hex!("invalid")
** (ArgumentError) Invalid hex code: invalid

Specs

from_ratios(number() | String.t(), number() | String.t(), number() | String.t()) ::
  t()

Builds a new RGB color from red, green and blue color ratios.

Example

iex> Tint.RGB.from_ratios(1, 0.5, 0)
#Tint.RGB<255,128,0 (#FF8000)>

Specs

from_tuple(
  {number() | String.t(), number() | String.t(), number() | String.t()}
) :: t()

Converts a tuple containing hue, saturation and value into a Tint.RGB struct.

Example

iex> Tint.RGB.from_tuple({255, 127, 30})
#Tint.RGB<255,127,30 (#FF7F1E)>

Specs

grayish?(t(), non_neg_integer()) :: boolean()

Determines whether the given color is grayish based on the distance of the red, green an blue channels of the color.

Additionally, you have to specify a tolerance that defines how far the min and the max channels may be apart from each other. A tolerance of 0 means that the color has to be an exact grayscale color. A tolerance of 255 means that any color is regarded gray.

Specs

grayscale?(t()) :: boolean()

Determines whether the given color is a grayscale color which basically means that the red, green and blue channels of the color have the same value.

Specs

nearest_color(Tint.color(), [Tint.color()], Tint.Distance.distance_algorithm()) ::
  nil | Tint.color()

Finds the nearest color for the specified color using the given color palette and an optional distance algorithm.

Specs

nearest_colors(
  Tint.color(),
  [Tint.color()],
  non_neg_integer(),
  Tint.Distance.distance_algorithm()
) :: [Tint.color()]

Finds the n nearest colors for the specified color using the given color palette and an optional distance algorithm.

Specs

new(number() | String.t(), number() | String.t(), number() | String.t()) :: t()

Builds a new RGB color from red, green and blue color parts. Please always use this function to build a new RGB color.

Examples

iex> Tint.RGB.new(0, 0, 0)
#Tint.RGB<0,0,0 (#000000)>

iex> Tint.RGB.new(255, 127, 30)
#Tint.RGB<255,127,30 (#FF7F1E)>

iex> Tint.RGB.new(256, -1, 0)
** (Tint.OutOfRangeError) Value 256 is out of range [0,255]

Specs

to_hex(t()) :: String.t()

Converts a RGB color to a hex code.

Example

iex> Tint.RGB.to_hex(%Tint.RGB{red: 255, green: 127, blue: 30})
"#FF7F1E"

Specs

to_ratios(t()) :: {float(), float(), float()}

Builds a tuple containing the ratios of the red, green and blue components of a given color.

Specs

to_tuple(t()) :: {non_neg_integer(), non_neg_integer(), non_neg_integer()}

Converts a RGB color into a tuple containing the red, green and blue channels.

Example

iex> Tint.RGB.to_tuple(%Tint.RGB{red: 255, green: 127, blue: 30})
{255, 127, 30}