pixelart 1.0.0 → 1.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c77200956faad2093e12cba99a8f8a3339941e612406701a795eecdcdd8248d8
-  data.tar.gz: d3dfbf4c9d278db95219b695dc55cea1b31debd8b5a08a20305135526d3618d1
+  metadata.gz: e407d45e71520e9e7c34448811a80e796254aba70c791e3497df00b0fa700486
+  data.tar.gz: 55c324e6cf901bd8ed78fa48d97f27a3f66c60d314d070a457ef4e272ebe9f01
 SHA512:
-  metadata.gz: db9abc2122d9727e2fee58c54913174983ff3dd03d2e2658c4b0a84d80114f0f482673d2b7e51fea61dbbb423f1df05eb5e027ba51d741ab86dc7e16d6f2eb72
-  data.tar.gz: 36c0733c3c5e15f18cca6787185eb2229fa8d7a98c3d037cf781295b8d32fc74be542a433de1504981afb984d9234730191dcf14443b3f614cd3dc9139d4fa7e
+  metadata.gz: 6e36d0cb47e5e36b81b3a3f47d62fa119b898f9bbf11c422d53f5ab3cfdfe022a8f3dda3d82ea1db4f2eb422376ea82ac153922add94caeb5aff97214813a81a
+  data.tar.gz: b8957560272efd295ef73bdd450531dc9d631fd293215dbd0f9f835bdbdb50669018f1d24a27a6df45d8714a2633bc1d22a6b6761979dc7804b3c5290c2f1eaa

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
@@ -13,4 +14,6 @@ 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,8 @@ Hoe.spec 'pixelart' do
 
   self.extra_deps = [
     ['chunky_png'],
+    ['mini_magick'],
+    ['csvreader'],
   ]
 
   self.licenses = ['Public Domain']

data/lib/pixelart/base.rb

@@ -1,12 +1,27 @@
-## 3rd party
+###############
+#  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
@@ -16,13 +31,36 @@ 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

@@ -64,18 +64,21 @@ end
 
 
 
-def zoom( zoom=2 )
+def zoom( zoom=2, spacing: 0 )
   ## create a new zoom factor x image (2x, 3x, etc.)
 
-  img = Image.new( @img.width*zoom,
-                   @img.height*zoom )
+  width  = @img.width*zoom+(@img.width-1)*spacing
+  height = @img.height*zoom+(@img.height-1)*spacing
 
-  @img.height.times do |y|
-    @img.width.times do |x|
+  img = Image.new( width, height )
+
+  @img.width.times do |x|
+    @img.height.times do |y|
       pixel = @img[x,y]
       zoom.times do |n|
         zoom.times do |m|
-          img[n+zoom*x,m+zoom*y] = pixel
+          img[n+zoom*x+spacing*x,
+              m+zoom*y+spacing*y] = pixel
         end
       end
     end # each x
@@ -94,12 +97,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/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,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

data/lib/pixelart/version.rb

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

data/lib/pixelart.rb

@@ -8,3 +8,5 @@ require 'pixelart/base'   # aka "strict(er)" version
 #    make Image, Color, Palette8bit, etc top-level
 include Pixelart
 
+
+

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pixelart
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.2.1
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-09-21 00:00:00.000000000 Z
+date: 2021-11-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: chunky_png
@@ -24,6 +24,34 @@ 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: csvreader
+  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 +102,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
@@ -83,6 +112,8 @@ files:
 - 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: