pixelart 1.2.2 → 1.3.1

data/lib/pixelart/stripes.rb

@@ -0,0 +1,116 @@
+module Pixelart
+  class Image
+
+
+def self.calc_stripes( length, n: 2, debug: false )
+  stripes = []
+
+  base_step = length / n    ## pixels per pixel
+
+  err_step = (length % n) * 2   ## multiply by 2
+  denominator =  n * 2   # denominator (in de - nenner  e.g. 1/nenner 4/nenner)
+
+  overflow = err_step*n/denominator  ## todo/check - assert that div is always WITHOUT remainder!!!!!
+
+  if debug
+    puts
+    puts "base_step (pixels per stripe):"
+    puts "  #{base_step}     -  #{base_step}px * #{n} = #{base_step*n}px"
+    puts "err_step  (in 1/#{length}*2):"
+    puts "  #{err_step} / #{denominator}      - #{err_step*n} / #{denominator} = +#{err_step*n/denominator}px overflow"
+    puts
+  end
+
+  err    = 0
+  stripe = 0
+
+  n.times do |i|
+    stripe  = base_step
+    err    += err_step
+
+    if err >= denominator ## overflow
+      puts "    -- overflow #{err}/#{denominator} - add +1 pixel to stripe #{i}"  if debug
+
+      stripe += 1
+      err   -= denominator
+    end
+
+
+    puts "  #{i} => #{stripe}  -- #{err} / #{denominator}"  if debug
+
+    stripes[i] = stripe
+  end
+
+  ## note: assert calculation - sum of stripes MUST be equal length
+  sum = stripes.sum
+  puts "  sum: #{sum}"  if debug
+
+  if sum != length
+    puts "!! ERROR - stripes sum #{sum} calculation failed; expected #{length}:"
+    pp stripes
+    exit 1
+  end
+
+  stripes
+end
+
+
+def stripes_horizontal( *colors )
+  colors = colors.map { |color| Color.parse( color ) }
+
+  img = Image.new( @img.width, @img.height )
+
+  n = colors.size
+  lengths = self.class.calc_stripes( @img.height, n: n )
+
+  i      = 0
+  length = lengths[0]
+  color  = colors[0]
+
+  @img.height.times do |y|
+    if y >= length
+      i      += 1
+      length += lengths[i]
+      color   = colors[i]
+    end
+    @img.width.times do |x|
+      img[x,y] = color
+    end
+  end
+
+  img.compose!( self )  ## paste/compose image onto backgorund
+  img
+end
+alias_method :stripes, :stripes_horizontal
+
+
+
+### todo/check: move colors to (reusable) constants int Color !!!! why? why not?
+RAINBOW_RED    = Color.parse( '#E40303' )
+RAINBOW_ORANGE = Color.parse( '#FF8C00' )
+RAINBOW_YELLOW = Color.parse( '#FFED00' )
+RAINBOW_GREEN  = Color.parse( '#008026' )
+RAINBOW_BLUE   = Color.parse( '#004DFF' )
+RAINBOW_VIOLET = Color.parse( '#750787' )
+
+
+def rainbow
+  ##
+  # the most common variant consists of six stripes:
+  #   red, orange, yellow, green, blue, and violet.
+  # The flag is typically flown horizontally,
+  #  with the red stripe on top, as it would be in a natural rainbow
+  #
+  #  see https://en.wikipedia.org/wiki/Rainbow_flag_(LGBT)
+  stripes( RAINBOW_RED,
+           RAINBOW_ORANGE,
+           RAINBOW_YELLOW,
+           RAINBOW_GREEN,
+           RAINBOW_BLUE,
+           RAINBOW_VIOLET )
+end
+alias_method :pride, :rainbow
+
+
+  end  # class Image
+end   # module Pixelart

data/lib/pixelart/transparent.rb

@@ -1,60 +1,60 @@
-
-module Pixelart
-class Image
-
-  def transparent( style = :solid, fuzzy: false )
-    img = Image.new( width, height )
-
-
-    background = self[0,0]
-
-    bh,bs,bl =  Color.to_hsl( background )
-    bh = (bh % 360)  ## might might negative degree (always make positive)
-
-    height.times do |y|
-        if style == :linear
-          background = self[0,y]
-
-          bh,bs,bl =  Color.to_hsl( background )
-          bh = (bh % 360)  ## might might negative degree (always make positive)
-        end
-      width.times do |x|
-        pixel = self[x,y]
-
-        if background == 0  ## special case if background is already transparent keep going
-          img[x,y] =  pixel
-        elsif fuzzy
-          ## check for more transparents
-            ##   not s  is 0.0 to 0.99  (100%)
-            ##   and l  is 0.0 to 0.99  (100%)
-          h,s,l =  Color.to_hsl( pixel )
-          h = (h % 360)  ## might might negative degree (always make positive)
-
-          ## try some kind-of fuzzy "heuristic" match on background color
-          if ((h >= bh-5) && (h <= bh+5)) &&
-             ((s >= bs-0.07) && (s <= bs+0.07)) &&
-             ((l >= bl-0.07) && (l <= bl+0.07))
-           img[x,y] = 0  ## Color::TRANSPARENT
-
-           if h != bh || s != bs || l != bl
-              # report fuzzy background color
-              puts "  #{x}/#{y} fuzzy background #{[h,s,l]} ~= #{[bh,bs,bl]}"
-           end
-          else
-            img[x,y] =  pixel
-          end
-        else
-           if pixel == background
-            img[x,y] = 0   ## Color::TRANSPARENT
-           else
-             img[x,y] =  pixel
-           end
-        end
-      end
-    end
-    img
-  end # method transparent
-
-
-end   # class Image
-end  # module Pixelart
+
+module Pixelart
+class Image
+
+  def transparent( style = :solid, fuzzy: false )
+    img = Image.new( width, height )
+
+
+    background = self[0,0]
+
+    bh,bs,bl =  Color.to_hsl( background )
+    bh = (bh % 360)  ## might might negative degree (always make positive)
+
+    height.times do |y|
+        if style == :linear
+          background = self[0,y]
+
+          bh,bs,bl =  Color.to_hsl( background )
+          bh = (bh % 360)  ## might might negative degree (always make positive)
+        end
+      width.times do |x|
+        pixel = self[x,y]
+
+        if background == 0  ## special case if background is already transparent keep going
+          img[x,y] =  pixel
+        elsif fuzzy
+          ## check for more transparents
+            ##   not s  is 0.0 to 0.99  (100%)
+            ##   and l  is 0.0 to 0.99  (100%)
+          h,s,l =  Color.to_hsl( pixel )
+          h = (h % 360)  ## might might negative degree (always make positive)
+
+          ## try some kind-of fuzzy "heuristic" match on background color
+          if ((h >= bh-5) && (h <= bh+5)) &&
+             ((s >= bs-0.07) && (s <= bs+0.07)) &&
+             ((l >= bl-0.07) && (l <= bl+0.07))
+           img[x,y] = 0  ## Color::TRANSPARENT
+
+           if h != bh || s != bs || l != bl
+              # report fuzzy background color
+              puts "  #{x}/#{y} fuzzy background #{[h,s,l]} ~= #{[bh,bs,bl]}"
+           end
+          else
+            img[x,y] =  pixel
+          end
+        else
+           if pixel == background
+            img[x,y] = 0   ## Color::TRANSPARENT
+           else
+             img[x,y] =  pixel
+           end
+        end
+      end
+    end
+    img
+  end # method transparent
+
+
+end   # class Image
+end  # module Pixelart

data/lib/pixelart/ukraine.rb

@@ -0,0 +1,20 @@
+#######
+#
+#  Glory To Ukraine! Fuck (Vladimir) Putin! Stop the War!
+#   Send A Stop The War Message To The World With Your Pixel Art Images
+#
+
+
+module Pixelart
+
+class Image
+
+  ### todo/check: move colors to (reusable) constants int Color !!!! why? why not?
+  UKRAINE_BLUE   = Color.parse( '#0057b7' )
+  UKRAINE_YELLOW = Color.parse( '#ffdd00' )
+
+  def ukraine() stripes( UKRAINE_BLUE, UKRAINE_YELLOW ); end
+end  # class Image
+
+end # module Pixelart
+

data/lib/pixelart/vector.rb

@@ -1,163 +1,163 @@
-module Pixelart
-
-
-class Vector   # holds a vector graphics image (in source)
-
-  class Shape; end
-  class Circle < Shape
-    def initialize( cx, cy, r, fill: )
-      @cx   = cx
-      @cy   = cy
-      @r    = r
-      @fill = fill
-    end
-
-    def to_svg
-      %Q{<circle cx="#{@cx}" cy="#{@cy}" r="#{@r}" fill="#{@fill}" />}
-    end
-
-    def to_magick
-      ## circle
-      ##  give the center and any point on the perimeter (boundary)
-      px = @cx+@r
-      py = @cy
-      "-fill '#{@fill}' -draw 'circle #{@cx},#{@cy},#{px},#{py}'"
-    end
-  end # class Circle
-
-  class Path < Shape
-    def initialize( fill:, stroke: )
-      @commands = []
-      @fill     = fill
-      @stroke   = stroke
-    end
-
-    def move_to( x, y )   ## add a move_to instruction
-      @commands << ['M', x, y]
-      self
-    end
-
-    def line_to( x, y )
-      @commands << ['L', x, y]
-      self
-    end
-
-    def line( *coords )  ## move_to/line_to all-in-one shortcut
-      ## todo/check - assert coords has at least two x/y pairs - why? why not?
-      move_to( *coords[0..1] )
-      coords[2..-1].each_slice( 2) do |coord|
-        line_to( *coord )
-      end
-      self
-    end
-
-
-
-    def to_svg
-       buf =  %Q{<path style="stroke: #{@stroke}; fill: #{@fill || 'none'};" }
-       buf << %Q{d="}
-       last_command = ''
-       @commands.each_with_index do |command,i|
-          buf << " "  if i > 0  # add space separator
-
-          ## "optimize" - that is, do not repead command if same as before
-          buf << command[0]   if command[0] != last_command
-          buf << "#{command[1]} #{command[2]}"
-          last_command = command[0]
-       end
-
-       buf << %Q{"}
-       buf << "/>"
-       buf
-    end
-  end # class Path
-
-
-
-  def initialize( width, height, header: nil )
-     @width  = width
-     @height = height
-
-     @header = header
-     @shapes = []
-  end
-
-  def circle( cx:, cy:, r:, fill: )
-     @shapes << Circle.new( cx, cy, r, fill: fill )
-  end
-
-  ## note: default stroke (color) to black (#000000) for now - why? why not?
-  def path( stroke: '#000000', fill: nil )
-     path = Path.new( stroke: stroke, fill: fill )
-     @shapes << path
-
-     path   ## note: MUST return "inner" path shape for chaining "dsl-like" methods / commands
-  end
-
-
-
-  def to_image
-     ## use an empty image (canvas) with transparent background
-     ##   as magick input image
-     canvas = Image.new( @width, @height )
-     canvas.save( MAGICK_INPUT )
-
-     ## note: magick command line might get way too long, thus,
-     ##   save commands to a script
-     ## note: save magick input first (see above) before save script
-     ##        will (auto-)create missing directories in path (if missing)
-
-    File.open( MAGICK_SCRIPT, 'w:utf-8' ) do |f|
-      f.write( "#{MAGICK_INPUT} \\\n" )
-      @shapes.each do |shape|
-        f.write( "#{shape.to_magick} \\\n" )
-      end
-      f.write( "-write #{MAGICK_OUTPUT}\n" )
-    end
-
-    MiniMagick::Tool::Magick.new do |magick|
-      magick.script( MAGICK_SCRIPT )
-    end
-
-    Image.read( MAGICK_OUTPUT )
-  end
-
-
-  def to_svg
-    buf = String.new('')
-
-    if @header
-      buf << "<!--\n"
-      ## auto-indent lines by five (5) spaces for now
-      @header.each_line do |line|
-        buf << "     #{line}"
-      end
-      buf << "\n-->\n\n"
-    end
-
-    buf << %Q{<svg version="1.1" width="#{@width}" height="#{@height}" xmlns="http://www.w3.org/2000/svg">\n}
-    @shapes.each do |shape|
-       buf << "  #{shape.to_svg}\n"
-    end
-    buf << "</svg>"
-    buf
-  end
-
-
-  def save( path, format: nil )
-    if format && format.downcase == 'png'  ## support png with image magick
-      img = to_image
-      img.save( path )
-    else
-     # make sure outdir exits
-     outdir = File.dirname( path )
-     FileUtils.mkdir_p( outdir )  unless Dir.exist?( outdir )
-     File.open( path, 'w:utf-8' ) do |f|
-        f.write( to_svg )
-      end
-    end
-  end
-  alias_method :write, :save
-
-end # class Vector
-end # module Pixelart
+module Pixelart
+
+
+class Vector   # holds a vector graphics image (in source)
+
+  class Shape; end
+  class Circle < Shape
+    def initialize( cx, cy, r, fill: )
+      @cx   = cx
+      @cy   = cy
+      @r    = r
+      @fill = fill
+    end
+
+    def to_svg
+      %Q{<circle cx="#{@cx}" cy="#{@cy}" r="#{@r}" fill="#{@fill}" />}
+    end
+
+    def to_magick
+      ## circle
+      ##  give the center and any point on the perimeter (boundary)
+      px = @cx+@r
+      py = @cy
+      "-fill '#{@fill}' -draw 'circle #{@cx},#{@cy},#{px},#{py}'"
+    end
+  end # class Circle
+
+  class Path < Shape
+    def initialize( fill:, stroke: )
+      @commands = []
+      @fill     = fill
+      @stroke   = stroke
+    end
+
+    def move_to( x, y )   ## add a move_to instruction
+      @commands << ['M', x, y]
+      self
+    end
+
+    def line_to( x, y )
+      @commands << ['L', x, y]
+      self
+    end
+
+    def line( *coords )  ## move_to/line_to all-in-one shortcut
+      ## todo/check - assert coords has at least two x/y pairs - why? why not?
+      move_to( *coords[0..1] )
+      coords[2..-1].each_slice( 2) do |coord|
+        line_to( *coord )
+      end
+      self
+    end
+
+
+
+    def to_svg
+       buf =  %Q{<path style="stroke: #{@stroke}; fill: #{@fill || 'none'};" }
+       buf << %Q{d="}
+       last_command = ''
+       @commands.each_with_index do |command,i|
+          buf << " "  if i > 0  # add space separator
+
+          ## "optimize" - that is, do not repead command if same as before
+          buf << command[0]   if command[0] != last_command
+          buf << "#{command[1]} #{command[2]}"
+          last_command = command[0]
+       end
+
+       buf << %Q{"}
+       buf << "/>"
+       buf
+    end
+  end # class Path
+
+
+
+  def initialize( width, height, header: nil )
+     @width  = width
+     @height = height
+
+     @header = header
+     @shapes = []
+  end
+
+  def circle( cx:, cy:, r:, fill: )
+     @shapes << Circle.new( cx, cy, r, fill: fill )
+  end
+
+  ## note: default stroke (color) to black (#000000) for now - why? why not?
+  def path( stroke: '#000000', fill: nil )
+     path = Path.new( stroke: stroke, fill: fill )
+     @shapes << path
+
+     path   ## note: MUST return "inner" path shape for chaining "dsl-like" methods / commands
+  end
+
+
+
+  def to_image
+     ## use an empty image (canvas) with transparent background
+     ##   as magick input image
+     canvas = Image.new( @width, @height )
+     canvas.save( MAGICK_INPUT )
+
+     ## note: magick command line might get way too long, thus,
+     ##   save commands to a script
+     ## note: save magick input first (see above) before save script
+     ##        will (auto-)create missing directories in path (if missing)
+
+    File.open( MAGICK_SCRIPT, 'w:utf-8' ) do |f|
+      f.write( "#{MAGICK_INPUT} \\\n" )
+      @shapes.each do |shape|
+        f.write( "#{shape.to_magick} \\\n" )
+      end
+      f.write( "-write #{MAGICK_OUTPUT}\n" )
+    end
+
+    MiniMagick::Tool::Magick.new do |magick|
+      magick.script( MAGICK_SCRIPT )
+    end
+
+    Image.read( MAGICK_OUTPUT )
+  end
+
+
+  def to_svg
+    buf = String.new('')
+
+    if @header
+      buf << "<!--\n"
+      ## auto-indent lines by five (5) spaces for now
+      @header.each_line do |line|
+        buf << "     #{line}"
+      end
+      buf << "\n-->\n\n"
+    end
+
+    buf << %Q{<svg version="1.1" width="#{@width}" height="#{@height}" xmlns="http://www.w3.org/2000/svg">\n}
+    @shapes.each do |shape|
+       buf << "  #{shape.to_svg}\n"
+    end
+    buf << "</svg>"
+    buf
+  end
+
+
+  def save( path, format: nil )
+    if format && format.downcase == 'png'  ## support png with image magick
+      img = to_image
+      img.save( path )
+    else
+     # make sure outdir exits
+     outdir = File.dirname( path )
+     FileUtils.mkdir_p( outdir )  unless Dir.exist?( outdir )
+     File.open( path, 'w:utf-8' ) do |f|
+        f.write( to_svg )
+      end
+    end
+  end
+  alias_method :write, :save
+
+end # class Vector
+end # module Pixelart

data/lib/pixelart/version.rb

@@ -1,22 +1,22 @@
-
-module Pixelart
-
-  MAJOR = 1
-  MINOR = 2
-  PATCH = 2
-  VERSION = [MAJOR,MINOR,PATCH].join('.')
-
-  def self.version
-    VERSION
-  end
-
-  def self.banner
-    "pixelart/#{VERSION} on Ruby #{RUBY_VERSION} (#{RUBY_RELEASE_DATE}) [#{RUBY_PLATFORM}] in (#{root})"
-  end
-
-  def self.root
-    File.expand_path( File.dirname(File.dirname(File.dirname(__FILE__))) )
-  end
-
-end # module Pixelart
-
+
+module Pixelart
+
+  MAJOR = 1
+  MINOR = 3
+  PATCH = 1
+  VERSION = [MAJOR,MINOR,PATCH].join('.')
+
+  def self.version
+    VERSION
+  end
+
+  def self.banner
+    "pixelart/#{VERSION} on Ruby #{RUBY_VERSION} (#{RUBY_RELEASE_DATE}) [#{RUBY_PLATFORM}] in (#{root})"
+  end
+
+  def self.root
+    File.expand_path( File.dirname(File.dirname(File.dirname(__FILE__))) )
+  end
+
+end # module Pixelart
+

data/lib/pixelart.rb

@@ -1,12 +1,12 @@
-
-## our own code (without "top-level" shortcuts e.g. "modular version")
-require 'pixelart/base'   # aka "strict(er)" version
-
-
-###
-#  add convenience top-level shortcuts / aliases
-#    make Image, Color, Palette8bit, etc top-level
-include Pixelart
-
-
-
+
+## our own code (without "top-level" shortcuts e.g. "modular version")
+require 'pixelart/base'   # aka "strict(er)" version
+
+
+###
+#  add convenience top-level shortcuts / aliases
+#    make Image, Color, Palette8bit, etc top-level
+include Pixelart
+
+
+