originals 0.0.1 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0dc0b708faa79c717f62c1662f04ca5b3a92ae3af34b2b186917c06e0c671cce
-  data.tar.gz: 588504c3aeafda0c47c24c34fdbe2a9fefb241c1ac581c31af42ea698c121570
+  metadata.gz: c3867e1b818cebd7b9c563808bff7318af27fd681cefde7d52ed39af67ff43ff
+  data.tar.gz: e70ff427357f892df830dc343398c34db7640f57eede9951aaf4c8f6bfefc798
 SHA512:
-  metadata.gz: 93401936c4cf2bd2a6771e2da58d1db3cd869d1fb9dcd0dc7174525f0ad522e09b49976e432b3dbf9ef44ab3ff1f11894ba1c840093cadb0252efb5871c1269c
-  data.tar.gz: 99ee16f20effb783d9501202361a85737872f782e75ec96aabdfe36727f58c2b4ac174dc007a48c5a59f16317da340701e6cc81c55953efd29dcd023ca72ae14
+  metadata.gz: 9f34ca1a5baa49c374bb4022d8d2c83ee8e2ea78543bca1c050f1fb9252804fed021983427310de65b9dff288a1824aec8ed985f6c4ccaaa6ade0bcda687a2ce
+  data.tar.gz: 1be3dd507e1b33b36f1b7b597892f1cd9638038aeeb8a5af69247ae3156a6cf1fef3467b560f4ad8ca1e853001052cbd186b5dfc1ff43358e0478ec7443e5739

data/Manifest.txt

@@ -3,5 +3,8 @@ LICENSE.md
 Manifest.txt
 README.md
 Rakefile
+bin/fab
+bin/fabricate
 lib/originals.rb
+lib/originals/tool.rb
 lib/originals/version.rb

data/README.md

@@ -1,18 +1,252 @@
-#  Factory of Modern Originals (FOMO) 
+#  Factory of Modern Originals (FOMO)
 
-Do-It-Yourself (DIY) Yes, You Can! Fab(criate) Your Own Unique (Pixel) Artworks w/ Text Attributes (Via Built-In Spritesheets) Incl. 2X/4X/8X Zoom for Bigger Sizes And More
+originals - do-it-yourself (DIY) - yes, you can! - fab(criate) your own unique (pixel) artworks w/ text attributes (via built-in spritesheets) incl. 2x/4x/8x zoom for bigger sizes and more
 
 
+* home  :: [github.com/pixelartexchange/originals](https://github.com/pixelartexchange/originals)
+* bugs  :: [github.com/pixelartexchange/originals/issues](https://github.com/pixelartexchange/originals/issues)
+* gem   :: [rubygems.org/gems/originals](https://rubygems.org/gems/originals)
+* rdoc  :: [rubydoc.info/gems/originals](http://rubydoc.info/gems/originals)
 
 
 
 
+##  Command-Line Usage
 
 
+Use the `fab` (or `fabricate`) command line tool. Try:
 
+```
+$ fab -h
+```
 
+resulting in:
 
+```
+Usage: fab [options] name [attribute] ...
+    -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)
 
+    -h, --help                       Prints this help
+```
 
 
 
+### Punks (24x24)
+
+_Fabricate punk character pixel art originals from text attributes (from scratch / zero) via builtin spritesheet_
+
+
+Let's try:
+
+```
+$ fab punk alien headband
+```
+
+resulting in:
+
+![](https://github.com/pixelartexchange/originals/raw/master/i/punk0.png)
+
+Let's try  the `-z/--zoom` factor 2x, 4x, 8x, etc.:
+
+```
+$ fab --zoom=4 punk alien headband
+# -or-
+$ fab -z4 punk alien headband
+```
+
+resulting in:
+
+4x ![](https://github.com/pixelartexchange/originals/raw/master/i/punk0@4x.png)
+
+
+Let's try some more:
+
+```
+$ fab punk male3 peak_spike goat horned_rim_glasses
+$ fab punk demon heart_shades
+```
+
+resulting in:
+
+![](https://github.com/pixelartexchange/originals/raw/master/i/punk1.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/punk2.png)
+
+4x  (using the `--zoom=4`/`-z4` option)
+
+![](https://github.com/pixelartexchange/originals/raw/master/i/punk1@4x.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/punk2@4x.png)
+
+
+
+Let's try the `-b/--background` option with two solid colors
+(e.g. `#638596`  and `#ffbf00`) and with the built-in ukraine and  pride (rainbow) flag:
+
+
+```
+$ fab --background=638596 punk male3 peak_spike goat horned_rim_glasses
+# -or-
+$ fab -b638596 punk male3 peak_spike goat horned_rim_glasses
+
+$ fab --background=ffbf00 punk male3 peak_spike goat horned_rim_glasses
+$ fab --background=ukraine punk male3 peak_spike goat horned_rim_glasses
+$ fab --background=pride punk male3 peak_spike goat horned_rim_glasses
+```
+
+resulting in:
+
+![](https://github.com/pixelartexchange/originals/raw/master/i/punk1.1.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/punk1.2.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/punk1.3.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/punk1.4.png)
+
+4x  (using the `--zoom=4`/`-z4` option)
+
+![](https://github.com/pixelartexchange/originals/raw/master/i/punk1.1@4x.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/punk1.2@4x.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/punk1.3@4x.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/punk1.4@4x.png)
+
+
+
+### Phunks (24x24)
+
+Let's try some left-looking punks also known as Phunks -  "hand-phlipped" by Philip the Intern
+
+```
+$ fab phunk male2 spots hoodie
+```
+
+resulting in:
+
+![](https://github.com/pixelartexchange/originals/raw/master/i/phunk0.png)
+
+4x  (using the `--zoom=4`/`-z4` option)
+
+![](https://github.com/pixelartexchange/originals/raw/master/i/phunk0@4x.png)
+
+
+
+### Philips (24x24)
+
+Let's try some left-looking philips (pre-configured phunk
+with the built-in attributes: Male 3):
+
+```
+$ fab philip
+$ fab philip jester_hat smile
+```
+
+resulting in:
+
+![](https://github.com/pixelartexchange/originals/raw/master/i/philip0.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/philip1.png)
+
+4x  (using the `--zoom=4`/`-z4` option)
+
+![](https://github.com/pixelartexchange/originals/raw/master/i/philip0@4x.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/philip1@4x.png)
+
+
+
+### 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):
+
+```
+$ fab marilyn
+$ fab marilyn 3d_glasses
+$ fab marilyn flowers earring smile
+$ fab marilyn hot_lipstick big_shades
+
+# or with some backgrounds
+$ fab --background=638596 marilyn hot_lipstick big_shades
+$ fab --background=ffbf00 marilyn hot_lipstick big_shades
+$ fab --background=ukraine marilyn hot_lipstick big_shades
+$ fab --background=pride marilyn hot_lipstick big_shades
+```
+
+resulting in:
+
+![](https://github.com/pixelartexchange/originals/raw/master/i/marilyn0.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/marilyn1.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/marilyn3.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/marilyn2.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/marilyn2.1.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/marilyn2.2.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/marilyn2.3.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/marilyn2.4.png)
+
+4x  (using the `--zoom=4`/`-z4` option)
+
+![](https://github.com/pixelartexchange/originals/raw/master/i/marilyn0@4x.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/marilyn1@4x.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/marilyn3@4x.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/marilyn2.1@4x.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/marilyn2.2@4x.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/marilyn2.3@4x.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/marilyn2.4@4x.png)
+
+
+### Shiba Inu Doge (24x24)
+
+
+Let's try some shiba inu doge - much wow:
+
+
+```
+$ fab doge alien headband
+$ fab doge dark tiara big_shades
+
+# -or- with some backgrounds
+$ fab --background=638596 doge dark tiara big_shades
+$ fab --background=ffbf00 doge dark tiara big_shades
+$ fab --background=ukraine doge dark tiara big_shades
+$ fab --background=pride   doge dark tiara big_shades
+```
+
+resulting in:
+
+![](https://github.com/pixelartexchange/originals/raw/master/i/doge0.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/doge1.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/doge1.1.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/doge1.2.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/doge1.3.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/doge1.4.png)
+
+4x  (using the `--zoom=4`/`-z4` option)
+
+![](https://github.com/pixelartexchange/originals/raw/master/i/doge0@4x.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/doge1@4x.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/doge1.1@4x.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/doge1.2@4x.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/doge1.3@4x.png)
+![](https://github.com/pixelartexchange/originals/raw/master/i/doge1.4@4x.png)
+
+
+
+And so on. Stay tuned for more original artwork series!
+
+
+
+
+## Install
+
+Just install the gem:
+
+    $ gem install originals
+
+
+
+## License
+
+The scripts are dedicated to the public domain.
+Use it as you please with no restrictions whatsoever.
+
+
+## Questions? Comments?
+
+Post them on the [CryptoPunksDev reddit](https://old.reddit.com/r/CryptoPunksDev). Thanks.
+

data/Rakefile

@@ -27,6 +27,7 @@ Hoe.spec 'originals' do
 
   self.extra_deps = [
     ['cryptopunks'],
+    ['shibainus'],
   ]
 
   self.licenses = ['Public Domain']

data/bin/fab

@@ -0,0 +1,17 @@
+#!/usr/bin/env ruby
+
+###################
+# == DEV TIPS:
+#
+# For local testing run like:
+#
+#    ruby -Ilib bin/fab
+#
+# Set the executable bit in Linux. Example:
+#
+#    % chmod a+x bin/fab
+#
+
+require 'originals'
+
+Originals::Tool.main

data/bin/fabricate

@@ -0,0 +1,17 @@
+#!/usr/bin/env ruby
+
+###################
+# == DEV TIPS:
+#
+# For local testing run like:
+#
+#    ruby -Ilib bin/fabricate
+#
+# Set the executable bit in Linux. Example:
+#
+#    % chmod a+x bin/fabricate
+#
+
+require 'originals'
+
+Originals::Tool.main

data/lib/originals/tool.rb

@@ -0,0 +1,74 @@
+module Originals
+class Tool
+
+  def self.main( args=ARGV )
+    puts "==> welcome to the fab(ricate) tool with args:"
+    pp args
+
+    options = { }
+    parser = OptionParser.new do |opts|
+
+      opts.on("--zoom NUM", "-z", Integer,
+              "Zoom factor x2, x4, x8, etc. (default: 1)") do |num|
+          options[ :zoom]  = num
+      end
+
+      opts.on("--background STRING", "--bg STRING", "-b", String,
+              "Background (default: transparent)") do |str|
+          options[ :background] = str
+      end
+
+      opts.on("--id NUM", "-i", Integer,
+              "Unique identifier (default: none)") do |str|
+          options[ :id] = str
+      end
+
+      opts.on("-h", "--help", "Prints this help") do
+        puts opts
+        exit
+      end
+    end
+
+    parser.parse!( args )
+    puts "options:"
+    pp options
+
+    puts "args:"
+    pp args
+
+    if args.size < 1
+      puts "!! ERROR - no art series name found - use <name> <attribute>..."
+      puts ""
+      exit
+    end
+
+    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( '[ ()_-]', '' )
+
+    img = Original::Image.fabricate( key, *attributes,
+                                     background: options[ :background] )
+
+
+    basename = "#{key}#{options[:id]}"
+
+    path =  if options[:zoom]
+               img = img.zoom( options[:zoom] )
+               "./#{basename}@#{options[:zoom]}x.png"
+            else
+               "./#{basename}.png"
+            end
+
+    puts "  saving original #{name} (#{img.width}x#{img.height}) to >#{path}<..."
+    img.save( path )
+
+    puts "bye"
+  end
+end # class Tool
+
+end # module Originals
+
+

data/lib/originals/version.rb

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

data/lib/originals.rb

@@ -1,8 +1,166 @@
 ## 3rd party libs
+require 'cryptopunks'
+require 'shibainus'
+
+
 
 ## our own code
 require 'originals/version'    # note: let version always go first
 
 
+## forward define superclass for image
+module Originals
+  class Image < Pixelart::Image; end
+end
+
+
+module Originals
+
+def self.factory   ## "shared" single (default) instance
+    @factory ||= Factory.new
+end
+
+
+
+##
+#  "wrap" fabricate inside Image - why? why not?
+class Image
+def self.fabricate( name, *attributes, background: nil )  ## add fac alias - why? why not?
+   ## 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 )
+          else
+            puts "!! ERROR; don't know how to fabricate >#{name}<; sorry"
+            exit 1
+          end
+   img
+end
+class << self
+   alias_method :fab, :fabricate
+end
+end # class Image
+
+
+
+
+
+class Factory     ## add Fabricator/Artist/Artfactory/? alias or such - why? why not?
+
+def punk( *attributes, mirror: false, background: nil )
+    ## note: if no attributes passed in
+    ##    default to ['Male 2']
+    attributes = ['Male 2']  if attributes.size == 0
+
+   _generate_punk( *attributes,
+                   mirror:     mirror,
+                   background: background )
+end
+
+def phunk( *attributes, background: nil )
+   punk( *attributes,
+          mirror: true,
+          background: background )
+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 )
+end
+
+
+PHILIP_ATTRIBUTES = ['Male 3']
+def philip( *attributes, background: nil )
+  _generate_punk( *PHILIP_ATTRIBUTES,
+                  *attributes,
+                  mirror: true,
+                  background: background )
+end
+
+
+
+def shiba( *attributes, background: nil )
+    ## 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
+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
+
+    img = if background.is_a?( String ) && ['ua', 'ukraine'].include?( background.downcase )
+              Image.new( width, height ).ukraine
+          elsif background.is_a?( String ) && ['rainbow', 'pride'].include?( background.downcase )
+              Image.new( width, height ).pride
+          else
+            Image.new( width, width, background )
+          end
+
+    img2 = Image.new( width, width )
+    img2.compose!( img )
+    img2.compose!( base )
+    img2
+end
+
+end # class Factory
+
+
+end # module Originals
+
+
+
+
+require 'originals/tool'
+
+
+
+####
+# convenience aliases / shortcuts / alternate spellings
+Original = Originals
+
+
+
 
 puts Originals.banner    # say hello

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: originals
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.0
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-05-29 00:00:00.000000000 Z
+date: 2022-05-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cryptopunks
@@ -24,6 +24,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: shibainus
+  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
@@ -62,7 +76,9 @@ description: originals - Do-It-Yourself (DIY) Yes, You Can! - Factory of Modern
   (FOMO) - Fab(criate) Your Own Unique (Pixel) Artworks w/ Text Attributes (Via Built-In
   Spritesheets) Incl. 2X/4X/8X Zoom for Bigger Sizes And More
 email: wwwmake@googlegroups.com
-executables: []
+executables:
+- fab
+- fabricate
 extensions: []
 extra_rdoc_files:
 - CHANGELOG.md
@@ -75,7 +91,10 @@ files:
 - Manifest.txt
 - README.md
 - Rakefile
+- bin/fab
+- bin/fabricate
 - lib/originals.rb
+- lib/originals/tool.rb
 - lib/originals/version.rb
 homepage: https://github.com/pixelartexchange/originals
 licenses: