Class: Unmagic::Color::RGB::Hex

Inherits:
Object
  • Object
show all
Defined in:
lib/unmagic/color/rgb/hex.rb

Overview

Hexadecimal color parsing utilities.

Hex colors are a compact way to write Unmagic::Color::RGB values using hexadecimal (base-16) notation. Each pair of hex digits represents one color component (‘0-255`).

## Understanding Hexadecimal

Hexadecimal uses 16 digits: ‘0-9` and `A-F`

  • ‘0 = 0`, `9 = 9`, `A = 10`, `B = 11`, … `F = 15`

  • Two hex digits can represent ‘0-255` (`16 × 16 = 256` values)

  • ‘FF = 255`, `00 = 0`, `80 = 128`, etc.

## Hex Color Format

  • **Full format**: ‘#RRGGBB` (6 digits, 2 per component)

  • **Short format**: ‘#RGB` (3 digits, each digit is doubled)

  • **Hash optional**: Can be written with or without the ‘#` prefix

## Examples

  • ‘#FF0000` = Red (`255, 0, 0`)

  • ‘#00FF00` = Green (`0, 255, 0`)

  • ‘#0000FF` = Blue (`0, 0, 255`)

  • ‘#F00` = `#FF0000` (short form)

  • ‘#ABC` = `#AABBCC` (short form expanded)

Defined Under Namespace

Classes: ParseError

Class Method Summary collapse

Class Method Details

.parse(input) ⇒ RGB

Parse a hexadecimal color string.

Accepts both full (6-digit) and short (3-digit) hex formats, with or without the # prefix.

Examples:

Full format with hash

Unmagic::Color::RGB::Hex.parse("#FF8800")

Short format without hash

Unmagic::Color::RGB::Hex.parse("F80")

Parameters:

  • input (String) —

    The hex color string to parse

Returns:

  • (RGB) —

    The parsed RGB color

Raises:

  • (ParseError) —

    If the input is not a valid hex color



72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
 
# File 'lib/unmagic/color/rgb/hex.rb', line 72

def parse(input)
  raise ParseError, "Input must be a string" unless input.is_a?(::String)

  # Clean up the input
  hex = input.strip.gsub(/^#/, "")

  # Check for valid length (3 or 6 characters)
  unless hex.length == 3 || hex.length == 6
    raise ParseError, "Invalid number of characters (got #{hex.length}, expected 3 or 6)"
  end

  # Check if all characters are valid hex digits
  unless hex.match?(/\A[0-9A-Fa-f]+\z/)
    invalid_chars = hex.chars.reject { |c| c.match?(/[0-9A-Fa-f]/) }
    raise ParseError, "Invalid hex characters: #{invalid_chars.join(", ")}"
  end

  # Handle 3-character hex codes
  if hex.length == 3
    hex = hex.chars.map { |c| c * 2 }.join
  end

  r = hex[0..1].to_i(16)
  g = hex[2..3].to_i(16)
  b = hex[4..5].to_i(16)

  RGB.new(red: r, green: g, blue: b)
end

.valid?(value) ⇒ Boolean

Check if a string is a valid hex color.

Examples:

Unmagic::Color::RGB::Hex.valid?("#FF5733")
# => true

Unmagic::Color::RGB::Hex.valid?("F73")
# => true

Unmagic::Color::RGB::Hex.valid?("GGGGGG")
# => false

Parameters:

  • value (String) —

    The string to validate

Returns:

  • (Boolean) —

    true if valid hex color, false otherwise



51
52
53
54
55
56
 
# File 'lib/unmagic/color/rgb/hex.rb', line 51

def valid?(value)
  parse(value)
  true
rescue ParseError
  false
end