tesseract-ocr 0.0.2 → 0.0.3

data/lib/tesseract/engine/baseline.rb

@@ -0,0 +1,43 @@
+#--
+# Copyright 2011 meh. All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without modification, are
+# permitted provided that the following conditions are met:
+#
+#    1. Redistributions of source code must retain the above copyright notice, this list of
+#       conditions and the following disclaimer.
+#
+# THIS SOFTWARE IS PROVIDED BY meh ''AS IS'' AND ANY EXPRESS OR IMPLIED
+# WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+# FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL meh OR
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+# SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+# ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+# ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#
+# The views and conclusions contained in the software and documentation are those of the
+# authors and should not be interpreted as representing official policies, either expressed
+# or implied, of meh.
+#++
+
+module Tesseract; class Engine
+
+class Baseline
+	def initialize (struct)
+		@internal = struct
+	end
+
+	C::Iterator::Baseline.layout.members.each {|name|
+		define_method name do
+			@internal[name]
+		end
+	}
+
+	def inspect
+		"#<Baseline: #{x1};#{y1} #{x2};#{y2}>"
+	end
+end
+
+end; end

data/lib/tesseract/engine/bounding_box.rb

@@ -0,0 +1,54 @@
+#--
+# Copyright 2011 meh. All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without modification, are
+# permitted provided that the following conditions are met:
+#
+#    1. Redistributions of source code must retain the above copyright notice, this list of
+#       conditions and the following disclaimer.
+#
+# THIS SOFTWARE IS PROVIDED BY meh ''AS IS'' AND ANY EXPRESS OR IMPLIED
+# WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+# FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL meh OR
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+# SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+# ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+# ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#
+# The views and conclusions contained in the software and documentation are those of the
+# authors and should not be interpreted as representing official policies, either expressed
+# or implied, of meh.
+#++
+
+module Tesseract; class Engine
+
+class BoundingBox
+	def initialize (struct)
+		@internal = struct
+	end
+
+	C::Iterator::BoundingBox.layout.members.each {|name|
+		define_method name do
+			@internal[name]
+		end
+	}
+
+	alias x left
+	alias y top
+
+	def width
+		right - left
+	end
+
+	def height
+		bottom - top
+	end
+
+	def inspect
+		"#<BoundingBox(#{x}, #{y}): #{width}x#{height}>"
+	end
+end
+
+end; end

data/lib/tesseract/engine/font_attributes.rb

@@ -0,0 +1,50 @@
+#--
+# Copyright 2011 meh. All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without modification, are
+# permitted provided that the following conditions are met:
+#
+#    1. Redistributions of source code must retain the above copyright notice, this list of
+#       conditions and the following disclaimer.
+#
+# THIS SOFTWARE IS PROVIDED BY meh ''AS IS'' AND ANY EXPRESS OR IMPLIED
+# WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+# FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL meh OR
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+# SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+# ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+# ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#
+# The views and conclusions contained in the software and documentation are those of the
+# authors and should not be interpreted as representing official policies, either expressed
+# or implied, of meh.
+#++
+
+module Tesseract; class Engine
+
+class FontAttributes
+	def initialize (struct)
+		@internal = struct
+	end
+
+	C::Iterator::FontAttributes.layout.members.each {|name|
+		define_method name do
+			@internal[name]
+		end
+	}
+
+	alias bold?       is_bold
+	alias italic?     is_italic
+	alias underlined? is_underlined
+	alias monospace?  is_monospace
+	alias serif?      is_serif
+	alias smallcaps?  is_smallcaps
+
+	def inspect
+		"#<Font(#{id} #{name || 'unknown'} #{pointsize}pt):#{' bold' if bold?}#{' italic' if italic?}#{' underlined' if underlined?}#{' monospace' if monospace?}#{' serif' if serif?}#{' smallcaps' if smallcaps?}>"
+	end
+end
+
+end; end

data/lib/tesseract/engine/iterator.rb

@@ -0,0 +1,161 @@
+#--
+# Copyright 2011 meh. All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without modification, are
+# permitted provided that the following conditions are met:
+#
+#    1. Redistributions of source code must retain the above copyright notice, this list of
+#       conditions and the following disclaimer.
+#
+# THIS SOFTWARE IS PROVIDED BY meh ''AS IS'' AND ANY EXPRESS OR IMPLIED
+# WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+# FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL meh OR
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+# SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+# ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+# ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#
+# The views and conclusions contained in the software and documentation are those of the
+# authors and should not be interpreted as representing official policies, either expressed
+# or implied, of meh.
+#++
+
+require 'tesseract/engine/bounding_box'
+require 'tesseract/engine/baseline'
+require 'tesseract/engine/orientation'
+require 'tesseract/engine/font_attributes'
+
+module Tesseract; class Engine
+
+class Iterator
+	class Element
+		def self.for (level)
+			Iterator.const_get(level.capitalize)
+		rescue
+			self
+		end
+
+		def initialize (level, iterator)
+			@level    = level
+			@iterator = iterator
+		end
+
+		memoize
+		def bounding_box
+			BoundingBox.new(@iterator.bounding_box(@level))
+		end
+
+		memoize
+		def binary_image
+			@iterator.get_binary_image(@level) rescue nil
+		end
+
+		memoize
+		def image
+			@iterator.get_image(@level) rescue nil
+		end
+
+		memoize
+		def baseline
+			Baseline.new(@iterator.baseline(@level))
+		end
+
+		memoize
+		def orientation
+			Orientation.new(@iterator.orientation)
+		end
+
+		memoize
+		def text
+			@iterator.get_text(@level)
+		end
+
+		memoize
+		def confidence
+			@iterator.confidence(@level)
+		end
+
+		alias to_s text
+
+		def inspect
+			"#<Tesseract::#{@level.capitalize}(#{confidence}): #{text.inspect}>"
+		end
+	end
+
+	class Block < Element
+		memoize
+		def type
+			@iterator.block_type
+		end
+	end
+
+	class Word < Element
+		memoize
+		def font_attributes
+			FontAttributes.new(@iterator.word_font_attributes)
+		end
+
+		memoize
+		def from_dictionary?
+			@iterator.word_is_from_dictionary?
+		end
+
+		memoize
+		def numeric?
+			@iterator.word_is_numeric?
+		end
+	end
+
+	class Symbol < Element
+		memoize
+		def superscript?
+			@iterator.symbol_is_superscript?
+		end
+
+		memoize
+		def subscript?
+			@iterator.symbol_is_subscript?
+		end
+
+		memoize
+		def dropcap?
+			@iterator.symbol_is_dropcap?
+		end
+	end
+
+	def initialize (iterator)
+		@iterator = iterator
+	end
+
+	%w(block paragraph line word symbol).each {|level|
+		define_method "each_#{level}" do |&block|
+			return enum_for "each_#{level}" unless block
+
+			@iterator.begin
+
+			begin
+				block.call Element.for(level).new(level, @iterator)
+			end while @iterator.next level
+		end
+
+		define_method "#{level}s" do
+			__send__("each_#{level}").map {|e|
+				e.methods.each {|name|
+					if e.respond_to? "__memoized_#{name}"
+						e.__send__ name
+					end
+				}
+
+				e.instance_eval {
+					@iterator = nil
+				}
+
+				e
+			}
+		end
+	}
+end
+
+end; end

data/lib/tesseract/engine/orientation.rb

@@ -0,0 +1,45 @@
+#--
+# Copyright 2011 meh. All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without modification, are
+# permitted provided that the following conditions are met:
+#
+#    1. Redistributions of source code must retain the above copyright notice, this list of
+#       conditions and the following disclaimer.
+#
+# THIS SOFTWARE IS PROVIDED BY meh ''AS IS'' AND ANY EXPRESS OR IMPLIED
+# WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+# FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL meh OR
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+# SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+# ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+# ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#
+# The views and conclusions contained in the software and documentation are those of the
+# authors and should not be interpreted as representing official policies, either expressed
+# or implied, of meh.
+#++
+
+module Tesseract; class Engine
+
+class Orientation
+	def initialize (struct)
+		@internal = struct
+	end
+
+	C::Iterator::Orientation.layout.members.each {|name|
+		define_method name do
+			@internal[name]
+		end
+	}
+
+	alias direction orientation
+
+	def inspect
+		"#<Orientation: #{orientation} #{writing_direction} #{textline_order} #{deskew_angle}>"
+	end
+end
+
+end; end

data/lib/tesseract/extensions.rb

@@ -23,16 +23,6 @@
 #++
 
 require 'namedic'
+require 'memoized'
 require 'iso-639'
-
-module Kernel
-	def suppress_stderr
-		old = IO.pipe.last.reopen($stderr)
-
-		$stderr.reopen(IO.pipe.last)
-		result = yield
-		$stderr.reopen(old)
-
-		result
-	end
-end
+require 'io/manage'

data/lib/tesseract/iterator.rb

@@ -0,0 +1,38 @@
+#--
+# Copyright 2011 meh. All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without modification, are
+# permitted provided that the following conditions are met:
+#
+#    1. Redistributions of source code must retain the above copyright notice, this list of
+#       conditions and the following disclaimer.
+#
+# THIS SOFTWARE IS PROVIDED BY meh ''AS IS'' AND ANY EXPRESS OR IMPLIED
+# WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+# FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL meh OR
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+# SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+# ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+# ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#
+# The views and conclusions contained in the software and documentation are those of the
+# authors and should not be interpreted as representing official policies, either expressed
+# or implied, of meh.
+#++
+
+module Tesseract
+
+class Iterator
+	def initialize (api, pointer)
+		@api      = api
+		@internal = pointer
+	end
+
+	def to_ffi
+		@internal
+	end
+end
+
+end

data/lib/tesseract/version.rb

@@ -24,6 +24,6 @@
 
 module Tesseract
 	def self.version
-		'0.0.2'
+		'0.0.3'
 	end
 end

data/tesseract-ocr.gemspec

@@ -15,6 +15,7 @@ Gem::Specification.new {|s|
 	s.require_paths = ['lib']
 
 	s.add_dependency 'namedic'
+	s.add_dependency 'memoized'
 	s.add_dependency 'iso-639'
 
 	s.add_dependency 'ffi-extra'

data/test/tesseract_bench.rb

@@ -0,0 +1,31 @@
+#! /usr/bin/env ruby
+require 'tesseract'
+require 'benchmark'
+
+Benchmark.bm do |b|
+	engine = Tesseract::Engine.new
+
+	b.report 'text_for: ' do
+		100.times do
+			engine.text_for('first.png')
+
+			GC.start
+		end
+	end
+
+	b.report 'words_for: ' do
+		100.times do
+			engine.words_for('first.png')
+
+			GC.start
+		end
+	end
+
+	b.report 'symbols_for: ' do
+		100.times do
+			engine.symbols_for('first.png')
+
+			GC.start
+		end
+	end
+end