pixelart 1.3.2 → 1.3.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f92122c8e9247bc55e6068de9ed5d8d4fcee830efec5878235af10b3a969da02
-  data.tar.gz: 5823cae5dc165d280ff68925e0aaa35d1f34fb5b2df9da1e75d3cacc9aab378d
+  metadata.gz: 43bc0ad17527099593a49e143036c875bf93fc61873d551252a19376490734fd
+  data.tar.gz: c57fdb4d5241915767f4480a698f3f362d25c53f99805050b8c8dd4c2ca9ec27
 SHA512:
-  metadata.gz: 3ff8f76c9cacbbbe28d5036c6c525c6bf1f9aab9c0a48d13bec657866a5a79ab85f9e604e343b0df7d29d05a1c6858e379cd562c9ae1d1fa60cd7fc5056a1cb0
-  data.tar.gz: dfb12289285f8b9e8091e70549c1eedb1aee8c06c29b3176d51221e2e45843b43f5ae07dcb47beb05cb9070bbebb2d1ebdfbd48419843c550cd55117e74b9f09
+  metadata.gz: 742db57f909288c2a19105244951f676c99723544be749e60544d3576f326f323ec00bcdf0ea9fbeef0e6a6a0d55771f5ad06a7e5fe1a32814b6f509bc472be4
+  data.tar.gz: 2b7d05f9e4ab9a4f4348b3fb7b7f1f5b36ee884b4db3bae901479c84c4dac0207f67f56ba140319a45bd1704c9af14075ef7dfc3ef20897476dfc5bf242a509c

data/Manifest.txt

@@ -6,14 +6,12 @@ lib/pixelart.rb
 lib/pixelart/base.rb
 lib/pixelart/blur.rb
 lib/pixelart/circle.rb
-lib/pixelart/color.rb
 lib/pixelart/composite.rb
+lib/pixelart/convert.rb
 lib/pixelart/generator.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/sample.rb
 lib/pixelart/silhouette.rb

data/README.md

@@ -288,3 +288,9 @@ Just install the gem:
 
 The scripts are dedicated to the public domain.
 Use it as you please with no restrictions whatsoever.
+
+
+
+## Questions? Comments?
+
+Post them on the [D.I.Y. Punk (Pixel) Art reddit](https://old.reddit.com/r/DIYPunkArt). Thanks.

data/Rakefile

@@ -18,9 +18,10 @@ Hoe.spec 'pixelart' do
   self.history_file = 'CHANGELOG.md'
 
   self.extra_deps = [
+    ['cocos'],
+    ['pixelart-colors'],
     ['chunky_png'],
     ['mini_magick'],
-    ['csvreader'],
   ]
 
   self.licenses = ['Public Domain']

data/lib/pixelart/base.rb

@@ -1,3 +1,13 @@
+require 'cocos'
+require 'base64'
+
+
+###
+#   base module
+require 'pixelart/colors'
+
+
+
 ###############
 #  3rd party
 require 'chunky_png'
@@ -7,27 +17,9 @@ require 'chunky_png'
 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'
 
@@ -71,22 +63,9 @@ require 'pixelart/blur'
 
 
 
-
-
-
-
-##########
-#  add some spelling convenience variants
-PixelArt = Pixelart
-
-module Pixelart
-  Palette256 = Palette8Bit = Palette8bit
-
-  Palette256Image = Palette8BitImage = Palette8bitImage =
-  ImagePalette256 = ImagePalette8Bit = ImagePalette8bit
-
-  CompositeImage = ImageComposite
-end
+###
+# mover helpers / utils
+require 'pixelart/convert'
 
 
 

data/lib/pixelart/convert.rb

@@ -0,0 +1,54 @@
+module Pixelart
+
+class Image
+
+
+## helper to convert (all) image in directory
+##    chech: move to ImageUtils.convert  or such - why? why not?
+##
+##  what about the name e.g. rename to convert_dir or
+##                                    batch_convert such - why? why not?
+def self.convert( dir, from: 'jpg',
+                       to: 'png',
+                       outdir: nil,
+                       overwrite: true )
+
+    outdir = dir   if outdir.nil?
+
+    files = Dir.glob( "#{dir}/*.#{from}" )
+    puts "==> found #{files.size} image(s) to convert from #{from} to #{to} (overwrite mode set to: #{overwrite})"
+
+    files.each_with_index do |file,i|
+      dirname   = File.dirname( file )
+      extname   = File.extname( file )
+      basename  = File.basename( file, extname )
+
+      ## skip convert if target / dest file already exists
+      next  if overwrite == false && File.exist?( "#{outdir}/#{basename}.#{to}" )
+
+      ##  note: make sure outdir exists (magic will not create it??)
+      FileUtils.mkdir_p( outdir )  unless Dir.exist?( outdir )
+
+      cmd = "magick convert #{dirname}/#{basename}.#{from} #{outdir}/#{basename}.#{to}"
+
+      puts "   [#{i+1}/#{files.size}] - #{cmd}"
+      ## todo/fix:   check return value!!! magick comand not available (in path) and so on!!!
+      system( cmd )
+
+      if from == 'gif'
+        ## assume multi-images for gif
+        ##   save  image-0.png  to  image.png
+        path0 = "#{outdir}/#{basename}-0.#{to}"
+        path  = "#{outdir}/#{basename}.#{to}"
+
+        puts "   saving #{path0} to #{path}..."
+
+        blob = File.open( path0, 'rb' ) { |f| f.read }
+        File.open( path, 'wb' ) { |f| f.write( blob ) }
+      end
+    end
+end
+
+
+end   # class Image
+end   # class Pixelart

data/lib/pixelart/image.rb

@@ -2,12 +2,42 @@ module Pixelart
 
 class Image
 
+
+##  keep track of all (inherited) subclasses via inherited hook
+##
+## change/rename  to descendants - why? why not?
+##
+## note about rails (activesupport?)
+##  If you use rails >= 3, you have two options in place.
+##    Use .descendants if you want more than one level depth of children classes,
+##    or use .subclasses for the first level of child classes.
+
+def self.subclasses
+  @subclasses ||= []
+end
+
+def self.inherited( subclass )
+  subclasses << subclass
+end
+
+
+
+
+
 def self.read( path )   ## convenience helper
   img_inner = ChunkyPNG::Image.from_file( path )
   img = new( img_inner.width, img_inner.height, img_inner )
   img
 end
 
+def self.parse_base64( str )
+  blob = Base64.decode64( str )
+  img_inner = ChunkyPNG::Image.from_blob( blob )
+  img = new( img_inner.width, img_inner.height, img_inner )
+  img
+end
+
+
 
 
 CHARS = '.@xo^~%*+=:'     ## todo/check: rename to default chars or such? why? why not?
@@ -95,6 +125,16 @@ def crop( x, y, crop_width, crop_height )
 end
 
 
+##  shift image n-pixels to the left (NOT changing width/height)
+def left( left )
+  img = Image.new( width, height )
+  img.compose!( crop( 0, 0, width-left, height ), left, 0 )
+  img
+end
+
+
+
+
 
 #######################
 ## filter / effects
@@ -106,19 +146,29 @@ end
 alias_method :greyscale, :grayscale
 
 
-
-def flip
-  img = @img.flip
+######################
+#  flip horizontally on x-axis (top-to-bottom/bottom-to-top)
+#    e.g. pixels on the top will now be pixels on the bottom
+def flip_horizontally
+  img = @img.flip_horizontally
   Image.new( img.width, img.height, img )
 end
-alias_method :flip_horizontally, :flip
+## keep flop? alias - why? why not?
+##   note: chunky_png use flip alias for flip_horizontally!!!!
+alias_method :flop, :flip_horizontally
+
 
+###
+#  flip vertially on y-axis (right-to-left/left-to-right)
+#     e.g. pixels on the left will now be pixels on the right
 def mirror
   img = @img.mirror
   Image.new( img.width, img.height, img )
 end
 alias_method :flip_vertically, :mirror
-alias_method :flop,            :mirror
+alias_method :flip,            :mirror   ## note: chunky_png use flip alias for flip_horizontally (top-to-bottom)!!!!
+alias_method :phlip,           :mirror   ## philip the intern ("hand-phlip one-by-one")
+alias_method :hand_phlip,      :mirror
 
 
 def rotate_counter_clockwise   # 90 degrees

data/lib/pixelart/version.rb

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

data/lib/pixelart.rb

@@ -9,4 +9,14 @@ require 'pixelart/base'   # aka "strict(er)" version
 include Pixelart
 
 
+##########
+#  add some spelling convenience variants
+
+
+module Pixelart
+  Palette256Image = Palette8BitImage = Palette8bitImage =
+  ImagePalette256 = ImagePalette8Bit = ImagePalette8bit
+
+  CompositeImage = ImageComposite
+end
 

metadata

@@ -1,17 +1,17 @@
 --- !ruby/object:Gem::Specification
 name: pixelart
 version: !ruby/object:Gem::Version
-  version: 1.3.2
+  version: 1.3.5
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-05-28 00:00:00.000000000 Z
+date: 2022-08-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: chunky_png
+  name: cocos
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -25,7 +25,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: mini_magick
+  name: pixelart-colors
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -39,7 +39,21 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: csvreader
+  name: chunky_png
+  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: mini_magick
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -104,14 +118,12 @@ files:
 - lib/pixelart/base.rb
 - lib/pixelart/blur.rb
 - lib/pixelart/circle.rb
-- lib/pixelart/color.rb
 - lib/pixelart/composite.rb
+- lib/pixelart/convert.rb
 - lib/pixelart/generator.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/sample.rb
 - lib/pixelart/silhouette.rb

data/lib/pixelart/color.rb

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

data/lib/pixelart/gradient.rb

@@ -1,106 +0,0 @@
-
-## inspired / helped by
-##  https://en.wikipedia.org/wiki/List_of_software_palettes#Color_gradient_palettes
-##  https://github.com/mistic100/tinygradient
-##   https://mistic100.github.io/tinygradient/
-##   https://bsouthga.dev/posts/color-gradients-with-python
-
-
-module Pixelart
-
-class Gradient
-
-  def initialize( *stops )
-    ## note:  convert stop colors to rgb triplets e.g.
-    ##         from #ffffff to [255,255,255]
-    ##              #000000 to [0,0,0]  etc.
-    @stops = stops.map do |stop|
-               stop = Color.parse( stop )
-               [Color.r(stop), Color.g(stop), Color.b(stop)]
-             end
-  end
-
-
-  def colors( steps )
-    segments = @stops.size - 1
-
-    ## note: gradient will include start (first)
-    ##   AND stop color (last) - stop color is NOT excluded for now!!
-    if segments == 1
-       start = @stops[0]
-       stop  = @stops[1]
-
-       gradient = linear_gradient( start, stop, steps,
-                                   include_stop: true )
-    else
-      steps_per_segment, mod = steps.divmod( segments )
-      raise ArgumentError, "steps (#{steps}) must be divisible by # of segments (#{segments}); expected mod of 0 but got #{mod}"   if mod != 0
-
-      gradient = []
-      segments.times do |segment|
-        start = @stops[segment]
-        stop  = @stops[segment+1]
-        include_stop =  (segment == segments-1)  ## note: only include stop if last segment!!
-
-        # print "  segment #{segment+1}/#{segments} #{steps_per_segment} color(s) - "
-        # print "  start: #{start.inspect}  "
-        # print  include_stop ? 'include' : 'exclude'
-        # print " stop:  #{stop.inspect}"
-        # print "\n"
-
-        gradient += linear_gradient( start, stop, steps_per_segment,
-                                     include_stop: include_stop )
-      end
-    end
-
-    ## convert to color (Integer)
-    gradient.map do |color|
-      Color.rgb( *color )
-    end
- end
-
-
-
- def interpolate( start, stop, steps, n )
-   ## note: n - expected to start with 1,2,3,etc.
-   color = []
-   3.times do |i|
-     stepize = Float(stop[i] - start[i]) / Float(steps-1)
-     value = stepize * n
-     ## convert back to Integer from Float
-     ##   add 0.5 for rounding up (starting with 0.5) - why? why not?
-     value = (value+0.5).to_i
-     value = start[i] + value
-
-     color << value
-   end
-   color
- end
-
-
- def linear_gradient( start, stop, steps,
-                      include_stop: true )
-
-  gradient = [start]  ## auto-add start color (first color in gradient)
-
-  if include_stop
-    1.upto( steps-2 ).each do |n|  ## sub two (-2), that is, start and stop color
-      gradient << interpolate( start, stop, steps, n )
-    end
-    # note: use original passed in stop color (should match calculated)
-    gradient << stop
-  else
-    1.upto( steps-1 ).each do |n|  ## sub one (-1), that is, start color only
-      ## note: add one (+1) to steps because stop color gets excluded (not included)!!
-      gradient << interpolate( start, stop, steps+1, n )
-    end
-  end
-
-  gradient
-end
-
-
-
-end  # class Gradient
-end  # module Pixelart
-

data/lib/pixelart/palette.rb

@@ -1,72 +0,0 @@
-module Pixelart
-
-
-class Palette8bit     # or use Palette256 alias?
-
-
-  ## auto-add grayscale 0 to 255
-  ##  e.g. rgb(0,0,0)
-  ##       rgb(1,1,1)
-  ##       rgb(2,2,2)
-  ##       ...
-  ##       rgb(255,255,255)
-  GRAYSCALE = (0..255).map { |n| Color.rgb( n, n, n ) }
-
-
-   ## 8x32 gradient color stops
-   ##   see https://en.wikipedia.org/wiki/List_of_software_palettes#Color_gradient_palettes
-
-  SEPIA_STOPS = [
-    ['080400', '262117'],
-    ['272218', '453E2F'],
-    ['463F30', '645C48'],
-    ['655D48', '837A60'],
-
-    ['847A60', 'A29778'],
-    ['A39878', 'C1B590'],
-    ['C2B691', 'E0D2A8'],
-    ['E1D3A9', 'FEEFBF'],
-  ]
-
-  BLUE_STOPS = [
-    ['000000', '001F3E'],
-    ['002040', '003F7E'],
-    ['004080', '005FBD'],
-    ['0060BF', '007FFD'],
-
-    ['0080FF', '009FFF'],
-    ['00A0FF', '00BFFF'],
-    ['00C0FF', '00DFFF'],
-    ['00E0FF', '00FEFF'],
-  ]
-
-  FALSE_STOPS = [
-    ['FF00FF', '6400FF'],
-    ['5F00FF', '003CFF'],
-    ['0041FF', '00DCFF'],
-    ['00E1FF', '00FF82'],
-
-    ['00FF7D', '1EFF00'],
-    ['23FF00', 'BEFF00'],
-    ['C3FF00', 'FFA000'],
-    ['FF9B00', 'FF0000'],
-  ]
-
-
-  def self.build_palette( gradients )
-    colors_per_gradient, mod = 256.divmod( gradients.size )
-    raise ArgumentError, "8bit palette - 256 must be divisible by # of gradients (#{gradients.size}; expected mod of 0 but got #{mod}"   if mod != 0
-
-    colors = []
-    gradients.each do |stops|
-      colors += Gradient.new( *stops ).colors( colors_per_gradient )
-    end
-    colors
-  end
-
-  SEPIA     = build_palette( SEPIA_STOPS )
-  BLUE      = build_palette( BLUE_STOPS )
-  FALSE     = build_palette( FALSE_STOPS )
-end  # class Palette8bit
-end # module Pixelart
-