mork 0.0.5 → 0.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 74b53c108c7a1ae34a090aac3b9380805326ee01
-  data.tar.gz: f34f58ad865ffc0995cf51a21e0c2c163b4f8e27
+  metadata.gz: 4e92c32ca59c988cea80c3c77500fd756e53410d
+  data.tar.gz: 0334a33ef6ce0f4166ba19d57d9b82909f915c05
 SHA512:
-  metadata.gz: 55f9f4dff569c87008aa9e15a4029172258d0c3998746700188f440695ece40948a0b529d21a3512dd632537cfc123ee8730e8bfb99b7dd31a6c708150f742a4
-  data.tar.gz: 68b53cf1ab3b9adc014b8da070da4e8d16b8706eb3754f735fa596b8025f6b720b803d8a225efacd1db2d9922b1ba98ae1cba2712b714de694c67b9d1c5f6d6c
+  metadata.gz: 7f7dd80d9be2d3a2ccd58ec2e1a077401269baeebcb2d84d0105b325f351bad0bef130607502d5e5eecb86af0004e49e12d6d8410251ac55013147d5261924af
+  data.tar.gz: 96b17f9ea0bf9a307d46a1f8cecbc6e39858f0c6303ea3d23690e8bfccb8602eccf5a08b5690046edef8bfb345a49b87994629586cbf90e41e7387df270541ca

data/config/grids.yml

@@ -27,7 +27,7 @@ default:
       height:     10
       size:        7
       box:      true
-  responses:
+  items:
     columns:       4
     column_width: 50.0
     rows:         40

data/lib/mork/grid.rb

@@ -9,14 +9,24 @@ module Mork
     def initialize(options = {})
       case options.class.to_s
       when "Hash"
-        @params = DGRID.merge! options
+        @params = DGRID.merge symbolize options
       when "String"
-        @params = DGRID.merge! YAML.load_file(options)
+        @params = DGRID.merge symbolize YAML.load_file(options)
       else
         raise "Invalid options parameter: #{options.class.inspect}"
       end
     end
     
+    # symbolize(object)
+    #
+    # recursively turn hash keys into symbols. pasted from
+    # http://stackoverflow.com/questions/800122/best-way-to-convert-strings-to-symbols-in-hash
+    def symbolize(obj)
+      return obj.inject({}){|memo,(k,v)| memo[k.to_sym] =  symbolize(v); memo} if obj.is_a? Hash
+      return obj.inject([]){|memo,v    | memo           << symbolize(v); memo} if obj.is_a? Array
+      return obj
+    end
+    
     def options
       @params
     end
@@ -31,7 +41,7 @@ module Mork
     end
     
     def max_choices_per_question
-      @params[:responses][:max_cells]
+      @params[:items][:max_cells].to_i
     end
     
     def code_bits
@@ -41,43 +51,52 @@ module Mork
     # ====================================================
     # = Returning {x, y, w, h} hashes for area locations =
     # ====================================================
-    def reg_mark_tl_search_area
-      reg_mark_search_area 0, 0
+    # {} = rm_search_area(x, y)
+    #
+    # the 4 values needed to locate a single registration mark
+    def rm_search_area(corner, i)
+      {
+        x: (ppu_x * rmx(corner, i)).round,
+        y: (ppu_y * rmy(corner, i)).round,
+        w: (ppu_x * (reg_search + reg_step * i)).round,
+        h: (ppu_y * (reg_search + reg_step * i)).round
+      }
     end
     
-    def reg_mark_tr_search_area
-      reg_mark_search_area page_width - reg_search, 0
+    def rm_edgy_x
+      (ppu_x * reg_radius).round + 5
     end
-        
-    def reg_mark_br_search_area
-      reg_mark_search_area page_width - reg_search, page_height - reg_search
+    
+    def rm_edgy_y
+      (ppu_y * reg_radius).round + 5
     end
     
-    def reg_mark_bl_search_area
-      reg_mark_search_area 0, page_height - reg_search
+    def rm_max_search_area_side
+      (ppu_x * page_width / 4).round
     end
     
     def choice_cell_area(q, c)
       cell_area cell_x(q, c), cell_y(q)
     end
     
-    def dark_control_cell_area
-      cell_area ctrl_cell_left, ctrl_cell_y
+    def ctrl_area_dark
+      cell_area ctrl_cell_x, ctrl_cell_y
     end
     
-    def light_control_cell_area
-      cell_area ctrl_cell_left + cell_spacing, ctrl_cell_y
+    def ctrl_area_light
+      cell_area ctrl_cell_x + cell_spacing, ctrl_cell_y
     end
     
-    def white_calibration_area
+    def cal_area_white
       code_cell_area -1
     end
     
-    def black_calibration_area
+    def cal_area_black
       code_cell_area 0
     end
     
     def code_bit_area(i)
+      raise "Invalid code bit" if i >= code_bits
       code_cell_area i+1
     end
     
@@ -93,7 +112,7 @@ module Mork
     end
     
     def pdf_reg_marks
-      r = @params[:regmarks][:radius].to_f.mm
+      r = reg_radius.mm
       [
         { p: [0,                  0                  ], r: r },
         { p: [0,                  reg_frame_height.mm], r: r },
@@ -145,21 +164,21 @@ module Mork
 
     def pdf_qnum_xy(q)
       [
-        cell_x(q, 0).mm - pdf_qnum_width - @params[:responses][:number_margin].to_f.mm,
+        cell_x(q, 0).mm - pdf_qnum_width - @params[:items][:number_margin].to_f.mm,
         (reg_frame_height - cell_y(q)).mm - cell_height
       ]
     end
     
     def pdf_qnum_size
-      @params[:responses][:number_size].to_f
+      @params[:items][:number_size].to_f
     end
     
     def pdf_chlett_size
-      @params[:responses][:letter_size].to_f
+      @params[:items][:letter_size].to_f
     end
 
     def pdf_qnum_width
-      @params[:responses][:number_width].to_f.mm
+      @params[:items][:number_width].to_f.mm
     end
     
     def pdf_header_xy(k)
@@ -192,7 +211,7 @@ module Mork
       @params[:header][k][:box] == true
     end
     
-    def pdf_dark_control_cell_area
+    def pdf_ctrl_area_dark
       {
         p: [pdf_control_xy[0]+pdf_control_width+ctrl_margin.mm, pdf_control_xy[1]],
         w: cell_width.mm,
@@ -200,7 +219,7 @@ module Mork
       }
     end
     
-    def pdf_light_control_cell_area
+    def pdf_ctrl_area_light
       {
         p: [cell_spacing.mm + pdf_control_xy[0]+pdf_control_width+@params[:control][:margin].to_f.mm, pdf_control_xy[1]],
         w: cell_width.mm,
@@ -209,7 +228,7 @@ module Mork
     end
     
     def pdf_dark_control_letter_xy
-      xy = pdf_dark_control_cell_area[:p]
+      xy = pdf_ctrl_area_dark[:p]
       [
         xy[0] + 2.mm,
         xy[1] - 4.mm
@@ -217,7 +236,7 @@ module Mork
     end
 
     def pdf_light_control_letter_xy
-      xy = pdf_light_control_cell_area[:p]
+      xy = pdf_ctrl_area_light[:p]
       [
         xy[0] + 2.mm,
         xy[1] - 4.mm
@@ -249,11 +268,13 @@ module Mork
       @py / reg_frame_height
     end
     
-    def cw
+    def ppu_x
+      # horizontal pixels per unit of length (mm by def)
       @px / page_width
     end
     
-    def ch
+    def ppu_y
+      # vertical pixels per unit of length (mm by def)
       @py / page_height
     end
     
@@ -269,24 +290,12 @@ module Mork
       }
     end
 
-    # {} = reg_mark_search_area(x, y)
-    #
-    # the 4 values needed to locate a single registration mark
-    def reg_mark_search_area(x, y)
-      {
-        x: (cw * x).round,
-        y: (ch * y).round,
-        w: (cw * reg_search).round,
-        h: (ch * reg_search).round
-      }
-    end
-    
     # cell_y(q)
     # 
     # the distance from the registration frame to the top edge
     # of all choice cells in the q-th question
     def cell_y(q)
-      first_y + response_spacing * (q % rows) - cell_height / 2
+      first_y + item_spacing * (q % rows) - cell_height / 2
     end
     
     # cell_x(q,c)
@@ -321,33 +330,53 @@ module Mork
     # = registration sides =
     # ======================
 
+    def rmx(corner, i)
+      case corner
+      when :tl; reg_off
+      when :tr; page_width - reg_search - reg_off - reg_step * i
+      when :br; page_width - reg_search - reg_off - reg_step * i
+      when :bl; reg_off
+      end
+    end
+    
+    def rmy(corner, i)
+      case corner
+      when :tl; reg_off
+      when :tr; reg_off
+      when :br; page_height - reg_search - reg_off - reg_step * i
+      when :bl; page_height - reg_search - reg_off - reg_step * i
+      end
+    end
+    
+    def reg_step
+      reg_radius
+    end
+
     # ===============================
     # = Simple parameter extraction =
     # ===============================
-    def ctrl_cell_left()    @params[:control][:left].to_f + @params[:control][:width].to_f + ctrl_margin  end
+    def ctrl_cell_x()       @params[:control][:left].to_f + @params[:control][:width].to_f + ctrl_margin  end
     def ctrl_margin()       @params[:control][:margin].to_f           end
     def ctrl_cell_y()       @params[:control][:top].to_f              end
     def code_height()       @params[:code][:height].to_f              end
     def code_width()        @params[:code][:width].to_f               end
     def page_width()        @params[:page_size][:width].to_f          end
     def page_height()       @params[:page_size][:height].to_f         end
-    def name_x()            @params[:header][:name][:top].to_f        end
-    def name_y()            @params[:header][:name][:left].to_f       end
-    def name_w()            @params[:header][:name][:width].to_f      end
-    def name_size()         @params[:header][:name][:size].to_f       end
-    def cell_width()        @params[:responses][:cell_width].to_f     end
-    def cell_height()       @params[:responses][:cell_height].to_f    end
-    def cell_spacing()      @params[:responses][:x_spacing].to_f      end
-    def response_spacing()  @params[:responses][:y_spacing].to_f      end
-    def column_width()      @params[:responses][:column_width].to_f   end
-    def row_spacing()       @params[:responses][:y_spacing].to_f      end
-    def first_x()           @params[:responses][:first_x].to_f        end
-    def first_y()           @params[:responses][:first_y].to_f        end
-    def rows()              @params[:responses][:rows]                end
-    def columns()           @params[:responses][:columns]             end
+    def cell_width()        @params[:items][:cell_width].to_f     end
+    def cell_height()       @params[:items][:cell_height].to_f    end
+    def cell_spacing()      @params[:items][:x_spacing].to_f      end
+    def item_spacing()      @params[:items][:y_spacing].to_f      end
+    def column_width()      @params[:items][:column_width].to_f   end
+    def row_spacing()       @params[:items][:y_spacing].to_f      end
+    def first_x()           @params[:items][:first_x].to_f        end
+    def first_y()           @params[:items][:first_y].to_f        end
+    def rows()              @params[:items][:rows]                end
+    def columns()           @params[:items][:columns]             end
     def reg_margin()        @params[:regmarks][:margin].to_f          end
     def reg_search()        @params[:regmarks][:search].to_f          end
+    def reg_radius()        @params[:regmarks][:radius].to_f          end
     def reg_frame_width()   page_width  - reg_margin * 2              end
     def reg_frame_height()  page_height - reg_margin * 2              end
+    def reg_off()           @params[:regmarks][:offset].to_f          end
   end
 end

data/lib/mork/grid_const.rb

@@ -4,13 +4,14 @@ module Mork
     # default units are millimiters
     page_size: {
       # this is A4
-      width:       210.0,
-      height:      297.0
+      width:       210,
+      height:      297
     }, # page end
     regmarks: {
       margin:  10,
       radius:  2.5,
-      search:  10
+      search:  10,
+      offset:   3
     }, # regmarks end
     header: {
       name: {
@@ -40,7 +41,7 @@ module Mork
         box:      true,
       }
     }, # header end
-    responses: {
+    items: {
       columns:       4, 
       column_width: 49,
       rows:         30,
@@ -65,7 +66,7 @@ module Mork
       number_margin:  2,
       # font size for the choice letter
       letter_size:    8
-    }, # responses end
+    }, # items end
     code: {
       bits:    40,
       left:     15,

data/lib/mork/mimage.rb

@@ -27,6 +27,15 @@ module Mork
       @image.composite! m, c[:x], c[:y], Magick::CopyYellowCompositeOp
     end
     
+    def join!(p)
+      poly = Magick::Draw.new
+      poly.fill_opacity 0
+      poly.stroke 'green'
+      poly.stroke_width 3
+      poly.polygon p[0], p[1], p[2], p[3], p[4], p[5], p[6], p[7]
+      poly.draw @image
+    end
+    
     # ============
     # = Cropping =
     # ============

data/lib/mork/npatch.rb

@@ -15,13 +15,13 @@ module Mork
     end
     
     def dark_centroid
-      return nil, nil unless sufficient_contrast?
+      sufficient_contrast? or return
       xp = patch.sum(1).to_a
       yp = patch.sum(0).to_a
       # find the intensity trough
       ctr_x = xp.find_index(xp.min)
       ctr_y = yp.find_index(yp.min)
-      return nil, nil if edgy?(ctr_x, ctr_y)
+      # return :edgy if edgy?(ctr_x, ctr_y)
       return ctr_x, ctr_y
     end
     
@@ -44,6 +44,7 @@ module Mork
     end
     
     def edgy?(x, y)
+      puts "PATCH: (#{@width},#{@height})  EDGY: x=#{x}, y=#{y}"
       tol = 5
       (x < tol) or (y < tol) or (y > @height - tol) or (x > @width - tol)
     end

data/lib/mork/sheet.rb

@@ -1,20 +1,28 @@
 module Mork
   class Sheet
     def initialize(im, grid=Grid.new)
-      im = Mimage.new(im) if im.class == String
-      raise "A new sheet requires either a Mimage or the name of the source image file" unless im.class == Mimage
+      @raw = case im.class.to_s
+             when "String"
+               Mimage.new im
+             when "Mimage"
+               im
+             else
+               raise "A new sheet requires either a Mimage or the name of the source image file"         
+             end
       @grid = grid
       # send page size to the grid, so that all later measurements can be done within the
       # grid itself; this method assumes a 'stretch' strategy, i.e. where the image
       # after registration has the same size in pixels as the original scanned file
-      @grid.set_page_size im.width, im.height
-      @mimage = register(im)
+      @grid.set_page_size @raw.width, @raw.height
+      @rmsa = {}
+      @ok_reg = register @raw
     end
     
     # code
     # 
     # returns the sheet code as an integer
     def code
+      return if not_registered
       code_string.to_i(2)
     end
     
@@ -23,6 +31,7 @@ module Mork
     # returns the sheet code as a string of 0s and 1s. The string is code_bits
     # bits long, with most significant bits to the left
     def code_string
+      return if not_registered
       cs = (0...@grid.code_bits).inject("") { |c, v| c << code_cell_value(v) }
       cs.reverse
     end
@@ -32,6 +41,7 @@ module Mork
     # returns true if the specified question/choice cell has been darkened
     # false otherwise
     def marked?(q, c)
+      return if not_registered
       shade_of(q, c) < choice_threshold
     end
     
@@ -44,6 +54,7 @@ module Mork
     # in which case the choices for the first n questions will be returned.
     # if called without arguments, all available choices will be evaluated
     def mark_array(r = nil)
+      return if not_registered
       question_range(r).collect do |q|
         cho = []
         (0...@grid.max_choices_per_question).each do |c|
@@ -54,6 +65,7 @@ module Mork
     end
     
     def mark_logical_array(r = nil)
+      return if not_registered
       question_range(r).collect do |q|
         (0...@grid.max_choices_per_question).collect {|c| marked?(q, c)}
       end
@@ -64,49 +76,65 @@ module Mork
     # ================
     
     def highlight_all
+      return if not_registered
       @grid.max_questions.times do |i|
         @grid.max_choices_per_question.times do |j|
           highlight_choice i, j
         end
       end
-      @mimage.highlight! @grid.dark_control_cell_area
-      @mimage.highlight! @grid.light_control_cell_area
+      @crop.highlight! @grid.ctrl_area_dark
+      @crop.highlight! @grid.ctrl_area_light
     end
     
     def highlight
+      return if not_registered
       mark_array.each_with_index do |qa, i|
         qa.each do |cho|
           highlight_choice i, cho
         end
       end
-      @mimage.highlight! @grid.dark_control_cell_area
-      @mimage.highlight! @grid.light_control_cell_area
+      @crop.highlight! @grid.ctrl_area_dark
+      @crop.highlight! @grid.ctrl_area_light
     end
     
     def highlight_choice(q, c)
-      @mimage.highlight! @grid.choice_cell_area(q, c)
+      return if not_registered
+      @crop.highlight! @grid.choice_cell_area(q, c)
     end
 
     def highlight_code
+      return if not_registered
       @grid.code_bits.times do |bit|
-        @mimage.highlight! @grid.code_bit_area bit
+        @crop.highlight! @grid.code_bit_area bit
       end
     end
     
     def highlight_code_bit(i)
-      @mimage.highlight! @grid.code_bit_area(i)
+      @crop.highlight!(@grid.code_bit_area(i)) if @ok_reg
     end
 
     def highlight_dark_calibration_bit
-      @mimage.highlight! @grid.black_calibration_area
+      @crop.highlight!(@grid.cal_area_black) if @ok_reg
     end
     
     def highlight_light_calibration_bit
-      @mimage.highlight! @grid.white_calibration_area
+      @crop.highlight!(@grid.cal_area_white) if @ok_reg
+    end
+    
+    def highlight_reg_area
+      @raw.highlight! @rmsa[:tl]
+      @raw.highlight! @rmsa[:tr]
+      @raw.highlight! @rmsa[:br]
+      @raw.highlight! @rmsa[:bl]
+      @raw.join!(@rm) if @ok_reg
     end
 
     def write(fname)
-      @mimage.write(fname)
+      @crop.write(fname) if @ok_reg
+    end
+    
+    def write_raw(fname)
+      @raw.write(fname)
     end
     
   private
@@ -137,13 +165,13 @@ module Mork
     end
 
     def choice_threshold
-      @choice_threshold ||= (naverage(@grid.dark_control_cell_area)   + 
-                             naverage(@grid.light_control_cell_area)) / 2
+      @choice_threshold ||= (naverage(@grid.ctrl_area_dark)   + 
+                             naverage(@grid.ctrl_area_light)) / 2
     end
     
     def code_threshold
-      @code_threshold ||= (naverage(@grid.black_calibration_area)  +
-                           naverage(@grid.white_calibration_area)) / 2
+      @code_threshold ||= (naverage(@grid.cal_area_black)  +
+                           naverage(@grid.cal_area_white)) / 2
     end
     
     # ================
@@ -151,30 +179,54 @@ module Mork
     # ================
     
     def register(img)
+      @rm = []
+      @reg_status = []
       # find the XY coordinates of the 4 registration marks
-      x1, y1 = reg_centroid_on(img, @grid.reg_mark_tl_search_area)
-      x2, y2 = reg_centroid_on(img, @grid.reg_mark_tr_search_area)
-      x3, y3 = reg_centroid_on(img, @grid.reg_mark_br_search_area)
-      x4, y4 = reg_centroid_on(img, @grid.reg_mark_bl_search_area)
+      @reg_status[0], @rm[0], @rm[1] = reg_centroid_on(img, :tl)
+      @reg_status[1], @rm[2], @rm[3] = reg_centroid_on(img, :tr)
+      @reg_status[2], @rm[4], @rm[5] = reg_centroid_on(img, :br)
+      @reg_status[3], @rm[6], @rm[7] = reg_centroid_on(img, :bl)
+      return false if @reg_status.any? { |c| c != :ok }
       # stretch the 4 points to fit the original size and return the resulting image
-      img.stretch [
-        x1, y1,         0,          0,
-        x2, y2, img.width,          0,
-        x3, y3, img.width, img.height,
-        x4, y4,         0, img.height
+      @crop = img.stretch [
+        @rm[0], @rm[1],         0,          0,
+        @rm[2], @rm[3], img.width,          0,
+        @rm[4], @rm[5], img.width, img.height,
+        @rm[6], @rm[7],         0, img.height
       ]
+      true
     end
     
     # returns the centroid of the dark region within the given area
     # in the XY coordinates of the entire image
-    def reg_centroid_on(img, c)
-      cx, cy = NPatch.new(img.crop(c)).dark_centroid
-      return nil, nil if cx.nil?
-      return cx + c[:x], cy + c[:y]
+    def reg_centroid_on(img, corner)
+      1000.times do |i|
+        @rmsa[corner] = @grid.rm_search_area(corner, i)
+        puts "RM: #{@rmsa[corner].inspect}"
+        cx, cy = NPatch.new(img.crop(@rmsa[corner])).dark_centroid
+        if cx.nil?
+          status = :insufficient_contrast  
+        elsif (cx < @grid.rm_edgy_x) or
+              (cy < @grid.rm_edgy_y) or
+              (cy > @rmsa[corner][:h] - @grid.rm_edgy_y) or
+              (cx > @rmsa[corner][:w] - @grid.rm_edgy_x)
+          status = :edgy
+        else
+          return :ok, cx + @rmsa[corner][:x], cy + @rmsa[corner][:y]
+        end
+        return status if @rmsa[corner][:w] > @grid.rm_max_search_area_side
+      end
     end
     
     def naverage(where)
-      NPatch.new(@mimage.crop where).average
+      NPatch.new(@crop.crop where).average
+    end
+    
+    def not_registered
+      unless @ok_reg
+        puts "---=={ Unregistered image. Reason: '#{@reg_status.inspect}' }==---"
+        true
+      end
     end
   end
 end

data/lib/mork/sheet_pdf.rb

@@ -73,12 +73,12 @@ module Mork
           font_size 
           stroke_color "ff0000"
           # dark
-          a = @grid.pdf_dark_control_cell_area
+          a = @grid.pdf_ctrl_area_dark
           rounded_rectangle a[:p], a[:w], a[:h], [a[:h], a[:w]].min / 2
           fill_color "ff0000"
           draw_text info[:labels][0], at: @grid.pdf_dark_control_letter_xy
           # light
-          a = @grid.pdf_light_control_cell_area
+          a = @grid.pdf_ctrl_area_light
           rounded_rectangle a[:p], a[:w], a[:h], [a[:h], a[:w]].min / 2
           fill_color "ff0000"
           draw_text info[:labels][1], at: @grid.pdf_light_control_letter_xy

data/lib/mork/version.rb

@@ -1,3 +1,3 @@
 module Mork
-  VERSION = "0.0.5"
+  VERSION = "0.0.6"
 end

data/spec/mork/grid_spec.rb

@@ -2,53 +2,190 @@ require 'spec_helper'
 
 module Mork
   describe Grid do
-    let(:grid) { Grid.new }
-
-    describe "#initialize" do
-      it "returns a Grid object" do
-        grid.should be_a(Grid)
+    context 'default grid', focus: true do
+      before(:all) do
+        @grid = Grid.new
+        @grid.set_page_size 1601, 2281 # the size of sample01.jpg
       end
-    end
-    
-    describe "#cell_x" do
-      context "for 1st-column questions" do
-        it "returns the distance from the registration frame of the left edge of the 1st choice" do
-          grid.send(:cell_x,0,0).should == 7.5
+      
+      describe '#max_questions' do
+        it 'returns the maximum number of questions in a sheet' do
+          @grid.max_questions.should == 120
+        end
+      end
+      
+      describe '#max_choices_per_question' do
+        it 'returns the maximum number of choice cells per question' do
+          @grid.max_choices_per_question.should == 5
+        end
+      end
+      
+      describe '#code_bits' do
+        it 'returns the number of bits used to define the form code' do
+          @grid.code_bits.should == 40
         end
         
-        it "returns the distance from the registration frame of the left edge of the 2nd choice" do
-          grid.send(:cell_x,0,1).should == 14.5
+        it 'returns an integer' do
+          @grid.code_bits.should be_a Fixnum
+        end
+      end
+      
+      describe '#rm_search_area' do
+        context 'on the first iteration' do
+          it 'returns an {:x, :y, :w, :h} hash of coordinates in pixels for the :tl reg_mark corner' do
+            c = @grid.rm_search_area :tl, 0
+            c.should == { x: 23, y: 23, w: 76, h: 77 }
+          end
+
+          it 'returns an {:x, :y, :w, :h} hash of coordinates in pixels for the :tr reg_mark corner' do
+            c = @grid.rm_search_area :tr, 0
+            c.should == { x: 1502, y: 23, w: 76, h: 77 }
+          end
+
+          it 'returns an {:x, :y, :w, :h} hash of coordinates in pixels for the :br reg_mark corner' do
+            c = @grid.rm_search_area :br, 0
+            c.should == { x: 1502, y: 2181, w: 76, h: 77 }
+          end
+
+          it 'returns an {:x, :y, :w, :h} hash of coordinates in pixels for the :bl reg_mark corner' do
+            c = @grid.rm_search_area :bl, 0
+            c.should == { x: 23, y: 2181, w: 76, h: 77 }
+          end
+        end
+
+        context 'on the third iteration' do
+          it 'returns an {:x, :y, :w, :h} hash of coordinates in pixels for the :tl reg_mark corner' do
+            c = @grid.rm_search_area :tl, 2
+            c.should == { x: 23, y: 23, w: 114, h: 115 }
+          end
+
+          it 'returns an {:x, :y, :w, :h} hash of coordinates in pixels for the :tr reg_mark corner' do
+            c = @grid.rm_search_area :tr, 2
+            c.should == { x: 1464, y: 23, w: 114, h: 115 }
+          end
+
+          it 'returns an {:x, :y, :w, :h} hash of coordinates in pixels for the :br reg_mark corner' do
+            c = @grid.rm_search_area :br, 2
+            c.should == { x: 1464, y: 2143, w: 114, h: 115 }
+          end
+
+          it 'returns an {:x, :y, :w, :h} hash of coordinates in pixels for the :bl reg_mark corner' do
+            c = @grid.rm_search_area :bl, 2
+            c.should == { x: 23, y: 2143, w: 114, h: 115 }
+          end
+        end
+      end
+      
+      describe '#rm_edgy_x' do
+        it 'returns the minimum acceptable number of pixels from the regmark center to the edge of the rm_search_area' do
+          @grid.rm_edgy_x.should == 24
+        end
+        it 'returns an integer' do
+          @grid.rm_edgy_x.should be_a Fixnum
         end
       end
 
-      context "for 4th-column questions" do
-        it "returns the distance from the registration frame of the left edge of the 1st choice" do
-          grid.send(:cell_x,120,0).should == 157.5
+      describe '#rm_edgy_y' do
+        it 'returns the minimum acceptable number of pixels from the regmark center to the edge of the rm_search_area' do
+          @grid.rm_edgy_y.should == 24
+        end
+        it 'returns an integer' do
+          @grid.rm_edgy_y.should be_a Fixnum
+        end
+      end
+      
+      describe '#rm_max_search_area_side' do
+        it 'returns the maximum extent of the regmark search area, 1/4 of the raw image horizontal pixels' do
+          @grid.rm_max_search_area_side.should == 400
+        end
+        it 'returns an integer' do
+          @grid.rm_max_search_area_side.should be_a Fixnum
+        end
+      end
+      
+      describe '#choice_cell_area' do
+        it 'returns the coordinates of the first choice cell' do
+          @grid.choice_cell_area(0,0).should == {x: 63, y: 436, w: 51, h: 41}
         end
         
-        it "returns the distance from the registration frame of the left edge of the 2nd choice" do
-          grid.send(:cell_x,120,1).should == 164.5
+        it 'returns the coordinates of the last choice cell' do
+          @grid.choice_cell_area(119,4).should == {x: 1538, y: 2108, w: 51, h: 41}
         end
       end
-    end
-    
-    describe "#cell_y" do
-      it "returns the distance from the registration frame of the top edge of the 1st row of cells" do
-        grid.send(:cell_y,0).should == 33.5
+      
+      describe '#ctrl_area_dark' do
+        it 'returns the coordinates of the control cell used to set the darkened threshold' do
+          @grid.ctrl_area_dark.should == {:x=>1479, :y=>329, :w=>51, :h=>41}
+        end
       end
       
-      it "returns the distance from the registration frame of the 40th row of cells" do
-        grid.send(:cell_y,39).should == 267.5
+      describe '#ctrl_area_light' do
+        it 'returns the coordinates of the control cell used to set the darkened threshold' do
+          @grid.ctrl_area_light.should == {:x=>1538, :y=>329, :w=>51, :h=>41}
+        end
       end
-    end
-    
-    describe "#cell_xy" do
-      it "returns the left and top distances from the registration frame of a sample cell" do
-        x, y = grid.send(:cell_xy,54, 3)
-        x.should == 78.5
-        y.should == 117.5
+      
+      describe '#cal_area_white' do
+        it 'returns the coordinates of the white area used for code calibration' do
+          @grid.cal_area_white.should == {:x=>93, :y=>2260, :w=>25, :h=>21}
+        end
       end
+      
+      describe '#cal_area_black' do
+        it 'returns the coordinates of the code calibration bar' do
+          @grid.cal_area_black.should == {:x=>126, :y=>2260, :w=>25, :h=>21}
+        end
+      end
+      
+      describe '#code_bit_area' do
+        it 'returns the coordinates of the first code bit area' do
+          @grid.code_bit_area(0).should == {:x=>160, :y=>2260, :w=>25, :h=>21}
+        end
+
+        it 'returns the coordinates of the last code bit area' do
+          @grid.code_bit_area(39).should == {:x=>1475, :y=>2260, :w=>25, :h=>21}
+        end
+        
+        it 'fails if an invalid code bit is requested' do
+          lambda { @grid.code_bit_area(40) }.should raise_error
+        end
+      end
+      
+      
     end
+
+    
+    # describe "#cell_x" do
+    #   context "for 1st-column questions" do
+    #     it "returns the distance from the registration frame of the left edge of the 1st choice" do
+    #       grid.send(:cell_x,0,0).should == 7.5
+    #     end
+    #
+    #     it "returns the distance from the registration frame of the left edge of the 2nd choice" do
+    #       grid.send(:cell_x,0,1).should == 14.5
+    #     end
+    #   end
+    #
+    #   context "for 4th-column questions" do
+    #     it "returns the distance from the registration frame of the left edge of the 1st choice" do
+    #       grid.send(:cell_x,120,0).should == 157.5
+    #     end
+    #
+    #     it "returns the distance from the registration frame of the left edge of the 2nd choice" do
+    #       grid.send(:cell_x,120,1).should == 164.5
+    #     end
+    #   end
+    # end
+    #
+    # describe "#cell_y" do
+    #   it "returns the distance from the registration frame of the top edge of the 1st row of cells" do
+    #     grid.send(:cell_y,0).should == 33.5
+    #   end
+    #
+    #   it "returns the distance from the registration frame of the 40th row of cells" do
+    #     grid.send(:cell_y,39).should == 267.5
+    #   end
+    # end
   end
 end
 

data/spec/mork/sheet_pdf_spec.rb

@@ -53,7 +53,7 @@ module Mork
             box:      true,
           }
         }, # header end
-        responses: {
+        items: {
           columns:       4, 
           column_width: 49,
           rows:         30,

data/spec/mork/sheet_spec.rb

@@ -4,7 +4,7 @@ module Mork
   describe Sheet do
     context "describing marked choices" do
       before(:all) do
-        @sheet = Sheet.new('spec/samples/sample02.jpg')
+        @sheet = Sheet.new('spec/samples/sample01.jpg', Grid.new('spec/samples/grid01.yml'))
       end
 
       describe "#marked?" do

data/spec/samples/grid01.yml

@@ -0,0 +1,58 @@
+page_size:
+  width:  210
+  height: 297
+regmarks:
+  margin:  10
+  radius:   2.5
+  search:  12
+  offset:   2
+header:
+  name:
+    top:    5
+    left:   7.5
+    width: 170
+    size: 14
+  title:
+    top: 15
+    left: 7.5
+    width: 180
+    size: 12
+  code:
+    top: 5
+    left: 165
+    width: 20
+    size: 14
+  signature:
+    top: 30
+    left: 7.5
+    width: 120
+    height: 15
+    size: 7
+    box: true
+items:
+  columns: 4
+  column_width: 49
+  rows: 30
+  first_x: 10.5
+  first_y: 55.5
+  x_spacing: 7.0
+  y_spacing: 7.0
+  cell_width: 6.0
+  cell_height: 5.0
+  max_cells: 5
+  number_size: 10
+  number_width: 8
+  number_margin: 2
+  letter_size: 8
+code:
+  bits: 40
+  left: 15
+  width: 3.0
+  height: 2.5
+  spacing: 4
+control:
+  top: 40
+  left: 123
+  width: 50
+  size: 9
+  margin: 2.5

data/spec/spec_helper.rb

@@ -1,5 +1,10 @@
 require 'mork'
 
+RSpec.configure do |c|
+  # filter_run is short-form alias for filter_run_including
+  c.filter_run focus: true
+end
+
 class SampleImager
   attr_reader :info, :reg_marks, :q_boxes, :code_string, :code_int
   

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mork
 version: !ruby/object:Gem::Version
-  version: 0.0.5
+  version: 0.0.6
 platform: ruby
 authors:
 - Giuseppe Bertini
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-09-04 00:00:00.000000000 Z
+date: 2014-09-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: narray
@@ -183,16 +183,16 @@ files:
 - spec/mork/npatch_spec.rb
 - spec/mork/sheet_pdf_spec.rb
 - spec/mork/sheet_spec.rb
-- spec/samples/22161694.pdf
 - spec/samples/code_sample.pdf
 - spec/samples/code_sample.png
 - spec/samples/code_zero.pdf
+- spec/samples/content01.yml
+- spec/samples/grid01.yml
 - spec/samples/info.yml
-- spec/samples/qzc006.jpg
 - spec/samples/reg_mark.jpg
-- spec/samples/sample.pages
 - spec/samples/sample01.jpg
 - spec/samples/sample02.jpg
+- spec/samples/sample03.jpg
 - spec/samples/sheet1.jpg
 - spec/samples/sheet1.pdf
 - spec/samples/two_pages.pdf
@@ -227,16 +227,16 @@ test_files:
 - spec/mork/npatch_spec.rb
 - spec/mork/sheet_pdf_spec.rb
 - spec/mork/sheet_spec.rb
-- spec/samples/22161694.pdf
 - spec/samples/code_sample.pdf
 - spec/samples/code_sample.png
 - spec/samples/code_zero.pdf
+- spec/samples/content01.yml
+- spec/samples/grid01.yml
 - spec/samples/info.yml
-- spec/samples/qzc006.jpg
 - spec/samples/reg_mark.jpg
-- spec/samples/sample.pages
 - spec/samples/sample01.jpg
 - spec/samples/sample02.jpg
+- spec/samples/sample03.jpg
 - spec/samples/sheet1.jpg
 - spec/samples/sheet1.pdf
 - spec/samples/two_pages.pdf