pixelart 1.2.2 → 1.3.1

data/Rakefile

@@ -1,32 +1,32 @@
-require 'hoe'
-require './lib/pixelart/version.rb'
-
-Hoe.spec 'pixelart' do
-
-  self.version = Pixelart::VERSION
-
-  self.summary = "pixelart - mint your own pixel art images off chain using any design (in ascii text) in any colors; incl. 2x/4x/8x zoom for bigger sizes"
-  self.description = summary
-
-  self.urls    = { home: 'https://github.com/pixelartexchange/pixel' }
-
-  self.author  = 'Gerald Bauer'
-  self.email   = 'wwwmake@googlegroups.com'
-
-  # switch extension to .markdown for gihub formatting
-  self.readme_file  = 'README.md'
-  self.history_file = 'CHANGELOG.md'
-
-  self.extra_deps = [
-    ['chunky_png'],
-    ['mini_magick'],
-    ['csvreader'],
-  ]
-
-  self.licenses = ['Public Domain']
-
-  self.spec_extras = {
-    required_ruby_version: '>= 2.3'
-  }
-
-end
+require 'hoe'
+require './lib/pixelart/version.rb'
+
+Hoe.spec 'pixelart' do
+
+  self.version = Pixelart::VERSION
+
+  self.summary = "pixelart - mint your own pixel art images off chain using any design (in ascii text) in any colors; incl. 2x/4x/8x zoom for bigger sizes"
+  self.description = summary
+
+  self.urls    = { home: 'https://github.com/pixelartexchange/pixelart' }
+
+  self.author  = 'Gerald Bauer'
+  self.email   = 'wwwmake@googlegroups.com'
+
+  # switch extension to .markdown for gihub formatting
+  self.readme_file  = 'README.md'
+  self.history_file = 'CHANGELOG.md'
+
+  self.extra_deps = [
+    ['chunky_png'],
+    ['mini_magick'],
+    ['csvreader'],
+  ]
+
+  self.licenses = ['Public Domain']
+
+  self.spec_extras = {
+    required_ruby_version: '>= 2.3'
+  }
+
+end

data/lib/pixelart/base.rb

@@ -1,84 +1,93 @@
-###############
-#  3rd party
-require 'chunky_png'
-
-# optional
-#   note: requires installed imagemagick command line installed for usage
-require 'mini_magick'
-
-
-# bonus / prologue / convenience 3rd party
-require 'csvreader'
-
-
-## stdlib
-require 'pp'
-require 'time'
-require 'date'
-require 'fileutils'
-
-require 'json'
-require 'yaml'
-
-
-
-
-## our own code
-require 'pixelart/version'    # note: let version always go first
-require 'pixelart/color'
-require 'pixelart/gradient'
-require 'pixelart/palette'
-require 'pixelart/image'
-require 'pixelart/composite'
-
-
-require 'pixelart/pixelator'
-
-require 'pixelart/misc'   ## misc helpers
-
-#########################
-# (special) effects / filters / etc
-require 'pixelart/led'
-require 'pixelart/sketch'
-require 'pixelart/transparent'
-require 'pixelart/silhouette'
-
-
-## (special) effects / filters that require imagemagick
-
-
-## todo/check  - use a config block or such - why? why not?
-module Pixelart
-  MAGICK_SCRIPT = './tmp/magick_script.txt'
-  MAGICK_INPUT  = './tmp/magick_input.png'
-  MAGICK_OUTPUT = './tmp/magick_output.png'
-end
-
-require 'pixelart/vector'   ## vector graphics helpers
-
-
-require 'pixelart/spots'
-require 'pixelart/blur'
-
-
-
-
-
-
-
-##########
-#  add some spelling convenience variants
-PixelArt = Pixelart
-
-module Pixelart
-  Palette256 = Palette8Bit = Palette8bit
-
-  Palette256Image = Palette8BitImage = Palette8bitImage =
-  ImagePalette256 = ImagePalette8Bit = ImagePalette8bit
-
-  CompositeImage = ImageComposite
-end
-
-
-
-puts Pixelart.banner    # say hello
+###############
+#  3rd party
+require 'chunky_png'
+
+# optional
+#   note: requires installed imagemagick command line installed for usage
+require 'mini_magick'
+
+
+# bonus / prologue / convenience 3rd party
+require 'csvreader'
+
+
+## stdlib
+require 'pp'
+require 'time'
+require 'date'
+require 'fileutils'
+
+require 'json'
+require 'yaml'
+
+
+
+
+## our own code
+require 'pixelart/version'    # note: let version always go first
+require 'pixelart/color'
+require 'pixelart/gradient'
+require 'pixelart/palette'
+require 'pixelart/image'
+require 'pixelart/composite'
+
+require 'pixelart/sample'   ## (down)sample / pixelate
+
+
+require 'pixelart/pixelator'
+
+require 'pixelart/misc'   ## misc helpers
+require 'pixelart/stripes'
+
+
+require 'pixelart/generator'   ## generate images from text via spritesheets
+
+
+#########################
+# (special) effects / filters / etc
+require 'pixelart/circle'
+require 'pixelart/led'
+require 'pixelart/sketch'
+require 'pixelart/transparent'
+require 'pixelart/silhouette'
+require 'pixelart/ukraine'
+
+
+## (special) effects / filters that require imagemagick
+
+
+## todo/check  - use a config block or such - why? why not?
+module Pixelart
+  MAGICK_SCRIPT = './tmp/magick_script.txt'
+  MAGICK_INPUT  = './tmp/magick_input.png'
+  MAGICK_OUTPUT = './tmp/magick_output.png'
+end
+
+require 'pixelart/vector'   ## vector graphics helpers
+
+
+require 'pixelart/spots'
+require 'pixelart/blur'
+
+
+
+
+
+
+
+##########
+#  add some spelling convenience variants
+PixelArt = Pixelart
+
+module Pixelart
+  Palette256 = Palette8Bit = Palette8bit
+
+  Palette256Image = Palette8BitImage = Palette8bitImage =
+  ImagePalette256 = ImagePalette8Bit = ImagePalette8bit
+
+  CompositeImage = ImageComposite
+end
+
+
+
+puts Pixelart.banner    # say hello

data/lib/pixelart/blur.rb

@@ -1,19 +1,19 @@
-module Pixelart
-
-class Image
-
-def blur( blur=2 )
-  @img.save( MAGICK_INPUT )
-
-  MiniMagick::Tool::Magick.new do |magick|
-    magick << MAGICK_INPUT
-    magick.blur( "#{blur}x#{blur}" )
-    magick << MAGICK_OUTPUT
-  end
-
-  Image.read( MAGICK_OUTPUT )
-end
-
-end # class Image
-end # class Pixelart
-
+module Pixelart
+
+class Image
+
+def blur( blur=2 )
+  @img.save( MAGICK_INPUT )
+
+  MiniMagick::Tool::Magick.new do |magick|
+    magick << MAGICK_INPUT
+    magick.blur( "#{blur}x#{blur}" )
+    magick << MAGICK_OUTPUT
+  end
+
+  Image.read( MAGICK_OUTPUT )
+end
+
+end # class Image
+end # class Pixelart
+

data/lib/pixelart/circle.rb

@@ -0,0 +1,46 @@
+###
+#
+#  add more circle aliases
+#    e.g.  circular / round or such - why? why not?
+
+
+module Pixelart
+
+class Image
+  def circle
+    ### for radius use min of width / height
+    r = [@img.width, @img.height].min / 2
+
+    center_x = width  / 2
+    center_y = height / 2
+
+    ################
+    #  try with 96x96
+    #    center_x:  96 / 2 = 48
+    #    center_y:  96 / 2 = 48
+    #
+    #     r:    96 / 2 = 48
+
+    img = Image.new( @img.width, @img.height )
+
+    @img.width.times do |x|
+      @img.height.times do |y|
+
+        ## change to float calcuation (instead of ints) - why? why not?
+        xx, yy, rr = x - center_x,
+                     y - center_y,
+                     r
+
+        img[ x, y] = if xx*xx+yy*yy < rr*rr
+                           @img[ x, y ]
+                     else
+                           0  ## transparent - alpha(0)
+                     end
+      end
+    end
+
+    img
+  end
+end  # class Image
+
+end # module Pixelart

data/lib/pixelart/color.rb

@@ -1,131 +1,131 @@
-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
-
-
-
-  ## known built-in color names
-  def self.build_names
-    names = {
-      '#00000000' => 'TRANSPARENT',
-      '#000000ff' => 'BLACK',
-      '#ffffffff' => 'WHITE',
-    }
-
-    ## auto-add grayscale 1 to 254
-    (1..254).each do |n|
-      hex = "#" + ('%02x' % n)*3
-      hex << "ff"  ## add alpha channel (255)
-      names[ hex ] = "8-BIT GRAYSCALE ##{n}"
-    end
-
-    names
-  end
-
-  NAMES = build_names
-
-
-
-  def self.format( color )
-    rgb = [r(color),
-           g(color),
-           b(color)]
-
-    # rgb in hex (string format)
-    #   note: do NOT include alpha channel for now - why? why not?
-    hex = "#" + rgb.map{|num| '%02x' % num }.join
-
-    hsl = to_hsl( color )
-    ## get alpha channel (transparency) for hsla
-    alpha = hsl[3]
-
-
-    buf = ''
-    buf << hex
-    buf << " / "
-    buf << "rgb("
-    buf << "%3d " % rgb[0]
-    buf << "%3d " % rgb[1]
-    buf << "%3d)"  % rgb[2]
-    buf << " - "
-    buf << "hsl("
-    buf << "%3d° " % (hsl[0] % 360)
-    buf << "%3d%% " % (hsl[1]*100+0.5).to_i
-    buf << "%3d%%)" % (hsl[2]*100+0.5).to_i
-
-    if alpha != 255
-      buf << " - α(%3d%%)" % (alpha*100/255+0.5).to_i
-    else
-      buf << "          "  ## add empty for 255 (full opacity)
-    end
-
-    ## note: add alpha channel to hex
-    alpha_hex = '%02x' % alpha
-    name = NAMES[ hex+alpha_hex ]
-    buf << " - #{name}"  if name
-
-    buf
-  end
-  class << self
-    alias_method :fmt, :format
-  end
-
-end  # class Color
-end  # module Pixelart
-
-
+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
+
+
+
+  ## known built-in color names
+  def self.build_names
+    names = {
+      '#00000000' => 'TRANSPARENT',
+      '#000000ff' => 'BLACK',
+      '#ffffffff' => 'WHITE',
+    }
+
+    ## auto-add grayscale 1 to 254
+    (1..254).each do |n|
+      hex = "#" + ('%02x' % n)*3
+      hex << "ff"  ## add alpha channel (255)
+      names[ hex ] = "8-BIT GRAYSCALE ##{n}"
+    end
+
+    names
+  end
+
+  NAMES = build_names
+
+
+
+  def self.format( color )
+    rgb = [r(color),
+           g(color),
+           b(color)]
+
+    # rgb in hex (string format)
+    #   note: do NOT include alpha channel for now - why? why not?
+    hex = "#" + rgb.map{|num| '%02x' % num }.join
+
+    hsl = to_hsl( color )
+    ## get alpha channel (transparency) for hsla
+    alpha = hsl[3]
+
+
+    buf = ''
+    buf << hex
+    buf << " / "
+    buf << "rgb("
+    buf << "%3d " % rgb[0]
+    buf << "%3d " % rgb[1]
+    buf << "%3d)"  % rgb[2]
+    buf << " - "
+    buf << "hsl("
+    buf << "%3d° " % (hsl[0] % 360)
+    buf << "%3d%% " % (hsl[1]*100+0.5).to_i
+    buf << "%3d%%)" % (hsl[2]*100+0.5).to_i
+
+    if alpha != 255
+      buf << " - α(%3d%%)" % (alpha*100/255+0.5).to_i
+    else
+      buf << "          "  ## add empty for 255 (full opacity)
+    end
+
+    ## note: add alpha channel to hex
+    alpha_hex = '%02x' % alpha
+    name = NAMES[ hex+alpha_hex ]
+    buf << " - #{name}"  if name
+
+    buf
+  end
+  class << self
+    alias_method :fmt, :format
+  end
+
+end  # class Color
+end  # module Pixelart
+
+