focusinspector 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"
+
+# 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 "rdoc", ">= 3.9"
+  gem "bundler", ">= 1.0.0"
+  gem "jeweler", ">= 1.8.4"
+  gem "rmagick", ">= 2.13.1"
+  gem "mini_exiftool", ">= 1.6.0"
+end

data/Gemfile.lock

@@ -0,0 +1,33 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    diff-lcs (1.1.3)
+    git (1.2.5)
+    jeweler (1.8.4)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+      rdoc
+    mini_exiftool (1.6.0)
+    rake (0.9.2.2)
+    rdoc (3.9.4)
+    rmagick (2.13.1)
+    rspec (2.11.0)
+      rspec-core (~> 2.11.0)
+      rspec-expectations (~> 2.11.0)
+      rspec-mocks (~> 2.11.0)
+    rspec-core (2.11.1)
+    rspec-expectations (2.11.3)
+      diff-lcs (~> 1.1.3)
+    rspec-mocks (2.11.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (>= 1.0.0)
+  jeweler (>= 1.8.4)
+  mini_exiftool (>= 1.6.0)
+  rdoc (>= 3.9)
+  rmagick (>= 2.13.1)
+  rspec (>= 2.8.0)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2012 Chris Schlaeger
+
+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.rdoc

@@ -0,0 +1,92 @@
+= focusinspector
+
+Simple utility for DSLR photographers. It allows you to overlay the
+used focus points over the image. It can also be used to fine tune
+your lens focus.
+
+== Installation
+
+Before you install this software, make sure you have the following
+dependencies installed:
+
+* ImageMagick: You need to install the header files (-devel package) as well. (http://www.imagemagick.org/script/index.php)
+* exiftool: Needed to extract EXIF information from images. (http://owl.phy.queensu.ca/~phil/exiftool/)
+* dcraw: Needed to extract the JPG thumbnail from raw files. (http://www.cybercom.net/~dcoffin/dcraw/)
+* gwenview: This is the default image viewer of the KDE environment.  You can use any other software that can show JPG files but you need to use the --viewer option to specify it on the command line.
+* ruby 1.9: Focus Inspector is written in Ruby (http://www.ruby-lang.org/en/)
+
+All these package can be found on the commonly used Linux distros.
+You can easily install them with the package manager.
+
+Additionally, you need to have the following ruby gem packages installed:
+
+* rmagick
+* mini_exiftool
+
+These will be automatically installed when you install Focus
+Inspector as a gem package.
+
+  gem install focusinspector
+
+== Usage
+
+Focus Inspector has 3 usage modes:
+
+=== Show focus grid and active focus points
+
+Display a JPG or raw file with focus grid overlay. The file needs
+to have proper EXIF information.
+
+  focusinspector show DSC_1234.NEF
+
+If you don't have KDE installed, you need to use the --viewer option
+to specify the JPG viewer to be used.
+
+=== Measure sharpness of the image of the FI test chart
+
+This only works with an photograph of the Focus Inspector test chart.
+The test pattern must be surrounding the active focus point and
+should roughly cover a quarter of the total image.
+
+  focusinspector measure DSC_1234.NEF
+
+The result is a sharpness value in percent. This is not really an
+absolute value, but it can be used to compare sharpness of images
+that were taken under the same lighting conditions with the same test
+chart.
+
+=== List some focusing relevant EXIF data
+
+Just for convenience.
+
+  focusinspector list DSC_1234.NEF
+
+== Supported Cameras
+
+Currently, only the following cameras are supported:
+
+* Nikon D5100
+* Nikon D300 and D300s
+* Nikon D800 and D800E
+
+Adding other cameras is fairly straight forward. The location of all
+focus points needs to be added to lib/focusinspector/Camera.rb.
+Unfortunately, not all EXIF tags are standardized across camera
+vendors. Adding support for other vendors than Nikon might require
+some additional work to find and parse the right EXIF tags.
+
+== Contributing to focusinspector
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
+* Fork the project.
+* Start a feature/bugfix branch.
+* Commit and push until you are happy with your contribution.
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright and lincense
+
+Copyright (c) 2012 Chris Schlaeger. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,49 @@
+# 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 = "focusinspector"
+  gem.homepage = "http://github.com/scrapper/focusinspector"
+  gem.license = "MIT"
+  gem.summary = %Q{Utility for DSLR photographers}
+  gem.description = %Q{Allows you to view active focus points in taken images and to fine tune your lenses}
+  gem.email = "chris@linux.com"
+  gem.authors = ["Chris Schlaeger"]
+  # 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 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "focusinspector #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

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

data/bin/focusinspector

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+$:.unshift File.join(File.dirname(__FILE__), '..', 'lib')
+require File.basename(__FILE__)
+

data/focusinspector.gemspec

@@ -0,0 +1,76 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "focusinspector"
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Chris Schlaeger"]
+  s.date = "2012-10-13"
+  s.description = "Allows you to view active focus points in taken images and to fine tune your lenses"
+  s.email = "chris@linux.com"
+  s.executables = ["focusinspector"]
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    "FI-Test-Chart.pdf",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "bin/focusinspector",
+    "focusinspector.gemspec",
+    "lib/focusinspector.rb",
+    "lib/focusinspector/AppConfig.rb",
+    "lib/focusinspector/Camera.rb",
+    "lib/focusinspector/FocusInspector.rb",
+    "lib/focusinspector/ImageMarker.rb",
+    "lib/focusinspector/ImageViewer.rb",
+    "lib/focusinspector/Log.rb",
+    "lib/focusinspector/SharpnessMeter.rb",
+    "spec/focusinspector_spec.rb",
+    "spec/spec_helper.rb"
+  ]
+  s.homepage = "http://github.com/scrapper/focusinspector"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.23"
+  s.summary = "Utility for DSLR photographers"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, [">= 2.8.0"])
+      s.add_development_dependency(%q<rdoc>, [">= 3.9"])
+      s.add_development_dependency(%q<bundler>, [">= 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, [">= 1.8.4"])
+      s.add_development_dependency(%q<rmagick>, [">= 2.13.1"])
+      s.add_development_dependency(%q<mini_exiftool>, [">= 1.6.0"])
+    else
+      s.add_dependency(%q<rspec>, [">= 2.8.0"])
+      s.add_dependency(%q<rdoc>, [">= 3.9"])
+      s.add_dependency(%q<bundler>, [">= 1.0.0"])
+      s.add_dependency(%q<jeweler>, [">= 1.8.4"])
+      s.add_dependency(%q<rmagick>, [">= 2.13.1"])
+      s.add_dependency(%q<mini_exiftool>, [">= 1.6.0"])
+    end
+  else
+    s.add_dependency(%q<rspec>, [">= 2.8.0"])
+    s.add_dependency(%q<rdoc>, [">= 3.9"])
+    s.add_dependency(%q<bundler>, [">= 1.0.0"])
+    s.add_dependency(%q<jeweler>, [">= 1.8.4"])
+    s.add_dependency(%q<rmagick>, [">= 2.13.1"])
+    s.add_dependency(%q<mini_exiftool>, [">= 1.6.0"])
+  end
+end
+

data/lib/focusinspector.rb

@@ -0,0 +1,20 @@
+#!/usr/bin/env ruby -w
+# encoding: UTF-8
+#
+# Focus Inspector - The focus inspection and lens calibration software.
+#
+# Copyright (c) 2012 by Chris Schlaeger <chris@linux.com>
+#
+# This program is Open Source software; you can redistribute it and/or modify
+# it under the terms of MIT license as shipped with this software.
+
+require 'rubygems'
+require 'tempfile'
+require 'optparse'
+require 'RMagick'
+require 'mini_exiftool'
+
+require 'focusinspector/FocusInspector'
+
+FocusInspector.new(ARGV)
+

data/lib/focusinspector/AppConfig.rb

@@ -0,0 +1,71 @@
+#!/usr/bin/env ruby -w
+# encoding: UTF-8
+#
+# Focus Inspector - The focus inspection and lens calibration software.
+#
+# Copyright (c) 2012 by Chris Schlaeger <chris@linux.com>
+#
+# This program is Open Source software; you can redistribute it and/or modify
+# it under the terms of MIT license as shipped with this software.
+
+class AppConfig
+
+  attr_reader :imageFile, :command, :viewer
+
+  def initialize(args)
+    @imageFile = nil
+    @command = nil
+    @viewer = 'gwenview'
+
+    version = IO.read(File.expand_path(File.dirname(__FILE__) +
+                                       "/../../VERSION")).strip
+
+    opts = OptionParser.new
+    opts.banner = <<"EOT"
+Focus Inspector v#{version}  (c) Copyright 2012 by Chris Schlaeger
+
+Usage: focusinspector [options] <command> <ImageFile>
+EOT
+
+    opts.on('--viewer <viewer>', 'Image viewer to use') do |v|
+      @viewer = v
+    end
+
+    opts.on_tail('-h', '--help', 'Show this message') do
+      puts opts
+    end
+
+    opts.separator ""
+    opts.separator <<"EOT"
+Supported commands are:
+  show    : Show image with focus points overlay
+  measure : Measure the sharpness of a photo of the test chart
+  list    : List some focusing information of the image
+
+EOT
+
+    opts.order!
+    @command = ARGV[0]
+    unless @command
+      Log.error('Command is missing')
+      puts opts
+    end
+    unless %w( show measure list ).include?(command)
+      Log.error("Unknown command #{@command}")
+      puts opts
+    end
+
+    @imageFile = ARGV[1]
+    unless @imageFile
+      Log.error('Image file name missing.')
+      puts opts
+    end
+
+    unless File.exists?(@imageFile)
+      Log.error("Cannot find image file #{@imageFile}")
+    end
+  end
+
+end
+
+

data/lib/focusinspector/Camera.rb

@@ -0,0 +1,209 @@
+#!/usr/bin/env ruby -w
+# encoding: UTF-8
+#
+# Focus Inspector - The focus inspection and lens calibration software.
+#
+# Copyright (c) 2012 by Chris Schlaeger <chris@linux.com>
+#
+# This program is Open Source software; you can redistribute it and/or modify
+# it under the terms of MIT license as shipped with this software.
+
+class Camera
+
+  def initialize(imageFile)
+    @imageFile = imageFile
+    @cameras = {
+                 'NIKON D300' =>
+                 begin
+                   h = {}
+                   xSkip = 0.0676
+                   ySkip = 0.095
+                   # Rows A to E.
+                   (-2).upto(2) do |row|
+                     # Rows A and E have only 9 points, the others have 11.
+                     cols = row.abs == 2 ? 4 : 5
+                     (-cols).upto(cols) do |col|
+                     h["#{(?A.ord + row + 2).chr}#{col + cols + 1}"] =
+                         [ 0.5 + col * xSkip, 0.5 + row * ySkip ]
+                     end
+                   end
+                   h['C6 (Center)'] = h['C6']
+                   h
+                 end,
+                 'NIKON D5100' =>
+                 begin
+                   x = [ 0.225, 0.330, 0.5 ]
+                   y = [ 0.295, 0.385, 0.5 ]
+                   x[3] = x[2] + (x[2] - x[1])
+                   x[4] = x[2] + (x[2] - x[0])
+                   y[3] = y[2] + (y[2] - y[1])
+                   y[4] = y[2] + (y[2] - y[0])
+                   {
+                     'Far Left'    => [ x[0], y[2] ],
+                     'Upper-left'  => [ x[1], y[1] ],
+                     'Mid-left'    => [ x[1], y[2] ],
+                     'Lower-left'  => [ x[1], y[3] ],
+                     'Top'         => [ x[2], y[0] ],
+                     'Center'      => [ x[2], y[2] ],
+                     'Bottom'      => [ x[2], y[4] ],
+                     'Upper-right' => [ x[3], y[1] ],
+                     'Mid-right'   => [ x[3], y[2] ],
+                     'Lower-right' => [ x[3], y[3] ],
+                     'Far Right'   => [ x[4], y[2] ]
+                   }
+                 end,
+                 'NIKON D800' =>
+                 begin
+                   h = {}
+                   # Rows A to E.
+                   (-2).upto(2) do |row|
+                     # Rows A and E have only 9 points, the others have 11.
+                     cols = row.abs == 2 ? 4 : 5
+                     (-cols).upto(cols) do |col|
+                       # The 3 center columns have a wider x and y spread.
+                       if col.abs <= 1
+                         xSkip = 0.053
+                         xOff = 0.0
+                         ySkip = 0.075
+                       else
+                         xSkip = 0.048
+                         xOff = 0.011 * (col < 0 ? -1 : 1)
+                         ySkip = 0.0659
+                       end
+                       h["#{(?A.ord + row + 2).chr}#{col + cols + 1}"] =
+                         [ 0.5 + xOff + col * xSkip, 0.5 + row * ySkip ]
+                     end
+                   end
+                   h['C6 (Center)'] = h['C6']
+                   h
+                 end
+               }
+    # Add some aliases for similar cameras. Just a guess right now.
+    @cameras['NIKON D300S'] = @cameras['NIKON D300']
+    @cameras['NIKON D800E'] = @cameras['NIKON D800']
+
+    unless (@exif = MiniExiftool.new(@imageFile))
+      Log.error("Image file #{imageFile} has no EXIF information")
+    end
+    unless (modelName = @exif['Model'])
+      Log.error("No camera model name found in image file #{imageFile}")
+    end
+    unless (@focusPoints = @cameras[modelName])
+      Log.error("Camera #{modelName} is not supported.")
+    end
+    @width = @exif['ImageWidth'].to_i
+    @height = @exif['ImageHeight'].to_i
+    @cx = @width / 2
+    @cy = @height / 2
+  end
+
+  def focusAreaSize
+    if (afW = @exif['AFAreaWidth']) && (afH = @exif['AFAreaHeight'])
+      [ afW, afH ]
+    else
+      # We currently use a 27th of the screen width and height. This might have
+      # to be made camera specific.
+      [ @width / 27, @height / 27 ]
+    end
+  end
+
+  def orientation
+    @exif['Orientation'] || "Horizontal (normal)"
+  end
+
+  def contrastDetectAF?
+    @exif['ContrastDetectAF'] == 'On'
+  end
+
+  def focusPoint
+    @exif['Primary_AF_Point']
+  end
+
+  def focusFineTune
+    @exif['AFFineTuneAdj']
+  end
+
+  def printDetails
+    puts "Focus Mode:              #{@exif['FocusMode']}"
+    puts "Contrast Detection:      #{@exif['ContrastDetectAF']}"
+    puts "Phase Detection:         #{@exif['PhaseDetectAF']}"
+    puts "AF Fine Tune:            #{@exif['AFFineTune']}"
+    puts "AF Fine Tune Adjustment: #{@exif['AFFineTuneAdj']}"
+    puts "Focus Distance:          #{@exif['FocusDistance']}"
+    puts "Depth Of Field:          #{@exif['DOF']}"
+    puts "Hyperfocal Distance:     #{@exif['HyperfocalDistance']}"
+  end
+
+  def primaryAutoFocusPoint
+    if @exif['ContrastDetectAF'] != 'On'
+      if (primaryAFP = @exif['Primary_AF_Point']) == "(none)" or primaryAFP.nil?
+        Log.error("Image has no primary focus point information")
+      end
+
+      unless (coords = fpCoords(primaryAFP))
+        Log.error("Unknown focus point #{primaryAFP}")
+      end
+      return coords
+    else
+      unless (x = @exif['AFAreaXPosition'])
+        Log.error('Contrast detect focus X position not found')
+      end
+      x = x.to_i
+      unless (y = @exif['AFAreaYPosition'])
+        Log.error('Contrast detect focus Y position not found')
+      end
+      y = y.to_i
+
+      return [ x, y ]
+    end
+  end
+
+  def activeFocusPoints
+    return [] if @exif['ContrastDetectAF'] == 'On'
+
+    if (fps = @exif['AFPointsUsed']) == "(none)" or fps.nil?
+      Log.error("Image has no focus point information")
+    end
+
+    allFPs = @focusPoints.keys.join(',')
+
+    coords = []
+    fps.split(',').each do |fp|
+      unless (xy = fpCoords(fp))
+        Log.error("Unknown focus point #{fp}")
+      end
+      coords << xy
+    end
+    coords
+  end
+
+  def inactiveFocusPoints
+    return [] if @exif['ContrastDetectAF'] == 'On'
+
+    if (fps = @exif['AFPointsUsed']) == "(none)" or fps.nil?
+      Log.error("Image has no focus point information")
+    end
+    fps = fps.split(',')
+
+    allFPs = @focusPoints.keys
+
+    coords = []
+    (allFPs - fps).each do |fp|
+      coords << fpCoords(fp)
+    end
+    coords
+  end
+
+  private
+
+  def fpCoords(tag)
+    x, y = @focusPoints[tag]
+    unless x && y
+      Log.error("Unknown focus point #{tag} found in image file")
+    end
+    [ (x * @width).to_i, (y * @height).to_i ]
+  end
+
+end
+
+

data/lib/focusinspector/FocusInspector.rb

@@ -0,0 +1,67 @@
+#!/usr/bin/env ruby -w
+# encoding: UTF-8
+#
+# Focus Inspector - The focus inspection and lens calibration software.
+#
+# Copyright (c) 2012 by Chris Schlaeger <chris@linux.com>
+#
+# This program is Open Source software; you can redistribute it and/or modify
+# it under the terms of MIT license as shipped with this software.
+
+require 'focusinspector/Log'
+require 'focusinspector/AppConfig'
+require 'focusinspector/Camera'
+require 'focusinspector/SharpnessMeter'
+require 'focusinspector/ImageMarker'
+require 'focusinspector/ImageViewer'
+
+class FocusInspector
+
+  def initialize(args)
+    @config = AppConfig.new(args)
+
+    @imageFile = @config.imageFile
+    # Conver the raw file to jpg if we have one.
+    convertRaw
+
+    focusInfo = Camera.new(@imageFile)
+    x, y = focusInfo.primaryAutoFocusPoint
+
+    case @config.command
+    when 'list'
+      focusInfo.printDetails
+    when 'measure'
+      sm = SharpnessMeter.new(@jpgFile)
+      puts "Sharpness:  %.2f%%  (%s)" % [ (sm.measure(x, y) * 100.0),
+           focusInfo.contrastDetectAF? ? 'Contrast Detection AF' :
+           "FP: #{focusInfo.focusPoint}  AFFT: #{focusInfo.focusFineTune}" ]
+    when 'show'
+      im = ImageMarker.new(@jpgFile, *focusInfo.focusAreaSize, @config.viewer)
+      im.mark(x, y, 'red', true)
+
+      activeFPxy = focusInfo.activeFocusPoints
+      inactiveFPxy = focusInfo.inactiveFocusPoints
+
+      activeFPxy.each { |xy| im.mark(*xy, 'red') }
+      inactiveFPxy.each { |xy| im.mark(*xy, 'grey') }
+
+      im.show(focusInfo.orientation)
+    end
+  end
+
+  def convertRaw
+    if @imageFile[-4..-1] == '.NEF' || @imageFile[-4..-1] == '.nef'
+      @tmpJPGfile = Tempfile.new('lenstuner-jpg')
+      @tmpJPGfile.close
+      @jpgFile = @tmpJPGfile.path
+      command = "dcraw -c -e #{@imageFile} > #{@jpgFile}"
+      unless system(command)
+        Log.error("Cannot execute '#{command}'")
+      end
+    else
+      @jpgFile = @imageFile
+    end
+  end
+
+end
+

data/lib/focusinspector/ImageMarker.rb

@@ -0,0 +1,48 @@
+#!/usr/bin/env ruby -w
+# encoding: UTF-8
+#
+# Focus Inspector - The focus inspection and lens calibration software.
+#
+# Copyright (c) 2012 by Chris Schlaeger <chris@linux.com>
+#
+# This program is Open Source software; you can redistribute it and/or modify
+# it under the terms of MIT license as shipped with this software.
+
+class ImageMarker
+
+  def initialize(imageFile, w, h, viewer)
+    begin
+      @image = Magick::Image.read(imageFile).first
+      # The size of the auto focus area.
+      @w = w
+      @h = h
+    rescue
+      Log.error("Cannot open image file #{imageFile}")
+    end
+    @viewer = viewer
+  end
+
+  def mark(x, y, color, bold = false)
+    painter = Magick::Draw.new
+    painter.fill_opacity(0.0)
+    painter.stroke(color)
+    painter.stroke_width = bold ? 13 : 9
+    painter.rectangle(x - @w / 2, y - @h / 2, x + @w / 2, y + @h / 2)
+    painter.draw(@image)
+  end
+
+  def show(orientation)
+    # Since we have created a new image, the orientation of the original got
+    # lost. We simply rotate the image to match the original orientation.
+    case orientation
+    when 'Rotate 90 CW'
+      @image.rotate!(90)
+    when 'Rotate 270 CW'
+      @image.rotate!(270)
+    end
+
+    ImageViewer.new(@image, @viewer)
+  end
+
+end
+

data/lib/focusinspector/ImageViewer.rb

@@ -0,0 +1,26 @@
+#!/usr/bin/env ruby -w
+# encoding: UTF-8
+#
+# Focus Inspector - The focus inspection and lens calibration software.
+#
+# Copyright (c) 2012 by Chris Schlaeger <chris@linux.com>
+#
+# This program is Open Source software; you can redistribute it and/or modify
+# it under the terms of MIT license as shipped with this software.
+
+class ImageViewer
+
+  def initialize(image, viewer)
+    # Write the marked version of the original image to a temporary file.
+    file = Tempfile.new('lenstuner')
+    image.write('jpeg:' + file.path)
+    file.close
+    # Start viewer to display the marked image.
+    command = "#{viewer} #{file.path} 2> /dev/null"
+    unless system(command)
+      Log.error("Cannot execute '#{command}'")
+    end
+  end
+
+end
+

data/lib/focusinspector/Log.rb

@@ -0,0 +1,32 @@
+#!/usr/bin/env ruby -w
+# encoding: UTF-8
+#
+# Focus Inspector - The focus inspection and lens calibration software.
+#
+# Copyright (c) 2012 by Chris Schlaeger <chris@linux.com>
+#
+# This program is Open Source software; you can redistribute it and/or modify
+# it under the terms of MIT license as shipped with this software.
+
+class Log
+
+  #def initialize(logLevel)
+  @@level = 1
+  #end
+
+  def Log::error(msg)
+    $stderr.puts "\nERROR: #{msg}"
+    exit 1
+  end
+
+  def Log::warn(msg)
+    $stderr.puts "\nWARNING: #{msg}" if @@level > 0
+  end
+
+  def Log::debug(msg)
+    puts msg if @@level > 1
+  end
+
+end
+
+

data/lib/focusinspector/SharpnessMeter.rb

@@ -0,0 +1,245 @@
+#!/usr/bin/env ruby -w
+# encoding: UTF-8
+#
+# Focus Inspector - The focus inspection and lens calibration software.
+#
+# Copyright (c) 2012 by Chris Schlaeger <chris@linux.com>
+#
+# This program is Open Source software; you can redistribute it and/or modify
+# it under the terms of MIT license as shipped with this software.
+
+class SharpnessMeter
+
+  def initialize(imageFile)
+    @imageFile = imageFile
+    @minSquareSize = 100
+  end
+
+  def measure(x, y)
+    image = Magick::Image.read(@imageFile).first
+
+    x, y, sqSize = findBlackSquare(image, x, y)
+    crop = cropQuadrants(image, x, y)
+    #ImageViewer.new(image)
+    colorHistogram = crop.color_histogram
+    bwHistogram = convertHistToBW(colorHistogram)
+    calcSharpness(bwHistogram, crop)
+  end
+
+  private
+
+  def color(image, x, y, radius = 2)
+    blackCount = 0
+    whiteCount = 0
+    greyCount = 0
+    (-radius).upto(radius) do |xi|
+      (-radius).upto(radius) do |yi|
+        col = image.pixel_color(x + xi, y + yi)
+        val = (col.red + col.green + col.blue) / 3
+        if val < 0x6000
+          blackCount += 1
+        elsif val > 0xA000
+          whiteCount += 1
+        else
+          greyCount += 1
+        end
+      end
+    end
+    if blackCount > whiteCount && blackCount > greyCount
+      :black
+    elsif whiteCount > blackCount && whiteCount > greyCount
+      :white
+    else
+      :grey
+    end
+  end
+
+  def showMarkedImage(image, x, y, w, h)
+    painter = Magick::Draw.new
+    painter.opacity(0)
+    painter.stroke('red')
+    painter.stroke_width =  9
+    painter.rectangle(x, y, x + w, y + h)
+    painter.draw(image)
+
+    ImageViewer.new(image)
+    exit
+  end
+
+  def findEdge(image, x, y, dx, dy)
+    startCol = color(image, x, y)
+    raise 'Starting point must not be grey.' if startCol == :grey
+
+    while (c = color(image, x, y)) == :grey || c == startCol
+      if c == startCol
+        sx = x
+        sy = y
+      end
+      x += dx
+      y += dy
+
+      if x < 0 || x >= image.columns || y < 0 || y >= image.rows
+        Log.error("Cannot detect the edge of the square (#{dx}, #{dy}).")
+      end
+    end
+    ex = x
+    ey = y
+
+    # The edge is located right in the middle of the grey zone.
+    [ sx + (ex - sx) / 2, sy + (ey - sy) / 2 ]
+  end
+
+  def findBlackSquare(image, x, y)
+    # Find a pixel inside of a black square by moving along a spiral line.
+    stepInc = 11
+    steps = stepInc
+    stepCount = 0
+    dir = :right
+    while color(image, x, y) != :black
+      case dir
+      when :right
+        x += steps
+        dir = :down unless stepCount % 2 == 0
+      when :down
+        y += steps
+        dir = :left unless stepCount % 2 == 0
+      when :left
+        x -= steps
+        dir = :up unless stepCount % 2 == 0
+      when :up
+        y -= steps
+        dir = :right unless stepCount % 2 == 0
+      end
+      if stepCount < 3
+        stepCount += 1
+      else
+        stepCount = 0
+        steps += stepInc
+      end
+      Log.debug("x: #{x}  y: #{y}")
+      if x < 0 || x >= image.columns || y < 0 || y >= image.rows
+        Log.error("No black square found.")
+      end
+    end
+    #image.crop!(x - 15, y - 15, 30, 30)
+    #ImageViewer.new(image)
+    #exit
+
+    blackSqX0 = findEdge(image, x, y, -1, 0)[0]
+    blackSqX1 = findEdge(image, x, y, 1, 0)[0]
+    blackSqY0 = findEdge(image, x, y, 0, -1)[1]
+    blackSqY1 = findEdge(image, x, y, 0, 1)[1]
+
+    # Compute the edge length of the square.
+    sqWidth = blackSqX1 - blackSqX0 + 1
+    sqHeight = blackSqY1 - blackSqY0 + 1
+
+    Log.debug("Square size is #{sqWidth} x #{sqHeight}")
+    if sqWidth < @minSquareSize || sqHeight < @minSquareSize
+      Log.error("The size (#{sqWidth} x #{sqHeight}) of the detected " +
+                "black square is too small.")
+    end
+
+    #showMarkedImage(image, blackSqX0, blackSqY0, sqWidth, sqHeight)
+
+    [ blackSqX0, blackSqY0, (sqWidth + sqHeight) / 2 ]
+  end
+
+  def cropQuadrants(image, bx, by)
+    probeSize = @minSquareSize
+    # Return a probeSize sized rectangle with the top left corner of the
+    # black square in the center spot.
+    radius = @minSquareSize / 2
+    x = bx - radius
+    y = by - radius
+
+    #showMarkedImage(image, x, y, probeSize, probeSize)
+    unless color(image, x, y, radius) == :black
+      Log.error("Top-left quadrant is not black")
+    end
+    unless color(image, x, y + @minSquareSize, radius) == :white
+      Log.error("Bottom-left quadrant is not white")
+    end
+    unless color(image, x + @minSquareSize, y + @minSquareSize,
+                 radius) == :black
+      Log.error("Bottom-right quadrant is not black")
+    end
+    unless color(image, x + @minSquareSize, y, radius) == :white
+      Log.error("Top-right quadrant is not white")
+    end
+
+    image.crop(x, y, probeSize, probeSize)
+  end
+
+  def convertHistToBW(cHist)
+    bwHist = Hash.new(0)
+
+    cHist.each do |rgb, val|
+      # The color histogram contains the values for 16 bit RGB colors.
+      bwHist[(rgb.red + rgb.green + rgb.blue) / 3] += val
+    end
+
+    #bwHist.each { |i, v | Log.debug("Color #{i}: #{v}") }
+    bwHist
+  end
+
+  def findHistogramPeak(hist, black)
+    peakIndex = nil
+    if black
+      sIdx = 0
+      eIdx = 0x7FFF
+    else
+      sIdx = 0x8000
+      eIdx = 0xFFFF
+    end
+
+    sIdx.upto(eIdx) do |i|
+      if peakIndex.nil? || hist[peakIndex] < hist[i]
+        peakIndex = i
+      end
+    end
+
+    peakIndex
+  end
+
+  def calcSharpness(bwHist, image)
+    peakBlackIndex = findHistogramPeak(bwHist, true)
+    peakWhiteIndex = findHistogramPeak(bwHist, false)
+
+    hEdge = 0
+    image.columns.times do |c|
+      hEdge += edgeSharpness(image, c, 0, 0, 1)
+    end
+    hEdge /= image.columns
+
+    vEdge = 0
+    image.rows.times do |r|
+      vEdge += edgeSharpness(image, 0, r, 1, 0)
+    end
+    vEdge /= image.rows
+
+    maxEdge = peakWhiteIndex - peakBlackIndex
+
+    ((hEdge + vEdge) / 2.0) / maxEdge
+   end
+
+   def edgeSharpness(image, x, y, dx, dy)
+     biggestDelta = 0
+     while (x >= 0 && x < image.columns && y >= 0 && y < image.rows)
+       nx = x + dx
+       ny = y + dy
+       col = image.pixel_color(x, y)
+       val1 = (col.red + col.green + col.blue) / 3
+       col = image.pixel_color(nx, ny)
+       val2 = (col.red + col.green + col.blue) / 3
+       delta = (val1 - val2).abs
+       biggestDelta = delta if biggestDelta < delta
+       x = nx
+       y = ny
+     end
+
+     biggestDelta
+   end
+
+end
+

data/spec/focusinspector_spec.rb

@@ -0,0 +1,7 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "Focusinspector" do
+  it "fails" do
+    fail "hey buddy, you should probably rename this file and start specing for real"
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,12 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'rspec'
+require 'focusinspector'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+  
+end

metadata

@@ -0,0 +1,169 @@
+--- !ruby/object:Gem::Specification
+name: focusinspector
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Chris Schlaeger
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-10-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.8.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.8.0
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.9'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.8.4
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.8.4
+- !ruby/object:Gem::Dependency
+  name: rmagick
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.13.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.13.1
+- !ruby/object:Gem::Dependency
+  name: mini_exiftool
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.6.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.6.0
+description: Allows you to view active focus points in taken images and to fine tune
+  your lenses
+email: chris@linux.com
+executables:
+- focusinspector
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.rdoc
+files:
+- .document
+- .rspec
+- FI-Test-Chart.pdf
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- VERSION
+- bin/focusinspector
+- focusinspector.gemspec
+- lib/focusinspector.rb
+- lib/focusinspector/AppConfig.rb
+- lib/focusinspector/Camera.rb
+- lib/focusinspector/FocusInspector.rb
+- lib/focusinspector/ImageMarker.rb
+- lib/focusinspector/ImageViewer.rb
+- lib/focusinspector/Log.rb
+- lib/focusinspector/SharpnessMeter.rb
+- spec/focusinspector_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/scrapper/focusinspector
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 841599558763575183
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Utility for DSLR photographers
+test_files: []