pixelart 1.2.1 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e407d45e71520e9e7c34448811a80e796254aba70c791e3497df00b0fa700486
-  data.tar.gz: 55c324e6cf901bd8ed78fa48d97f27a3f66c60d314d070a457ef4e272ebe9f01
+  metadata.gz: f203be5e0f2e2a06f88711fd51da837fb71212e58c0bc9aef80358f661f10f58
+  data.tar.gz: f1377fcab0ec03d91ca692ed8d6e2222bacf5aedc5e477121c4cf1950968ad22
 SHA512:
-  metadata.gz: 6e36d0cb47e5e36b81b3a3f47d62fa119b898f9bbf11c422d53f5ab3cfdfe022a8f3dda3d82ea1db4f2eb422376ea82ac153922add94caeb5aff97214813a81a
-  data.tar.gz: b8957560272efd295ef73bdd450531dc9d631fd293215dbd0f9f835bdbdb50669018f1d24a27a6df45d8714a2633bc1d22a6b6761979dc7804b3c5290c2f1eaa
+  metadata.gz: b3c11e63d1764934b71a62410c23e14af07b42da9ce046a5853b92d493809abd3bede1ef3b40c025e61fd28d9efcb77f87bc31a9997def982dd65e67b62da0a0
+  data.tar.gz: 78f8de9b81fa1ed6c6a77a5ea3bc6414aef36837314f5a2a073c1ab4683b31899c5bcdfe3be85ad7e3c5159f3ee708d9f231e97799f2262378f5b7b49998119a

data/CHANGELOG.md

@@ -1,3 +1,3 @@
-### 0.0.1 / 2021-04-08
-
-* Everything is new. First release
+### 0.0.1 / 2021-04-08
+
+* Everything is new. First release

data/Manifest.txt

@@ -5,6 +5,7 @@ Rakefile
 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/gradient.rb
@@ -13,7 +14,11 @@ lib/pixelart/led.rb
 lib/pixelart/misc.rb
 lib/pixelart/palette.rb
 lib/pixelart/pixelator.rb
+lib/pixelart/silhouette.rb
 lib/pixelart/sketch.rb
 lib/pixelart/spots.rb
+lib/pixelart/stripes.rb
+lib/pixelart/transparent.rb
+lib/pixelart/ukraine.rb
 lib/pixelart/vector.rb
 lib/pixelart/version.rb

data/README.md

@@ -1,291 +1,290 @@
-# Pixel Art
-
-pixelart  - mint your own pixel art images off chain using any design (in ascii text) in any colors; incl. 2x/4x/8x zoom for bigger sizes
-
-
-* home  :: [github.com/rubycoco/pixel](https://github.com/rubycoco/pixel)
-* bugs  :: [github.com/rubycoco/pixel/issues](https://github.com/rubycoco/pixel/issues)
-* gem   :: [rubygems.org/gems/pixelart](https://rubygems.org/gems/pixelart)
-* rdoc  :: [rubydoc.info/gems/pixelart](http://rubydoc.info/gems/pixelart)
-
-
-
-##  Usage
-
-Let's use the mooncat design #0 (Standing·Smile·Solid·Left)
-in the original 21×17 pixel format in ascii text:
-
-
-```ruby
-require 'pixelart'
-
-pixels =<<PIXELS
-0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 1 0 0
-0 0 0 0 0 0 0 0 0 0 0 1 3 1 0 0 0 1 3 1 0
-0 0 0 0 0 0 0 0 0 0 0 1 5 3 1 1 1 3 5 1 0
-0 1 1 1 0 0 0 0 0 0 1 1 3 3 3 3 3 3 3 1 1
-0 1 3 1 0 0 0 0 0 0 1 3 3 3 3 3 3 3 3 3 1
-1 3 1 1 0 1 1 1 1 1 1 3 3 1 3 3 3 1 3 3 1
-1 3 1 0 1 1 3 3 3 3 1 3 3 3 3 3 3 3 3 3 1
-1 3 1 0 1 3 3 3 3 3 1 3 3 4 3 5 3 4 3 3 1
-1 3 1 1 1 3 3 3 3 3 1 3 3 3 4 3 4 3 3 3 1
-1 1 3 3 3 3 3 3 3 3 3 1 3 3 3 3 3 3 3 1 0
-0 1 1 1 3 3 3 3 3 3 3 3 1 1 1 1 1 1 1 0 0
-0 0 0 1 3 3 3 3 3 3 3 3 3 3 3 3 3 3 1 0 0
-0 0 0 1 1 3 3 3 1 4 4 4 1 3 3 3 3 3 1 0 0
-0 0 0 0 1 1 3 3 3 1 4 1 3 3 1 3 3 1 0 0 0
-0 0 0 0 0 1 1 3 3 1 4 1 3 1 1 3 1 0 0 0 0
-0 0 0 0 0 0 1 1 3 5 1 1 5 1 1 5 1 0 0 0 0
-0 0 0 0 0 0 0 1 1 1 1 1 1 1 1 1 1 0 0 0 0
-PIXELS
-```
-
-And let's use the genesis white color scheme - super rare only 48 exist in the official MoonCatRescue blockchain contract state storage ;-):
-
-``` ruby
-colors = [
-  '#555555',   # color 1
-  '#d3d3d3',   # color 2
-  '#ffffff',   # color 3
-  '#aaaaaa',   # color 4
-  '#ff9999'    # color 5
-]
-```
-
-Note: The color 0 (transparent) is auto-magically added / defined.
-
-
-And let's mint a mooncat image:
-
-``` ruby
-img = Image.parse( pixels, colors: colors )
-img.save( './i/mooncat_white.png' )
-```
-
-And let's try a 3x zoom factor:
-
-``` ruby
-img3x = img.zoom( 3 )
-img3x.save( './i/mooncat_white-3x.png' )
-```
-
-Voila!
-
-![](https://github.com/rubycoco/pixel/raw/master/pixelart/i/mooncat_white.png)
-![](https://github.com/rubycoco/pixel/raw/master/pixelart/i/mooncat_white-3x.png)
-
-
-
-Let's change the colors to use the genesis black color scheme:
-
-``` ruby
-colors = [
-  '#555555',   # color 1
-  '#222222',   # color 2
-  '#111111',   # color 3
-  '#bbbbbb',   # color 4
-  '#ff9999'    # color 5
-]
-```
-
-And let's start minting:
-
-``` ruby
-img = Image.parse( pixels, colors: colors )
-img.save( './i/mooncat_black.png' )
-
-img3x = img.zoom( 3 )
-img3x.save( './i/mooncat_black-3x.png' )
-```
-
-Voila! Black is the new White!
-
-![](https://github.com/rubycoco/pixel/raw/master/pixelart/i/mooncat_black.png)
-![](https://github.com/rubycoco/pixel/raw/master/pixelart/i/mooncat_black-3x.png)
-
-
-
-
-## Yes, You Can - Use Your Own Pixel Designs
-
-Let's use the Darth Vader pixel art originally designed by
-Aral Tasher in CSS. See the [online demo »](https://codepen.io/araltasher/pen/ajdzNE)
-
-Let's cut-n-paste the pixel art matrix:
-
-
-``` ruby
-pixels = <<PIXELS
-o o o o o o o o o o o o o o o o o lg lg lg dg o o o o o o o o o o o o o o o o o
-o o o o o o o o o o o o o o dg lg lg w lg lg dg dg lg dg o o o o o o o o o o o o o o
-o o o o o o o o o o o o o dg lg w lg w lg lg dg dg w lg  dg o o o o o o o o o o o o o
-o o o o o o o o o o o o dg lg w w lg w lg lg dg dg w w  lg dg o o o o o o o o o o o
-o o o o o o o o o o o o dg dg w w lg w lg lg dg dg w w  dg dg o o o o o o o o o o o
-o o o o o o o o o o o dg dg dg lg w lg w lg lg dg dg w lg dg dg dg o o o o o o o o o o
-o o o o o o o o o o o dg dg dg w lg lg w lg lg dg dg lg w dg dg dg o o o o o o o o o o
-o o o o o o o o o o o dg dg w lg lg lg w lg lg dg dg lg lg w dg dg o o o o o o o o o o
-o o o o o o o o o o o dg lg lg b b b lg dg dg lg b b b lg lg dg o o o o o o o o o o
-o o o o o o o o o o o dg lg b b b b b lg lg b b b b b lg dg o o o o o o o o o o
-o o o o o o o o o o o lg b b db lg db b dg dg b lg db db b b lg o o o o o o o o o o
-o o o o o o o o o o lg b b b db db db b lg lg b db db db b b b lg o o o o o o o o o
-o o o o o o o o o o lg b b dg lg lg lg lg b b lg lg lg lg dg b b lg o o o o o o o o o
-o o o o o o o o o lg b b b dg dg dg dg lg b b lg dg dg dg dg b b b lg o o o o o o o o
-o o o o o o o o o lg b b b dg dg dg lg b b b b lg dg dg dg b b b lg o o o o o o o o
-o o o o o o o o lg b b b b b dg dg b dg b dg b b lg dg b b b b b lg o o o o o o o
-o o o o o o o o b b b b b b w b b dg b dg b dg b w b b b b b b o o o o o o o
-o o o o o o o o b b b b b b dg dg dg dg dg dg dg dg dg dg b b b b b b o o o o o o o
-o o o o o o o o o b b b b lg b b b b b b b b b b b b b b b o o o o o o o o
-o o o o o o o o o o o o b lg lg dg dg b b b b dg dg b b b o o o o o o o o o o o
-o o o o o o o o o o o o lg lg dg dg dg dg b b b dg dg dg dg b b o o o o o o o o o o
-o o o o o o o o o dg dg b dg dg dg dg dg dg dg dg dg dg dg dg dg dg dg b dg dg o o o o o o o
-o o o o o o o o dg dg b b lg lg lg lg lg lg lg lg lg lg lg lg lg lg lg b b dg dg o o o o o o
-o o o o o o o dg dg b lg b lg dg lg lg dg dg lg lg dg dg lg lg dg dg lg b lg b dg dg o o o o o
-o o o o o o dg dg b lg lg b lg dg lg lg dg dg lg lg dg dg lg lg dg dg lg b lg lg b dg dg o o o o
-o o o o o dg dg b b b b b lg dg lg lg dg dg lg lg dg dg lg lg dg dg lg b b b b b dg dg
-o o o o dg dg dg b dg dg b b b b lg lg dg dg lg lg dg dg lg lg b b b b dg dg dg b dg dg dg
-o o o dg dg dg b dg dg dg b b b dg b b dg dg lg lg dg dg b b b dg b b b dg dg dg b dg dg dg
-o o o dg dg b dg dg dg b b b dg dg dg b b b lg lg b b b dg dg dg b b b b dg dg dg b dg dg
-o o dg dg dg b dg dg b b b b dg dg dg b lg lg b b lg lg dg dg dg dg b b b b b dg dg b dg dg dg
-o o dg dg dg b dg b b b b b dg dg dg b b b b b b b dg b dg dg b b b b b b dg b dg dg dg
-o dg dg dg dg b dg b b b b b dg b dg b b lg lg b r b dg b dg dg b b b b b b dg b dg dg dg dg
-o dg dg dg dg b dg lg b b b b dg b dg b b b b b b b dg b dg dg b b b b b lg dg b dg dg dg dg
-o dg dg dg dg b lg dg lg b b b dg b dg b b lg lg b blu b dg b dg dg b b b b lg dg lg b dg dg dg dg
-o dg dg dg dg b dg lg dg lg b b dg b dg b b b b b b b dg b dg dg b b b lg dg lg dg b dg dg dg dg
-o dg dg dg dg b dg dg lg dg lg b dg b dg b lg lg lg lg lg lg b b dg dg b b lg dg lg dg dg b dg dg dg dg
-o dg dg dg dg b b dg dg lg dg b b b b b b b b b b b b b b b b b dg lg dg dg b b dg dg dg dg
-o dg dg dg dg b b b dg dg dg b lg b g b b lg lg lg lg b b g b lg b b dg dg dg b b b dg dg dg dg
-o dg dg dg dg b b b b dg b b b b b b b dg dg lg lg b b b b b b b b dg b b b b dg dg dg dg
-o dg dg dg dg b b b b b b b b b b b b b b b b b b b b b b b b b b b b b dg dg dg dg
-o dg dg dg dg b b b b b b b dg b dg b dg dg dg dg dg dg b dg b lg b b b b b b b b dg dg dg dg
-o dg dg dg b b b b b b b b dg b dg b dg dg dg dg dg dg b dg b lg dg b b b b b b b b dg dg dg
-o dg dg dg b b b b b b b b b dg dg b dg dg dg dg dg dg b dg b dg dg b b b b b b b b dg dg dg
-o dg dg dg b b b b b b b b b dg dg b b dg dg dg dg b b dg b w lg b b b b b b b b dg dg dg
-o dg dg dg b b b b b b b b b dg dg b b dg dg dg dg b b dg b w lg b b b b b b b b dg dg dg
-o dg dg dg b b b b b b b b b dg dg b dg b dg dg b dg b dg b lg dg b b b b b b b b dg dg dg
-o dg dg dg b b b b b b b b b dg dg b dg dg b b dg dg b dg b dg dg b b b b b b b b dg dg dg
-o dg dg dg b b b b b b b b dg dg dg b dg dg b dg dg dg b dg b lg dg b b b b b b b b dg dg dg
-o dg dg dg b b b b b b b b dg dg dg b dg dg b dg dg dg b dg b lg dg b b b b b b b b dg dg dg
-dg dg dg dg b b b b b b b b dg dg dg b dg dg b dg dg dg b dg b lg dg b b b b b b b b dg dg dg dg
-dg dg dg dg b b b b b b b b dg dg dg b dg b b b dg dg b dg b b b b b b b b b b b dg dg dg dg
-dg dg dg dg b b b b b b b b dg dg dg b dg b b b dg dg b dg dg dg b b b b b b b b b dg dg dg dg
-dg dg dg dg b b b b b b b b dg dg dg b dg b b b dg dg b dg dg dg b b b b b b b b b dg dg dg dg
-dg dg dg dg b b b b b b b b dg b dg b dg b b b dg dg b dg dg dg b b b b b b b b b dg dg dg dg
-dg dg dg dg b b b b b b b b dg b dg b dg b b b dg dg b dg dg dg b b b b b b b b b dg dg dg dg
-dg dg dg dg b b b b b b b b dg b dg b dg b b b dg dg b dg dg dg b b b b b b b b b dg dg dg dg
-dg dg dg dg b b b b b b b b dg b dg b dg b b b dg dg b dg b dg b b b b b b b b b dg dg dg dg
-dg dg dg dg b b b b b b b b dg b dg b dg b b b dg dg b dg b dg b b b b b b b b b dg dg dg dg
-dg dg dg dg b b b b b b b b dg b dg b dg b b b dg dg b dg b dg b b b b b b b b b dg dg dg dg
-dg dg dg dg b b b b b b b b dg b dg b dg b b b dg dg b dg b dg b b b b b b b b b dg dg dg dg
-dg dg dg dg b b b b b b b b b b b b dg b b b dg dg b b b b b b b b b b b b b dg dg dg dg
-dg dg dg dg b b b b b b b b dg lg dg dg dg b b b dg lg dg dg dg dg b b b b b b b b b dg dg dg dg
-dg dg dg dg b b b b b b b b dg lg dg dg dg b b b dg lg dg dg dg dg b b b b b b b b b dg dg dg dg
-dg dg dg dg b b o o o o o o b b b dg dg b b b dg dg dg b b b o o o o o o o b b dg dg dg dg
-o o dg dg o o o o o o o b lg lg dg b b b o o b b lg dg dg dg b o o o o o o b b dg dg dg dg
-o o o o o o o o o b lg lg dg dg dg dg dg b o o b dg lg lg dg dg dg b
-o o o o o o o o b dg dg dg dg dg dg dg dg b o o b dg dg dg dg dg dg b b
-o o o o ulg ulg ulg ulg b b b b b b b b b b ulg ulg b b b b b b b b b ulg ulg ulg ulg
-PIXELS
-```
-
-
-Note: Yes, you can use any number (e.g. `0` `1` `2` `3` etc)
-or shortcut (e.g. `o` `b` `ulg` `lg` etc) for pixels.
-Only make sure you have a color map matching your shortcuts.
-
-
-Let's add the color map:
-
-``` ruby
-colors = {
-   o:   'transparent',
-   b:   '#1D191A',
-   ulg: '#eaeaec',
-   lg:  '#747474',
-   db:  '#453C35',
-   dg:  '#343031',
-   w:   '#fff',
-   r:   '#fc3435',
-   blu: '#1F3A93',
-   g:   '#00943b'
-}
-```
-
-
-And let's mint an imperial master image:
-
-``` ruby
-img = Image.parse( pixels, colors: colors )
-img.save( './i/vader.png' )
-```
-
-And let's try a 5x zoom factor:
-
-``` ruby
-img5x = img.zoom( 5 )
-img5x.save( './i/vader5x.png' )
-```
-
-Voila!
-
-![](https://github.com/rubycoco/pixel/raw/master/pixelart/i/vader.png)
-![](https://github.com/rubycoco/pixel/raw/master/pixelart/i/vader5x.png)
-
-
-
-
-## Modular "Base" Version
-
-
-Note: By default if you require pixelart
-all classes inside the `Pixelart` module such as `Image`, `Color`, `Gradient`, `Palette8bit`, etc. get "top-leveled", that is,
-included in the top level e.g.:
-
-``` ruby
-require 'pixelart/base'
-include Pixelart
-```
-
-And now you can use all classes without
-the `Pixelart::` module scope e.g.:
-
-``` ruby
-gradient = Gradient.new( '000000', 'ffffff' )
-
-pp colors = gradient.colors( 256 )
-puts '---'
-pp colors.map { |color| Color.to_hex( color ) }
-```
-
-vs
-
-``` ruby
-gradient = Pixelart::Gradient.new( '000000', 'ffffff' )
-
-pp colors = gradient.colors( 256 )
-puts '---'
-pp colors.map { |color| Pixelart::Color.to_hex( color ) }
-```
-
-
-For a "stricter" modular version require the "base" version
-that always requires the `Pixelart::` module scope e.g.:
-
-``` ruby
-require 'pixelart/base'
-```
-
-
-
-
-## Install
-
-Just install the gem:
-
-    $ gem install pixelart
-
-
-## License
-
-The scripts are dedicated to the public domain.
-Use it as you please with no restrictions whatsoever.
-
+# Pixel Art
+
+pixelart  - mint your own pixel art images off chain using any design (in ascii text) in any colors; incl. 2x/4x/8x zoom for bigger sizes
+
+
+* home  :: [github.com/pixelartexchange/pixelart](https://github.com/pixelartexchange/pixelart)
+* bugs  :: [github.com/pixelartexchange/pixelart/issues](https://github.com/pixelartexchange/pixelart/issues)
+* gem   :: [rubygems.org/gems/pixelart](https://rubygems.org/gems/pixelart)
+* rdoc  :: [rubydoc.info/gems/pixelart](http://rubydoc.info/gems/pixelart)
+
+
+
+##  Usage
+
+Let's use the mooncat design #0 (Standing·Smile·Solid·Left)
+in the original 21×17 pixel format in ascii text:
+
+
+```ruby
+require 'pixelart'
+
+pixels =<<PIXELS
+0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 1 0 0
+0 0 0 0 0 0 0 0 0 0 0 1 3 1 0 0 0 1 3 1 0
+0 0 0 0 0 0 0 0 0 0 0 1 5 3 1 1 1 3 5 1 0
+0 1 1 1 0 0 0 0 0 0 1 1 3 3 3 3 3 3 3 1 1
+0 1 3 1 0 0 0 0 0 0 1 3 3 3 3 3 3 3 3 3 1
+1 3 1 1 0 1 1 1 1 1 1 3 3 1 3 3 3 1 3 3 1
+1 3 1 0 1 1 3 3 3 3 1 3 3 3 3 3 3 3 3 3 1
+1 3 1 0 1 3 3 3 3 3 1 3 3 4 3 5 3 4 3 3 1
+1 3 1 1 1 3 3 3 3 3 1 3 3 3 4 3 4 3 3 3 1
+1 1 3 3 3 3 3 3 3 3 3 1 3 3 3 3 3 3 3 1 0
+0 1 1 1 3 3 3 3 3 3 3 3 1 1 1 1 1 1 1 0 0
+0 0 0 1 3 3 3 3 3 3 3 3 3 3 3 3 3 3 1 0 0
+0 0 0 1 1 3 3 3 1 4 4 4 1 3 3 3 3 3 1 0 0
+0 0 0 0 1 1 3 3 3 1 4 1 3 3 1 3 3 1 0 0 0
+0 0 0 0 0 1 1 3 3 1 4 1 3 1 1 3 1 0 0 0 0
+0 0 0 0 0 0 1 1 3 5 1 1 5 1 1 5 1 0 0 0 0
+0 0 0 0 0 0 0 1 1 1 1 1 1 1 1 1 1 0 0 0 0
+PIXELS
+```
+
+And let's use the genesis white color scheme - super rare only 48 exist in the official MoonCatRescue blockchain contract state storage ;-):
+
+``` ruby
+colors = [
+  '#555555',   # color 1
+  '#d3d3d3',   # color 2
+  '#ffffff',   # color 3
+  '#aaaaaa',   # color 4
+  '#ff9999'    # color 5
+]
+```
+
+Note: The color 0 (transparent) is auto-magically added / defined.
+
+
+And let's mint a mooncat image:
+
+``` ruby
+img = Image.parse( pixels, colors: colors )
+img.save( './i/mooncat_white.png' )
+```
+
+And let's try a 3x zoom factor:
+
+``` ruby
+img3x = img.zoom( 3 )
+img3x.save( './i/mooncat_white-3x.png' )
+```
+
+Voila!
+
+![](https://github.com/pixelartexchange/pixelart/raw/master/pixelart/i/mooncat_white.png)
+![](https://github.com/pixelartexchange/pixelart/raw/master/pixelart/i/mooncat_white-3x.png)
+
+
+
+Let's change the colors to use the genesis black color scheme:
+
+``` ruby
+colors = [
+  '#555555',   # color 1
+  '#222222',   # color 2
+  '#111111',   # color 3
+  '#bbbbbb',   # color 4
+  '#ff9999'    # color 5
+]
+```
+
+And let's start minting:
+
+``` ruby
+img = Image.parse( pixels, colors: colors )
+img.save( './i/mooncat_black.png' )
+
+img3x = img.zoom( 3 )
+img3x.save( './i/mooncat_black-3x.png' )
+```
+
+Voila! Black is the new White!
+
+![](https://github.com/pixelartexchange/pixelart/raw/master/pixelart/i/mooncat_black.png)
+![](https://github.com/pixelartexchange/pixelart/raw/master/pixelart/i/mooncat_black-3x.png)
+
+
+
+
+## Yes, You Can - Use Your Own Pixel Designs
+
+Let's use the Darth Vader pixel art originally designed by
+Aral Tasher in CSS. See the [online demo »](https://codepen.io/araltasher/pen/ajdzNE)
+
+Let's cut-n-paste the pixel art matrix:
+
+
+``` ruby
+pixels = <<PIXELS
+o o o o o o o o o o o o o o o o o lg lg lg dg o o o o o o o o o o o o o o o o o
+o o o o o o o o o o o o o o dg lg lg w lg lg dg dg lg dg o o o o o o o o o o o o o o
+o o o o o o o o o o o o o dg lg w lg w lg lg dg dg w lg  dg o o o o o o o o o o o o o
+o o o o o o o o o o o o dg lg w w lg w lg lg dg dg w w  lg dg o o o o o o o o o o o
+o o o o o o o o o o o o dg dg w w lg w lg lg dg dg w w  dg dg o o o o o o o o o o o
+o o o o o o o o o o o dg dg dg lg w lg w lg lg dg dg w lg dg dg dg o o o o o o o o o o
+o o o o o o o o o o o dg dg dg w lg lg w lg lg dg dg lg w dg dg dg o o o o o o o o o o
+o o o o o o o o o o o dg dg w lg lg lg w lg lg dg dg lg lg w dg dg o o o o o o o o o o
+o o o o o o o o o o o dg lg lg b b b lg dg dg lg b b b lg lg dg o o o o o o o o o o
+o o o o o o o o o o o dg lg b b b b b lg lg b b b b b lg dg o o o o o o o o o o
+o o o o o o o o o o o lg b b db lg db b dg dg b lg db db b b lg o o o o o o o o o o
+o o o o o o o o o o lg b b b db db db b lg lg b db db db b b b lg o o o o o o o o o
+o o o o o o o o o o lg b b dg lg lg lg lg b b lg lg lg lg dg b b lg o o o o o o o o o
+o o o o o o o o o lg b b b dg dg dg dg lg b b lg dg dg dg dg b b b lg o o o o o o o o
+o o o o o o o o o lg b b b dg dg dg lg b b b b lg dg dg dg b b b lg o o o o o o o o
+o o o o o o o o lg b b b b b dg dg b dg b dg b b lg dg b b b b b lg o o o o o o o
+o o o o o o o o b b b b b b w b b dg b dg b dg b w b b b b b b o o o o o o o
+o o o o o o o o b b b b b b dg dg dg dg dg dg dg dg dg dg b b b b b b o o o o o o o
+o o o o o o o o o b b b b lg b b b b b b b b b b b b b b b o o o o o o o o
+o o o o o o o o o o o o b lg lg dg dg b b b b dg dg b b b o o o o o o o o o o o
+o o o o o o o o o o o o lg lg dg dg dg dg b b b dg dg dg dg b b o o o o o o o o o o
+o o o o o o o o o dg dg b dg dg dg dg dg dg dg dg dg dg dg dg dg dg dg b dg dg o o o o o o o
+o o o o o o o o dg dg b b lg lg lg lg lg lg lg lg lg lg lg lg lg lg lg b b dg dg o o o o o o
+o o o o o o o dg dg b lg b lg dg lg lg dg dg lg lg dg dg lg lg dg dg lg b lg b dg dg o o o o o
+o o o o o o dg dg b lg lg b lg dg lg lg dg dg lg lg dg dg lg lg dg dg lg b lg lg b dg dg o o o o
+o o o o o dg dg b b b b b lg dg lg lg dg dg lg lg dg dg lg lg dg dg lg b b b b b dg dg
+o o o o dg dg dg b dg dg b b b b lg lg dg dg lg lg dg dg lg lg b b b b dg dg dg b dg dg dg
+o o o dg dg dg b dg dg dg b b b dg b b dg dg lg lg dg dg b b b dg b b b dg dg dg b dg dg dg
+o o o dg dg b dg dg dg b b b dg dg dg b b b lg lg b b b dg dg dg b b b b dg dg dg b dg dg
+o o dg dg dg b dg dg b b b b dg dg dg b lg lg b b lg lg dg dg dg dg b b b b b dg dg b dg dg dg
+o o dg dg dg b dg b b b b b dg dg dg b b b b b b b dg b dg dg b b b b b b dg b dg dg dg
+o dg dg dg dg b dg b b b b b dg b dg b b lg lg b r b dg b dg dg b b b b b b dg b dg dg dg dg
+o dg dg dg dg b dg lg b b b b dg b dg b b b b b b b dg b dg dg b b b b b lg dg b dg dg dg dg
+o dg dg dg dg b lg dg lg b b b dg b dg b b lg lg b blu b dg b dg dg b b b b lg dg lg b dg dg dg dg
+o dg dg dg dg b dg lg dg lg b b dg b dg b b b b b b b dg b dg dg b b b lg dg lg dg b dg dg dg dg
+o dg dg dg dg b dg dg lg dg lg b dg b dg b lg lg lg lg lg lg b b dg dg b b lg dg lg dg dg b dg dg dg dg
+o dg dg dg dg b b dg dg lg dg b b b b b b b b b b b b b b b b b dg lg dg dg b b dg dg dg dg
+o dg dg dg dg b b b dg dg dg b lg b g b b lg lg lg lg b b g b lg b b dg dg dg b b b dg dg dg dg
+o dg dg dg dg b b b b dg b b b b b b b dg dg lg lg b b b b b b b b dg b b b b dg dg dg dg
+o dg dg dg dg b b b b b b b b b b b b b b b b b b b b b b b b b b b b b dg dg dg dg
+o dg dg dg dg b b b b b b b dg b dg b dg dg dg dg dg dg b dg b lg b b b b b b b b dg dg dg dg
+o dg dg dg b b b b b b b b dg b dg b dg dg dg dg dg dg b dg b lg dg b b b b b b b b dg dg dg
+o dg dg dg b b b b b b b b b dg dg b dg dg dg dg dg dg b dg b dg dg b b b b b b b b dg dg dg
+o dg dg dg b b b b b b b b b dg dg b b dg dg dg dg b b dg b w lg b b b b b b b b dg dg dg
+o dg dg dg b b b b b b b b b dg dg b b dg dg dg dg b b dg b w lg b b b b b b b b dg dg dg
+o dg dg dg b b b b b b b b b dg dg b dg b dg dg b dg b dg b lg dg b b b b b b b b dg dg dg
+o dg dg dg b b b b b b b b b dg dg b dg dg b b dg dg b dg b dg dg b b b b b b b b dg dg dg
+o dg dg dg b b b b b b b b dg dg dg b dg dg b dg dg dg b dg b lg dg b b b b b b b b dg dg dg
+o dg dg dg b b b b b b b b dg dg dg b dg dg b dg dg dg b dg b lg dg b b b b b b b b dg dg dg
+dg dg dg dg b b b b b b b b dg dg dg b dg dg b dg dg dg b dg b lg dg b b b b b b b b dg dg dg dg
+dg dg dg dg b b b b b b b b dg dg dg b dg b b b dg dg b dg b b b b b b b b b b b dg dg dg dg
+dg dg dg dg b b b b b b b b dg dg dg b dg b b b dg dg b dg dg dg b b b b b b b b b dg dg dg dg
+dg dg dg dg b b b b b b b b dg dg dg b dg b b b dg dg b dg dg dg b b b b b b b b b dg dg dg dg
+dg dg dg dg b b b b b b b b dg b dg b dg b b b dg dg b dg dg dg b b b b b b b b b dg dg dg dg
+dg dg dg dg b b b b b b b b dg b dg b dg b b b dg dg b dg dg dg b b b b b b b b b dg dg dg dg
+dg dg dg dg b b b b b b b b dg b dg b dg b b b dg dg b dg dg dg b b b b b b b b b dg dg dg dg
+dg dg dg dg b b b b b b b b dg b dg b dg b b b dg dg b dg b dg b b b b b b b b b dg dg dg dg
+dg dg dg dg b b b b b b b b dg b dg b dg b b b dg dg b dg b dg b b b b b b b b b dg dg dg dg
+dg dg dg dg b b b b b b b b dg b dg b dg b b b dg dg b dg b dg b b b b b b b b b dg dg dg dg
+dg dg dg dg b b b b b b b b dg b dg b dg b b b dg dg b dg b dg b b b b b b b b b dg dg dg dg
+dg dg dg dg b b b b b b b b b b b b dg b b b dg dg b b b b b b b b b b b b b dg dg dg dg
+dg dg dg dg b b b b b b b b dg lg dg dg dg b b b dg lg dg dg dg dg b b b b b b b b b dg dg dg dg
+dg dg dg dg b b b b b b b b dg lg dg dg dg b b b dg lg dg dg dg dg b b b b b b b b b dg dg dg dg
+dg dg dg dg b b o o o o o o b b b dg dg b b b dg dg dg b b b o o o o o o o b b dg dg dg dg
+o o dg dg o o o o o o o b lg lg dg b b b o o b b lg dg dg dg b o o o o o o b b dg dg dg dg
+o o o o o o o o o b lg lg dg dg dg dg dg b o o b dg lg lg dg dg dg b
+o o o o o o o o b dg dg dg dg dg dg dg dg b o o b dg dg dg dg dg dg b b
+o o o o ulg ulg ulg ulg b b b b b b b b b b ulg ulg b b b b b b b b b ulg ulg ulg ulg
+PIXELS
+```
+
+
+Note: Yes, you can use any number (e.g. `0` `1` `2` `3` etc)
+or shortcut (e.g. `o` `b` `ulg` `lg` etc) for pixels.
+Only make sure you have a color map matching your shortcuts.
+
+
+Let's add the color map:
+
+``` ruby
+colors = {
+   o:   'transparent',
+   b:   '#1D191A',
+   ulg: '#eaeaec',
+   lg:  '#747474',
+   db:  '#453C35',
+   dg:  '#343031',
+   w:   '#fff',
+   r:   '#fc3435',
+   blu: '#1F3A93',
+   g:   '#00943b'
+}
+```
+
+
+And let's mint an imperial master image:
+
+``` ruby
+img = Image.parse( pixels, colors: colors )
+img.save( './i/vader.png' )
+```
+
+And let's try a 5x zoom factor:
+
+``` ruby
+img5x = img.zoom( 5 )
+img5x.save( './i/vader5x.png' )
+```
+
+Voila!
+
+![](https://github.com/pixelartexchange/pixelart/raw/master/pixelart/i/vader.png)
+![](https://github.com/pixelartexchange/pixelart/raw/master/pixelart/i/vader5x.png)
+
+
+
+
+## Modular "Base" Version
+
+
+Note: By default if you require pixelart
+all classes inside the `Pixelart` module such as `Image`, `Color`, `Gradient`, `Palette8bit`, etc. get "top-leveled", that is,
+included in the top level e.g.:
+
+``` ruby
+require 'pixelart/base'
+include Pixelart
+```
+
+And now you can use all classes without
+the `Pixelart::` module scope e.g.:
+
+``` ruby
+gradient = Gradient.new( '000000', 'ffffff' )
+
+pp colors = gradient.colors( 256 )
+puts '---'
+pp colors.map { |color| Color.to_hex( color ) }
+```
+
+vs
+
+``` ruby
+gradient = Pixelart::Gradient.new( '000000', 'ffffff' )
+
+pp colors = gradient.colors( 256 )
+puts '---'
+pp colors.map { |color| Pixelart::Color.to_hex( color ) }
+```
+
+
+For a "stricter" modular version require the "base" version
+that always requires the `Pixelart::` module scope e.g.:
+
+``` ruby
+require 'pixelart/base'
+```
+
+
+
+
+## Install
+
+Just install the gem:
+
+    $ gem install pixelart
+
+
+## License
+
+The scripts are dedicated to the public domain.
+Use it as you please with no restrictions whatsoever.