pixelart 1.2.2 → 1.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6be97cd0f30e95965b6ca21d69142283d1e2869ba99e37b84245b5d95c47fda0
-  data.tar.gz: 2bc68cf7a70d718e2d96b92f4401f44074b01282cb5ede85d548b36edac7d3d6
+  metadata.gz: a9cb1460263f319b98c4d333f6caa42118eb94f583f9cc6cdaa5bfa6bc4316b9
+  data.tar.gz: 2deabe3c3bc35c62d249e0ff5178d23f986d1131c96daf53a8d36fde51cd6de8
 SHA512:
-  metadata.gz: c329166bd2144e1e440d01447c9babc6d999de0aed2d9eb3dedaa521b016b829f0039d8fdf5475afeffbc46f2f75f1efaca1a95f73a3c3e968d653041ff4656a
-  data.tar.gz: 44ab750a9bdec98770ff6ed325b8fac5883e693ae3356b08012184bdf72a20c1c88a023fb883dc437311df043d6a2d23012f54309d70dfa8e3402deb5683e945
+  metadata.gz: 57213049f46aac9a612adb3d9e236ce03aa336318705cabaed98f1f87557dc5dc08a73a7f50254852ab0c3c988ca0ed3d5b3ba6666925640ab837692c573be7c
+  data.tar.gz: 9ff7ae16a77eca4b2d4deb65b98747aa053ab97ab15b0f8a40d373f5ecb96dcd2c18d2fdfd18beca0c06a5e9330719dd2df1a3be1efac07c8f008dfa0b4db614

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,17 +5,22 @@ 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/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
+lib/pixelart/stripes.rb
 lib/pixelart/transparent.rb
+lib/pixelart/ukraine.rb
 lib/pixelart/vector.rb
 lib/pixelart/version.rb

data/README.md

@@ -1,290 +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/pixelartexchange/pixel](https://github.com/pixelartexchange/pixel)
-* bugs  :: [github.com/pixelartexchange/pixel/issues](https://github.com/pixelartexchange/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/pixelartexchange/pixel/raw/master/pixelart/i/mooncat_white.png)
-![](https://github.com/pixelartexchange/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/pixelartexchange/pixel/raw/master/pixelart/i/mooncat_black.png)
-![](https://github.com/pixelartexchange/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/pixelartexchange/pixel/raw/master/pixelart/i/vader.png)
-![](https://github.com/pixelartexchange/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.