glyph_imager 0.0.3

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,21 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 William Melody
+
+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,17 @@
+= glyph_imager
+
+This gem is completely undocumented and the code is pretty much just tossed together, but the basic idea is that it uses imagemagick to generate an image of specified unicode character glyphs from a TTF.
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2010 William Melody. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,53 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "glyph_imager"
+    gem.summary = %Q{Generate images of glyphs for a specified character in a specified font}
+    gem.description = %Q{Generate images of glyphs for a specified character in a specified font}
+    gem.email = "hi@williammelody.com"
+    gem.homepage = "http://github.com/alphabetum/glyph_imager"
+    gem.authors = ["William Melody"]
+    gem.add_development_dependency "thoughtbot-shoulda", ">= 0"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/test_*.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "glyph_imager #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.3

data/glyph_imager.gemspec

@@ -0,0 +1,90 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{glyph_imager}
+  s.version = "0.0.3"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["William Melody"]
+  s.date = %q{2010-04-27}
+  s.description = %q{Generate images of glyphs for a specified character in a specified font}
+  s.email = %q{hi@williammelody.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "glyph_imager.gemspec",
+     "lib/glyph_imager.rb",
+     "test/fonts/DejaVuSerif.ttf",
+     "test/helper.rb",
+     "test/test_glyph_imager.rb",
+     "vendor/graphics_utf",
+     "vendor/ttf-ruby-0.1/AUTHORS",
+     "vendor/ttf-ruby-0.1/COPYING",
+     "vendor/ttf-ruby-0.1/README",
+     "vendor/ttf-ruby-0.1/TODO",
+     "vendor/ttf-ruby-0.1/VERSION",
+     "vendor/ttf-ruby-0.1/lib/ttf.rb",
+     "vendor/ttf-ruby-0.1/lib/ttf/datatypes.rb",
+     "vendor/ttf-ruby-0.1/lib/ttf/encodings.rb",
+     "vendor/ttf-ruby-0.1/lib/ttf/exceptions.rb",
+     "vendor/ttf-ruby-0.1/lib/ttf/font_loader.rb",
+     "vendor/ttf-ruby-0.1/lib/ttf/fontchunk.rb",
+     "vendor/ttf-ruby-0.1/lib/ttf/table/cmap.rb",
+     "vendor/ttf-ruby-0.1/lib/ttf/table/cvt.rb",
+     "vendor/ttf-ruby-0.1/lib/ttf/table/fpgm.rb",
+     "vendor/ttf-ruby-0.1/lib/ttf/table/gasp.rb",
+     "vendor/ttf-ruby-0.1/lib/ttf/table/glyf.rb",
+     "vendor/ttf-ruby-0.1/lib/ttf/table/head.rb",
+     "vendor/ttf-ruby-0.1/lib/ttf/table/hhea.rb",
+     "vendor/ttf-ruby-0.1/lib/ttf/table/hmtx.rb",
+     "vendor/ttf-ruby-0.1/lib/ttf/table/kern.rb",
+     "vendor/ttf-ruby-0.1/lib/ttf/table/loca.rb",
+     "vendor/ttf-ruby-0.1/lib/ttf/table/maxp.rb",
+     "vendor/ttf-ruby-0.1/lib/ttf/table/name.rb",
+     "vendor/ttf-ruby-0.1/lib/ttf/table/os2.rb",
+     "vendor/ttf-ruby-0.1/lib/ttf/table/post.rb",
+     "vendor/ttf-ruby-0.1/lib/ttf/table/prep.rb",
+     "vendor/ttf-ruby-0.1/lib/ttf/table/vhea.rb",
+     "vendor/ttf-ruby-0.1/lib/ttf/table/vmtx.rb",
+     "vendor/ttf-ruby-0.1/setup.rb",
+     "vendor/ttf-ruby-0.1/tools/README",
+     "vendor/ttf-ruby-0.1/tools/ttfcairoglyphviewer",
+     "vendor/ttf-ruby-0.1/tools/ttfdump",
+     "vendor/ttf-ruby-0.1/tools/ttfglyph2svg",
+     "vendor/ttf-ruby-0.1/tools/ttfsubset"
+  ]
+  s.homepage = %q{http://github.com/alphabetum/glyph_imager}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.6}
+  s.summary = %q{Generate images of glyphs for a specified character in a specified font}
+  s.test_files = [
+    "test/helper.rb",
+     "test/test_glyph_imager.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<thoughtbot-shoulda>, [">= 0"])
+    else
+      s.add_dependency(%q<thoughtbot-shoulda>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<thoughtbot-shoulda>, [">= 0"])
+  end
+end
+

data/lib/glyph_imager.rb

@@ -0,0 +1,102 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'vendor', 'ttf-ruby-0.1', 'lib'))
+require 'ttf'
+
+module GlyphImager
+  
+  def self.image_character_for_font(options = {})
+    %w[code_point font_path output_dir].each do |k|
+      if options[k.to_sym].nil?
+        raise ArgumentError, "missing value for :#{k}"
+      end
+    end
+    font = FontRecord.new(options[:font_path])
+    if font.has_glyph_for_unicode_char?(options[:code_point])
+      imager = GlyphImager::Imager.new(options)
+      imager.create_image
+      return imager
+    end
+  end
+  
+  
+  
+  class FontRecord
+    
+    @@metadata_ids = %w[
+      copyright_notice
+      font_family_name
+      font_subfamily_name
+      unique_font_identifier
+      full_font_name
+      version_string
+      postscript_name
+      trademark
+      manufacturer_name
+      designer_name
+      description
+      vendor_url
+      designer_url
+      license_description
+      license_url
+      reserved
+      preferred_family
+      preferred_subfamily
+      compatible_full
+    ]
+    
+    
+    @@metadata_ids.each do |m|
+      define_method(m) do
+        name_table.name_records[@@metadata_ids.index(m)].to_s
+      end
+    end
+    
+    def initialize(filename)
+      @font = Font::TTF::FontLoader.new(filename)
+    end
+    
+    def font
+      @font
+    end
+    
+    def name_table
+      @name_table ||= @font.get_table(:name)
+    end
+    
+    def get_encoding_table4
+      @enc_tbl ||= @font.get_table(:cmap).encoding_tables.find do |t|
+          t.class == Font::TTF::Table::Cmap::EncodingTable4
+      end
+    end
+    
+    def has_glyph_for_unicode_char?(code_point)
+      get_encoding_table4.get_glyph_id_for_unicode(code_point.hex) != 0
+    end
+    
+  end
+  
+  class Imager
+    
+    @@graphics_utf_path = File.join(File.dirname(__FILE__), '..', 'vendor', 'graphics_utf')
+    
+    def initialize(opts = {})
+      @options = { :size => "80x80" }.merge(opts)
+      %w[code_point font_path output_dir].each do |k|
+        if @options[k.to_sym].nil?
+          raise ArgumentError, "missing value for :#{k}"
+        end
+      end
+    end
+    
+    def output_path
+      "#{@options[:output_dir]}/#{@options[:code_point]}.png"
+    end
+    
+        
+    def create_image
+      %x[#{@@graphics_utf_path} -N #{@options[:code_point]} | convert -font #{@options[:font_path]} -size #{@options[:size]} -gravity center label:@- #{output_path}]
+      return self
+    end
+    
+  end
+  
+end

data/test/helper.rb

@@ -0,0 +1,10 @@
+require 'rubygems'
+require 'test/unit'
+require 'shoulda'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'glyph_imager'
+
+class Test::Unit::TestCase
+end

data/test/test_glyph_imager.rb

@@ -0,0 +1,62 @@
+require 'helper'
+
+class TestGlyphImager < Test::Unit::TestCase
+  
+  def setup
+    @font_path = File.join(File.dirname(__FILE__), 'fonts', 'DejaVuSerif.ttf')
+    @font = GlyphImager::FontRecord.new(@font_path)
+    @output_dir = "/tmp"
+  end
+  
+  def teardown
+    if File.exists?("/tmp/0021.png")
+      File.delete("/tmp/0021.png")
+    end
+  end
+  
+  should "read font" do
+    assert_not_nil @font
+  end
+  
+  should "return font metadata" do
+    assert_equal "DejaVu Serif", @font.full_font_name
+    assert_equal "Copyright (c) 2003 by Bitstream, Inc. All Rights Reserved.\nDejaVu changes are in public domain\n", @font.copyright_notice
+  end
+  
+  should "return true when glyph exists for character" do
+    assert @font.has_glyph_for_unicode_char?("0021")
+  end
+  
+  should "return false when glyph doesn't exist for character" do
+    assert !@font.has_glyph_for_unicode_char?("11B14")
+  end
+  
+  should "create new image" do
+    @imager = GlyphImager::Imager.new({ 
+      :code_point => "0021",
+      :font_path => @font_path,
+      :output_dir => "/tmp"
+    })
+    @imager.create_image
+    assert File.exists?("/tmp/0021.png")
+  end
+  
+  should "create new image for character supported by font" do
+    GlyphImager.image_character_for_font({
+      :code_point => "0021",
+      :font_path => @font_path,
+      :output_dir => "/tmp"
+    })
+    assert File.exists?("/tmp/0021.png")
+  end
+  
+  should "not create new image for character not supported by font" do
+    GlyphImager.image_character_for_font({
+      :code_point => "11B14",
+      :font_path => @font_path,
+      :output_dir => "/tmp"
+    })
+    assert !File.exists?("/tmp/11B14.png")
+  end
+  
+end

data/vendor/graphics_utf

@@ -0,0 +1,157 @@
+#!/bin/sh -
+#
+# graphics_utf [options] character_set
+# graphics_utf [options] start_utf_hex  [end_utf_hex]
+#
+# Print UTF characters tables to standard output...
+#
+# Options:   -n   no formating around charcaters
+#            -N   no formating, and no linefeeds either
+#
+# Character-Sets Known by this script include:
+#       ascii, ascii+meta, meta, latin, latin_ext, tolkan, punct, indices,
+#       numbers, factions, roman, arrows, math, mathsup,
+#       technical, graphics, dingbats, braile, and asian (big)
+#
+# For example
+#    graphics_utf numbers
+#    graphics_utf 0000 0200
+#
+# Or use ImageMagick to display in a specific font
+#
+#   graphics_utf -N dingbats |\
+#     convert -font Mincho -pointsize 48 label:@- x:
+#
+####
+#
+# For a GUI version (yuck) use  "gucharmap"
+#
+# WARNING: Input arguments are NOT tested for correctness.
+# This script represents a security risk if used ONLINE.
+# I accept no responsiblity for misuse. Use at own risk.
+#
+# Anthony Thyssen    30 August 2005
+#
+PROGNAME=`type $0 | awk '{print $3}'`  # search for executable on path
+PROGDIR=`dirname $PROGNAME`            # extract directory of program
+PROGNAME=`basename $PROGNAME`          # base name of program
+Usage() {                              # output the script comments as docs
+  echo >&2 "$PROGNAME:" "$@"
+  sed >&2 -n '/^###/q; /^#/!q; s/^#//; s/^ //; 3s/^/Usage: /; 2,$ p' \
+          "$PROGDIR/$PROGNAME"
+  exit 10;
+}
+
+FORMAT=normal
+
+while [  $# -gt 0 ]; do
+  case "$1" in
+  --help|--doc*)      Usage ;;
+  -n|--noheaders)     FORMAT=nohead ;;
+  -N|--nolinefeeds)   FORMAT= ;;
+
+  --) shift; break ;;    # end of user options
+  -*) Usage "Unknown option \"$1\"" ;;
+  *)  break ;;           # end of user options
+
+  esac
+  shift   # next option
+done
+
+case `echo "$1" | tr 'A-Z' 'a-z'` in
+ascii)        start=`printf '%d' 0x0020` end=`printf '%d' 0x0080` ;;
+ascii+meta)   start=`printf '%d' 0x0020` end=`printf '%d' 0x0100` ;;
+latin)        start=`printf '%d' 0x0000` end=`printf '%d' 0x0250` ;;
+meta)         start=`printf '%d' 0x00A0` end=`printf '%d' 0x0100` ;;
+latin_ext)    start=`printf '%d' 0x1E00` end=`printf '%d' 0x1F00` ;;
+runic|tolkan) start=`printf '%d' 0x16A0` end=`printf '%d' 0x1700` ;;
+punctuation|\
+  punct)      start=`printf '%d' 0x2000` end=`printf '%d' 0x2070` ;;
+indices)      start=`printf '%d' 0x2070` end=`printf '%d' 0x20A0` ;;
+numbers)      start=`printf '%d' 0x2150` end=`printf '%d' 0x2180` ;;
+factions)     start=`printf '%d' 0x2150` end=`printf '%d' 0x2160` ;;
+roman)        start=`printf '%d' 0x2160` end=`printf '%d' 0x2190` ;;
+arrows)       start=`printf '%d' 0x2190` end=`printf '%d' 0x2200` ;;
+arrows-a)     start=`printf '%d' 0x27F0` end=`printf '%d' 0x2800` ;;
+arrows-b)     start=`printf '%d' 0x2900` end=`printf '%d' 0x2980` ;;
+math)         start=`printf '%d' 0x2200` end=`printf '%d' 0x2300` ;;
+technical)    start=`printf '%d' 0x2300` end=`printf '%d' 0x2400` ;;
+graphics)     start=`printf '%d' 0x2500` end=`printf '%d' 0x2600` ;;
+miscellaneous|\
+  misc)       start=`printf '%d' 0x2600` end=`printf '%d' 0x2700` ;;
+dingbats)     start=`printf '%d' 0x2700` end=`printf '%d' 0x2800` ;;
+braile)       start=`printf '%d' 0x2800` end=`printf '%d' 0x2900` ;;
+mathsup)      start=`printf '%d' 0x2A00` end=`printf '%d' 0x2B00` ;;
+asian)        start=`printf '%d' 0x4E00` end=`printf '%d' 0xA000` ;;
+
+[0-9a-fA-F][0-9a-fA-F][0-9a-fA-F][0-9a-fA-F])
+  start=`printf '%d' 0x${1:-2000}`
+  if [ "x$2" = 'x' ]; then
+    case "$FORMAT" in
+    normal) end=`expr $start + 16 \* 16` ;;
+    nohead) end=`expr $start + 16` ;;
+    *)      end=`expr $start + 1` ;;
+    esac
+  else
+    end=`printf '%d' 0x$2`
+  fi
+  ;;
+
+'') # no argument -- standard charcaters
+  start=`printf '%d' 0x0020` end=`printf '%d' 0x0080`
+  ;;
+*)
+  Usage
+  echo >&2 "Usage: $0 character_set"
+  echo >&2 "       $0 start_utf_hex  [end_utf_hex]"
+  echo >&2 "Continuing with the 'latin' character_set..."
+  echo >&2 ""
+  start=`printf '%d' 0x0020` end=`printf '%d' 0x0080`
+  ;;
+esac
+
+# ------------------------------------------------------------------------
+
+i=$start
+
+[ "$FORMAT" = 'normal' ] &&
+   printf '             UTF-8 Characters  %04X to %04X\n'  $start  $end
+
+while [ $i -lt $end ]; do
+
+  if [ "$FORMAT" = 'normal' ]; then
+    [  `expr $i % 256` -eq 0 -o $i -eq $start ] &&
+      printf "      _0__1__2__3__4__5__6__7__8__9__a__b__c__d__e__f_\n"
+    printf "%04X " $i
+    #[ $i -lt 32 -o $i -eq 128 -o $i -eq 144 ] &&
+  fi
+  if [ $i -lt 32 ]; then
+    if [ "$FORMAT" = 'normal' ]; then
+      printf "       Skipping  Control  Character  Range\n"
+    fi
+  else
+    for j in  0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15; do
+      c=`expr $i + $j`
+      if [ "$FORMAT" = 'normal' ]; then
+        printf "  "
+      elif [ $c -ge $end ]; then
+        break
+      fi
+      if [ $i -ge 160 ]; then    # full unicode character
+        c=`printf "%04X" $c`
+        #env LC_CTYPE=en_AU.utf8 printf "\u$c"
+        env LC_CTYPE=en_AU.utf8 \
+           perl -e "binmode(STDOUT, ':utf8'); print chr(0x$c)"
+      elif [ $i -ge 128 ]; then  # meta-control character
+        printf "\xc2\x`printf "%02X" $c`"
+      else                       # normal character
+        printf "\x`printf "%02X" $c`"
+      fi
+    done
+    [ "$FORMAT" ] && printf "\n"
+  fi
+  i=`expr $i + 16`
+
+done
+
+# ------------------------------------------------------------------------