sugar_png 0.0.1 → 0.5.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: f4e3f3c23821bd5142bd7fa690b710dac9f81f32f387384c5696b414674addbf
+  data.tar.gz: c6219a130b05bf3b7bae14c91401710b91c6226eafca11747e80852cb189112e
+SHA512:
+  metadata.gz: de450b6e2c69a0b37d524be8c29a18fadee725e941df5bfd7146dd47263eea3dea7305d9e34373b86b4de730ace12e084e1eb2b0491ae95ae94d0e5e8b983d7c
+  data.tar.gz: bc68d74a7c5b9464c4a49255e9408431a94ab8eaa7f6b059a967f54e403b057a3e5200bf17e7e2b12746617fa5e4f40f5f96e0b4d76b4dda1a3710c2536f841a

data/Gemfile

@@ -2,12 +2,14 @@ source "http://rubygems.org"
 # Add dependencies required to use your gem here.
 # Example:
 #   gem "activesupport", ">= 2.3.5"
-gem 'zpng', ">= 0.2.0"
+gem 'zpng', ">= 0.3.1"
 
 # Add dependencies to develop your gem here.
 # Include everything needed to run rake, tests, features, etc.
 group :development do
-  gem "rspec",   ">= 2.8.0"
-  gem "bundler", ">= 1.0.0"
-  gem "jeweler", "~> 1.8.4"
+  gem "rspec",   "~> 3.9.0"
+  gem "rspec-its", "~> 1.3.0"
+  gem "bundler", "~> 2.2.3"
+  gem "jeweler", "~> 2.3.9"
+  gem "awesome_print"
 end

data/Gemfile.lock

@@ -1,36 +1,89 @@
 GEM
   remote: http://rubygems.org/
   specs:
-    diff-lcs (1.1.3)
-    git (1.2.5)
-    hexdump (0.2.3)
-    jeweler (1.8.4)
-      bundler (~> 1.0)
+    addressable (2.4.0)
+    awesome_print (1.8.0)
+    builder (3.2.4)
+    descendants_tracker (0.0.4)
+      thread_safe (~> 0.3, >= 0.3.1)
+    diff-lcs (1.4.4)
+    faraday (0.9.2)
+      multipart-post (>= 1.2, < 3)
+    git (1.8.1)
+      rchardet (~> 1.8)
+    github_api (0.16.0)
+      addressable (~> 2.4.0)
+      descendants_tracker (~> 0.0.4)
+      faraday (~> 0.8, < 0.10)
+      hashie (>= 3.4)
+      mime-types (>= 1.16, < 3.0)
+      oauth2 (~> 1.0)
+    hashie (4.1.0)
+    highline (2.0.3)
+    jeweler (2.3.9)
+      builder
+      bundler
       git (>= 1.2.5)
+      github_api (~> 0.16.0)
+      highline (>= 1.6.15)
+      nokogiri (>= 1.5.10)
+      psych
       rake
       rdoc
-    json (1.7.5)
-    rainbow (1.1.4)
-    rake (10.0.3)
-    rdoc (3.12)
-      json (~> 1.4)
-    rspec (2.12.0)
-      rspec-core (~> 2.12.0)
-      rspec-expectations (~> 2.12.0)
-      rspec-mocks (~> 2.12.0)
-    rspec-core (2.12.2)
-    rspec-expectations (2.12.1)
-      diff-lcs (~> 1.1.3)
-    rspec-mocks (2.12.1)
-    zpng (0.2.0)
-      hexdump
+      semver2
+    jwt (2.2.2)
+    mime-types (2.99.3)
+    mini_portile2 (2.5.0)
+    multi_json (1.15.0)
+    multi_xml (0.6.0)
+    multipart-post (2.1.1)
+    nokogiri (1.11.1)
+      mini_portile2 (~> 2.5.0)
+      racc (~> 1.4)
+    oauth2 (1.4.4)
+      faraday (>= 0.8, < 2.0)
+      jwt (>= 1.0, < 3.0)
+      multi_json (~> 1.3)
+      multi_xml (~> 0.5)
+      rack (>= 1.2, < 3)
+    psych (3.3.0)
+    racc (1.5.2)
+    rack (2.2.3)
+    rainbow (3.0.0)
+    rake (13.0.3)
+    rchardet (1.8.0)
+    rdoc (6.3.0)
+    rspec (3.9.0)
+      rspec-core (~> 3.9.0)
+      rspec-expectations (~> 3.9.0)
+      rspec-mocks (~> 3.9.0)
+    rspec-core (3.9.3)
+      rspec-support (~> 3.9.3)
+    rspec-expectations (3.9.4)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.9.0)
+    rspec-its (1.3.0)
+      rspec-core (>= 3.0.0)
+      rspec-expectations (>= 3.0.0)
+    rspec-mocks (3.9.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.9.0)
+    rspec-support (3.9.4)
+    semver2 (3.4.2)
+    thread_safe (0.3.6)
+    zpng (0.3.2)
       rainbow
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
-  bundler (>= 1.0.0)
-  jeweler (~> 1.8.4)
-  rspec (>= 2.8.0)
-  zpng (>= 0.2.0)
+  awesome_print
+  bundler (~> 2.2.3)
+  jeweler (~> 2.3.9)
+  rspec (~> 3.9.0)
+  rspec-its (~> 1.3.0)
+  zpng (>= 0.3.1)
+
+BUNDLED WITH
+   2.2.3

data/README.md

@@ -0,0 +1,105 @@
+sugar_png    [![Build Status](https://travis-ci.org/zed-0xff/sugar_png.png?branch=master)](https://travis-ci.org/zed-0xff/sugar_png)  [![Dependency Status](https://gemnasium.com/zed-0xff/sugar_png.png)](https://gemnasium.com/zed-0xff/sugar_png)
+======
+
+
+Description
+-----------
+A pure ruby high-level PNG file creation toolkit.
+
+(If you need a low-level PNG manipulation & analysis toolkit - take a look at [ZPNG](https://github.com/zed-0xff/zpng))
+
+Features
+--------
+ * neat syntax
+ * unicode text drawing support
+ * 16-bit color depth support
+
+Installation
+------------
+    gem install sugar_png
+
+Examples
+--------
+
+### Hello World!
+<img src="https://raw.githubusercontent.com/zed-0xff/sugar_png/master/samples/readme/hello_world.png" alt="Hello World!" title="Hello World!" align="right" />
+```ruby
+  SugarPNG.new do
+    text "Hello World!"
+    save "out.png"
+  end
+```
+
+### Explicit image dimensions + bg color
+<img src="https://raw.githubusercontent.com/zed-0xff/sugar_png/master/samples/readme/explicit_image_dimensions_bg_color.png" alt="Explicit image dimensions + bg color" title="Explicit image dimensions + bg color" align="right" />
+```ruby
+  SugarPNG.new do
+    background 'red' # or :blue, or #ffee00, or :transparent (default)
+    width 100
+    height 50
+    text "Hello World!", :color => '#ffffff'
+    save "out.png"
+  end
+```
+
+### Japanese text with rainbow borders, zoomed 4x
+<img src="https://raw.githubusercontent.com/zed-0xff/sugar_png/master/samples/readme/japanese_text_with_rainbow_borders_zoomed_4x.png" alt="Japanese text with rainbow borders, zoomed 4x" title="Japanese text with rainbow borders, zoomed 4x" align="right" />
+```ruby
+  SugarPNG.new do
+    border 1, :red
+    border 1, :green
+    border 1, :blue
+    text '水水水'
+    zoom 4
+
+    save "out.png"
+  end
+```
+
+### White noise
+<img src="https://raw.githubusercontent.com/zed-0xff/sugar_png/master/samples/readme/white_noise.png" alt="White noise" title="White noise" align="right" />
+```ruby
+  SugarPNG.new do
+    bg :black  # shortcut for 'background'
+    fg :white  # ditto
+    width  100
+    height 100
+    200.times{ pixel(rand(100),rand(100)) }
+
+    save "out.png"
+  end
+```
+
+### Playing with transparency & 16-bit color depth
+<img src="https://raw.githubusercontent.com/zed-0xff/sugar_png/master/samples/readme/playing_with_transparency_16_bit_color_depth.png" alt="Playing with transparency & 16-bit color depth" title="Playing with transparency & 16-bit color depth" align="right" />
+```ruby
+  SugarPNG.new do |img|
+    img.depth = 16
+
+    100.times do |y|
+      100.times do |x|
+        img[x,y] = [0,65536*x/100,0,65535*y/100] # RGBA
+      end
+    end
+
+    # 'export' returns PNG image data suitable for streaming to client
+    # or manually saving to a file or do whatever you want 
+    @data = img.export
+  end
+```
+
+### Pixels can be set using Ranges, Enumerators & Arrays
+<img src="https://raw.githubusercontent.com/zed-0xff/sugar_png/master/samples/readme/pixels_can_be_set_using_ranges_enumerators_arrays.png" alt="Pixels can be set using Ranges, Enumerators & Arrays" title="Pixels can be set using Ranges, Enumerators & Arrays" align="right" />
+```ruby
+  SugarPNG.new do |img|
+    # Ranges
+    img[10...50, 10..20] = :blue
+    # Array + Enumerator
+    img[[1,2,4,8,16,32], 0.step(50,2)] = :red
+    img.zoom = 2 
+  end.save("out.png")
+```
+
+License
+-------
+Released under the MIT License.  See the [LICENSE](https://github.com/zed-0xff/sugar_png/blob/master/LICENSE.txt) file for further details.

data/README.md.tpl

@@ -0,0 +1,99 @@
+sugar_png    [![Build Status](https://travis-ci.org/zed-0xff/sugar_png.png?branch=master)](https://travis-ci.org/zed-0xff/sugar_png)  [![Dependency Status](https://gemnasium.com/zed-0xff/sugar_png.png)](https://gemnasium.com/zed-0xff/sugar_png)
+======
+
+
+Description
+-----------
+A pure ruby high-level PNG file creation toolkit.
+
+(If you need a low-level PNG manipulation & analysis toolkit - take a look at [ZPNG](https://github.com/zed-0xff/zpng))
+
+Features
+--------
+ * neat syntax
+ * unicode text drawing support
+ * 16-bit color depth support
+
+Installation
+------------
+    gem install sugar_png
+
+Examples
+--------
+
+### Hello World!
+```ruby
+  SugarPNG.new do
+    text "Hello World!"
+    save "out.png"
+  end
+```
+
+### Explicit image dimensions + bg color
+```ruby
+  SugarPNG.new do
+    background 'red' # or :blue, or #ffee00, or :transparent (default)
+    width 100
+    height 50
+    text "Hello World!", :color => '#ffffff'
+    save "out.png"
+  end
+```
+
+### Japanese text with rainbow borders, zoomed 4x
+```ruby
+  SugarPNG.new do
+    border 1, :red
+    border 1, :green
+    border 1, :blue
+    text '水水水'
+    zoom 4
+
+    save "out.png"
+  end
+```
+
+### White noise
+```ruby
+  SugarPNG.new do
+    bg :black  # shortcut for 'background'
+    fg :white  # ditto
+    width  100
+    height 100
+    200.times{ pixel(rand(100),rand(100)) }
+
+    save "out.png"
+  end
+```
+
+### Playing with transparency & 16-bit color depth
+```ruby
+  SugarPNG.new do |img|
+    img.depth = 16
+
+    100.times do |y|
+      100.times do |x|
+        img[x,y] = [0,65536*x/100,0,65535*y/100] # RGBA
+      end
+    end
+
+    # 'export' returns PNG image data suitable for streaming to client
+    # or manually saving to a file or do whatever you want 
+    @data = img.export
+  end
+```
+
+### Pixels can be set using Ranges, Enumerators & Arrays
+```ruby
+  SugarPNG.new do |img|
+    # Ranges
+    img[10...50, 10..20] = :blue
+    # Array + Enumerator
+    img[[1,2,4,8,16,32], 0.step(50,2)] = :red
+    img.zoom = 2 
+  end.save("out.png")
+```
+
+License
+-------
+Released under the MIT License.  See the [LICENSE](https://github.com/zed-0xff/sugar_png/blob/master/LICENSE.txt) file for further details.

data/Rakefile

@@ -23,6 +23,7 @@ Jeweler::Tasks.new do |gem|
   gem.authors = ["Andrey \"Zed\" Zaikin"]
   #gem.executables = %w'sugar_png'
   gem.files.include "lib/**/*.rb"
+  gem.files.include "data/font/??"
   # dependencies defined in Gemfile
 end
 Jeweler::RubygemsDotOrgTasks.new
@@ -40,12 +41,46 @@ end
 
 task :default => :spec
 
-desc "generate"
-task :gen do
-  $:.unshift("./lib")
-  require 'sugar_png'
-  img = ZPNG::Image.new :width => 16, :height => 16, :bpp => 4
-  img.save "out.png"
+desc "build readme"
+task :readme do
+  dir = "samples/readme"
+  FileUtils.mkdir_p(dir) unless Dir.exist?(dir)
+
+  tpl = File.read('README.md.tpl')
+  Dir.chdir "tmp"
+  result = tpl.gsub(/^### ([^~`\n]+?)\n```ruby(.+?)^```/m) do |x|
+    title, code = $1, $2
+    fname = File.join(
+      dir,
+      title.split(/\W+/).join('_').sub(/^_+/,'').sub(/_+$/,'').downcase + ".png"
+    )
+    
+    File.open("tmp.rb", "w:utf-8") do |f|
+      f.puts "#coding: utf-8"
+      f.puts "$:.unshift('../lib')"
+      f.puts "require 'sugar_png'"
+      f.puts "srand 0"
+      f.puts code
+      f.puts <<-EOF
+        if defined?(@data) && @data
+          File.open("out.png","wb"){ |f| f<<@data }
+        end
+      EOF
+    end
+
+    puts "[.] #{fname} .. "
+    system "ruby tmp.rb"
+    exit unless $?.success?
+    raise "[?] no out.png" unless File.exist?("out.png")
+    FileUtils.mv "out.png", "../#{fname}"
+
+    url = File.join("https://raw.githubusercontent.com/zed-0xff/sugar_png/master", fname)
+    img = %Q|<img src="#{url}" alt="#{title}" title="#{title}" align="right" />|
+
+    x.sub(title,title+"\n"+img)
+  end
+  Dir.chdir ".."
+  File.open('README.md','w'){ |f| f << result }
 end
 
 Rake::Task[:console].clear

data/VERSION

@@ -1 +1 @@
-0.0.1
+0.5.2

data/data/1-dump-hex.rb

@@ -0,0 +1,22 @@
+#!/usr/bin/env ruby
+
+fname = ARGV.first || "unifont-5.1.20080820.hex"
+
+want = ARGV[1] && ARGV[1].to_i(16)
+
+File.read(fname).each_line do |line|
+  idx, data = line.strip.split(':',2)
+  idx = idx.to_i(16)
+  next if want && want != idx
+  case data.size
+  when 32
+    data.scan(/../).each do |x|
+      puts(("%08b" % x.to_i(16)).tr('01',' #'))
+    end
+  when 64
+    data.scan(/..../).each do |x|
+      puts(("%016b" % x.to_i(16)).tr('01',' #'))
+    end
+  else raise data.size.to_s
+  end
+end

data/data/2-marshal-test.rb

@@ -0,0 +1,22 @@
+#!/usr/bin/env ruby
+require 'hexdump'
+require 'awesome_print'
+
+def dump x
+  data = Marshal.dump(x)
+  printf "[.] %4d: %-10s (%d): %s\n".green, data.size, x.class.to_s, x.size, x.inspect[0,30].gray
+  Hexdump.dump data
+  puts
+end
+
+dump 0
+dump 0xff
+dump [0] * 10
+dump [0xff] * 10
+dump 'x'
+dump 'x'*100
+dump ['x']*100
+
+a = [1,2,3,4,5]
+dump a
+dump [a]*10