EXIFutils V3.1.4 - 05-February-2011

  Web:   http://www.hugsan.com/EXIFutils
  Email: support@hugsan.com

  Copyright (c) 2000-2011 Hugsan Pty. Ltd. All Rights Reserved.
                                                                          
  See EXIFutilsLicense.rtf for conditions of use of this software.

PACKAGE CONTENTS

  readme.txt                 - the file you are reading now
  EXIFutilsLicense.txt       - license conditions for using this software
  exiflist                   - exiflist executable
  exifdate                   - exifdate executable
  exifcopy                   - exifcopy executable
  exifedit                   - exifedit executable
  exiffile                   - exiffile executable
  exifkey                    - exifkey executable
  exifinstall                - installation script

  docs                       - User Documenation - PDF format

INSTALLING THE EXIF UTILITIES

INSTALLING A FULL RELEASE
If you have an earlier version of EXIFutils installed on your system
it is recommended that you delete all files from that version before
proceeding with the installation of this release.

To install the EXIFutils on a MacOS X system do the following:

1. Download the EXIFutils kit

2. Logon as the user who will be using EXIFutils. The EXIFutils license
   will be installed into the home directory of this user.

3. Open Stuffit and drag the EXIFutils kit onto the "Expand Archives and
   Encoded Files" in the Drag and Drop Area. Save the files in a directory
   on your disk.

4. Open a Terminal Window and change to the directory into which you 
   saved the EXIFutils files, For example, if you saved the EXIFutils
   kit into your Documents directory you would enter:

   cd  ~/Documents/EXIFutilsOSX3.0

5. Run the EXIFutils installation script 'exifinstall'. This will add
   the EXIFutils directory into the execution PATH of your system:

   ./exifinstall

6. Exit the Terminal Window and open a new Terminal Window.

7. If you have purchased a Full Use license for the EXIFutils, open a
   TERMINAL window and run exifkey to install the license:

   exifkey -k 1234567890123 -u "John Smith" -e john@smith.com 

   The license key, user name, and email address must be entered exactly 
   as shown in the registration information you received.

   If you have purchased an upgrade license key to upgrade from V2.x,
   and your V2.x license is already installed on the system, then the 
   above command will upgrade your license to V3.

   If your V2.x license is NOT installed on the system, use the following
   command to upgrade your license
  
   exifkey -k 1234567890123 -u "John Smith" -e john@smith.com -o 1234567890123

   where the -k option specifies the V3.0 license key and the -o option
   specifies the V2.x license key


USING EXIF UTILITIES
 
  See the User Guide for a complete description of how to use the 
  EXIFutils.
  
  Basic usage information can be displayed using the -h option on all
  commands, eg:

     exiflist -h | more

REPORTING PROBLEMS

  Please report any problems to support@hugsan.com

VERSION HISTORY

V3.1
  Feature Changes
  - Add support for all IPTC4XMP Core fields and most IPTC4XMP Extension 
    fields. Not all IPTC4XMP Extension fields can be supported as EXIFutils
    does not yet support sequencess ("Bags") of structures, or structures
    with multiple levels of subfields.
  - Add support for PLUS XMP fields
  - Add support additional Olympus .ORF file headers
  - Change behaviour of exifedit /r option. This option will now delete all
    occurences of the specified field(s), not just the first occurence. In 
    practice this will only affect multi-image files.
  - Generic TIF IFDs will now be reported with the name "Generic IFD". 
    Previously they were displayed as "Unknown".
  - Tidied up formatting of XMP fields in exifinfo /f display.
  - Accept XMP dates that do not include the seconds field (sometime 
    produced by Photoshop CS3).
  Bug Fixes
  - Fix buffer overrun when serializing XMP data that is exactly the 
    length as the buffer
  - Fix "Attempt to write past end of buffer..." error when processing
    multi-page TIF files that contain large numbers of image IFDs at the
    same level.
  - Fix "Error: Write failed for output file..." message that occurred when
    deleting a field when no fields of that type existed (eg: when deleting
    an IPTC field when there were no IPTC fields in the file).
  - Fix bug in exifedit -t a option (generate thumbnail). The generated 
    thumbnail always had it's Orientation field set to "Upper Left" when 
    it should have been set to the same orientation as the main image.
  - Correct errors in definition of i4x-country-code and i4x-subj-code
    fields.

V3.0
  New Features
    - Added support for MacOS X on Intel based platforms
    - Add support for Adobe XMP meta data, including:
      o Reading, adding and removing XMP fields
      o Assigning values from legacy EXIF and IPTC metadata fields to their
        XMP equivalents, and vice versa. 
      o Assigning multiple language string values to fields defined as 
        "language alternate" fields. 
      o Setting a default language other than English. 
    - Added support for the following file types:
      o Adobe Digital Negative (.DNG) - read/write
      o Olympus Raw (.ORF) - read only
      o Sony Raw (.ARW) - read only
    - Improvments to exiflist command.
      o Added new display options:
        - The /o dn option displays the nicknames and values of all fields 
          present in the image file in an easy to read format 
        - The /o x display the serialized XMP datas block stored in the image
          file.
      o Simplified exiflist by removing the following options:
        - /l (display field definitions) 
        - /i (display character set settings).
        The functionality provided by these options have been moved to the 
        new exifinfo command.
      o The comma/tab separated list output format (/o l, /o ln, and /o lh 
        options) now allows you to list all fields present in a file. 
        Previously only fields for which EXIFutils had a definition could be 
        listed.
      o Can now list the values of EXIF fields for which EXIFutils does not 
        have a definition. Previously only fields which were known to EXIFutils
        could be listed. These unknown fields are referenced by using their tag
        number, eg tag-01ad
      o Change behaviour of exiflist /o ln and /o lf option. Any selected 
        fields that are not present in the image file will be shown as having
        a null value. Previously the field would have been ommitted from the 
        output.
    - Added exifinfo command to display:
      o Meta data field definitions
      o EXIFutils settings, environment variables, and default values
      o The names of known XMP Schemas 
    - Remove the limit on the number of files that can be edited in a single 
      directory (previously limited to 1000)
    - Improved installation on Windows:
      o "Check for Update" option added to Windows installation allow for 
        checking for new versions of EXIFutils.
      o More reliable setting of PATH environment variable during installation. 
    - Updated many Maker Note field definitions to include fields/values from 
      newer cameras
  o Bug Fixes
    - Fix problems in the display of GPS values:
      o Seconds values in latitudes and longitudes were incorrectly being 
        ommitted even when minutes values were whole numbers.
      o Leading zeroes were missing from some date/time values.
    - Fix bug in exifdate when subtracting 59 minutes from a minute value of 00
    - Fix bug in setting of IPTC string field values. A null byte was 
      incorrectly being appended to values.
    - Remove "buf_p" debugging message that was incorrectly output to stdout 
      after a "Maker Note prefix is incorrect" warning was issued.
