ruby-dzi 0.1.0

data/Manifest

@@ -0,0 +1,8 @@
+LICENSE-GPL.txt
+LICENSE-LGPL.txt
+LICENSE-MPL.txt
+README.rdoc
+Rakefile
+init.rb
+lib/ruby_dzi.rb
+Manifest

data/README.rdoc

@@ -0,0 +1,31 @@
+= Ruby Dzi Generator
+A forked project of Deep Zoom Slicer
+
+Ruby Dzi slices images into several tiles and creates dzi descriptor file.
+Sliced images are compatible for use with OpenZoom, Deep Zoom and Seadragon.
+
+== Additional Information
+
+Fork Contributor: Marc Vitalis <marc.vitalis@live.com>
+
+Fork from::
+
+Deep Zoom Slicer
+Copyright (c) 2009, MESO Web Scapes, Sascha Hanssen (hanssen@meso.net)
+All rights reserved.
+
+* Author: MESO Web Scapes (www.meso.net)
+* License: MPL 1.1/GPL 3/LGPL 3
+* Meso Homepage: http://www.meso.net/deep_zoom_slicer
+* GitHub: http://github.com/hanssen/deep_zoom_slicer
+
+Contributor(s):
+* Sascha Hanssen <hanssen@meso.net>
+
+Software distributed under the License is distributed on an "AS IS" basis,
+WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
+for the specific language governing rights and limitations under the
+License.
+
+Deep Zoom and Seadragon are trademarks or registered trademarks of Microsoft, Inc.
+

data/Rakefile

@@ -0,0 +1,15 @@
+require 'rubygems'
+require 'rake'
+require 'echoe'
+
+Echoe.new('ruby-dzi', '0.1.0') do |p|
+  p.description    = "Ruby Dzi slices images into several tiles and creates dzi descriptor file."
+  p.url            = "http://github.com/netxph/ruby-dzi"
+  p.author         = "Marc Vitalis"
+  p.email          = "marc.vitalis@live.com"
+  p.ignore_pattern = ["*.jpg", "*_files/**/**", "test.rb", "*.dzi", "pkg"]
+  p.development_dependencies = ["rmagick"]
+end
+
+Dir["#{File.dirname(__FILE__)}/tasks/*.rake"].sort.each { |ext| load ext }
+

data/init.rb

@@ -0,0 +1 @@
+require 'ruby_dzi'

data/lib/ruby_dzi.rb

@@ -0,0 +1,175 @@
+# Ruby Dzi generator
+# A fork from Deep Zoom Slicer project
+#
+# Ruby Dzi slices images and generates a dzi file that is compatible with DeepZoom or Seadragon
+#
+# Requirements: rmagick gem (tested with version 2.9.0)
+#
+# Contributor: Marc Vitalis <marc.vitalis@live.com> 
+#
+# Original Author:: MESO Web Scapes (www.meso.net)
+# By:: Sascha Hanssen <hanssen@meso.net>
+# License:: MPL 1.1/GPL 3/LGPL 3
+#
+# Software distributed under the License is distributed on an "AS IS" basis,
+# WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
+# for the specific language governing rights and limitations under the
+# License.
+#
+require 'rubygems'
+require 'fileutils'
+require 'RMagick'
+require 'open-uri'
+
+class RubyDzi
+  include Magick
+
+  attr_accessor :image_path, :name, :format, :output_ext, :quality, :dir, :tile_size, :overlap
+
+  def initialize(image_path)
+
+    #set defaults
+    @quality = 75
+    @dir = '.'
+    @tile_size = 254
+    @overlap = 1
+    @output_ext = 'dzi'
+
+    @image_path = image_path
+
+  end
+
+  def generate!(name, format = 'jpg')
+    @name = name
+    @format = format
+    
+    @levels_root_dir     = File.join(@dir, @name + '_files')
+    @xml_descriptor_path = File.join(@dir, @name + '.dzi')
+
+    image = get_image(@image_path)
+    
+    image.strip! # remove meta information
+
+    orig_width, orig_height = image.columns, image.rows
+
+    remove_files!
+
+    # iterate over all levels (= zoom stages)
+    max_level(orig_width, orig_height).downto(0) do |level|
+      width, height = image.columns, image.rows
+      puts "level #{level} is #{width} x #{height}"
+      
+      current_level_dir = File.join(@levels_root_dir, level.to_s)
+      FileUtils.mkdir_p(current_level_dir)
+      
+      # iterate over columns
+      x, col_count = 0, 0
+      while x < width      
+        # iterate over rows
+        y, row_count = 0, 0
+        while y < height          
+          dest_path = File.join(current_level_dir, "#{col_count}_#{row_count}.#{@extension}")
+          tile_width, tile_height = tile_dimensions(x, y, @tile_size, @overlap)
+          
+          save_cropped_image(image, dest_path, x, y, tile_width, tile_height, @quality)
+          
+          y += (tile_height - (2 * @overlap))
+          row_count += 1
+        end
+        x += (tile_width - (2 * @overlap))
+        col_count += 1
+      end
+      
+      image.resize!(0.5)
+    end
+
+    # generate xml descriptor and write file
+    write_xml_descriptor(@xml_descriptor_path,
+                         :tile_size => @tile_size,
+                         :overlap   => @overlap,
+                         :format    => @extension,
+                         :width     => orig_width,
+                         :height    => orig_height)
+  end
+
+  def remove_files!
+    files_existed = (File.file?(@xml_descriptor_path) or File.directory?(@levels_root_dir))
+
+    File.delete @xml_descriptor_path if File.file? @xml_descriptor_path
+    FileUtils.remove_dir @levels_root_dir if File.directory? @levels_root_dir
+
+    return files_existed
+  end
+
+protected
+
+  def tile_dimensions(x, y, tile_size, overlap)
+    overlapping_tile_size = tile_size + (2 * overlap)
+    border_tile_size      = tile_size + overlap
+    
+    tile_width  = (x > 0) ? overlapping_tile_size : border_tile_size
+    tile_height = (y > 0) ? overlapping_tile_size : border_tile_size
+    
+    return tile_width, tile_height
+  end
+
+  def max_level(width, height)
+    return (Math.log([width, height].max) / Math.log(2)).ceil
+  end
+
+  def save_cropped_image(src, dest, x, y, width, height, quality = 75)
+    if src.is_a? Magick::Image
+      img = src
+    else
+      img = Magick::Image::read(src).first
+    end
+    
+    quality = quality * 100 if quality < 1
+
+    # The crop method retains the offset information in the cropped image.
+    # To reset the offset data, adding true as the last argument to crop.
+    cropped = img.crop(x, y, width, height, true)
+    cropped.write(dest) { self.quality = quality }
+  end
+  
+  
+  def write_xml_descriptor(path, attr)
+    attr = { :xmlns => 'http://schemas.microsoft.com/deepzoom/2008' }.merge attr
+    
+    xml = "<?xml version='1.0' encoding='UTF-8'?>" + 
+          "<Image TileSize='#{attr[:tile_size]}' Overlap='#{attr[:overlap]}' " + 
+            "Format='#{attr[:format]}' xmlns='#{attr[:xmlns]}'>" + 
+          "<Size Width='#{attr[:width]}' Height='#{attr[:height]}'/>" + 
+          "</Image>"
+
+    open(path, "w") { |file| file.puts(xml) }
+  end
+
+  def split_to_filename_and_extension(path)
+    extension = File.extname(path).gsub('.', '')
+    filename  = File.basename(path, '.' + extension) 
+    return filename, extension
+  end 
+
+  def valid_url?(urlStr)
+    url = URI.parse(urlStr)
+    Net::HTTP.start(url.host, url.port) do |http|
+      return http.head(url.request_uri).code == "200"
+    end
+  end
+
+  def get_image(image_path)
+    image = nil
+
+    if File.file?(image_path)
+      image = Image::read(image_path).first
+    elsif valid_url
+      f = open(image_path)
+      image = Image.from_blob(f.read).first
+      f.close
+    end
+
+    return image
+  end
+
+end

data/ruby-dzi.gemspec

@@ -0,0 +1,33 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{ruby-dzi}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Marc Vitalis"]
+  s.date = %q{2010-07-03}
+  s.description = %q{Ruby Dzi slices images into several tiles and creates dzi descriptor file.}
+  s.email = %q{marc.vitalis@live.com}
+  s.extra_rdoc_files = ["LICENSE-GPL.txt", "LICENSE-LGPL.txt", "LICENSE-MPL.txt", "README.rdoc", "lib/ruby_dzi.rb"]
+  s.files = ["LICENSE-GPL.txt", "LICENSE-LGPL.txt", "LICENSE-MPL.txt", "README.rdoc", "Rakefile", "init.rb", "lib/ruby_dzi.rb", "Manifest", "ruby-dzi.gemspec"]
+  s.homepage = %q{http://github.com/netxph/ruby-dzi}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Ruby-dzi", "--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{ruby-dzi}
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Ruby Dzi slices images into several tiles and creates dzi descriptor file.}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rmagick>, [">= 0"])
+    else
+      s.add_dependency(%q<rmagick>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<rmagick>, [">= 0"])
+  end
+end

metadata

@@ -0,0 +1,98 @@
+--- !ruby/object:Gem::Specification 
+name: ruby-dzi
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Marc Vitalis
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-07-03 00:00:00 +08: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: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id001
+description: Ruby Dzi slices images into several tiles and creates dzi descriptor file.
+email: marc.vitalis@live.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE-GPL.txt
+- LICENSE-LGPL.txt
+- LICENSE-MPL.txt
+- README.rdoc
+- lib/ruby_dzi.rb
+files: 
+- LICENSE-GPL.txt
+- LICENSE-LGPL.txt
+- LICENSE-MPL.txt
+- README.rdoc
+- Rakefile
+- init.rb
+- lib/ruby_dzi.rb
+- Manifest
+- ruby-dzi.gemspec
+has_rdoc: true
+homepage: http://github.com/netxph/ruby-dzi
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Ruby-dzi
+- --main
+- README.rdoc
+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: 11
+      segments: 
+      - 1
+      - 2
+      version: "1.2"
+requirements: []
+
+rubyforge_project: ruby-dzi
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Ruby Dzi slices images into several tiles and creates dzi descriptor file.
+test_files: []
+