mini_exiftool 2.8.0 → 2.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 3b9e96de32763ccdb88cf04f5227edfe743528f2
-  data.tar.gz: d8d478046af5e4ac9919273f9b8e9e0e6e05d5cb
+  metadata.gz: c2559eebe29019af3b0994df1a77e99b5bdea856
+  data.tar.gz: 67896c8639c4c237c4943d9aa51aa20598a9c9f2
 SHA512:
-  metadata.gz: c554bc5145031425c2369f8eb6ba89c64c469dd223b4d7a70fe98737b8e1a92f1694bd6b46c4172ae7ef6b165e7e0b7898fbaf3e14a0e49b566c094d870071c8
-  data.tar.gz: c3b5f2b84be63c556a731252fb53107a50692c79867d42c2bf5825d24e7c076aec34ad4069e27b74f66267454ba5c12fb8157eb7ac8f62c5ce4f2eb1075e5f74
+  metadata.gz: e73616156d2107208f35f9df53c644b7e8f4c397b4dfbe8af1ff5fe3651ee37c2e3c152c373dc9ce10b73162ea8ee0ba2543c433ebc79d23a0bca7de38fe010a
+  data.tar.gz: aec0a216d53f767fc4a1b6d2fc0fab00189a33ae8de4e34474008fd472fc99f152ddd832d17dfef7964864978a60a05c65b17b6f9249d8c17264f004a33afe8c

data/Changelog

@@ -1,3 +1,7 @@
+2.8.1
+- Improve documentation and use Integer instead of Fixnum because it's
+  deprecated in Ruby 2.4.0.
+
 2.8.0
 - MiniExiftool doesn't close any longer a given IO to MiniExiftool.new
   respectively MiniExiftool#load. You are responsible to do that.

data/README.md

@@ -0,0 +1,181 @@
+# MiniExiftool
+
+This library is a wrapper for the ExifTool command-line application
+(http://www.sno.phy.queensu.ca/~phil/exiftool) written by Phil Harvey.
+It provides the full power of ExifTool to Ruby: reading and writing of
+EXIF-data, IPTC-data and XMP-data.
+
+## Requirements
+
+Ruby 1.9 or higher and an installation of the ExifTool
+command-line application at least version 7.65.
+If you run on Ruby 1.8 or with a prior exiftool version
+install mini_exiftool version 1.x.x.
+Instructions for installation you can find under
+http://www.sno.phy.queensu.ca/~phil/exiftool/install.html .
+
+Alternatively Wil Gieseler has bundled a meta-gem that eliminates the
+need for a separate ExifTool installation. Have a look at
+http://github.com/wilg/mini_exiftool_vendored or
+http://rubygems.org/gems/mini_exiftool_vendored .
+
+## Installation
+
+First you need ExifTool (see under Requirements above). Then you can simply
+install the gem with
+```sh
+gem install mini_exiftool
+```
+or simply add to the following to your Gemfile:
+```ruby
+gem 'multi_exiftool'
+```
+
+If you need to support older versions of Ruby or Exiftool (see Requirements above)
+
+```sh
+gem install --version "< 2.0.0" mini_exiftool
+```
+
+or if you use a Gemfile add:
+
+```ruby
+gem 'multi_exiftool', '<2.0.0'
+```
+
+## Configuration
+
+You can manually set the exiftool command that should be used via
+
+```ruby
+MiniExiftool.command = '/path/to/my/exiftool'
+```
+
+In addition, you can also tell MiniExiftool where to store the PStore files with tags
+which exiftool supports. The PStore files are used for performance issues.
+Per default the PStore files are stored in a sub directory `.mini_exiftool` or
+`_mini_exiftool` under your home directory.
+
+```ruby
+MiniExiftool.pstore_dir = '/path/to/pstore/dir'
+```
+
+If you're using Rails, this is easily done with
+
+```ruby
+MiniExiftool.pstore_dir = Rails.root.join('tmp').to_s
+```
+
+Important hint: if you have to change the configuration you have to do this direct
+after `require 'mini_exiftool'`.
+
+## Usage
+
+In general MiniExiftool is very intuitive to use as the following examples show:
+
+```ruby
+# Reading meta data from a file
+photo = MiniExiftool.new 'photo.jpg'
+puts photo.title
+
+# Alternative reading meta data from an IO instance
+photo = MiniExiftool.new io
+puts photo.title
+
+# Writing meta data
+photo = MiniExiftool.new 'photo.jpg'
+photo.title = 'This is the new title'
+photo.save
+
+# Copying meta data
+photo = MiniExiftool.new('photo.jpg')
+photo.copy_tags_from('another_photo.jpg', :author)
+```
+
+For further information about using MiniExiftool read the Tutorial.md.
+in the project root folder and have a look at the examples in directory
+examples.
+
+## Caveats
+
+The philosophy of MiniExiftool is safety over performance.
+It can not handle more than one file at once. Writing operations are
+executed on a copy of the original file to have atomar writing: Either
+all changed values are written or none.
+To be able to assign errors to a specific tag writing operations also call
+the Exiftool command-line application once for each changed tag!
+
+In short: MiniExiftool has a very bad performance especially at write operations.
+
+**If you work with many files it is strongly recommended not to use MiniExiftool
+but instead my other gem [MultiExiftool](https://github.com/janfri/multi_exiftool).
+This is designed to handle many files and do reading and writing fast.**
+
+## Encodings
+
+In MiniExiftool all strings are encoded in UTF-8. If you need other
+encodings in your project use the String#encod* methods.
+
+If you have problems with corrupted strings when using MiniExiftool
+there are two reasons for this:
+
+### Internal character sets
+
+You can specify the charset in which the meta data is in the file encoded
+if you read or write to some sections of meta data (i.e. IPTC, XMP ...).
+It exists various options of the form *_encoding: exif, iptc, xmp, png,
+id3, pdf, photoshop, quicktime, aiff, mie and vorbis.
+
+For IPTC meta data it is recommended to set also the CodedCharacterSet
+tag.
+
+Please read the section about the character sets of the ExifTool command
+line application carefully to understand what's going on
+(http://www.sno.phy.queensu.ca/~phil/exiftool/faq.html#Q10)!
+
+```ruby
+# Using UTF-8 as internal encoding for IPTC tags and MacRoman
+# as internal encoding for EXIF tags
+photo = MiniExiftool.new('photo.jpg', iptc_encoding: 'UTF8',
+                         exif_encoding: 'MacRoman'
+# IPTC CaptionAbstract is already UTF-8 encoded
+puts photo.caption_abstract
+# EXIF Comment is converted from MacRoman to UTF-8
+puts photo.comment
+
+photo = MiniExiftool.new('photo.jpg', iptc_encoding: 'UTF8',
+                         exif_encoding: 'MacRoman'
+# When saving IPTC data setting CodedCharacterSet as recommended
+photo.coded_character_set = 'UTF8'
+# IPTC CaptionAbstract will be stored in UTF-8 encoding
+photo.caption_abstract = 'Some text with Ümläuts'
+# EXIF Comment will be stored in MacRoman encoding
+photo.comment = 'Comment with Ümläuts'
+photo.save
+```
+
+### Corrupt characters
+
+You use the correct internal character set but in the string are still corrupt
+characters.
+This problem you can solve with the option `replace_invalid_chars`:
+
+```ruby
+# Replace all invalid characters with a question mark
+photo = MiniExiftool.new('photo.jpg', replace_invalid_chars: '?')
+```
+
+## Contribution
+
+The code is hosted in a git repository on github at
+https://github.com/janfri/mini_exiftool
+feel free to contribute!
+
+## Author
+Jan Friedrich <janfri26@gmail.com>
+
+## Copyright / License
+Copyright (c) 2007-2016 by Jan Friedrich
+
+Licensed under terms of the GNU LESSER GENERAL PUBLIC LICENSE, Version 2.1,
+February 1999 (see file COPYING for more details)

data/Rakefile

@@ -19,7 +19,7 @@ EXIF-data, IPTC-data and XMP-data.
   END
   p.homepage = 'https://github.com/janfri/mini_exiftool'
   p.license = 'LGPL-2.1'
-  p.gem_files << 'Tutorial.rdoc'
+  p.gem_files << 'Tutorial.md'
   p.gem_files += FileList.new('examples/**')
   p.install_message = <<-END
 +-----------------------------------------------------------------------+

data/Tutorial.md

@@ -0,0 +1,215 @@
+# Mini Tutorial
+
+
+## Installation
+
+* Installing the ExifTool command-line application from Phil Harvey
+  (see http://www.sno.phy.queensu.ca/~phil/exiftool/install.html)
+* Installing the Ruby library (`gem install mini_exiftool`)
+
+
+## Lesson 1: Reading Meta Data
+
+### A Simple Example
+
+```ruby
+require 'mini_exiftool'
+
+photo = MiniExiftool.new 'photo.jpg'
+puts photo['DateTimeOriginal']
+```
+
+### Smart Tag Names
+In the example above we use `photo['DateTimeOriginal']` to
+get the value for the time the photo was taken. But tag names are not
+case sensitive and additional underlines are also irrelevant. So
+following expressions are equivalent:
+```ruby
+photo['DateTimeOriginal']
+photo['datetimeoriginal']
+photo['date_time_original']
+```
+
+It is also possible to use symbols:
+```ruby
+ photo[:DateTimeOriginal]
+ photo[:datetimeoriginal]
+ photo[:date_time_original]
+```
+
+### Nicer Access Via Dynamic Methods
+
+Using the []-method is the safest way to access to values of tags
+(e. g. Self-timer you can only access this way) but the smarter way is
+using dynamic method access. You can write:
+```ruby
+photo.datetimeoriginal
+```
+or also
+```ruby
+photo.date_time_original
+```
+
+### Value Types
+
+Following types of values are at the moment supported:
+* Array (e. g. Keywords => ['tree', 'gras'])
+* Integer (e. g. ISO => 400)
+* Float (e. g. FNumber => 9.5)
+* String (e. g. Model => DYNAX 7D)
+* Time (e. g. DateTimeOriginal => 2005:09:13 20:08:50)
+
+Be aware, if there is only one value in a tag which can hold multiple
+values the result isn't an array! But you can get one with the Array
+method:
+```ruby
+# only _one_ keyword
+p1 = MiniExiftool.new 'p1.jpg'
+p1.keywords # => 'red'
+# _more than one_ keywords
+p3 = MiniExiftool.new 'p3.jpg'
+p3.keywords # => ['red', 'yellow', 'green']
+
+# if we want to get an array in both cases and don't know
+# if there is one ore more values set let's take Array()
+Array(p1.keywords) # => ['red']
+Array(p3.keywords) # => ['red', 'yellow', 'green']
+```
+
+### Using options
+
+The ExifTool command-line application has an option (-n) to get values
+as numbers if possible, in MiniExiftool you can do this with setting
+the `:numerical` option to `true` while generating a new
+instance with new or using the `numerical=`-method
+combining with calling `reload`.
+
+Let's look at an example:
+```ruby
+# standard: numerical is false
+photo = MiniExiftool.new 'photo.jpg'
+photo.exposure_time # => '1/60 (Rational)
+# now with numerical is true
+photo.numerical = true
+photo.reload
+photo.exposure_time # => 0.01666667 (Float)
+```
+
+This behaviour can be useful if you want to do calculations on the
+value, if you only want to show the value the standard behaviour is
+maybe better.
+
+The Time class of Ruby cannot handle timestamps before 1st January 1970
+on some platforms. If there are timestamps in files before this date it
+will result in an error. In this case we can set the option
+`:timestamps` to `DateTime` to use DateTime objects instead
+of Time objects.
+
+There is another option `:composite`. If this is set to
+`false` the composite tags are not calculated by the exiftool
+command-line application (option -e).
+
+Further options are
+* `:ignore_minor_errors` to ignore minor
+  errors (See -m-option of the exiftool command-line application,
+  default is `false`)
+* `:coord_format` set format for GPS coordinates (See
+  -c-option of the exiftool command-line application, default is `nil`
+  that means exiftool standard)
+* `:fast` useful when reading JPEGs over a slow network connection
+  (See -fast-option of the exiftool command-line application, default is `false`)
+* `:fast2` useful when reading JPEGs over a slow network connection
+  (See -fast2-option of the exiftool command-line application, default is `false`)
+* `:replace_invalid_chars` replace string for invalid
+  UTF-8 characters or `false` if no replacing should be done,
+  default is `false`
+* `:exif_encoding`, `:iptc_encoding`,
+  `:xmp_encoding`, `:png_encoding`,
+  `:id3_encoding`, `:pdf_encoding`,
+  `:photoshop_encoding`, `:quicktime_encoding`,
+  `:aiff_encoding`, `:mie_encoding`,
+  `:vorbis_encoding` to set this specific encoding (see
+  -charset option of the exiftool command-line application, default is
+  `nil`: no encoding specified)
+
+### Using an IO instance
+
+```ruby
+require 'mini_exiftool'
+require 'open3'
+
+# Using external curl command
+input, output = Open3.popen2("curl -s http://www.url.of.a.photo")
+input.close
+photo = MiniExiftool.new output
+puts photo['ISO']
+```
+
+The kind of the parameter `filename_or_io` is determined via duck typing:
+if the argument responds to `to_str` it is interpreted as filename, if it
+responds to `read` it is interpreted es IO instance.
+Attention: If you use an IO instance then writing of values is not supported!
+
+Look at the show_speedup_with_fast_option example in the MiniExiftool examples
+directory for more details about using an IO instance.
+
+
+## Lesson 2: Writing Meta Data
+
+### Also A Very Simple Example
+
+```ruby
+require 'mini_exiftool'
+
+photo = MiniExiftool.new 'photo.jpg'
+photo.comment = 'hello world'
+photo.save
+```
+
+
+### Save Is Atomar
+
+If you have changed several values and call the `save`-method either
+all changes will be written to the file or nothing. The return value
+of the `save`-method is `true` if all values are written to the file
+otherwise save returns `false`. In the last case you can use the
+`errors`-method which returns a hash of the tags which values couldn't
+be written with an error message for each of them.
+
+
+### Interesting Methods
+
+Have a look at the `changed?`-method for checking if the
+value of a specific tag is changed or a changing in general is
+done. In the same way the `revert`-method reverts the value of a
+specific tag or in general all changes.
+
+You should also look at the rdoc information of MiniExiftool.
+
+
+## Lesson 3: Copying Meta Data
+
+### Examples
+
+```ruby
+require 'mini_exiftool'
+
+photo = MiniExiftool.new('photo.jpg')
+
+# Update the author tag of photo.jpg with the value of the author tag
+# of another_photo.jpg
+photo.copy_tags_from('another_photo.jpg', 'Author')
+
+# It's also possible to use symbols and case is also not meaningful
+photo.copy_tags_from('another_photo.jpg', :author)
+
+# Further more than one tag can be copied at once
+photo.copy_tags_from('another_photo', %w[author copyright])
+```
+
+Look at the file copy_icc_profile.rb in the examples folder of MiniExiftool.
+
+
+## Further Examples
+
+Have a look in the examples folder of MiniExiftool.

data/lib/mini_exiftool.rb

@@ -26,7 +26,7 @@ require 'time'
 # Simple OO access to the ExifTool command-line application.
 class MiniExiftool
 
-  VERSION = '2.8.0'
+  VERSION = '2.8.1'
 
   # Name of the ExifTool command-line application
   @@cmd = 'exiftool'

data/test/test_from_hash.rb

@@ -13,7 +13,7 @@ class TestFromHash < TestCase
     assert_kind_of Time, @mini_exiftool['DateTimeOriginal']
     assert_kind_of Float, @mini_exiftool['MaxApertureValue']
     assert_kind_of String, @mini_exiftool.flash
-    assert_kind_of Fixnum, @mini_exiftool['ExposureCompensation']
+    assert_kind_of Integer, @mini_exiftool['ExposureCompensation']
     assert_kind_of String, (@mini_exiftool['SubjectLocation'] || @mini_exiftool['SubjectArea'])
     assert_kind_of Array, @mini_exiftool['Keywords']
     assert_kind_of String, @mini_exiftool['SupplementalCategories']

data/test/test_read.rb

@@ -27,7 +27,7 @@ class TestRead < TestCase
     assert_kind_of Time, @mini_exiftool['DateTimeOriginal']
     assert_kind_of Float, @mini_exiftool['MaxApertureValue']
     assert_kind_of String, @mini_exiftool.flash
-    assert_kind_of Fixnum, @mini_exiftool['ExposureCompensation']
+    assert_kind_of Integer, @mini_exiftool['ExposureCompensation']
     assert_kind_of String, (@mini_exiftool['SubjectLocation'] || @mini_exiftool['SubjectArea'])
     assert_kind_of Array, @mini_exiftool['Keywords']
     assert_kind_of String, @mini_exiftool['SupplementalCategories']

data/test/test_read_numerical.rb

@@ -22,9 +22,9 @@ class TestReadNumerical < TestCase
     assert_kind_of String, @mini_exiftool_num.model
     assert_kind_of Time, @mini_exiftool_num['DateTimeOriginal']
     assert_kind_of Float, @mini_exiftool_num['MaxApertureValue']
-    assert_kind_of Fixnum, @mini_exiftool_num.flash
+    assert_kind_of Integer, @mini_exiftool_num.flash
     assert_kind_of String, @mini_exiftool_num.exif_version
-    assert_kind_of Fixnum, @mini_exiftool_num['ExposureCompensation']
+    assert_kind_of Integer, @mini_exiftool_num['ExposureCompensation']
     assert_kind_of String, (@mini_exiftool_num['SubjectLocation'] || @mini_exiftool_num['SubjectArea'])
     assert_kind_of Array, @mini_exiftool_num['Keywords']
     assert_kind_of String, @mini_exiftool_num['SupplementalCategories']

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mini_exiftool
 version: !ruby/object:Gem::Version
-  version: 2.8.0
+  version: 2.8.1
 platform: ruby
 authors:
 - Jan Friedrich
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-09-12 00:00:00.000000000 Z
+date: 2017-08-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rim
@@ -78,9 +78,9 @@ extra_rdoc_files: []
 files:
 - COPYING
 - Changelog
-- README.rdoc
+- README.md
 - Rakefile
-- Tutorial.rdoc
+- Tutorial.md
 - examples/copy_icc_profile.rb
 - examples/external_photo.rb
 - examples/print_portraits.rb
@@ -146,7 +146,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.6
+rubygems_version: 2.6.12
 signing_key: 
 specification_version: 4
 summary: This library is a wrapper for the ExifTool command-line application (http://www.sno.phy.queensu.ca/~phil/exiftool).

data/README.rdoc

@@ -1,137 +0,0 @@
-= MiniExiftool
-
-This library is a wrapper for the ExifTool command-line application
-(http://www.sno.phy.queensu.ca/~phil/exiftool) written by Phil Harvey.
-It provides the full power of ExifTool to Ruby: reading and writing of
-EXIF-data, IPTC-data and XMP-data.
-
-== Requirements
-
-Ruby 1.9 or higher and an installation of the ExifTool
-command-line application at least version 7.65.
-If you run on Ruby 1.8 or with a prior exiftool version
-install mini_exiftool version 1.x.x.
-Instructions for installation you can find under
-http://www.sno.phy.queensu.ca/~phil/exiftool/install.html .
-
-Alternatively Wil Gieseler has bundled a meta-gem that eliminates the
-need for a separate ExifTool installation. Have a look at
-http://github.com/wilg/mini_exiftool_vendored or
-http://rubygems.org/gems/mini_exiftool_vendored .
-
-== Installation
-
-First you need ExifTool (see under Requirements above). Then you can simply
-install the gem with
- gem install mini_exiftool
-
-If you need to support older versions of Ruby or exiftool (see Requirements above)
-  gem install --version "< 2.0.0" mini_exiftool
-
-== Configuration
-
-You can manually set the exiftool command that should be used via
-  MiniExiftool.command = '/path/to/my/exiftool'
-
-In addition, you can also tell MiniExiftool where to store the PStore files with tags
-which exiftool supports. The PStore files are used for performance issues.
-Per default the PStore files are stored in a sub directory .mini_exiftool or
-_mini_exiftool under your home directory.
-  MiniExiftool.pstore_dir = '/path/to/pstore/dir'
-
-If you're using Rails, this is easily done with
-  MiniExiftool.pstore_dir = Rails.root.join('tmp').to_s
-
-Important hint: if you have to change the configuration you have to do this direct
-after require 'mini_exiftool'.
-
-== Usage
-
-In general MiniExiftool is very intuitive to use as the following examples show:
-
- # Reading meta data from a file
- photo = MiniExiftool.new 'photo.jpg'
- puts photo.title
-
- # Alternative reading meta data from an IO instance
- photo = MiniExiftool.new io
- puts photo.title
-
- # Writing meta data
- photo = MiniExiftool.new 'photo.jpg'
- photo.title = 'This is the new title'
- photo.save
-
- # Copying meta data
- photo = MiniExiftool.new('photo.jpg')
- photo.copy_tags_from('another_photo.jpg', :author)
-
-
-For further information about using MiniExiftool read the Tutorial.rdoc
-in the project root folder and have a look at the examples in directory
-examples.
-
-== Encodings
-
-In MiniExiftool all strings are encoded in UTF-8. If you need other
-encodings in your project use the String#encod* methods.
-
-If you have problems with corrupted strings when using MiniExiftool
-there are two reasons for this:
-
-=== Internal character sets
-
-You can specify the charset in which the meta data is in the file encoded
-if you read or write to some sections of meta data (i.e. IPTC, XMP ...).
-It exists various options of the form *_encoding: exif, iptc, xmp, png,
-id3, pdf, photoshop, quicktime, aiff, mie and vorbis.
-
-For IPTC meta data it is recommended to set also the CodedCharacterSet
-tag.
-
-Please read the section about the character sets of the ExifTool command
-line application carefully to understand what's going on
-(http://www.sno.phy.queensu.ca/~phil/exiftool/faq.html#Q10)!
-
- # Using UTF-8 as internal encoding for IPTC tags and MacRoman
- # as internal encoding for EXIF tags
- photo = MiniExiftool.new('photo.jpg', iptc_encoding: 'UTF8',
-                          exif_encoding: 'MacRoman'
- # IPTC CaptionAbstract is already UTF-8 encoded
- puts photo.caption_abstract
- # EXIF Comment is converted from MacRoman to UTF-8
- puts photo.comment
-
- photo = MiniExiftool.new('photo.jpg', iptc_encoding: 'UTF8',
-                          exif_encoding: 'MacRoman'
- # When saving IPTC data setting CodedCharacterSet as recommended
- photo.coded_character_set = 'UTF8'
- # IPTC CaptionAbstract will be stored in UTF-8 encoding
- photo.caption_abstract = 'Some text with Ümläuts'
- # EXIF Comment will be stored in MacRoman encoding
- photo.comment = 'Comment with Ümläuts'
- photo.save
-
-=== Corrupt characters
-
-You use the correct internal character set but in the string are still corrupt
-characters.
-This problem you can solve with the option replace_invalid_chars:
-
- # Replace all invalid characters with a question mark
- photo = MiniExiftool.new('photo.jpg', replace_invalid_chars: '?')
-
-== Contribution
-
-The code is hosted in a git repository on github at
-https://github.com/janfri/mini_exiftool
-feel free to contribute!
-
-== Author
-Jan Friedrich <janfri26@gmail.com>
-
-== Copyright / License
-Copyright (c) 2007-2016 by Jan Friedrich
-
-Licensed under terms of the GNU LESSER GENERAL PUBLIC LICENSE, Version 2.1,
-February 1999 (see file COPYING for more details)

data/Tutorial.rdoc

@@ -1,194 +0,0 @@
-= Mini Tutorial
-
-
-== Installation
-
-* Installing the ExifTool command-line application from Phil Harvey
-  (see http://www.sno.phy.queensu.ca/~phil/exiftool/install.html)
-* Installing the Ruby library (<code>gem install mini_exiftool</code>)
-
-
-== Lesson 1: Reading Meta Data
-
-=== A Simple Example
-
- require 'mini_exiftool'
-
- photo = MiniExiftool.new 'photo.jpg'
- puts photo['DateTimeOriginal']
-
-=== Smart Tag Names
-In the example above we use <code>photo['DateTimeOriginal']</code> to
-get the value for the time the photo was taken. But tag names are not
-case sensitive and additional underlines are also irrelevant. So
-following expressions are equivalent:
- photo['DateTimeOriginal']
- photo['datetimeoriginal']
- photo['date_time_original']
-
-It is also possible to use symbols:
- photo[:DateTimeOriginal]
- photo[:datetimeoriginal]
- photo[:date_time_original]
-
-=== Nicer Access Via Dynamic Methods
-
-Using the []-method is the safest way to access to values of tags
-(e. g. Self-timer you can only access this way) but the smarter way is
-using dynamic method access. You can write:
- photo.datetimeoriginal
-or also
- photo.date_time_original
-
-=== Value Types
-
-Following types of values are at the moment supported:
-* Array (e. g. Keywords => ['tree', 'gras'])
-* Fixnum (e. g. ISO => 400)
-* Float (e. g. FNumber => 9.5)
-* String (e. g. Model => DYNAX 7D)
-* Time (e. g. DateTimeOriginal => 2005:09:13 20:08:50)
-
-Be aware, if there is only one value in a tag which can hold multiple
-values the result isn't an array! But you can get one with the Array
-method:
-  # only _one_ keyword
-  p1 = MiniExiftool.new 'p1.jpg'
-  p1.keywords # => 'red'
-  # _more than one_ keywords
-  p3 = MiniExiftool.new 'p3.jpg'
-  p3.keywords # => ['red', 'yellow', 'green']
-
-  # if we want to get an array in both cases and don't know
-  # if there is one ore more values set let's take Array()
-  Array(p1.keywords) # => ['red']
-  Array(p3.keywords) # => ['red', 'yellow', 'green']
-
-=== Using options
-
-The ExifTool command-line application has an option (-n) to get values
-as numbers if possible, in MiniExiftool you can do this with setting
-the <code>:numerical</code> option to +true+ while generating a new
-instance with new or using the <code>numerical=</code>-method
-combining with calling <code>reload</code>.
-
-Let's look at an example:
- # standard: numerical is false
- photo = MiniExiftool.new 'photo.jpg'
- photo.exposure_time # => '1/60' (String)
- # now with numerical is true
- photo.numerical = true
- photo.reload
- photo.exposure_time # => 0.01666667 (Float)
-This behaviour can be useful if you want to do calculations on the
-value, if you only want to show the value the standard behaviour is
-maybe better.
-
-The Time class of Ruby cannot handle timestamps before 1st January 1970
-on some platforms. If there are timestamps in files before this date it
-will result in an error. In this case we can set the option
-<code>:timestamps</code> to +DateTime+ to use DateTime objects instead
-of Time objects.
-
-There is another option <code>:composite</code>. If this is set to
-+false+ the composite tags are not calculated by the exiftool
-command-line application (option -e).
-
-Further options are
-* <code>:ignore_minor_errors</code> to ignore minor
-  errors (See -m-option of the exiftool command-line application,
-  default is +false+)
-* <code>:coord_format</code> set format for GPS coordinates (See
-  -c-option of the exiftool command-line application, default is +nil+
-  that means exiftool standard)
-* <code>:fast</code> useful when reading JPEGs over a slow network connection
-  (See -fast-option of the exiftool command-line application, default is +false+)
-* <code>:fast2</code> useful when reading JPEGs over a slow network connection
-  (See -fast2-option of the exiftool command-line application, default is +false+)
-* <code>:replace_invalid_chars</code> replace string for invalid
-  UTF-8 characters or +false+ if no replacing should be done,
-  default is +false+
-* <code>:exif_encoding</code>, <code>:iptc_encoding</code>,
-  <code>:xmp_encoding</code>, <code>:png_encoding</code>,
-  <code>:id3_encoding</code>, <code>:pdf_encoding</code>,
-  <code>:photoshop_encoding</code>, <code>:quicktime_encoding</code>,
-  <code>:aiff_encoding</code>, <code>:mie_encoding</code>,
-  <code>:vorbis_encoding</code> to set this specific encoding (see
-  -charset option of the exiftool command-line application, default is
-  +nil+: no encoding specified)
-
-=== Using an IO instance
-
- require 'mini_exiftool'
- require 'open3'
-
- # Using external curl command
- input, output = Open3.popen2("curl -s http://www.url.of.a.photo")
- input.close
- photo = MiniExiftool.new output
- puts photo['ISO']
-
-The kind of the parameter +filename_or_io+ is determined via duck typing:
-if the argument responds to +to_str+ it is interpreted as filename, if it
-responds to +read+ it is interpreted es IO instance.
-Attention: If you use an IO instance then writing of values is not supported!
-
-Look at the show_speedup_with_fast_option example in the MiniExiftool examples
-directory for more details about using an IO instance.
-
-
-== Lesson 2: Writing Meta Data
-
-=== Also A Very Simple Example
-
- require 'mini_exiftool'
-
- photo = MiniExiftool.new 'photo.jpg'
- photo.comment = 'hello world'
- photo.save
-
-
-=== Save Is Atomar
-
-If you have changed several values and call the +save+-method either
-all changes will be written to the file or nothing. The return value
-of the +save+-method is +true+ if all values are written to the file
-otherwise save returns +false+. In the last case you can use the
-+errors+-method which returns a hash of the tags which values couldn't
-be written with an error message for each of them.
-
-
-=== Interesting Methods
-
-Have a look at the <code>changed?</code>-method for checking if the
-value of a specific tag is changed or a changing in general is
-done. In the same way the +revert+-method reverts the value of a
-specific tag or in general all changes.
-
-You should also look at the rdoc information of MiniExiftool.
-
-
-== Lesson 3: Copying Meta Data
-
-=== Examples
-
- require 'mini_exiftool'
-
- photo = MiniExiftool.new('photo.jpg')
-
- # Update the author tag of photo.jpg with the value of the author tag
- # of another_photo.jpg
- photo.copy_tags_from('another_photo.jpg', 'Author')
-
- # It's also possible to use symbols and case is also not meaningful
- photo.copy_tags_from('another_photo.jpg', :author)
-
- # Further more than one tag can be copied at once
- photo.copy_tags_from('another_photo', %w[author copyright])
-
-Look at the file copy_icc_profile.rb in the examples folder of MiniExiftool.
-
-
-== Further Examples
-
-Have a look in the examples folder of MiniExiftool.