originals 1.0.1 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 46f999cee5a39188cde3f05e7286edeb3b979eb2a9b828c0f35979cc87cd66f9
-  data.tar.gz: ecb9a41255aea891551c6eabe3b74f65cff23dadca7f95dd0f89e30c90ce837d
+  metadata.gz: a0ba81141f671af0a54e1b962097a36eda487d0c8e6b1b04732709f3cb83d261
+  data.tar.gz: aa95846faac6ceb0209d86929a6f80a4263236c12cae8a30322db1876e0d237e
 SHA512:
-  metadata.gz: 4bfc10e29f89b14f1b45e912abb02365a4662227fc552812f529fa702976a37b020360980378683c689333c48915f6b5e9c27981fb023b6da5ba8ac535596904
-  data.tar.gz: c77c2a33f58c69b3eb76bdaf8e425611c9ed2ae333a5e08f4a814c3ec5a69dfb83fb0d5e7efc908f1a92e7672273e184718924220c841d933ddecabe155f9190
+  metadata.gz: '018a112f6b7718e71c2ad4becfd7637c15292bed978c8bdf6c6b6cf924747fbbacdef7a23e39e56527ed8ea8348d7d0d0bc86aa57251be42265e8196e8afdca2'
+  data.tar.gz: 9f27aefeb8bdd22667e4784d569b95871bd0f7588c3c60ee76c10d8081e8287fa5417f604cd94b00da2aa07dab96eff50634c9a607e5bd7b0cec80f42b3b5432

data/Manifest.txt

@@ -6,5 +6,6 @@ Rakefile
 bin/fab
 bin/fabricate
 lib/originals.rb
+lib/originals/service.rb
 lib/originals/tool.rb
 lib/originals/version.rb

data/README.md

@@ -23,10 +23,12 @@ $ fab -h
 resulting in:
 
 ```
-Usage: fab [options] name [attribute] ...
+Usage: fab [options] name [attribute attribute ...]
+       fab [options] name id
     -z, --zoom NUM                   Zoom factor x2, x4, x8, etc. (default: 1)
     -b, --background, --bg STRING    Background (default: transparent)
     -i, --id NUM                     Unique identifier (default: none)
+    -n, --name STRING                Base name (default: punk|phunk|marilyn|etc.)
 
     -h, --help                       Prints this help
 ```
@@ -35,10 +37,11 @@ Usage: fab [options] name [attribute] ...
 
 ### Punks (24x24)
 
-_Fabricate punk character pixel art originals from text attributes (from scratch / zero) via builtin spritesheet_
+_A free (pixel) art service brought to you by the [punks, (phunks, philips, marilyns, & more) generation library / gem »](https://github.com/cryptopunksnotdead/cryptopunks/tree/master/cryptopunks)_
 
 
-Let's try:
+
+Fab(ricate) punk character pixel art originals from text attributes (from scratch / zero) via built-in spritesheet. Let's try:
 
 ```
 $ fab punk alien headband
@@ -110,7 +113,7 @@ resulting in:
 
 
 
-### Phunks (24x24)
+#### Phunks (24x24)
 
 Let's try some left-looking punks also known as Phunks -  "hand-phlipped" by Philip the Intern
 
@@ -128,7 +131,7 @@ resulting in:
 
 
 
-### Philips (24x24)
+#### Philips (24x24)
 
 Let's try some left-looking philips (pre-configured phunk
 with the built-in attributes: Male 3):
@@ -150,7 +153,7 @@ resulting in:
 
 
 
-### Marilyns (24x24)
+#### Marilyns (24x24)
 
 Let's try some left-looking marilyns (pre-configured phunk
 with the built-in attributes: Female 3, Wild Blonde, Mole, Blue Eye Shadow):
@@ -190,8 +193,11 @@ resulting in:
 ![](https://github.com/pixelartexchange/originals/raw/master/i/marilyn2.4@4x.png)
 
 
+
 ### Shiba Inu Doge (24x24)
 
+_A free (pixel) art service brought to you by the [shiba-inus generation library / gem »](https://github.com/pixelartexchange/pixelart/tree/master/shibainus)_
+
 
 Let's try some shiba inu doge - much wow:
 
@@ -230,6 +236,8 @@ resulting in:
 
 ### Coolcats (24x24)
 
+_A free (pixel) art service brought to you by the [coolcats generation library / gem »](https://github.com/pixelartexchange/pixelart/tree/master/coolcats)_
+
 
 Let's try some coolcats:
 
@@ -271,6 +279,8 @@ resulting in:
 
 ### Nouns (32x32)
 
+_A free (pixel) art service brought to you by the [nouns generation library / gem »](https://github.com/pixelartexchange/pixelart/tree/master/nouns)_
+
 
 Let's try some noun (pixel avatars):
 
@@ -321,6 +331,9 @@ resulting in:
 
 ### Moonbirds / Owls (42x42)
 
+_A free (pixel) art service brought to you by the [moonbirds (& owls)generation library / gem »](https://github.com/pixelartexchange/pixelart/tree/master/moonbirds)_
+
+
 
 Let's try some super-rare never-before-seen moonbirds / owls:
 
@@ -360,12 +373,99 @@ resulting in:
 
 
 
-
 And so on. Stay tuned for more original artwork series!
 
 
 
 
+### Bonus: Readymades - Start w/ (Pixel) Art From (Online) Collections
+
+_A free readymade (pixel) art service brought to you by the [artbase (server edition) »](https://github.com/pixelartexchange/artbase.server)_
+
+
+Yes, you can. Pick any readymade pixel art (by number) from any of the many collections served-up by an artbase (server edition)
+installation.
+By default "out-of-the-box" the artbase web server / service installation running online
+at [pixelartexchange.herokuapp.com](https://pixelartexchange.herokuapp.com/) gets called via HTTP.
+
+
+
+#### More Punks (24x24)
+
+Let's try some more punks:
+
+```
+$ fab morepunk no.179
+$ fab morepunk no.180
+$ fab morepunk no.190
+```
+
+resulting in:
+
+![](https://github.com/pixelartexchange/originals/raw/master/i/morepunk179.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/morepunk180.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/morepunk190.png)
+
+4x  (using the `--zoom=4`/`-z4` option)
+
+![](https://github.com/pixelartexchange/originals/raw/master/i/morepunk179@4x.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/morepunk180@4x.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/morepunk190@4x.png)
+
+
+
+####  Punk Rocks (24x24)
+
+Let's try some punk rocks:
+
+```
+$ fab punkrock no.1
+$ fab punkrock no.4
+$ fab punkrock no.5
+```
+
+resulting in:
+
+![](https://github.com/pixelartexchange/originals/raw/master/i/punkrock1.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/punkrock4.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/punkrock5.png)
+
+4x  (using the `--zoom=4`/`-z4` option)
+
+![](https://github.com/pixelartexchange/originals/raw/master/i/punkrock1@4x.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/punkrock4@4x.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/punkrock5@4x.png)
+
+
+
+####  Dooggies (32x32)
+
+Let's try some dooggies:
+
+```
+$ fab dooggie no.0
+$ fab dooggie no.571
+$ fab dooggie no.7411
+```
+
+resulting in:
+
+![](https://github.com/pixelartexchange/originals/raw/master/i/dooggie0.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/dooggie571.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/dooggie7411.png)
+
+4x  (using the `--zoom=4`/`-z4` option)
+
+![](https://github.com/pixelartexchange/originals/raw/master/i/dooggie0@4x.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/dooggie571@4x.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/dooggie7411@4x.png)
+
+
+
+And so on.
+
+
+
 ## Install
 
 Just install the gem:

data/Rakefile

@@ -31,6 +31,7 @@ Hoe.spec 'originals' do
     ['moonbirds'],
     ['coolcats'],
     ['nouns'],
+    ['webclient'],
   ]
 
   self.licenses = ['Public Domain']

data/lib/originals/service.rb

@@ -0,0 +1,63 @@
+
+## get image via artbase (HTTP) web service
+
+
+## forward define superclass for image
+module Artbase
+  class Image < Pixelart::Image; end
+end
+
+
+
+module Artbase
+  ################
+  #  convenience helpers / shortcuts
+  def self.service   ## "shared" single (default) instance
+    @service ||= Service.new
+  end
+
+  class Image
+    def self.get( name, id )  Artbase.service.get( name, id ); end
+  end  # class Image
+
+
+  ## todo/fix: move name variants into artbase server itelf - why? why not?
+  COLLECTIONS = {
+      'punk'      => 'punks',
+      'morepunk'  => 'morepunks',
+    }
+
+  ###################
+  #  main artbase service handler / machinery
+  class Service
+    DEFAULT_BASE_URL = 'https://pixelartexchange.herokuapp.com'
+
+
+    def initialize( base_url=DEFAULT_BASE_URL )
+      @base_url = base_url
+    end
+
+    def get( collection, id )
+
+      url = "#{@base_url}/#{collection}/#{id}.png"
+      res = Webclient.get( url )
+
+      puts "#{res.status.code} #{res.status.message}"
+      puts "    content_type: #{res.content_type}"
+      puts "    content_length: #{res.content_length} bytes (#{res.content_length.class.name})"
+
+      if res.status.ok?
+        ## todo/fix: move to Pixelart::Image itself
+        ##     use from_blob or such - why? why not
+        img_inner = ChunkyPNG::Image.from_blob( res.blob )
+        img = Artbase::Image.new( img_inner.width, img_inner.height, img_inner )
+        img
+      else
+        puts "!! HTTP ERROR - image data request failed; sorry"
+        return nil
+      end
+    end
+  end # class Service
+
+end    # module Artbase
+

data/lib/originals/tool.rb

@@ -1,6 +1,9 @@
 module Originals
 class Tool
 
+
+
+
   def self.main( args=ARGV )
     puts "==> welcome to the fab(ricate) tool with args:"
     pp args
@@ -50,20 +53,57 @@ class Tool
     name       = args[0]   ## todo/check - use collection_name/slug or such?
     attributes = args[1..-1]
 
+
     ## normalize name of series
     ##   e.g.   Shiba Inu  => shibainu  etc.
-    key = name.downcase.gsub( '[ ()_-]', '' )
+    key = Originals.factory._norm_name( name )
+
+    ## check for readymade via series id
+    ##    allow some "literal" variants e.g.
+    ##      punk no.1 or no.001
+    ##      punk #1   or #001
+    ##  etc.
+    ##    and some more in the future - why? why not?
+
+    id = nil
+
+    img =   if attributes.size == 1 && id=Originals.factory._parse_id( attributes[0] )
+                ## check for known collection names
+                ## (mostly singular to plural)  - keep? why? why not?
+                collection = Artbase::COLLECTIONS[ key ] || key
+                Artbase::Image.get( collection, id )
+             else
+                Original::Image.fabricate( key, *attributes )
+             end
+
+    if img.nil?
+      puts "!! ERROR - don't know how to fabricate >#{name}<; sorry"
+      exit 1
+    end
 
-    img = Original::Image.fabricate( key, *attributes,
-                                     background: options[ :background] )
 
+    ## note: keep adding background as a separate step for now
+    if options[ :background]
+       ##  hack: for now for artbase collections
+       ##          try to remove background if any
+       ##         keep? why? why not?
+       img = img.transparent    if id
 
+      img = Original.factory._background( img,
+                                          options[ :background ] )
+    end
 
-    basename = if options[:name]
-                 "#{options[:name]}#{options[:id]}"
-               else
-                 "#{key}#{options[:id]}"
-               end
+    basename = String.new('')   ## note: start with our own string buffer
+                                ##    otherwise assigned first string gets modified!!
+    basename +=   options[:name] ? options[:name] : key
+
+    basename += if options[:id]
+                  options[:id]
+                elsif id
+                  id.to_s
+                else
+                  '' # add nothing
+                end
 
 
     path =  if options[:zoom]

data/lib/originals/version.rb

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

data/lib/originals.rb

@@ -5,6 +5,8 @@ require 'moonbirds'
 require 'coolcats'
 require 'nouns'
 
+require 'webclient'
+
 
 
 ## our own code
@@ -28,127 +30,113 @@ end
 ##
 #  "wrap" fabricate inside Image - why? why not?
 class Image
-def self.fabricate( name, *attributes, background: nil )  ## add fac alias - why? why not?
+
+def self.fabricate( name, *attributes, background: nil )
    ## normalize name of series
    ##   e.g.   Shiba Inu  => shibainu  etc.
-   key = name.downcase.gsub( '[ ()_-]', '' )
-
-   img =  if ['punk', 'punks',
-              'cryptopunk', 'cryptopunks'].include?( key )
-              Originals.factory.punk( *attributes, background: background )
-          elsif ['phunk', 'phunks',
-            'cryptophunk', 'cryptophunks'].include?( key )
-              Originals.factory.phunk( *attributes, background: background )
-          elsif ['marilyn', 'marilyns' ].include?( key )
-              Originals.factory.marilyn( *attributes, background: background )
-          elsif ['philip', 'philips',
-                 'philipp', 'philipps' ].include?( key )
-              Originals.factory.philip( *attributes, background: background )
-          elsif ['doge', 'doges',
-                 'shiba', 'shibas',
-                 'shibainu', 'shibainus'].include?( key )
-              Originals.factory.shiba( *attributes, background: background )
-          elsif ['bird', 'birds',
-                 'moonbird', 'moonbirds',
-                 'owl', 'owls'].include?( key )
-              Originals.factory.bird( *attributes, background: background )
-          elsif ['coolcat', 'coolcats'].include?( key )
-              Originals.factory.coolcat( *attributes, background: background )
-          elsif ['noun', 'nouns'].include?( key )
-              Originals.factory.noun( *attributes, background: background )
-          else
-            puts "!! ERROR; don't know how to fabricate >#{name}<; sorry"
-            exit 1
-          end
+   key = Originals.factory._norm_name( name )
+
+   img = if ['punk', 'punks',
+             'cryptopunk', 'cryptopunks'].include?( key )
+                   Originals.factory.punk( *attributes )
+         elsif ['phunk', 'phunks',
+                'cryptophunk', 'cryptophunks'].include?( key )
+                  Originals.factory.phunk( *attributes )
+         elsif ['marilyn', 'marilyns' ].include?( key )
+                  Originals.factory.marilyn( *attributes )
+         elsif ['philip', 'philips',
+                'philipp', 'philipps' ].include?( key )
+                  Originals.factory.philip( *attributes )
+         elsif ['doge', 'doges',
+                'shiba', 'shibas',
+                'shibainu', 'shibainus'].include?( key )
+                  Originals.factory.shiba( *attributes )
+         elsif ['bird', 'birds',
+                'moonbird', 'moonbirds',
+                'owl', 'owls'].include?( key )
+                  Originals.factory.bird( *attributes )
+         elsif ['coolcat', 'coolcats'].include?( key )
+                  Originals.factory.coolcat( *attributes )
+         elsif ['noun', 'nouns'].include?( key )
+                  Originals.factory.noun( *attributes )
+         else
+             return nil   ## return nil
+         end
+
+   ## note: keep add background as a separate (last) step for now - why? why not?
+   img = Originals.factory._background( img, background )   if background
    img
 end
 class << self
-   alias_method :fab, :fabricate
+  alias_method :fab, :fabricate
 end
-end # class Image
 
 
+end # class Image
 
 
 
 class Factory     ## add Fabricator/Artist/Artfactory/? alias or such - why? why not?
 
-def punk( *attributes, mirror: false, background: nil )
+
+def punk( *attributes )
     ## note: if no attributes passed in
     ##    default to ['Male 2']
     attributes = ['Male 2']  if attributes.size == 0
 
-   _generate_punk( *attributes,
-                   mirror:     mirror,
-                   background: background )
+    Cryptopunks::Image.generate( *attributes )
 end
 
-def phunk( *attributes, background: nil )
-   punk( *attributes,
-          mirror: true,
-          background: background )
+def phunk( *attributes )
+  punk( *attributes ).mirror
 end
 
 
 MARILYN_ATTRIBUTES = ['Female 3', 'Wild Blonde', 'Mole',
                       'Blue Eye Shadow']
 
-def marilyn( *attributes, background: nil )
-   _generate_punk( *MARILYN_ATTRIBUTES,
-                   *attributes,
-                   mirror: true,
-                   background: background )
+def marilyn( *attributes )
+  phunk( *MARILYN_ATTRIBUTES, *attributes )
 end
 
 
 PHILIP_ATTRIBUTES = ['Male 3']
-def philip( *attributes, background: nil )
-  _generate_punk( *PHILIP_ATTRIBUTES,
-                  *attributes,
-                  mirror: true,
-                  background: background )
+def philip( *attributes )
+  phunk( *PHILIP_ATTRIBUTES, *attributes )
 end
 
 
 
 ## add method alias doge, shiba_inu etc. - why? why not?
-def shiba( *attributes, background: nil )
+def shiba( *attributes )
     ## note: if no attributes passed in
     ##    default to ['Classic']
     attributes = ['Classic']  if attributes.size == 0
 
-    doge = Shiba::Image.generate( *attributes )
-    doge = _background( doge, background )  if background
-    doge
+    Shiba::Image.generate( *attributes )
 end
 
 
 ## add method alias moonbird, owl etc. - why? why not?
-def bird( *attributes, background: nil )
+def bird( *attributes )
   attributes = ['Brave Glitch']  if attributes.size == 0
 
-  bird = Moonbird::Image.generate( *attributes )
-  bird = _background( bird, background )  if background
-  bird
+  Moonbird::Image.generate( *attributes )
 end
 
 
-def coolcat( *attributes, background: nil )
-  cat = Coolcat::Image.generate( *attributes )
-  cat = _background( cat, background )  if background
-  cat
+def coolcat( *attributes )
+  Coolcat::Image.generate( *attributes )
 end
 
 
-def noun( *attributes, background: nil )
+def noun( *attributes )
   attributes = ['Body Grayscale 1',
                 'Checker Bigwalk Rainbow',
                 'Head Beer',
                 'Glasses Square Fullblack']  if attributes.size == 0
 
-  noun = Noun::Image.generate( *attributes )
-  noun = _background( noun, background )  if background
-  noun
+  Noun::Image.generate( *attributes )
 end
 
 
@@ -157,19 +145,6 @@ end
 ###
 #   helpers
 
-def _generate_punk( *attributes,
-                     mirror:     false,
-                     background: nil )
-   punk = Cryptopunks::Image.generate( *attributes )
-
-   punk = punk.mirror         if mirror
-   ## note: add background as LAST step  (after mirror operation)
-   ##                that is, if mirror=true background will NOT get mirrored
-   punk = _background( punk, background )  if background
-   punk
-end
-
-
 def _background( base, background )
     width, height = base.width, base.height
 
@@ -187,6 +162,23 @@ def _background( base, background )
     img2
 end
 
+def _norm_name( str )
+   str.downcase.gsub( /[ ()_-]/, '' )
+end
+
+def _parse_id( str )
+  if str.gsub( /[ #()._-]/, '' ) =~ /
+                    ^(no|n|id)?
+                    (?<id>[0-9]+)$
+                     /ix
+    id = Regexp.last_match[:id].to_i(10)   ## note: add base 10 (for 008 or such)
+    id
+  else
+     nil   # retur nil if no match
+  end
+end
+
+
 end # class Factory
 
 
@@ -194,7 +186,7 @@ end # module Originals
 
 
 
-
+require 'originals/service'
 require 'originals/tool'
 
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: originals
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.1.0
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-06-02 00:00:00.000000000 Z
+date: 2022-06-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cryptopunks
@@ -80,6 +80,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: webclient
+  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
@@ -136,6 +150,7 @@ files:
 - bin/fab
 - bin/fabricate
 - lib/originals.rb
+- lib/originals/service.rb
 - lib/originals/tool.rb
 - lib/originals/version.rb
 homepage: https://github.com/pixelartexchange/originals