rpdiff 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: af35e2511342dba9d3c08c126b947a999e448d2e
+  data.tar.gz: 9077537a63e74d9f736a1586dcefbe21a1271c1c
+SHA512:
+  metadata.gz: 6f810d02144f1063f6647b4fe2a229f53db5fab4e46605db3f1a2819c7c9b209f4b5ac9dc491588f19cc8513413231844c35f9ef34ed3f9771f4a4c15122364b
+  data.tar.gz: 72c4699264956ee3f1e3171b95d0b5a08d2d06e005ab57f1ce7378bcb0ca78d03d80e06f4506801ddeef8ccab22236c53b6a3839fc91143acbeac5f8153534f3

data/README

@@ -0,0 +1,5 @@
+This is a wrapper on Perceptual diff (http://pdiff.sourceforge.net/).
+
+The basic application is to compare images and see the differences or evaluate pixel by pixel how different they are. This is practical for a deployment/QA environment as well as other image processing applications, like finding similarities.
+
+Based on https://github.com/aaronfeng/perceptual_diff/blob/master/perceptual_diff.rb

data/bin/rpdiff

@@ -0,0 +1,31 @@
+#!/usr/bin/env ruby
+require_relative "../lib/rpdiff.rb"
+
+require 'optparse'
+options = {}
+
+OptionParser.new do |opts|
+  opts.banner = "Compares image1.tif and image2.tif using a perceptually based image metric. Options:"
+
+  opts.on("-verbose",                 "Turns on verbose mode")                                            {|val| options[:verbose]       = val}
+  opts.on("-debug",                   "Turns on perceptualdiff command line output")                      {|val| options[:debug]         = val}
+  opts.on("-output out.ppm", String,  "Write difference to the file o.ppm")                               {|val| options[:output]        = val}
+  opts.on("-fov deg",        String,  "Field of view in degrees (0.1 to 89.9)")                           {|val| options[:fov]           = val}
+  opts.on("-threshold p",    Integer, "#pixels p below which differences are ignored")                    {|val| options[:threshold]     = val}
+  opts.on("-gamma g",        Float,   "Value to convert rgb into linear space (default 2.2)")             {|val| options[:gamma]         = val}
+  opts.on("-luminance l",    Float,   "White luminance (default 100.0 cdm^-2)")                           {|val| options[:luminance]     = val}
+  opts.on("-luminanceonly",           "Only consider luminance; ignore chroma (color) in the comparison") {|val| options[:luminanceonly] = val}
+  opts.on("-match_percentage",        "Process pixel match in %")                                         {|val| options[:match_percentage] = val}
+
+  opts.parse!
+  if ARGV.count == 2
+    img1, img2 = ARGV
+
+    match_percentage = options.delete :match_percentage
+    rpdiff = RPDiff.new(img1, img2, options)
+    rpdiff.diff
+  else
+    puts opts
+    exit
+  end
+end

data/lib/rpdiff.rb

@@ -0,0 +1,43 @@
+class RPDiff
+
+  attr_reader   :visibly_different, :identical, :indistinguishable, :pixel_difference,
+                :img1, :img2, :fov, :threshold, :gamma, :luminance
+
+  def initialize(img1, img2, options={})
+    @img1, @img2, @options = img1, img2, options
+  end
+
+  def diff
+    @indistinguishable = @visibly_different = @identical = false
+    @pixel_difference = 0
+
+    opts = "#{@img1} #{@img2} "
+    @options.each {|k, v| opts << "-#{k} #{v}" if v }
+    io = `perceptualdiff -verbose #{opts}`
+
+    io.split(/\n/).each do |line|
+      @fov               = $1   if line =~ /Field of view is (\d+\.\d+) degrees/
+      @threshold         = $1   if line =~ /Threshold pixels is (\d+) pixels/
+      @gamma             = $1   if line =~ /The Gamma is (\d+\.\d+)/
+      @luminance         = $1   if line =~ /The Display's luminance is (\d+\.\d+) candela per meter squared/
+      @pixel_difference  = $1   if line =~ /(\d+) pixels are different/
+      @visibly_different = true if line =~ /FAIL: Images are visibly different/
+      @identical         = true if line =~ /PASS: Images are binary identical/
+      @indistinguishable = true if line =~ /PASS: Images are perceptually indistinguishable/
+    end
+
+    if @options[:match_percentage]
+      calculate_match_percentage
+    end
+
+    puts io
+  end
+
+  #Optional gem requirement to get a % value out of image similarity.
+  def calculate_match_percentage
+    require 'fastimage'
+    @image_sizes = FastImage.size(@img1)
+    @match_percentage = 100 - (@pixel_difference.to_f * 100 / (@image_sizes.first * @image_sizes.last).to_f)
+  end
+
+end

metadata

@@ -0,0 +1,46 @@
+--- !ruby/object:Gem::Specification
+name: rpdiff
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Gabriel Benmergui
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-02-26 00:00:00.000000000 Z
+dependencies: []
+description: A thin wrapper on Perceptual Diff for ease of use.
+email: gabriel.benmergui@gmail.com
+executables:
+- rpdiff
+extensions: []
+extra_rdoc_files: []
+files:
+- README
+- bin/rpdiff
+- lib/rpdiff.rb
+homepage: http://github.com/conanbatt/rpdiff
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- - lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Rpdiff is a ruby wrapper on Perceptual diff
+test_files: []