sugar_png 0.0.1 → 0.4.0

data/Gemfile

@@ -2,7 +2,7 @@ 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.2.1"
 
 # Add dependencies to develop your gem here.
 # Include everything needed to run rake, tests, features, etc.
@@ -10,4 +10,5 @@ group :development do
   gem "rspec",   ">= 2.8.0"
   gem "bundler", ">= 1.0.0"
   gem "jeweler", "~> 1.8.4"
+  gem "awesome_print"
 end

data/Gemfile.lock

@@ -1,9 +1,9 @@
 GEM
   remote: http://rubygems.org/
   specs:
+    awesome_print (1.1.0)
     diff-lcs (1.1.3)
     git (1.2.5)
-    hexdump (0.2.3)
     jeweler (1.8.4)
       bundler (~> 1.0)
       git (>= 1.2.5)
@@ -22,15 +22,15 @@ GEM
     rspec-expectations (2.12.1)
       diff-lcs (~> 1.1.3)
     rspec-mocks (2.12.1)
-    zpng (0.2.0)
-      hexdump
+    zpng (0.2.1)
       rainbow
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
+  awesome_print
   bundler (>= 1.0.0)
   jeweler (~> 1.8.4)
   rspec (>= 2.8.0)
-  zpng (>= 0.2.0)
+  zpng (>= 0.2.1)

data/README.md

@@ -0,0 +1,105 @@
+sugar_png    [![Build Status](https://secure.travis-ci.org/zed-0xff/sugar_png.png)](http://secure.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="//raw.github.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="//raw.github.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="//raw.github.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="//raw.github.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="//raw.github.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="//raw.github.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://secure.travis-ci.org/zed-0xff/sugar_png.png)](http://secure.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("//raw.github.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.4.0

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

data/data/3-hex2marshal.rb

@@ -0,0 +1,71 @@
+#!/usr/bin/env ruby
+
+fname = ARGV.first || "unifont-5.1.20080820.hex"
+
+want = ARGV[1] && ARGV[1].to_i(16)
+
+h = {}
+a = []
+dedup = {}
+aa = []
+
+File.read(fname).each_line do |line|
+  idx, data = line.strip.split(':',2)
+  idx = idx.to_i(16)
+  s = data.scan(/../).map{ |x| x.to_i(16).chr }.join
+  s = (dedup[s] ||= s)
+#  unless s.split('').uniq == ["\x00"]
+    h[idx] = s
+    a[idx] = s
+    aa[idx >> 8] ||= []
+    aa[idx >> 8][idx & 0xff] = s
+#  end
+end
+
+puts "[=] #{aa.size} pages"
+puts "[=] #{aa.uniq.size} unique pages"
+
+# dedup pages
+aa.each_with_index do |page,idx|
+  (idx+1).upto(aa.size-1) do |idx2|
+    aa[idx2] = page if aa[idx2] == page
+  end
+end
+
+puts "[=] #{h.size} non-empty chars"
+puts "[=] #{h.values.uniq.size} unique chars"
+
+puts "[=] #{h.values.join.size} bytes raw data size"
+
+data = Marshal.dump(h)
+puts "[=] #{data.size} bytes marshaled hash"
+
+data = Marshal.dump(a)
+puts "[=] #{data.size} bytes marshaled array"
+
+data = Marshal.dump(aa)
+puts "[=] #{data.size} bytes marshaled array2"
+
+# .index header     =  512 bytes
+# .index data       = 1024 bytes (256 pages of 4 bytes each)
+# first file header =  512 bytes
+#index = ''
+#offset = 512 + 1024 + 512
+aa.each_with_index do |a,pageno|
+  # skip empty pages and pages entirely of one glyph (most likely Unassigned ones)
+  next if a.nil? || a.empty? || a.uniq.size == 1
+  fname = "font/%02x" % pageno
+  data = Marshal.dump(a)
+  puts "[.] #{fname}: #{data.size}"
+  File.open(fname, "wb"){ |f| f << data }
+
+#  index << [offset].pack('V')
+#
+#  size = data.size
+#  if size & 0x1ff != 0
+#    size = (size|0x1ff) + 1
+#  end
+#  offset += size+512 # add TAR header size
+end
+
+#File.open('data/.index','wb'){ |f| f<<index }