pixelart 0.1.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 71ac76ef187b8148a547f8dd7b76f2216bdd034f2ba67f7974b6e1a98abe3992
-  data.tar.gz: 6b44348938795087874a80fec20a6e1f87633ff282f62804605b42cbb232e46d
+  metadata.gz: 5cc4a5d1c756256a1162bdab5208ff01549b7e2543ccb301457845dd1f393b48
+  data.tar.gz: 1f07a5a8203fc4b4fc93446bc52d6abf8ca1b94368c48952649c423ef0100b15
 SHA512:
-  metadata.gz: d94abebcda0b1d87bdc0bcdc0f6072d7ae88efed8b26a0733f4fcdccb9b8063068b9a55f24bf08ebe34705e30298ebaf5d1f619045e37fe5be3b2412a8019932
-  data.tar.gz: 63be655c80cf3703499aae7984a901888ca2ae3fe362ea66f5324e7abd98a0b207f5a150da9f2f1c6b7b2c29d52b71e44d252b6323eb8050160bac8c52e542f0
+  metadata.gz: 6031f337310c6935841ae3a9c2528f4aa6179c8a5b6b9a4b4aa21d0f98b9a9dd5a0578792cce660be1f15c11d95e35785efa80547e1950d28cf8e3ff21a05243
+  data.tar.gz: 4615099b098378c2eee14cb854c2ee67237a278172b3c789be1de72a59c9ba6779e8dc2a4e9a4384c93b2771d5c8f31a8cf1f51cff308d6bf0e27468a50d0cb3

data/Manifest.txt

@@ -3,5 +3,7 @@ Manifest.txt
 README.md
 Rakefile
 lib/pixelart.rb
+lib/pixelart/color.rb
+lib/pixelart/gradient.rb
 lib/pixelart/image.rb
 lib/pixelart/version.rb

data/lib/pixelart.rb

@@ -10,6 +10,8 @@ require 'fileutils'
 
 ## our own code
 require 'pixelart/version'    # note: let version always go first
+require 'pixelart/color'
+require 'pixelart/gradient'
 require 'pixelart/image'
 
 

data/lib/pixelart/color.rb

@@ -0,0 +1,62 @@
+module Pixelart
+
+
+class Color
+  TRANSPARENT = 0            # rgba(  0,  0,  0,  0)
+  BLACK       = 0xff         # rgba(  0,  0,  0,255)
+  WHITE       = 0xffffffff   # rgba(255,255,255,255)
+
+
+  def self.parse( color )
+    if color.is_a?( Integer )  ## e.g. assumes ChunkyPNG::Color.rgb() or such
+      color ## pass through as is 1:1
+    elsif color.is_a?( Array )  ## assume array of hsl(a) e. g. [180, 0.86, 0.88]
+      from_hsl( *color )
+    elsif color.is_a?( String )
+      if color.downcase == 'transparent'   ## special case for builtin colors
+        TRANSPARENT
+      else
+        ## note: return an Integer !!! (not a Color class or such!!! )
+        from_hex( color )
+      end
+    else
+      raise ArgumentError, "unknown color format; cannot parse - expected rgb hex string e.g. d3d3d3"
+    end
+  end
+
+  def self.from_hex( hex )
+    ## Creates a color by converting it from a string in hex notation.
+    ##
+    ## It supports colors with (#rrggbbaa) or without (#rrggbb)
+    ##  alpha channel as well as the 3-digit short format (#rgb)
+    ## for those without. Color strings may include
+    ## the prefix "0x" or "#"".
+    ChunkyPNG::Color.from_hex( hex )
+  end
+
+  def self.from_hsl( hue, saturation, lightness, alpha=255)
+    ChunkyPNG::Color.from_hsl( hue,
+                               saturation,
+                               lightness,
+                               alpha )
+  end
+
+
+  def self.to_hex( color, include_alpha: true )
+    ChunkyPNG::Color.to_hex( color, include_alpha )
+  end
+
+  def self.to_hsl( color, include_alpha: true )
+    # Returns an array with the separate HSL components of a color.
+    ChunkyPNG::Color.to_hsl( color, include_alpha )
+  end
+
+  def self.r( color ) ChunkyPNG::Color.r( color ); end
+  def self.g( color ) ChunkyPNG::Color.g( color ); end
+  def self.b( color ) ChunkyPNG::Color.b( color ); end
+
+  def self.rgb( r, g, b ) ChunkyPNG::Color.rgb( r, g, b); end
+end  # class Color
+end  # module Pixelart
+
+

data/lib/pixelart/gradient.rb

@@ -0,0 +1,96 @@
+
+## inspired by
+##  https://en.wikipedia.org/wiki/List_of_software_palettes#Color_gradient_palettes
+##  https://github.com/mistic100/tinygradient
+##   https://mistic100.github.io/tinygradient/
+
+
+module Pixelart
+
+class Gradient
+
+  def initialize( *stops )
+    ## note:  convert stop colors to rgb triplets e.g.
+    ##         from #ffffff to [255,255,255]
+    ##              #000000 to [0,0,0]  etc.
+    @stops = stops.map do |stop|
+               stop = Color.parse( stop )
+               [Color.r(stop), Color.g(stop), Color.b(stop)]
+             end
+  end
+
+
+  def colors( steps )
+    ## note: for now only support two colors
+    ##   note: gradient will include start (first)
+    ##     AND stop color (last) - stop color is NOT excluded for now!!
+    start = @stops[0]
+    stop  = @stops[1]
+
+    step = stepize( start, stop, steps-1 )
+    ## pp step
+
+    gradient = [start]
+
+    1.upto(steps-2).each do |i|
+       color = interpolate( step, start, i )
+       gradient << color
+    end
+    ## note: use original passed in stop color (should match calculated)
+    gradient << stop
+
+    ## convert to color (Integer)
+    gradient.map do |color|
+      Color.rgb( *color )
+    end
+ end
+
+##
+# Linearly compute the step size between start and end
+##  (not normalized)
+# @param {StepValue} start
+# @param {StepValue} end
+# @param {number} steps - number of desired steps
+#@return {StepValue}
+
+def stepize(start, stop, steps)
+  step = []
+
+  [0,1,2].each do |k|
+    step <<  Float(stop[k] - start[k]) / Float(steps)
+  end
+
+  step
+end
+
+##
+# Compute the final step color
+#  @param {StepValue} step - from `stepize`
+#  @param {StepValue} start
+#  @param {number} i - color index
+#  @return {StepValue}
+
+RGB_MAX = [256, 256, 256]
+def interpolate( step, start, i )
+  color = []
+
+  [0,1,2].each do |k|
+     color[k] = step[k]*i + start[k]
+
+     color[k] = if color[k] < 0.0
+                   color[k] + RGB_MAX[k]
+                else
+                   color[k] % RGB_MAX[k]
+                end
+
+     ## convert back to Integer from Float
+     ##   add 0.5 for rounding up (starting with 0.5) - why? why not?
+     color[k] = (color[k]+0.5).to_i
+  end
+  color
+end
+
+
+end  # class Gradient
+end  # module Pixelart
+

data/lib/pixelart/image.rb

@@ -1,57 +1,5 @@
 module Pixelart
 
-
-
-
-class Color
-  def self.parse( color )
-    if color.is_a?( Integer )  ## e.g. assumes ChunkyPNG::Color.rgb() or such
-      color ## pass through as is 1:1
-    elsif color.is_a?( Array )  ## assume array of hsl(a) e. g. [180, 0.86, 0.88]
-      ChunkyPNG::Color.from_hsl( *color )
-    elsif color.is_a?( String )
-      if color.downcase == 'transparent'   ## special case for builtin colors
-        ChunkyPNG::Color::TRANSPARENT
-      else
-        ## note: return an Integer !!! (not a Color class or such!!! )
-        ChunkyPNG::Color.from_hex( color )
-      end
-    else
-      raise ArgumentError, "unknown color format; cannot parse - expected rgb hex string e.g. d3d3d3"
-    end
-  end
-
-  def self.from_hex( hex )
-    ## Creates a color by converting it from a string in hex notation.
-    ##
-    ## It supports colors with (#rrggbbaa) or without (#rrggbb)
-    ##  alpha channel as well as the 3-digit short format (#rgb)
-    ## for those without. Color strings may include
-    ## the prefix "0x" or "#"".
-    ChunkyPNG::Color.from_hex( hex )
-  end
-
-  def self.from_hsl( hue, saturation, lightness, alpha=255)
-    ChunkyPNG::Color.from_hsl( hue,
-                               saturation,
-                               lightness,
-                               alpha )
-  end
-
-
-  def self.to_hex( color, include_alpha: true )
-    ChunkyPNG::Color.to_hex( color, include_alpha )
-  end
-
-  def self.to_hsl( color, include_alpha: true )
-    # Returns an array with the separate HSL components of a color.
-    ChunkyPNG::Color.to_hsl( color, include_alpha )
-  end
-end  # class Color
-
-
-
-
 class Image
 
 def self.read( path )   ## convenience helper
@@ -82,7 +30,7 @@ end
 
 
 
-def initialize( width, height, initial=ChunkyPNG::Color::TRANSPARENT )
+def initialize( width, height, initial=Color::TRANSPARENT )
 
   if initial.is_a?( ChunkyPNG::Image )
     @img = initial
@@ -204,7 +152,7 @@ end
 def self.parse_colors( colors )
   if colors.is_a?( Array )   ## convenience shortcut
     ## note: always auto-add color 0 as pre-defined transparent - why? why not?
-    h = { '0' => ChunkyPNG::Color::TRANSPARENT }
+    h = { '0' => Color::TRANSPARENT }
     colors.each_with_index do |color, i|
        h[ (i+1).to_s ] = Color.parse( color )
     end

data/lib/pixelart/version.rb

@@ -3,7 +3,7 @@ module Pixelart
 
   MAJOR = 0
   MINOR = 1
-  PATCH = 2
+  PATCH = 3
   VERSION = [MAJOR,MINOR,PATCH].join('.')
 
   def self.version

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pixelart
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-04-13 00:00:00.000000000 Z
+date: 2021-04-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: chunky_png
@@ -73,6 +73,8 @@ files:
 - README.md
 - Rakefile
 - lib/pixelart.rb
+- lib/pixelart/color.rb
+- lib/pixelart/gradient.rb
 - lib/pixelart/image.rb
 - lib/pixelart/version.rb
 homepage: https://github.com/cryptocopycats/mooncats