redgreenblue 0.18.0 → 0.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d7bd0c8570ea98fb428ff9b0213cbdbcfb406a7ec93174e71152b367221091a8
-  data.tar.gz: 802d9d4c8fba0af75a7d1095f24ae81f23d5e5338674b68a69ba0b023cd092bb
+  metadata.gz: c8ae59f94eaf3e3cfb8fd8610b95d8f14cc05f9902e565b0cc587ad03e560bc1
+  data.tar.gz: f34de8f1025a07deb03c6de996f2875cc3d72212151432dcbb811fbfe5093fd7
 SHA512:
-  metadata.gz: e8af18bacea35e6b732330b7d0a9d907ed90d41951c932307474bffef02e8d6965230441c2322d188314d4280ebbe678b0e56780ede151b5e0a61db2f1f41dc0
-  data.tar.gz: 6b749f770956cada8c6e7fa82c5ec8255ee6081ee98746bac71182572fd5d67ae83c069db4798b2b920c3d5d01c4e39c0cf1ad5b16e5c92a7ae9956d97923f90
+  metadata.gz: eece5011d8efd21b6fd22eea58de73b2cb070f34093085049b61c847c8c88f462e4b79465222060bee5398cd5c7c5c80a9d3fb682c68dacaba017c8e6ca1a47c
+  data.tar.gz: 54eac4f2defd4841e5057c91308e0479ccb03a29d0645b9e0a6603d3ec479cdd96ac2369496d401d77a10dedb816d93f0cb6464edc95e6a76a2228535971ef29

data/lib/redgreenblue/base.rb

@@ -1,90 +1,89 @@
-class RGB::Color
+module RGB
 
-  def initialize(*a)
-    self.values = a.any? ? a : [ 0.5, 0.5, 0.5 ]
-  end
+  class Color
 
-  # Returns the color space.
-  #
-  # Currently always 'sRGB'.
-  def color_space
-    'sRGB'
-  end
+    def initialize(*a)
+      self.values = a.any? ? a : [ 0.5, 0.5, 0.5 ]
+    end
 
-  # Returns the red component as a value between 0 and 1.
-  def red
-    @red
-  end
+    # Returns the color space.
+    #
+    # Currently always 'sRGB'.
+    def color_space
+      'sRGB'
+    end
 
-  # Returns the green component as a value between 0 and 1.
-  def green
-    @green
-  end
+    # Returns the red component as a value between 0 and 1.
+    def red
+      @red
+    end
 
-  # Returns the blue component as a value between 0 and 1.
-  def blue
-    @blue
-  end
+    # Returns the green component as a value between 0 and 1.
+    def green
+      @green
+    end
 
-  # Sets the red component to a value between 0 and 1.
-  #
-  # Values outside the range 0..1 will be clipped.
-  def red=(value)
-    @red = limit(value)
-  end
+    # Returns the blue component as a value between 0 and 1.
+    def blue
+      @blue
+    end
 
-  # Sets the green component to a value between 0 and 1.
-  #
-  # Values outside the range 0..1 will be clipped.
-  def green=(value)
-    @green = limit(value)
-  end
+    # Sets the red component to a value between 0 and 1.
+    #
+    # Values outside the range 0..1 will be clipped.
+    def red=(value)
+      @red = limit(value)
+    end
 
-  # Sets the blue component to a value between 0 and 1.
-  #
-  # Values outside the range 0..1 will be clipped.
-  def blue=(value)
-    @blue = limit(value)
-  end
+    # Sets the green component to a value between 0 and 1.
+    #
+    # Values outside the range 0..1 will be clipped.
+    def green=(value)
+      @green = limit(value)
+    end
 
-  # Returns the red, green, and blue components as three values between 0 and 1.
-  def values
-    [ red, green, blue ]
-  end
+    # Sets the blue component to a value between 0 and 1.
+    #
+    # Values outside the range 0..1 will be clipped.
+    def blue=(value)
+      @blue = limit(value)
+    end
 
-  alias to_a values
+    # Returns the red, green, and blue components as three values between 0 and 1.
+    def values
+      [ red, green, blue ]
+    end
 
-  # Sets the red, green, and blue components using three values between 0 and 1.
-  #
-  # Values outside the range 0..1 will be clipped.
-  def values=(*a)
-    self.red, self.green, self.blue = a.flatten
-  end
+    alias to_a values
 
-  # Returns true if this object and another object represent exactly the same color. Otherwise returns false.
-  def ==(other)
-    ( self.class == other.class ) && ( self.values == other.values )
-  end
+    # Sets the red, green, and blue components using three values between 0 and 1.
+    #
+    # Values outside the range 0..1 will be clipped.
+    def values=(*a)
+      self.red, self.green, self.blue = a.flatten
+    end
 
-  # Returns a sorted hash of 3 key/value pairs for red, green, and blue,
-  # sorted in order of decreasing value.
-  def to_h
-    ([:red, :green, :blue].zip values).sort_by {
-      |k,v| [-v,[:red, :green, :blue].index(k)]
-    }.to_h
-  end
+    # Returns true if this object and another object represent exactly the same color. Otherwise returns false.
+    def ==(other)
+      ( self.class == other.class ) && ( self.values == other.values )
+    end
 
-  private
+    # Returns a sorted hash of 3 key/value pairs for red, green, and blue,
+    # sorted in order of decreasing value.
+    def to_h
+      ([:red, :green, :blue].zip values).sort_by {
+        |k,v| [-v,[:red, :green, :blue].index(k)]
+      }.to_h
+    end
 
-  # limits to range 0..1
-  def limit(n)
-    n <= 0 ? 0.0 : n >= 1 ? 1.0 : n
-  end
+    private
 
-end
+    # limits to range 0..1
+    def limit(n)
+      n <= 0 ? 0.0 : n >= 1 ? 1.0 : n
+    end
 
-# The main namespace for redgreenblue.
-module RGB
+  end
 
   class << self
 

data/lib/redgreenblue/version.rb

@@ -1,7 +1,7 @@
 module RGB
 
   # redgreenblue version.
-  VERSION = '0.18.0'
+  VERSION = '0.19.0'
 
   # Returns RGB::VERSION.
   def self.version

data/lib/redgreenblue/yuv.rb

@@ -0,0 +1,24 @@
+require 'redgreenblue/base'
+
+class RGB::Color
+
+  # Returns the color's YUV values.
+  #
+  # Based on:
+  # - http://www.martinreddy.net/gfx/faqs/colorconv.faq (section 6.1)
+  # - https://en.wikipedia.org/wiki/Y%E2%80%B2UV
+  def yuv(round: true)
+    [
+      red *  0.299 + green *  0.587 + blue *  0.114,
+      red * -0.147 + green * -0.289 + blue *  0.436,
+      red *  0.615 + green * -0.515 + blue * -0.100
+    ].map { |v| round ? v.round(6) : v }
+
+    # Wikipedia (2024-Aug-7)
+    # suggests slightly different factors for U and V:
+    #
+    # U = red * -0.14713 + green * -0.28886 + blue *  0.436
+    # V = red *  0.615   + green * -0.51499 + blue * -0.10001
+  end
+
+end

data/lib/redgreenblue.rb

@@ -20,30 +20,47 @@ module RGB
 
 end
 
-%w(
+require 'redgreenblue/version'
 
-  version
+require 'redgreenblue/base'
 
-  base
+require 'redgreenblue/24bit'
+require 'redgreenblue/48bit'
+require 'redgreenblue/hex'
+require 'redgreenblue/int'
 
-  24bit 48bit hex int
+require 'redgreenblue/hsl'
+require 'redgreenblue/hsv'
+require 'redgreenblue/hsb'
 
-  hsl hsv hsb
+require 'redgreenblue/ostwald'
+require 'redgreenblue/hwb'
 
-  ostwald hwb
+require 'redgreenblue/gamma'
 
-  gamma
+require 'redgreenblue/cie_1931'
+require 'redgreenblue/cie_1976'
+require 'redgreenblue/cie_1994'
 
-  cie_1931 cie_1976 cie_1994
+require 'redgreenblue/name'
 
-  name
+require 'redgreenblue/inspect'
+require 'redgreenblue/view'
+require 'redgreenblue/lazy'
 
-  inspect view lazy
+require 'redgreenblue/rgb565'
+require 'redgreenblue/bgr24bit'
+require 'redgreenblue/gif'
+require 'redgreenblue/terminal'
+require 'redgreenblue/web'
+require 'redgreenblue/gpl'
+require 'redgreenblue/mac'
 
-  rgb565 bgr24bit gif terminal web gpl mac
+require 'redgreenblue/yuv'
 
-  match mix misc random
+require 'redgreenblue/match'
+require 'redgreenblue/mix'
+require 'redgreenblue/misc'
+require 'redgreenblue/random'
 
-  os
-
-).each { |m| require "redgreenblue/#{m}" }
+require 'redgreenblue/os'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: redgreenblue
 version: !ruby/object:Gem::Version
-  version: 0.18.0
+  version: 0.19.0
 platform: ruby
 authors:
 - lllist.eu
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-12-22 00:00:00.000000000 Z
+date: 2024-08-07 00:00:00.000000000 Z
 dependencies: []
 description:
 email:
@@ -53,6 +53,7 @@ files:
 - lib/redgreenblue/version.rb
 - lib/redgreenblue/view.rb
 - lib/redgreenblue/web.rb
+- lib/redgreenblue/yuv.rb
 homepage: https://github.com/lllisteu/redgreenblue
 licenses:
 - MIT