remove_white_border 1.0.0

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in remove_white_border.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2011 Alex McHale (alexmchale@gmail.com)
+
+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.markdown

@@ -0,0 +1,31 @@
+remove_white_border
+===================
+
+Description
+-----------
+
+This is a command line tool for removing the white border created on images by
+a scanner.
+
+Installation
+------------
+
+    gem install remove_white_border
+
+Runtime Dependencies
+--------------------
+
+* RMagick: Gem used for image manipulation
+* ImageMagick: Used by RMagick
+
+Usage
+-----
+
+    remove_white_border MyImage.png
+
+    remove_white_border MyImage.png MyNewImage.png
+
+License
+-------
+
+See LICENSE file.

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/bin/remove_white_border

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+
+require "remove_white_border"
+
+SRC = ARGV.shift
+DST = ARGV.shift
+
+if !SRC && !DST
+  puts "usage: remove_white_border IMAGE         (replaces the existing file)"
+  puts "       remove_white_border INPUT OUTPUT  (creates the output file)"
+else
+  RemoveWhiteBorder::Remover.new(SRC).write(DST)
+end

data/lib/remove_white_border.rb

@@ -0,0 +1,124 @@
+require "rmagick"
+
+module RemoveWhiteBorder
+
+  class Remover
+
+    WHITE = 60000
+
+    def initialize(filename)
+      @filename = filename
+      @image    = Magick::Image.read(filename).first
+      @width    = @image.columns
+      @height   = @image.rows
+    end
+
+    def white?(x, y)
+      if x && y
+        p = @image.pixel_color(x, y)
+        %w( red green blue ).all? { |c| p.send(c) >= WHITE }
+      elsif x
+        (0 ... @height).all? { |y| white? x, y }
+      elsif y
+        (0 ... @width).all? { |x| white? x, y }
+      end
+    end
+
+    # Determines and x and y that should be good to use for scanning the image.
+    def calculate_center(x = nil, y = nil, width = nil, height = nil)
+      x      ||= @width / 2
+      y      ||= @height / 2
+      width  ||= @width
+      height ||= @height
+
+      return @coords if @coords
+      return (@coords = [x, y]) if !white?(x, y)
+      return if width <= 2 || height <= 2
+
+      if coords = calculate_center(x - width/2, y - height/2, width/2, height/2)
+        return coords
+      end
+
+      if coords = calculate_center(x - width/2, y + height/2, width/2, height/2)
+        return coords
+      end
+
+      if coords = calculate_center(x + width/2, y - height/2, width/2, height/2)
+        return coords
+      end
+
+      if coords = calculate_center(x + width/2, y + height/2, width/2, height/2)
+        return coords
+      end
+    end
+
+    def nonwhite_top
+      # Find a good x to use.
+      x0 = calculate_center[0]
+
+      # Start with a quick scan down to find the first y that is not white.
+      y = 0
+      y += 1 while (y < @height - 1) && white?(x0, y)
+
+      # Now move back up until we find a row that is all white.
+      y -= 1 while (y > 0) && !white?(nil, y)
+
+      return y
+    end
+
+    def nonwhite_bottom
+      # Find a good x to use.
+      x0 = calculate_center[0]
+
+      # Start with a quick scan up to find the first y that is not white.
+      y = @height - 1
+      y -= 1 while (y > 0) && white?(x0, y)
+
+      # Now move back down until we find a row that is all white.
+      y += 1 while (y < @height - 1) && !white?(nil, y)
+
+      return y
+    end
+
+    def nonwhite_left
+      # Find a good y to use.
+      y0 = calculate_center[1]
+
+      # Start with a quick scan right to find the first x that is not white.
+      x = 0
+      x += 1 while (x < @width - 1) && white?(x, y0)
+
+      # Now move back left until we find a column that is all white.
+      x -= 1 while (x > 0) && !white?(x, nil)
+
+      return x
+    end
+
+    def nonwhite_right
+      # Find a good y to use.
+      y0 = calculate_center[1]
+
+      # Start with a quick scan left to find the first x that is not white.
+      x = @width - 1
+      x -= 1 while (x > 0) && white?(x, y0)
+
+      # Now move back right until we find a column that is all white.
+      x += 1 while (x < @width - 1) && !white?(x, nil)
+
+      return x
+    end
+
+    def write(output = nil)
+      output ||= @filename
+
+      x      = nonwhite_left
+      y      = nonwhite_top
+      width  = nonwhite_right - x
+      height = nonwhite_bottom - y
+
+      @image.crop(x, y, width, height).write(output)
+    end
+
+  end
+
+end

data/lib/remove_white_border/version.rb

@@ -0,0 +1,3 @@
+module RemoveWhiteBorder
+  VERSION = "1.0.0"
+end

data/remove_white_border.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "remove_white_border/version"
+
+Gem::Specification.new do |s|
+  s.name        = "remove_white_border"
+  s.version     = RemoveWhiteBorder::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Alex McHale"]
+  s.email       = ["alexmchale@gmail.com"]
+  s.homepage    = "https://github.com/alexmchale/remove_white_border"
+  s.summary     = %q{This is a command line tool for removing a white border around an image.}
+  s.description = %q{This is a command line tool for removing the white border around an image, often created by scanners.}
+
+  s.rubyforge_project = "remove_white_border"
+
+  s.add_dependency "rmagick", "~> 2.13.1"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

metadata

@@ -0,0 +1,91 @@
+--- !ruby/object:Gem::Specification 
+name: remove_white_border
+version: !ruby/object:Gem::Version 
+  hash: 23
+  prerelease: 
+  segments: 
+  - 1
+  - 0
+  - 0
+  version: 1.0.0
+platform: ruby
+authors: 
+- Alex McHale
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-05-21 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rmagick
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 57
+        segments: 
+        - 2
+        - 13
+        - 1
+        version: 2.13.1
+  type: :runtime
+  version_requirements: *id001
+description: This is a command line tool for removing the white border around an image, often created by scanners.
+email: 
+- alexmchale@gmail.com
+executables: 
+- remove_white_border
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- LICENSE
+- README.markdown
+- Rakefile
+- bin/remove_white_border
+- lib/remove_white_border.rb
+- lib/remove_white_border/version.rb
+- remove_white_border.gemspec
+has_rdoc: true
+homepage: https://github.com/alexmchale/remove_white_border
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: remove_white_border
+rubygems_version: 1.4.2
+signing_key: 
+specification_version: 3
+summary: This is a command line tool for removing a white border around an image.
+test_files: []
+