pixelart 0.2.2 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3c2b93e1779a1c06ff0b13dbfcae471648cd2f2dc153b17da3fd864615f6f6c1
-  data.tar.gz: cef870177214b37eb902a99a41410dc8c080b613fed7c48cccd801290392fd28
+  metadata.gz: 798a4eb7b61556c0c79889d01d404a499598286779e009fa71304986f4d68c31
+  data.tar.gz: 9b17446fe914c1b62135c1e1432bc2debf74037ca9e602feb25e71ec7088b117
 SHA512:
-  metadata.gz: 8ac5ad9fd3e16d9d490d7c43c38fa2b95ee6318a7c0f319e142fc59084ab70315ebb3d0e800d4536a098214768cab3adae99b1ec2c482ce93a4ab1e902d36cc5
-  data.tar.gz: 67e9e1214ae9f614a2694d30a9b63ce5aa2c83dad17a98dac141913b86cb4375ea22fc0630e2e3160f6b768b4b79ab2236555d0467471fd6a127f477ca48f6db
+  metadata.gz: 8073e67ffd10361088fd66b768d4aa5927c2f65cdd54389615b980c2181ec8cde2a2ad21eced1fe7a756af7ce2e7c681b2aea4a89aed2c869ad04a956388d54a
+  data.tar.gz: b69918e012f6270a9aa0817d69e094bb52cd12ed05399ac566872efdd2174af9c9534ef2e72f4f34f4d3f1bbe4d5062aedcbb42deb67ff55c52a005965b2d969

data/Manifest.txt

@@ -4,6 +4,7 @@ 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
@@ -12,4 +13,7 @@ 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/vector.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
@@ -16,11 +28,34 @@ 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/vector'   ## vector graphics helpers
+
+
+require 'pixelart/spots'
+require 'pixelart/blur'
+
+
+
 
 
 

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

@@ -7,6 +7,13 @@ class ImageComposite < Image  # check: (re)name to Collage, Sheet, Sprites, or s
   TILE_HEIGHT = 24
 
 
+  def self.read( path, width: TILE_WIDTH, height: TILE_WIDTH )   ## convenience helper
+    img = ChunkyPNG::Image.from_file( path )
+    new( img, width:  width,
+              height: width )
+  end
+
+
   def initialize( *args, **kwargs )
     @tile_width  = kwargs[:width]  || kwargs[:tile_width]  || TILE_WIDTH
     @tile_height = kwargs[:height] || kwargs[:tile_height] || TILE_HEIGHT
@@ -73,5 +80,21 @@ class ImageComposite < Image  # check: (re)name to Collage, Sheet, Sprites, or s
       super   ## e.g [x,y] --- get pixel
     end
   end
+
+
+  ## convenience helpers to loop over composite
+  def each( &block )
+    count.times do |i|
+      block.call( tile( i ) )
+    end
+  end
+
+  def each_with_index( &block )
+    count.times do |i|
+      block.call( tile( i ), i )
+    end
+  end
+
+
 end # class ImageComposite
 end # module Pixelart

data/lib/pixelart/image.rb

@@ -94,12 +94,25 @@ def grayscale
   img = @img.grayscale
   Image.new( img.width, img.height, img )
 end
+alias_method :greyscale, :grayscale
+
+
+
+def flip
+  img = @img.flip
+  Image.new( img.width, img.height, img )
+end
+alias_method :flip_horizontally, :flip
 
 def mirror
   img = @img.mirror
   Image.new( img.width, img.height, img )
 end
 alias_method :flip_vertically, :mirror
+alias_method :flop,            :mirror
+
+
+
 
 
 ## add replace_colors alias too? - why? why not?

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,146 @@
+module Pixelart
+
+class Image
+
+
+def spots_hidef( spot=10,
+                   spacing: 0,
+                   center: nil,
+                   radius: nil,
+                   background: nil,
+                   lightness: nil,
+                   odd: false )
+
+  width  = @img.width*spot+(@img.width-1)*spacing
+  height = @img.height*spot+(@img.height-1)*spacing
+
+  ## puts "  #{width}x#{height}"
+
+  ## settings in a hash for "pretty printing" in comments
+  settings = { spot: spot
+             }
+
+  settings[ :spacing ] = spacing  if spacing
+  settings[ :center ]  = center  if center
+  settings[ :radius ] = radius  if radius
+  settings[ :background ] = background  if background
+  settings[ :lightness ] = lightness  if lightness
+  settings[ :odd ] = odd   if odd
+
+
+  v = Vector.new( width, height, header: <<TXT )
+generated by pixelart/v#{VERSION} on #{Time.now.utc}
+
+spots_hidef with settings:
+    #{settings.to_json}
+TXT
+
+
+  min_center, max_center = center ? center : [0,0]
+  min_radius, max_radius = radius ? radius : [0,0]
+
+  ## note: allow passing in array of colors (will get randomally picked)
+  background_colors = if background
+                        ## check for array; otherwise assume single color passed in
+                        background_ary = background.is_a?( Array) ? background : [background]
+                        background_ary.map { |background| Color.parse( background ) }
+                      else
+                        [0]   # transparent (default - no background)
+                      end
+
+
+  min_lightness, max_lightness = lightness ? lightness : [0.0,0.0]
+
+
+   @img.width.times do |x|
+      @img.height.times do |y|
+         color = @img[ x, y ]
+
+         if color == 0   ## transparent
+           next if background.nil?
+
+           color = if background_colors.size == 1
+                     background_colors[0]
+                   else  ## pick random background color
+                     background_colors[ rand( background_colors.size ) ]
+                   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 )
+
+         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
+
+         r = if radius ## randomize (radius +/-)
+                       min_radius + rand( max_radius-min_radius )
+                     else
+                       spot/2
+                     end
+
+         cx += spot/2   if odd && (y % 2 == 1)  ## add odd offset
+
+
+         v.circle( cx: cx, cy: cy, r: r, fill: color_hex)
+      end
+    end
+  v
+end  ## method spots_hidef
+alias_method :spots_hd, :spots_hidef
+
+
+def spots( spot=10,
+              spacing: 0,
+              center: nil,
+              radius: nil,
+              background: nil,
+              lightness: nil,
+              odd: false )
+
+  v = spots_hidef( spot,
+        spacing: spacing,
+        center: center,
+        radius: radius,
+        background: background,
+        lightness: lightness,
+        odd: odd )
+
+  v.to_image
+end
+
+
+end # class Image
+end # class Pixelart
+

data/lib/pixelart/vector.rb

@@ -0,0 +1,108 @@
+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
+
+
+
+  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
+
+
+
+  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,9 +1,9 @@
 
 module Pixelart
 
-  MAJOR = 0
+  MAJOR = 1
   MINOR = 2
-  PATCH = 2
+  PATCH = 0
   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.2.2
+  version: 1.2.0
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-05-16 00:00:00.000000000 Z
+date: 2021-10-02 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,6 +88,7 @@ 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
@@ -82,6 +97,9 @@ files:
 - lib/pixelart/misc.rb
 - lib/pixelart/palette.rb
 - lib/pixelart/pixelator.rb
+- lib/pixelart/sketch.rb
+- lib/pixelart/spots.rb
+- lib/pixelart/vector.rb
 - lib/pixelart/version.rb
 homepage: https://github.com/rubycoco/pixel
 licenses: