pixelart 0.2.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4ebe6ddb193d15d611f37461ebca0f7de77d9df6d14c0078eeb483fcdcaf505e
-  data.tar.gz: 773ab34615671bb06b4e8b8e77096cc9e44588ec5c1b04662474e410a0382223
+  metadata.gz: bb520f7fc94b0b7d62336829d92929bbeb27600f0042ab3f68d81b6e5b26d2b3
+  data.tar.gz: ed4756f69b5f5d5ca696a1105aa348b5b86ab33653ff7c34d1b24f4dc75e244f
 SHA512:
-  metadata.gz: 50f927ae70136c40e9d8bcac7c7c87641dc51427fbf5abaf2a88f1312327e83f59689b597b91e0d9003887a349b10fd20ce4be2ba7bf7baf1b9cebd2df2ee7b5
-  data.tar.gz: 6afea4ef51112243f065b7071d26c4ae6a70b3c408015838ab01a02d38a3a53ff3f14f04c7cd9746520c6be10f4153eba8b6533e4a52726dc531a7d54e250c29
+  metadata.gz: caa3d9eeb12a4a59e4f6ec3191e432ae11d7cf44465e0b6722c69bda985af6caeea3a4390f773d4d535a38096f483c3d9467b03f63ed6547a168f79361db1991
+  data.tar.gz: d7f6d039eddc337b62ca22b338712a26423781b2a57703429469d376c02af0fef6aadd9182f4fb2cb755dc83f27c6bcbb97519ee528c01169ba8070534c7c377

data/Manifest.txt

@@ -4,11 +4,15 @@ README.md
 Rakefile
 lib/pixelart.rb
 lib/pixelart/base.rb
+lib/pixelart/blur.rb
 lib/pixelart/color.rb
+lib/pixelart/composite.rb
 lib/pixelart/gradient.rb
 lib/pixelart/image.rb
 lib/pixelart/led.rb
 lib/pixelart/misc.rb
 lib/pixelart/palette.rb
 lib/pixelart/pixelator.rb
+lib/pixelart/sketch.rb
+lib/pixelart/spots.rb
 lib/pixelart/version.rb

data/Rakefile

@@ -19,6 +19,7 @@ Hoe.spec 'pixelart' do
 
   self.extra_deps = [
     ['chunky_png'],
+    ['mini_magick'],
   ]
 
   self.licenses = ['Public Domain']

data/lib/pixelart/base.rb

@@ -1,12 +1,24 @@
-## 3rd party
+###############
+#  3rd party
 require 'chunky_png'
 
+# optional
+#   note: requires installed imagemagick command line installed for usage
+require 'mini_magick'
+
+
+
 ## 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
@@ -14,12 +26,32 @@ require 'pixelart/color'
 require 'pixelart/gradient'
 require 'pixelart/palette'
 require 'pixelart/image'
+require 'pixelart/composite'
 
 require 'pixelart/pixelator'
 
 require 'pixelart/misc'   ## misc helpers
 
-require 'pixelart/led'    ## (special) effects / filters
+#########################
+# (special) effects / filters
+require 'pixelart/led'
+require 'pixelart/sketch'
+
+## (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/spots'
+require 'pixelart/blur'
+
+
+
 
 
 
@@ -33,6 +65,8 @@ module Pixelart
 
   Palette256Image = Palette8BitImage = Palette8bitImage =
   ImagePalette256 = ImagePalette8Bit = ImagePalette8bit
+
+  CompositeImage = ImageComposite
 end
 
 

data/lib/pixelart/blur.rb

@@ -0,0 +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
+

data/lib/pixelart/composite.rb

@@ -0,0 +1,77 @@
+module Pixelart
+
+class ImageComposite < Image  # check: (re)name to Collage, Sheet, Sprites, or such?
+
+  ## default tile width / height in pixel -- check: (re)name to sprite or such? why? why not?
+  TILE_WIDTH  = 24
+  TILE_HEIGHT = 24
+
+
+  def initialize( *args, **kwargs )
+    @tile_width  = kwargs[:width]  || kwargs[:tile_width]  || TILE_WIDTH
+    @tile_height = kwargs[:height] || kwargs[:tile_height] || TILE_HEIGHT
+
+    ## todo/fix: check type - args[0] is Image!!!
+    if args.size == 1   ## assume "copy" c'tor with passed in image
+       img = args[0]    ## pass image through as-is
+
+       @tile_cols  = img.width  / @tile_width       ## e.g. 2400/24 = 100
+       @tile_rows  = img.height / @tile_height      ## e.g. 2400/24 = 100
+       @tile_count = @tile_cols * @tile_rows       ## ## 10000 = 100x100  (2400x2400 pixel)
+    elsif args.size == 2 || args.size == 0     ## cols, rows
+      ## todo/fix: check type - args[0] & args[1] is Integer!!!!!
+       ## todo/check - find a better name for cols/rows - why? why not?
+       @tile_cols = args[0] || 3
+       @tile_rows = args[1] || 3
+       @tile_count = 0   # (track) current index (of added images)
+
+       img = ChunkyPNG::Image.new( @tile_cols * @tile_width,
+                                   @tile_rows * @tile_height )
+    else
+       raise ArgumentError, "cols, rows or image arguments expected; got: #{args.inspect}"
+    end
+
+    puts "     #{img.height}x#{img.width} (height x width)"
+
+    super( nil, nil, img )
+  end
+
+
+  def count() @tile_count; end
+  alias_method :size, :count   ## add size alias (confusing if starting with 0?) - why? why not?
+
+  #####
+  # set / add tile
+
+  def add( image )
+    y, x =  @tile_count.divmod( @tile_cols )
+
+    puts "    [#{@tile_count}] @ (#{x}/#{y}) #{image.width}x#{image.height} (height x width)"
+
+    ## note: image.image  - "unwrap" the "raw" ChunkyPNG::Image
+    @img.compose!( image.image, x*@tile_width, y*@tile_height )
+    @tile_count += 1
+  end
+  alias_method :<<, :add
+
+
+
+  ######
+  # get tile
+
+  def tile( index )
+    y, x = index.divmod( @tile_cols )
+    img = @img.crop( x*@tile_width, y*@tile_height, @tile_width, @tile_height )
+    Image.new( img.width, img.height, img )  ## wrap in pixelart image
+  end
+
+  def []( *args )    ## overload - why? why not?
+    if args.size == 1
+      index = args[0]
+      tile( index )
+    else
+      super   ## e.g [x,y] --- get pixel
+    end
+  end
+end # class ImageComposite
+end # module Pixelart

data/lib/pixelart/image.rb

@@ -50,6 +50,9 @@ end
 
 
 def initialize( width, height, initial=Color::TRANSPARENT )
+   ### todo/fix:
+   ##  change params to *args only - why? why not?
+   ##     make width/height optional if image passed in?
 
   if initial.is_a?( ChunkyPNG::Image )
     @img = initial
@@ -92,6 +95,13 @@ def grayscale
   Image.new( img.width, img.height, img )
 end
 
+def mirror
+  img = @img.mirror
+  Image.new( img.width, img.height, img )
+end
+alias_method :flip_vertically, :mirror
+
+
 ## add replace_colors alias too? - why? why not?
 def change_colors( color_map )
   color_map = _parse_color_map( color_map )

data/lib/pixelart/pixelator.rb

@@ -76,7 +76,7 @@ class Pixelator    # or use Minifier or such - rename - why? why not?
   alias_method :[], :pixel
 
 
-  def can_pixelate?
+  def can_pixelate?( threshold: 50 )
     # check if any pixel has NOT a color with a 50% majority?
     count = 0
     @width.times do |x|
@@ -84,10 +84,13 @@ class Pixelator    # or use Minifier or such - rename - why? why not?
         pixel = pixel( x, y )
         sum         = pixel.values.sum
         color_count = pixel.values[0]
-        if color_count < (sum/2)
+
+        threshold_count = sum / (100/threshold)
+        if color_count < threshold_count
           count += 1
+          puts "!! #{color_count} < #{threshold_count} (#{threshold}%)"
           ## todo/check: stor warn in a public errors or warns array - why? why not?
-          puts "!! WARN #{count} - pixel (#{x}/#{y}) - no majority (50%) color:"
+          puts "!! WARN #{count} - pixel (#{x}/#{y}) - no majority (#{threshold}%) color:"
           pp pixel
         end
       end
@@ -111,7 +114,52 @@ class Pixelator    # or use Minifier or such - rename - why? why not?
 
     Image.new( img.width, img.height, img )  ## wrap in Pixelart::Image - why? why not?
   end
+
+  def outline
+    ## create a two color outline (transparent and non-transparent color)
+    img = ChunkyPNG::Image.new( @width, @height )
+
+    @width.times do |x|
+      @height.times do |y|
+        pixel = pixel( x, y )
+        ## calculate pixel count for transparent and non-transparent parts
+        ##   note:
+        ##     also count all colors with alpha channel < 200 to transparent!!
+        transparent_count, color_count = pixel.reduce([0,0]) do |mem, (color,count)|
+                                          hsl = Color.to_hsl( color )
+                                          ## get alpha channel (transparency) for hsla
+                                          ##    0-255 max.
+                                          alpha = hsl[3]
+                                         if color == 0x00 || alpha < 200
+                                            mem[0] += count
+                                         else
+                                            mem[1] += count
+                                         end
+                                         mem
+                                     end
+
+        print "."
+        if transparent_count > 0 && color_count > 0
+          print "(#{x}/#{y}=>#{transparent_count}/#{color_count})"
+        end
+
+        ## todo/check:
+        ##   warn if sum_transparent == sum_color
+        ##    or within "threshold" e.g. below 55% or 58% or such - why? why not?
+        ##    or add treshold as param to outline?
+        color = if transparent_count > color_count
+                   0x0
+                else
+                   0x0000ffff  ## use blue for now
+                end
+
+        img[x,y] = color
+      end
+    end
+    print "\n"
+
+    Image.new( img.width, img.height, img )  ## wrap in Pixelart::Image - why? why not?
+  end
 end  # class Pixelator
 end  # module Pixelart
 
-

data/lib/pixelart/sketch.rb

@@ -0,0 +1,69 @@
+module Pixelart
+
+
+
+class Image
+  def sketch( sketch=4, line: 1 )
+       # todo: line - find a better name eg. line_strenght/width or such?
+      width  = @img.width*sketch  + (@img.width+1)*line
+      height = @img.height*sketch + (@img.height+1)*line
+
+      puts "  #{width}x#{height}"
+
+      img = Image.new( width, height, Color::WHITE )
+
+      @img.width.times do |x|
+        @img.height.times do |y|
+          pixel = @img[x,y]
+
+          ## get surrounding pixels - if "out-of-bound" use transparent (0)
+          left   =  x == 0  ? Color::TRANSPARENT : @img[x-1,y]
+          top    =  y == 0  ? Color::TRANSPARENT : @img[x  ,y-1]
+
+          if pixel != left   ## draw vertical line
+              (sketch+line*2).times do |n|
+                line.times do |m|
+                  img[    x*sketch + line*x + m,
+                      n + y*sketch + line*y] = Color::BLACK
+                end
+              end
+          end
+
+          if pixel != top   ## draw horizontal line
+             (sketch+line*2).times do |n|
+               line.times do |m|
+                 img[n + x*sketch + line*x,
+                         y*sketch + line*y + m] = Color::BLACK
+                end
+             end
+          end
+
+
+          ## check special edge case for x and y to add "finish-up" right and bottom line
+          if x == @img.width-1 && pixel != Color::TRANSPARENT
+             ## draw vertical line
+             (sketch+line*2).times do |n|
+              line.times do |m|
+                img[    (x+1)*sketch + line*(x+1) + m,
+                    n + y*sketch + line*y] = Color::BLACK
+              end
+             end
+          end
+
+          if y== @img.height-1 && pixel != Color::TRANSPARENT
+            ## draw horizontal line
+            (sketch+line*2).times do |n|
+              line.times do |m|
+                img[n + x*sketch + line*x,
+                        (y+1)*sketch + line*(y+1) + m] = Color::BLACK
+              end
+            end
+          end
+        end
+      end
+
+      img
+  end
+end # class Image
+end # module Pixelart
+

data/lib/pixelart/spots.rb

@@ -0,0 +1,129 @@
+module Pixelart
+
+class Image
+
+
+def spots( spot=10,
+              spacing: 0,
+              center: nil,
+              radius: nil,
+              background: nil,
+              lightness: nil,
+              odd: false )
+
+  width  = @img.width
+  height = @img.height
+  ## puts "  #{width}x#{height}"
+
+  min_center, max_center = center ? center : [0,0]
+  min_radius, max_radius = radius ? radius : [0,0]
+
+  background_color = background ? Color.parse( background ) : 0
+
+  min_lightness, max_lightness = lightness ? lightness : [0.0,0.0]
+
+  ## note: magick command line might get way too long, thus,
+  ##   save commands to a script
+  script = String.new('')
+  script << "#{MAGICK_INPUT} \\\n"
+
+
+    width.times do |x|
+      height.times do |y|
+         color = @img[ x, y ]
+
+         if color == 0  ## transparent
+           if background   ## change transparent to background
+              color = background_color
+           else
+             next ## skip transparent
+           end
+         end
+
+
+         if lightness
+          ## todo/check: make it work with alpha too
+          h,s,l = Color.to_hsl( color, include_alpha: false )
+
+           h = h % 360    ## make sure h(ue) is always positive!!!
+
+           ## note: rand() return between 0.0 and 1.0
+           l_diff = min_lightness +
+                     (max_lightness-min_lightness)*rand()
+
+           lnew = [1.0, l+l_diff].min
+           lnew = [0.0, lnew].max
+
+           ## print " #{l}+#{l_diff}=#{lnew} "
+
+           color = Color.from_hsl( h,
+                                   [1.0, s].min,
+                                   lnew )
+         end
+
+         ## note: return hexstring with leading #
+         # e.g.    0 becomes #00000000
+         #        and so on
+         color_hex = Color.to_hex( color, include_alpha: true )
+         script << "-fill '#{color_hex}' "
+
+         cx_offset,
+         cy_offset = if center  ## randomize (offset off center +/-)
+                       [(spot/2 + min_center) + rand( max_center-min_center ),
+                        (spot/2 + min_center) + rand( max_center-min_center )]
+                     else
+                       [spot/2,   ## center
+                        spot/2]
+                     end
+
+         cx = x*spot + x*spacing + cx_offset
+         cy = y*spot + y*spacing + cx_offset
+
+         px_offset = if radius ## randomize (radius +/-)
+                       min_radius + rand( max_radius-min_radius )
+                     else
+                       spot/2
+                     end
+         px = cx + px_offset
+         py = cy
+
+
+         if odd && (y % 2 == 1)  ## add odd offset
+            cx += spot/2
+            px += spot/2
+         end
+
+         ## circle
+         ##  give the center and any point on the perimeter (boundary)
+         script << "-draw 'circle #{cx},#{cy},#{px},#{py}' \\\n"
+      end
+    end
+
+    script << "-write #{MAGICK_OUTPUT}\n"
+
+
+    ## use an empty image (canvas) with transparent background
+    ##   as magick input image
+   canvas = Image.new( width*spot+(width-1)*spacing,
+                       height*spot+(height-1)*spacing )
+   canvas.save( MAGICK_INPUT )
+
+   ## 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( script )
+   end
+
+
+  MiniMagick::Tool::Magick.new do |magick|
+    magick.script( MAGICK_SCRIPT )
+  end
+
+  Image.read( MAGICK_OUTPUT )
+end
+
+
+end # class Image
+end # class Pixelart
+

data/lib/pixelart/version.rb

@@ -1,8 +1,8 @@
 
 module Pixelart
 
-  MAJOR = 0
-  MINOR = 2
+  MAJOR = 1
+  MINOR = 1
   PATCH = 0
   VERSION = [MAJOR,MINOR,PATCH].join('.')
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pixelart
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-05-08 00:00:00.000000000 Z
+date: 2021-09-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: chunky_png
@@ -24,6 +24,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: mini_magick
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rdoc
   requirement: !ruby/object:Gem::Requirement
@@ -74,13 +88,17 @@ files:
 - Rakefile
 - lib/pixelart.rb
 - lib/pixelart/base.rb
+- lib/pixelart/blur.rb
 - lib/pixelart/color.rb
+- lib/pixelart/composite.rb
 - lib/pixelart/gradient.rb
 - lib/pixelart/image.rb
 - lib/pixelart/led.rb
 - lib/pixelart/misc.rb
 - lib/pixelart/palette.rb
 - lib/pixelart/pixelator.rb
+- lib/pixelart/sketch.rb
+- lib/pixelart/spots.rb
 - lib/pixelart/version.rb
 homepage: https://github.com/rubycoco/pixel
 licenses: