exifr 0.9

data/README

@@ -0,0 +1,12 @@
+= EXIF Reader
+EXIF Reader is a module to read EXIF from JPEG images.
+
+== Examples
+  EXIFR::JPEG.new('IMG_3422.JPG').width         # -> 2272
+  EXIFR::JPEG.new('IMG_3422.JPG').exif.model    # -> "Canon PowerShot G3"
+
+== Author
+R.W. van 't Veer
+
+== Copyright
+Copyright (c) 2006 R.W. van 't Veer

data/lib/exif.rb

@@ -0,0 +1,146 @@
+# Copyright (c) 2006 - R.W. van 't Veer
+
+module EXIFR
+  # = EXIF decoder
+  class EXIF < Hash
+    @@TAGS = {
+      0x0100 => :image_width,
+      0x0101 => :image_length,
+      0x0102 => :bits_per_sample,
+      0x0103 => :compression,
+      0x0106 => :photometric_interpretation,
+      0x010a => :fill_order,
+      0x010d => :document_name,
+      0x010e => :image_description,
+      0x010f => :make,
+      0x0110 => :model,
+      0x0111 => :strip_offsets,
+      0x0112 => :orientation,
+      0x0115 => :samples_per_pixel,
+      0x0116 => :rows_per_strip,
+      0x0117 => :strip_byte_counts,
+      0x011a => :xresolution,
+      0x011b => :yresolution,
+      0x011c => :planar_configuration,
+      0x0128 => :resolution_unit,
+      0x012d => :transfer_function,
+      0x0131 => :software,
+      0x0132 => :date_time,
+      0x013b => :artist,
+      0x013e => :white_point,
+      0x013f => :primary_chromaticities,
+      0x0156 => :transfer_range,
+      0x0200 => :jpegproc,
+      0x0201 => :jpeginterchange_format,
+      0x0202 => :jpeginterchange_format_length,
+      0x0211 => :ycb_cr_coefficients,
+      0x0212 => :ycb_cr_sub_sampling,
+      0x0213 => :ycb_cr_positioning,
+      0x0214 => :reference_black_white,
+      0x828d => :cfarepeat_pattern_dim,
+      0x828e => :cfapattern,
+      0x828f => :battery_level,
+      0x8298 => :copyright,
+      0x829a => :exposure_time,
+      0x829d => :fnumber,
+      0x83bb => :iptc_naa,
+      0x8769 => :exif_offset,
+      0x8773 => :inter_color_profile,
+      0x8822 => :exposure_program,
+      0x8824 => :spectral_sensitivity,
+      0x8825 => :gpsinfo,
+      0x8827 => :isospeed_ratings,
+      0x8828 => :oecf,
+      0x9000 => :exif_version,
+      0x9003 => :date_time_original,
+      0x9004 => :date_time_digitized,
+      0x9101 => :components_configuration,
+      0x9102 => :compressed_bits_per_pixel,
+      0x9201 => :shutter_speed_value,
+      0x9202 => :aperture_value,
+      0x9203 => :brightness_value,
+      0x9204 => :exposure_bias_value,
+      0x9205 => :max_aperture_value,
+      0x9206 => :subject_distance,
+      0x9207 => :metering_mode,
+      0x9208 => :light_source,
+      0x9209 => :flash,
+      0x920a => :focal_length,
+      0x9214 => :subject_area,
+      0x927c => :maker_note,
+      0x9286 => :user_comment,
+      0x9290 => :subsec_time,
+      0x9291 => :subsec_time_orginal,
+      0x9292 => :subsec_time_digitized,
+      0xa000 => :flash_pix_version,
+      0xa001 => :color_space,
+      0xa002 => :pixel_xdimension,
+      0xa003 => :pixel_ydimension,
+      0xa004 => :related_sound_file,
+      0xa005 => :interoperability_offset,
+      0xa20b => :flash_energy,
+      0xa20c => :spatial_frequency_response,
+      0xa20e => :focal_plane_xresolution,
+      0xa20f => :focal_plane_yresolution,
+      0xa210 => :focal_plane_resolution_unit,
+      0xa214 => :subject_location,
+      0xa215 => :exposure_index,
+      0xa217 => :sensing_method,
+      0xa300 => :file_source,
+      0xa301 => :scene_type,
+      0xa302 => :cfapattern,
+      0xa401 => :custom_rendered,
+      0xa402 => :exposure_mode,
+      0xa403 => :white_balance,
+      0xa404 => :digital_zoom_ratio,
+      0xa405 => :focal_len_in_35mm_film,
+      0xa406 => :scene_capture_type,
+      0xa407 => :gain_control,
+      0xa408 => :contrast,
+      0xa409 => :saturation,
+      0xa40a => :sharpness,
+      0xa40b => :device_setting_descr,
+      0xa40c => :subject_dist_range,
+      0xa420 => :image_unique_id
+    }
+    @@EXIF_HEADERS = [0x8769, 0x8825, 0xa005]
+    @@TIME_TAGS = [:date_time, :date_time_original, :date_time_digitized]
+
+    # +data+ the content of the JPEG APP1 frame without the EXIF marker
+    def initialize(data)
+      @data = data
+      traverse(TiffHeader.new(@data))
+      freeze
+    end
+
+    # convience
+    def method_missing(method, *args)
+      self[method]
+    end
+
+  private
+    def traverse(tiff)
+      tiff.fields.each do |f|
+        tag, value = @@TAGS[f.tag], f.value
+        value = (value.kind_of?(Array) && value.size == 1) ? value.first : value
+        if @@EXIF_HEADERS.include?(f.tag)
+          traverse(TiffHeader.new(@data, f.offset))
+        elsif tag
+          if @@TIME_TAGS.include? tag
+            self[tag] = value2time(value)
+          else
+            self[tag] = value
+          end
+        end
+      end
+    end
+
+    def value2time(value)
+      if value.sub(/\000.*$/, '') =~ /^(\d{4}):(\d\d):(\d\d) (\d\d):(\d\d):(\d\d)$/
+        Time.mktime($1, $2, $3, $4, $5, $6)
+      else
+        value
+      end
+    end
+  end
+end

data/lib/exifr.rb

@@ -0,0 +1,5 @@
+# Copyright (c) 2006 - R.W. van 't Veer
+
+require 'jpeg'
+require 'exif'
+require 'tiff_header'

data/lib/jpeg.rb

@@ -0,0 +1,69 @@
+# Copyright (c) 2006 - R.W. van 't Veer
+
+require 'rational'
+
+module EXIFR
+  # = JPEG decoder
+  #
+  # == Examples
+  #   EXIFR::JPEG.new('IMG_3422.JPG').width         # -> 2272
+  #   EXIFR::JPEG.new('IMG_3422.JPG').exif.model    # -> "Canon PowerShot G3"
+  class JPEG
+    # image height
+    attr_reader :height
+    # image width
+    attr_reader :width
+    # number of bits per ???
+    attr_reader :bits
+    # image comment
+    attr_reader :comment
+    # hash of exif data if available
+    attr_reader :exif
+
+    # +file+ is a filename or an IO object
+    def initialize(file)
+      if file.kind_of? IO
+        examine(file)
+      else
+        File.open(file, 'rb') { |io| examine(io) }
+      end
+    end
+
+    # returns +true+ when EXIF data is available
+    def exif?
+      !exif.nil?
+    end
+
+  private
+    def examine(io)
+      raise 'malformed JPEG' unless io.getc == 0xFF && io.getc == 0xD8 # SOI
+
+      class << io
+        def readint; (readchar << 8) + readchar; end
+        def readframe; read(readint - 2); end
+        def readsof; [readint, readchar, readint, readint, readchar]; end
+        def next
+          c = readchar while c != 0xFF
+          c = readchar while c == 0xFF
+          c
+        end
+      end
+
+      while marker = io.next
+        case marker
+          when 0xC0..0xC3, 0xC5..0xC7, 0xC9..0xCB, 0xCD..0xCF # SOF markers
+            length, @bits, @height, @width, components = io.readsof
+            raise 'malformed JPEG' unless length == 8 + components * 3
+          when 0xD9, 0xDA:  break # EOI, SOS
+          when 0xFE:        @comment = io.readframe # COM
+          when 0xE1:        app1 = io.readframe # APP1, contains EXIF tag
+          else              io.readframe # ignore frame
+        end
+      end
+
+      if app1 && EXIF
+        @exif = EXIF.new(app1[6..-1]) # rescue nil
+      end
+    end
+  end
+end

data/lib/tiff_header.rb

@@ -0,0 +1,75 @@
+# Copyright (c) 2006 - R.W. van 't Veer
+
+module EXIFR
+  class TiffHeader # :nodoc:
+    attr_reader :data, :fields
+
+    def initialize(data, offset = nil)
+      @data = data
+      @fields = []
+
+      class << @data
+        attr_accessor :short, :long
+        def readshort(pos); self[pos..(pos + 1)].unpack(@short)[0]; end
+        def readlong(pos); self[pos..(pos + 3)].unpack(@long)[0]; end
+      end
+
+      case @data[0..1]
+      when 'II'; @data.short, @data.long = 'v', 'V'
+      when 'MM'; @data.short, @data.long = 'n', 'N'
+      else; raise 'no II or MM marker found'
+      end
+
+      readIfds(offset || @data.readlong(4))
+    end
+
+    def readIfds(pos)
+      while pos != 0 do
+        num = @data.readshort(pos)
+        pos += 2
+
+        num.times do
+          fields << TiffField.new(@data, pos)
+          pos += 12
+        end
+
+        pos = @data.readlong(pos)
+      end
+    end
+  end
+
+  class TiffField # :nodoc:
+    attr_reader :tag, :offset, :value
+
+    def initialize(data, pos)
+      @tag, count, @offset = data.readshort(pos), data.readlong(pos + 4), data.readlong(pos + 8)
+
+      case data.readshort(pos + 2)
+      when 1, 6 # byte, signed byte
+        # TODO handle signed bytes
+        len, pack = count, proc { |d| d }
+      when 2 # ascii
+        len, pack = count, proc { |d| d.sub(/\000.*$/, '').strip }
+      when 3, 8 # short, signed short
+        # TODO handle signed
+        len, pack = count * 2, proc { |d| d.unpack(data.short + '*') }
+      when 4, 9 # long, signed long
+        # TODO handle signed
+        len, pack = count * 4, proc { |d| d.unpack(data.long + '*') }
+      when 5, 10
+        len, pack = count * 8, proc do |d|
+          r = []
+          d.unpack(data.long + '*').each_with_index do |v,i|
+            i % 2 == 0 ? r << [v] : r.last << v
+          end
+          r.map{|f| Rational.reduce(*f)}
+        end
+      end
+
+      if len && pack
+        start = len > 4 ? @offset : (pos + 8)
+        @value = pack[data[start..(start + len)]]
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,49 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.8.11
+specification_version: 1
+name: exifr
+version: !ruby/object:Gem::Version 
+  version: "0.9"
+date: 2006-04-14 00:00:00 +02:00
+summary: EXIF Reader is a module to read EXIF from JPEG images.
+require_paths: 
+- lib
+email: remco@remvee.net
+homepage: http://exifr.rubyforge.org/
+rubyforge_project: 
+description: 
+autorequire: exifr
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+authors: 
+- R.W. van 't Veer
+files: 
+- lib/exif.rb
+- lib/exifr.rb
+- lib/jpeg.rb
+- lib/tiff_header.rb
+- README
+test_files: []
+
+rdoc_options: []
+
+extra_rdoc_files: 
+- README
+executables: []
+
+extensions: []
+
+requirements: []
+
+dependencies: []
+