zpng 0.0.1

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

@@ -0,0 +1,15 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+#   gem "activesupport", ">= 2.3.5"
+gem 'colorize'
+gem 'hexdump'
+
+# 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.6.4"
+  gem "rcov", ">= 0"
+end

data/Gemfile.lock

@@ -0,0 +1,32 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    colorize (0.5.8)
+    diff-lcs (1.1.3)
+    git (1.2.5)
+    hexdump (0.2.1)
+    jeweler (1.6.4)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+    rake (0.9.2.2)
+    rcov (0.9.11)
+    rspec (2.8.0)
+      rspec-core (~> 2.8.0)
+      rspec-expectations (~> 2.8.0)
+      rspec-mocks (~> 2.8.0)
+    rspec-core (2.8.0)
+    rspec-expectations (2.8.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.8.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.0.0)
+  colorize
+  hexdump
+  jeweler (~> 1.6.4)
+  rcov
+  rspec (~> 2.8.0)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2012 Andrey "Zed" Zaikin
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,161 @@
+zpng
+======
+
+
+Description
+-----------
+A pure ruby PNG file manipulation & validation
+
+Installation
+------------
+    gem install zpng
+
+Usage
+-----
+
+    # zpng -h
+
+    Usage: zpng [options]
+        -v, --verbose                    Run verbosely (can be used multiple times)
+        -q, --quiet                      Silent any warnings (can be used multiple times)
+        -I, --info                       General image info
+        -C, --chunks                     Show file chunks (default)
+        -A, --ascii                      Try to display image as ASCII (works best with monochrome images)
+        -S, --scanlines                  Show scanlines info
+        -P, --palette                    Show palette
+
+### Info
+
+    # zpng --info qr_rgb.png
+
+    [.] image size 35x35
+    [.] uncompressed imagedata size = 3710 bytes
+
+### Chunks
+
+    # zpng --chunks qr_aux_chunks.png
+
+    [.] #<ZPNG::Chunk  IHDR size=   13, crc=36a28ef4, width=35, height=35, depth=1, color=0, compression=0, filter=0, interlace=0> CRC OK
+    [.] #<ZPNG::Chunk  gAMA size=    4, crc=0bfc6105 > CRC OK
+    [.] #<ZPNG::Chunk  sRGB size=    1, crc=aece1ce9 > CRC OK
+    [.] #<ZPNG::Chunk  cHRM size=   32, crc=9cba513c > CRC OK
+    [.] #<ZPNG::Chunk  pHYs size=    9, crc=46c96b3e > CRC OK
+    [.] #<ZPNG::Chunk  IDAT size=  213, crc=5f3f1ff9 > CRC OK
+    [.] #<ZPNG::Chunk  tEXt size=   37, crc=8d62fd1a > CRC OK
+    [.] #<ZPNG::Chunk  tEXt size=   37, crc=fc3f45a6 > CRC OK
+    [.] #<ZPNG::Chunk  IEND size=    0, crc=ae426082 > CRC OK
+
+### ASCII
+
+    # zpng --ascii qr_rgb.png
+
+                                       
+     ####### ##     ## # ##    ####### 
+     #     #       ## # ##     #     # 
+     # ### # #  #####  # #  ## # ### # 
+     # ### # ## #    # #### ## # ### # 
+     # ### # #### #    # ####  # ### # 
+     #     #  #  # #  #####    #     # 
+     ####### # # # # # # # # # ####### 
+              # # ##     ## ##         
+     ####  # #    ## # ##    ##  ### # 
+      # ##   ##     ## # ## # ###   ## 
+     # ### ##      ## # ##  ## # ### # 
+        ### #   #####  # #   ## #   #  
+     ## ## #  # #    # ####  ## ##     
+       #  # ## ## #    # ### ##    ##  
+     # ###### ## # #  #####  #######   
+     # ####  ### ## # ##    #   ## #   
+       ## ##  ###     ## # ## ######## 
+         #  ###  ##     ## ######### # 
+     #### ##### ##     ## #   #   # #  
+      ## #  #  # #  #####  # #  ##   # 
+       ###### ##### #    # ##      #   
+      ###     #  #### #    ### #   ### 
+     ###  #### ####  # #  #######   ## 
+     # # ## ## #     ## # ## ###### #  
+      # #######  # ##     ## #####   # 
+             # ### # ##     ##   # #   
+     #######    # # ##     ### # #     
+     #     #  ###  # #  ######   ### # 
+     # ### #     # #### #   ########   
+     # ### # ###   # #### # # #        
+     # ### # ###  #####  # ##  #  #    
+     #     # #### ##     ## ###      # 
+     ####### # #  ## # ##   # ##   #
+
+### Scanlines
+
+    # zpng --scanlines qr_rgb.png
+
+    [#<ZPNG::ScanLine idx=0, bpp=24, BPP=3, offset=1, filter=1>,
+     #<ZPNG::ScanLine idx=1, bpp=24, BPP=3, offset=107, filter=4>,
+     #<ZPNG::ScanLine idx=2, bpp=24, BPP=3, offset=213, filter=4>,
+     #<ZPNG::ScanLine idx=3, bpp=24, BPP=3, offset=319, filter=4>,
+     #<ZPNG::ScanLine idx=4, bpp=24, BPP=3, offset=425, filter=2>,
+     #<ZPNG::ScanLine idx=5, bpp=24, BPP=3, offset=531, filter=2>,
+     #<ZPNG::ScanLine idx=6, bpp=24, BPP=3, offset=637, filter=4>,
+     #<ZPNG::ScanLine idx=7, bpp=24, BPP=3, offset=743, filter=0>,
+     #<ZPNG::ScanLine idx=8, bpp=24, BPP=3, offset=849, filter=1>,
+     #<ZPNG::ScanLine idx=9, bpp=24, BPP=3, offset=955, filter=0>,
+     #<ZPNG::ScanLine idx=10, bpp=24, BPP=3, offset=1061, filter=0>,
+     #<ZPNG::ScanLine idx=11, bpp=24, BPP=3, offset=1167, filter=0>,
+     #<ZPNG::ScanLine idx=12, bpp=24, BPP=3, offset=1273, filter=1>,
+     #<ZPNG::ScanLine idx=13, bpp=24, BPP=3, offset=1379, filter=2>,
+     #<ZPNG::ScanLine idx=14, bpp=24, BPP=3, offset=1485, filter=4>,
+     #<ZPNG::ScanLine idx=15, bpp=24, BPP=3, offset=1591, filter=0>,
+     #<ZPNG::ScanLine idx=16, bpp=24, BPP=3, offset=1697, filter=4>,
+     #<ZPNG::ScanLine idx=17, bpp=24, BPP=3, offset=1803, filter=0>,
+     #<ZPNG::ScanLine idx=18, bpp=24, BPP=3, offset=1909, filter=4>,
+     #<ZPNG::ScanLine idx=19, bpp=24, BPP=3, offset=2015, filter=4>,
+     #<ZPNG::ScanLine idx=20, bpp=24, BPP=3, offset=2121, filter=0>,
+     #<ZPNG::ScanLine idx=21, bpp=24, BPP=3, offset=2227, filter=1>,
+     #<ZPNG::ScanLine idx=22, bpp=24, BPP=3, offset=2333, filter=2>,
+     #<ZPNG::ScanLine idx=23, bpp=24, BPP=3, offset=2439, filter=0>,
+     #<ZPNG::ScanLine idx=24, bpp=24, BPP=3, offset=2545, filter=2>,
+     #<ZPNG::ScanLine idx=25, bpp=24, BPP=3, offset=2651, filter=1>,
+     #<ZPNG::ScanLine idx=26, bpp=24, BPP=3, offset=2757, filter=1>,
+     #<ZPNG::ScanLine idx=27, bpp=24, BPP=3, offset=2863, filter=4>,
+     #<ZPNG::ScanLine idx=28, bpp=24, BPP=3, offset=2969, filter=4>,
+     #<ZPNG::ScanLine idx=29, bpp=24, BPP=3, offset=3075, filter=4>,
+     #<ZPNG::ScanLine idx=30, bpp=24, BPP=3, offset=3181, filter=4>,
+     #<ZPNG::ScanLine idx=31, bpp=24, BPP=3, offset=3287, filter=2>,
+     #<ZPNG::ScanLine idx=32, bpp=24, BPP=3, offset=3393, filter=4>,
+     #<ZPNG::ScanLine idx=33, bpp=24, BPP=3, offset=3499, filter=4>,
+     #<ZPNG::ScanLine idx=34, bpp=24, BPP=3, offset=3605, filter=1>]
+
+### Palette
+
+    # zpng --palette qr_plte_bw.png
+
+    #<ZPNG::Chunk  PLTE size=    6, crc=55c2d37e >
+    00000000  ff ff ff 00 00 00                                      |......|
+
+
+## Image manipulation
+
+    #!/usr/bin/env ruby
+    require 'zpng'
+    include ZPNG
+
+    img = Image.new(File.join(File.dirname(__FILE__),"http.png"))
+
+    puts "[.] original:"
+    puts img.to_s
+    puts
+
+    img.width.times do |x|
+      img[x,0] = (x % 2 == 0) ? Color::WHITE : Color::BLACK
+    end
+
+    puts "[.] modified:"
+    puts img.to_s
+
+    File.open("http-modified.png","wb") do |f|
+      f << img.export
+    end
+
+
+License
+-------
+Released under the MIT License.  See the [LICENSE](https://github.com/zed-0xff/zpng/blob/master/LICENSE.txt) file for further details.

data/README.md.tpl

@@ -0,0 +1,65 @@
+zpng
+======
+
+
+Description
+-----------
+A pure ruby PNG file manipulation & validation
+
+Installation
+------------
+    gem install zpng
+
+Usage
+-----
+
+% zpng -h
+
+### Info
+
+% zpng --info qr_rgb.png
+
+### Chunks
+
+% zpng --chunks qr_aux_chunks.png
+
+### ASCII
+
+% zpng --ascii qr_rgb.png
+
+### Scanlines
+
+% zpng --scanlines qr_rgb.png
+
+### Palette
+
+% zpng --palette qr_plte_bw.png
+
+
+## Image manipulation
+
+    #!/usr/bin/env ruby
+    require 'zpng'
+    include ZPNG
+
+    img = Image.new(File.join(File.dirname(__FILE__),"http.png"))
+
+    puts "[.] original:"
+    puts img.to_s
+    puts
+
+    img.width.times do |x|
+      img[x,0] = (x % 2 == 0) ? Color::WHITE : Color::BLACK
+    end
+
+    puts "[.] modified:"
+    puts img.to_s
+
+    File.open("http-modified.png","wb") do |f|
+      f << img.export
+    end
+
+
+License
+-------
+Released under the MIT License.  See the [LICENSE](https://github.com/zed-0xff/zpng/blob/master/LICENSE.txt) file for further details.

data/Rakefile

@@ -0,0 +1,74 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "zpng"
+  gem.homepage = "http://github.com/zed-0xff/zpng"
+  gem.license = "MIT"
+  gem.summary = %Q{pure ruby PNG file manipulation & validation}
+  #gem.description = %Q{TODO: longer description of your gem}
+  gem.email = "zed.0xff@gmail.com"
+  gem.authors = ["Andrey \"Zed\" Zaikin"]
+  gem.executables = %w'zpng'
+  gem.files.include "lib/**/*.rb"
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+#require 'rake/rdoctask'
+#Rake::RDocTask.new do |rdoc|
+#  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+#
+#  rdoc.rdoc_dir = 'rdoc'
+#  rdoc.title = "zpng #{version}"
+#  rdoc.rdoc_files.include('README*')
+#  rdoc.rdoc_files.include('lib/**/*.rb')
+#end
+
+desc "build readme"
+task :readme do
+  require 'erb'
+  tpl = File.read('README.md.tpl').gsub(/^%\s+(.+)/) do |x|
+    x.sub! /^%/,''
+    "<%= run(\"#{x}\") %>"
+  end
+  def run cmd
+    cmd.strip!
+    puts "[.] #{cmd} ..."
+    r = "    # #{cmd}\n\n"
+    cmd.sub! /^zpng/,"../bin/zpng"
+    lines = `#{cmd}`.sub(/\A\n+/m,'').sub(/\s+\Z/,'').split("\n")
+    lines = lines[0,25] + ['...'] if lines.size > 50
+    r << lines.map{|x| "    #{x}"}.join("\n")
+    r << "\n"
+  end
+  Dir.chdir 'samples'
+  result = ERB.new(tpl,nil,'%>').result
+  Dir.chdir '..'
+  File.open('README.md','w'){ |f| f << result }
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/bin/zpng

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+$LOAD_PATH.unshift(File.expand_path(File.dirname(__FILE__) + '/../lib'))
+require 'zpng'
+require 'zpng/cli'
+
+ZPNG::CLI.new.run

data/lib/zpng.rb

@@ -0,0 +1,41 @@
+#!/usr/bin/env ruby
+require 'zlib'
+require 'stringio'
+require 'colorize'
+
+require 'zpng/color'
+require 'zpng/block'
+require 'zpng/scan_line'
+require 'zpng/chunk'
+require 'zpng/image'
+
+# see alse http://github.com/wvanbergen/chunky_png/
+
+if $0 == __FILE__
+  if ARGV.size == 0
+    puts "gimme a png filename!"
+  else
+    img = ZPNG::Image.new(ARGV[0])
+    img.dump
+    puts "[.] image size #{img.width}x#{img.height}"
+    puts "[.] uncompressed imagedata size=#{img.imagedata.size}"
+    puts "[.] palette =#{img.palette}"
+#    puts "[.] imagedata: #{img.imagedata[0..30].split('').map{|x| sprintf("%02X",x.ord)}.join(' ')}"
+
+    require 'hexdump'
+    #Hexdump.dump(img.imagedata, :width => 6)
+    require 'pp'
+    pp img.scanlines[0..5]
+#    puts Hexdump.dump(img.imagedata[0,60])
+#    img.scanlines.each do |l|
+#      puts l.to_s
+#    end
+    puts img.to_s
+    img[1,0]= ZPNG::Color.new(0,0,0)
+    puts img.to_s
+    File.open 'export.png','wb' do |f|
+      f << img.export
+    end
+  end
+end
+

data/lib/zpng/block.rb

@@ -0,0 +1,41 @@
+module ZPNG
+  class Block
+    attr_accessor :width, :height, :pixels
+    def initialize image, x, y, w, h
+      @width, @height = w,h
+      @pixels = []
+      h.times do |i|
+        w.times do |j|
+          @pixels << image[x+j,y+i]
+        end
+      end
+    end
+
+    def to_s
+      a = []
+      height.times do |i|
+        b = []
+        width.times do |j|
+          b << pixels[i*width+j].to_s
+        end
+        a << b.join(" ")
+      end
+      a.join "\n"
+    end
+
+    def to_binary_string c_white = ' ', c_black = 'X'
+      @pixels.each do |p|
+        raise "pixel #{p.inspect} is not white nor black" if !p.white? && !p.black?
+      end
+      a = []
+      height.times do |i|
+        b = []
+        width.times do |j|
+          b << (pixels[i*width+j].black? ? c_black : c_white)
+        end
+        a << b.join(" ")
+      end
+      a.join "\n"
+    end
+  end
+end