pixelart 1.3.0 → 1.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f203be5e0f2e2a06f88711fd51da837fb71212e58c0bc9aef80358f661f10f58
-  data.tar.gz: f1377fcab0ec03d91ca692ed8d6e2222bacf5aedc5e477121c4cf1950968ad22
+  metadata.gz: a9cb1460263f319b98c4d333f6caa42118eb94f583f9cc6cdaa5bfa6bc4316b9
+  data.tar.gz: 2deabe3c3bc35c62d249e0ff5178d23f986d1131c96daf53a8d36fde51cd6de8
 SHA512:
-  metadata.gz: b3c11e63d1764934b71a62410c23e14af07b42da9ce046a5853b92d493809abd3bede1ef3b40c025e61fd28d9efcb77f87bc31a9997def982dd65e67b62da0a0
-  data.tar.gz: 78f8de9b81fa1ed6c6a77a5ea3bc6414aef36837314f5a2a073c1ab4683b31899c5bcdfe3be85ad7e3c5159f3ee708d9f231e97799f2262378f5b7b49998119a
+  metadata.gz: 57213049f46aac9a612adb3d9e236ce03aa336318705cabaed98f1f87557dc5dc08a73a7f50254852ab0c3c988ca0ed3d5b3ba6666925640ab837692c573be7c
+  data.tar.gz: 9ff7ae16a77eca4b2d4deb65b98747aa053ab97ab15b0f8a40d373f5ecb96dcd2c18d2fdfd18beca0c06a5e9330719dd2df1a3be1efac07c8f008dfa0b4db614

data/Manifest.txt

@@ -8,12 +8,14 @@ lib/pixelart/blur.rb
 lib/pixelart/circle.rb
 lib/pixelart/color.rb
 lib/pixelart/composite.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
 lib/pixelart/sketch.rb
 lib/pixelart/spots.rb

data/lib/pixelart/base.rb

@@ -31,12 +31,18 @@ require 'pixelart/palette'
 require 'pixelart/image'
 require 'pixelart/composite'
 
+require 'pixelart/sample'   ## (down)sample / pixelate
+
 
 require 'pixelart/pixelator'
 
 require 'pixelart/misc'   ## misc helpers
 require 'pixelart/stripes'
 
+
+require 'pixelart/generator'   ## generate images from text via spritesheets
+
+
 #########################
 # (special) effects / filters / etc
 require 'pixelart/circle'

data/lib/pixelart/generator.rb

@@ -0,0 +1,199 @@
+####
+#  "simple" generator (no different sizes, genders, etc.)
+#     uses built-in spritesheet for (archetypes &) attributes
+
+
+module Pixelart
+
+  class Metadata
+    class Sprite
+      attr_reader :id, :name, :type, :more_names
+
+      def initialize( id:,
+                      name:,
+                      type:,
+                      more_names: [] )
+         @id         = id      # zero-based index eg. 0,1,2,3, etc.
+         @name       = name
+         @type       = type
+         @more_names = more_names
+      end
+   end  # class Metadata::Sprite
+  end # class Metadata
+
+
+
+
+  class Generator
+
+ ######
+ # static helpers  - (turn into "true" static self.class methods - why? why not?)
+ #
+ def self.normalize_key( str )
+   ## add & e.g. B&W
+   ## add ' e.g. McDonald's Red
+    str.downcase.gsub(/[ ()&°'_-]/, '').strip
+ end
+
+ def self.normalize_name( str )
+   ## normalize spaces in more names
+   str.strip.gsub( /[ ]{2,}/, ' ' )
+ end
+
+ def normalize_key( str )     self.class.normalize_key( str ); end
+ def normalize_name( str )    self.class.normalize_name( str ); end
+
+
+
+ def build_attributes_by_name( recs )
+    h = {}
+    recs.each_with_index do |rec|
+      names = [rec.name] + rec.more_names
+
+      names.each do |name|
+        key = normalize_key( name )
+
+        if h[ key ]
+          puts "!!! ERROR - attribute name is not unique:"
+          pp rec
+          puts "duplicate:"
+          pp h[key]
+          exit 1
+        end
+        h[ key ] = rec
+      end
+   end
+    ## pp h
+    h
+ end
+
+
+ def build_recs( recs )   ## build and normalize (meta data) records
+    ## sort by id
+    recs = recs.sort do |l,r|
+                       l['id'].to_i( 10 ) <=> r['id'].to_i( 10 )   # use base10 (decimal)
+                     end
+
+    ## assert all recs are in order by id (0 to size)
+    recs.each_with_index do |rec, exp_id|
+       id = rec['id'].to_i(10)
+       if id != exp_id
+          puts "!! ERROR -  meta data record ids out-of-order - expected id #{exp_id}; got #{id}"
+          exit 1
+       end
+    end
+
+    ## convert to "wrapped / immutable" kind-of struct
+    recs = recs.map do |rec|
+             id         = rec['id'].to_i( 10 )
+             name       = normalize_name( rec['name'] )
+             type       = rec['type']
+
+             more_names = (rec['more_names'] || '').split( '|' )
+             more_names = more_names.map {|str| normalize_name( str ) }
+
+             Metadata::Sprite.new(
+               id:         id,
+               name:       name,
+               type:       type,
+               more_names: more_names )
+           end
+    recs
+ end  # method build_recs
+
+
+
+ def initialize( image_path="./spritesheet.png",
+                 meta_path="./spritesheet.csv",
+                 width: 24,
+                 height: 24 )
+    @width  = width
+    @height = height
+
+    @sheet = ImageComposite.read( image_path, width: @width, height: @height )
+    recs  = CsvHash.read( meta_path )
+
+    @recs = build_recs( recs )
+
+    ## lookup by "case/space-insensitive" name / key
+    @attributes_by_name = build_attributes_by_name( @recs )
+ end
+
+
+ def spritesheet() @sheet; end
+ alias_method  :sheet, :spritesheet
+
+
+ def records() @recs; end
+ alias_method :meta, :records
+
+
+
+
+ def find_meta( q )
+    key = normalize_key( q )  ## normalize q(uery) string/symbol
+
+    rec = @attributes_by_name[ key ]
+    if rec
+       puts " lookup >#{key}< => #{rec.id}: #{rec.name} / #{rec.type}"
+    else
+       puts "!! WARN - no lookup found for key >#{key}<"
+    end
+
+    rec
+ end
+
+ def find( q )
+    rec = find_meta( q )
+
+    ## return image if record found
+    rec ? @sheet[ rec.id ] : nil
+ end
+
+
+ def to_recs( *values )
+      recs       = []
+
+      attribute_names  = values
+
+      attribute_names.each do |attribute_name|
+        attribute = find_meta( attribute_name )
+        if attribute.nil?
+           puts "!! ERROR - attribute >#{attribute_name}< not found; sorry"
+           exit 1
+        end
+        recs << attribute
+      end
+
+      recs
+ end
+
+
+
+
+ def generate_image( *values, background: nil )
+
+    ids = if values[0].is_a?( Integer )  ## assume integer number (indexes)
+              values
+          else ## assume strings (names)
+              to_recs( *values ).map { |rec| rec.id }
+          end
+
+
+    img = Image.new( @width, @height )
+
+    if background    ## for now assume background is (simply) color
+       img.compose!( Image.new( @width, @height, background ) )
+    end
+
+    ids.each do |id|
+      img.compose!( @sheet[ id ] )
+    end
+
+    img
+ end
+ alias_method :generate, :generate_image
+
+ end # class Generator
+
+end # module Pixelart

data/lib/pixelart/sample.rb

@@ -0,0 +1,120 @@
+module Pixelart
+
+  class Image
+
+def self.calc_sample_steps( width, new_width,
+                            center: true,
+                            debug: false )
+  ## todo/fix: assert new_width is smaller than width
+  if debug
+    puts
+    puts "==> from: #{width}px  to: #{new_width}px"
+  end
+
+  indexes = []
+
+  base_step = width / new_width    ## pixels per pixel
+
+  err_step = (width % new_width) * 2   ## multiply by 2
+  denominator = new_width * 2   # denominator (in de - nenner  e.g. 1/nenner 4/nenner)
+
+  overflow = err_step*new_width/denominator  ## todo/check - assert that div is always WITHOUT remainder!!!!!
+
+  if debug
+    puts
+    puts "base_step (pixels per pixel):"
+    puts "  #{base_step}     -  #{base_step} * #{new_width}px = #{base_step*new_width}px"
+    puts "err_step  (in 1/#{width}*2):"
+    puts "  #{err_step} / #{denominator}      - #{err_step*new_width} / #{denominator} = +#{err_step*new_width/denominator}px overflow"
+    puts
+  end
+
+  # initial pixel offset
+  index = 0
+  err   = err_step/2   ##  note: start off with +err_step/2 to add overflow pixel in the "middle"
+
+
+  index +=  if center.is_a?( Integer )
+              center
+            elsif center
+              base_step/2
+            else
+               0   #  use 0px offset
+            end
+
+
+  new_width.times do |i|
+    if err >= denominator ## overflow
+      puts "    -- overflow #{err}/#{denominator} - add +1 pixel offset to #{i}"  if debug
+      index += 1
+      err   -= denominator
+    end
+
+    puts "  #{i} => #{index}  -- #{err} / #{denominator}"  if debug
+
+
+    indexes[i] = index
+
+    index += base_step
+    err   += err_step
+  end
+
+  indexes
+end
+
+
+
+    ## todo/check: rename to sample to resample or downsample - why? why not?
+    def sample( steps_x, steps_y=steps_x,
+                top_x: 0, top_y: 0 )
+      width   = steps_x.size
+      height  = steps_y.size
+      puts "    downsampling from #{self.width}x#{self.height} to #{width}x#{height}..."
+
+      dest = Image.new( width, height )
+
+      steps_x.each_with_index do |step_x, x|
+        steps_y.each_with_index do |step_y, y|
+           pixel = self[top_x+step_x, top_y+step_y]
+
+           dest[x,y] =  pixel
+        end
+      end
+
+      dest
+    end
+    alias_method :pixelate, :sample
+
+
+def sample_debug( steps_x, steps_y=steps_x,
+              color:  Color.parse( '#ffff00' ),
+              top_x: 0,
+              top_y: 0)  ## add a yellow pixel
+
+   ## todo/fix:  get a clone of the image (DO NOT modify in place)
+
+    img = self
+
+  steps_x.each_with_index do |step_x, x|
+    steps_y.each_with_index do |step_y, y|
+        base_x = top_x+step_x
+        base_y = top_y+step_y
+
+        img[base_x,base_y] = color
+
+       ## add more colors
+       img[base_x+1,base_y] = color
+       img[base_x+2,base_y] = color
+
+       img[base_x,base_y+1] = color
+       img[base_x,base_y+2] = color
+      end
+  end
+
+  self
+end
+alias_method :pixelate_debug, :sample_debug
+
+  end  # class Image
+end   # module Pixelart
+

data/lib/pixelart/version.rb

@@ -3,7 +3,7 @@ module Pixelart
 
   MAJOR = 1
   MINOR = 3
-  PATCH = 0
+  PATCH = 1
   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: 1.3.0
+  version: 1.3.1
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-05-03 00:00:00.000000000 Z
+date: 2022-05-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: chunky_png
@@ -106,12 +106,14 @@ files:
 - lib/pixelart/circle.rb
 - lib/pixelart/color.rb
 - lib/pixelart/composite.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
 - lib/pixelart/sketch.rb
 - lib/pixelart/spots.rb