pixelart 0.2.1 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 066a13d4aff234657b8685f611168ed012fd6b949a292add28e7729f31c1bdc7
-  data.tar.gz: a7f748b8c246bb4c944da848baef19d4fdc6cd9c74ac96050c38aa907e680247
+  metadata.gz: ba25604fe4925484c00f133e26e2d3d67aec4b23af8daa2cc3306235a2c704a6
+  data.tar.gz: 570abba81b211dc9aa1df3939b15e9e6845676884c01197c25d9cb23d3b4ba0f
 SHA512:
-  metadata.gz: de3a072fd7dd9fe939340f1914fdeab6cc16dd5a2c25fb86548a3d5d89eb043b8d236dd62e2be86ac191bc0a5689eec2d3d6a3b465e08853a85cc285f394701a
-  data.tar.gz: 6fc5ffec090a5fbdc29b990812168d7716b4a563f3faffe8bd69ed09da70ca079af6334fa523cfdf3ed96f1228fd35842bc44d72139eeb6dc1b1d6299bf08b09
+  metadata.gz: 1af47c73f13001e103d1ad0a4965d8125763935c2b962d50769f48cba1728ea351645bfb381721425c776b20ccd484acde470a41044b055552bb929e18a8e98d
+  data.tar.gz: e60473974839ade310e105c148f98b7a1e5232f6e0491df1108cb0f50028d8ff1b02af8e9c2ba61ede00c6396b4d5bf8833dd3c757692190f101ecdc6e6072f8

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

@@ -60,7 +60,7 @@ class ImageComposite < Image  # check: (re)name to Collage, Sheet, Sprites, or s
   # get tile
 
   def tile( index )
-    y, x = index.divmod( @tile_rows )
+    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

data/lib/pixelart/image.rb

@@ -95,6 +95,21 @@ 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
+
+def flip
+  img = @img.flip
+  Image.new( img.width, img.height, img )
+end
+alias_method :flip_horizontally, :flip
+
+
+
+
 ## add replace_colors alias too? - why? why not?
 def change_colors( color_map )
   color_map = _parse_color_map( color_map )

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,8 +1,8 @@
 
 module Pixelart
 
-  MAJOR = 0
-  MINOR = 2
+  MAJOR = 1
+  MINOR = 1
   PATCH = 1
   VERSION = [MAJOR,MINOR,PATCH].join('.')
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pixelart
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 1.1.1
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-05-15 00:00:00.000000000 Z
+date: 2021-09-25 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: