rjhead 2.88.1 → 2.88.2

data/ext/gpsinfo.c

@@ -1,217 +0,0 @@
-//--------------------------------------------------------------------------
-// Parsing of GPS info from exif header.
-//
-// Matthias Wandel,  Dec 1999 - Dec 2002 
-//--------------------------------------------------------------------------
-#include "jhead.h"
-
-#define MAX_GPS_TAG 0x1e
-
-
-#define TAG_GPS_LAT_REF    1
-#define TAG_GPS_LAT        2
-#define TAG_GPS_LONG_REF   3
-#define TAG_GPS_LONG       4
-#define TAG_GPS_ALT_REF    5
-#define TAG_GPS_ALT        6
-
-
-static const char * GpsTags[MAX_GPS_TAG+1]= {
-    "VersionID       ",//0x00  
-    "LatitudeRef     ",//0x01  
-    "Latitude        ",//0x02  
-    "LongitudeRef    ",//0x03  
-    "Longitude       ",//0x04  
-    "AltitudeRef     ",//0x05  
-    "Altitude        ",//0x06  
-    "TimeStamp       ",//0x07  
-    "Satellites      ",//0x08  
-    "Status          ",//0x09  
-    "MeasureMode     ",//0x0A  
-    "DOP             ",//0x0B  
-    "SpeedRef        ",//0x0C  
-    "Speed           ",//0x0D  
-    "TrackRef        ",//0x0E  
-    "Track           ",//0x0F  
-    "ImgDirectionRef ",//0x10  
-    "ImgDirection    ",//0x11  
-    "MapDatum        ",//0x12  
-    "DestLatitudeRef ",//0x13  
-    "DestLatitude    ",//0x14  
-    "DestLongitudeRef",//0x15  
-    "DestLongitude   ",//0x16  
-    "DestBearingRef  ",//0x17  
-    "DestBearing     ",//0x18  
-    "DestDistanceRef ",//0x19  
-    "DestDistance    ",//0x1A  
-    "ProcessingMethod",//0x1B  
-    "AreaInformation ",//0x1C  
-    "DateStamp       ",//0x1D  
-    "Differential    ",//0x1E
-};
-
-//--------------------------------------------------------------------------
-// Process GPS info directory
-//--------------------------------------------------------------------------
-void ProcessGpsInfo(unsigned char * DirStart, int ByteCountUnused, unsigned char * OffsetBase, unsigned ExifLength)
-{
-    int de;
-    unsigned a;
-    int NumDirEntries;
-
-    NumDirEntries = Get16u(DirStart);
-    #define DIR_ENTRY_ADDR(Start, Entry) (Start+2+12*(Entry))
-
-    if (ShowTags){
-        printf("(dir has %d entries)\n",NumDirEntries);
-    }
-
-    ImageInfo.GpsInfoPresent = TRUE;
-    strcpy(ImageInfo.GpsLat, "? ?");
-    strcpy(ImageInfo.GpsLong, "? ?");
-    ImageInfo.GpsAlt[0] = 0; 
-
-    for (de=0;de<NumDirEntries;de++){
-        unsigned Tag, Format, Components;
-        unsigned char * ValuePtr;
-        int ComponentSize;
-        unsigned ByteCount;
-        unsigned char * DirEntry;
-        DirEntry = DIR_ENTRY_ADDR(DirStart, de);
-
-        if (DirEntry+12 > OffsetBase+ExifLength){
-            ErrNonfatal("GPS info directory goes past end of exif",0,0);
-            return;
-        }
-
-        Tag = Get16u(DirEntry);
-        Format = Get16u(DirEntry+2);
-        Components = Get32u(DirEntry+4);
-
-        if ((Format-1) >= NUM_FORMATS) {
-            // (-1) catches illegal zero case as unsigned underflows to positive large.
-            ErrNonfatal("Illegal number format %d for Exif gps tag %04x", Format, Tag);
-            continue;
-        }
-
-        ComponentSize = BytesPerFormat[Format];
-        ByteCount = Components * ComponentSize;
-
-        if (ByteCount > 4){
-            unsigned OffsetVal;
-            OffsetVal = Get32u(DirEntry+8);
-            // If its bigger than 4 bytes, the dir entry contains an offset.
-            if (OffsetVal+ByteCount > ExifLength){
-                // Bogus pointer offset and / or bytecount value
-                ErrNonfatal("Illegal value pointer for Exif gps tag %04x", Tag,0);
-                continue;
-            }
-            ValuePtr = OffsetBase+OffsetVal;
-        }else{
-            // 4 bytes or less and value is in the dir entry itself
-            ValuePtr = DirEntry+8;
-        }
-
-        switch(Tag){
-            char FmtString[21];
-            char TempString[50];
-            double Values[3];
-
-            case TAG_GPS_LAT_REF:
-                ImageInfo.GpsLat[0] = ValuePtr[0];
-                break;
-
-            case TAG_GPS_LONG_REF:
-                ImageInfo.GpsLong[0] = ValuePtr[0];
-                break;
-
-            case TAG_GPS_LAT:
-            case TAG_GPS_LONG:
-                if (Format != FMT_URATIONAL){
-                    ErrNonfatal("Inappropriate format (%d) for Exif GPS coordinates!", Format, 0);
-                }
-                strcpy(FmtString, "%0.0fd %0.0fm %0.0fs");
-                for (a=0;a<3;a++){
-                    int den, digits;
-
-                    den = Get32s(ValuePtr+4+a*ComponentSize);
-                    digits = 0;
-                    while (den > 1 && digits <= 6){
-                        den = den / 10;
-                        digits += 1;
-                    }
-                    if (digits > 6) digits = 6;
-                    FmtString[1+a*7] = (char)('2'+digits+(digits ? 1 : 0));
-                    FmtString[3+a*7] = (char)('0'+digits);
-
-                    Values[a] = ConvertAnyFormat(ValuePtr+a*ComponentSize, Format);
-                }
-
-                sprintf(TempString, FmtString, Values[0], Values[1], Values[2]);
-
-                if (Tag == TAG_GPS_LAT){
-                    strncpy(ImageInfo.GpsLat+2, TempString, 29);
-                }else{
-                    strncpy(ImageInfo.GpsLong+2, TempString, 29);
-                }
-                break;
-
-            case TAG_GPS_ALT_REF:
-                ImageInfo.GpsAlt[0] = (char)(ValuePtr[0] ? '-' : ' ');
-                break;
-
-            case TAG_GPS_ALT:
-                sprintf(ImageInfo.GpsAlt + 1, "%.2fm", 
-                    ConvertAnyFormat(ValuePtr, Format));
-                break;
-        }
-
-        if (ShowTags){
-            // Show tag value.
-            if (Tag < MAX_GPS_TAG){
-                printf("        GPS%s =", GpsTags[Tag]);
-            }else{
-                // Show unknown tag
-                printf("        Illegal GPS tag %04x=", Tag);
-            }
-
-            switch(Format){
-                case FMT_UNDEFINED:
-                    // Undefined is typically an ascii string.
-
-                case FMT_STRING:
-                    // String arrays printed without function call (different from int arrays)
-                    {
-                        printf("\"");
-                        for (a=0;a<ByteCount;a++){
-                            int ZeroSkipped = 0;
-                            if (ValuePtr[a] >= 32){
-                                if (ZeroSkipped){
-                                    printf("?");
-                                    ZeroSkipped = 0;
-                                }
-                                putchar(ValuePtr[a]);
-                            }else{
-                                if (ValuePtr[a] == 0){
-                                    ZeroSkipped = 1;
-                                }
-                            }
-                        }
-                        printf("\"\n");
-                    }
-                    break;
-
-                default:
-                    // Handle arrays of numbers later (will there ever be?)
-                    for (a=0;;){
-                        PrintFormatNumber(ValuePtr+a*ComponentSize, Format, ByteCount);
-                        if (++a >= Components) break;
-                        printf(", ");
-                    }
-                    printf("\n");
-            }
-        }
-    }
-}
-
-   

data/ext/iptc.c

@@ -1,205 +0,0 @@
-//--------------------------------------------------------------------------
-//  Process IPTC data and XMP data.
-//--------------------------------------------------------------------------
-#include "jhead.h"
-
-// IPTC entry types known to Jhead (there's many more defined)
-#define IPTC_RECORD_VERSION         0x00
-#define IPTC_SUPLEMENTAL_CATEGORIES 0x14
-#define IPTC_KEYWORDS               0x19
-#define IPTC_CAPTION                0x78
-#define IPTC_AUTHOR                 0x7A
-#define IPTC_HEADLINE               0x69
-#define IPTC_SPECIAL_INSTRUCTIONS   0x28
-#define IPTC_CATEGORY               0x0F
-#define IPTC_BYLINE                 0x50
-#define IPTC_BYLINE_TITLE           0x55
-#define IPTC_CREDIT                 0x6E
-#define IPTC_SOURCE                 0x73
-#define IPTC_COPYRIGHT_NOTICE       0x74
-#define IPTC_OBJECT_NAME            0x05
-#define IPTC_CITY                   0x5A
-#define IPTC_STATE                  0x5F
-#define IPTC_COUNTRY                0x65
-#define IPTC_TRANSMISSION_REFERENCE 0x67
-#define IPTC_DATE                   0x37
-#define IPTC_COPYRIGHT              0x0A
-#define IPTC_COUNTRY_CODE           0x64
-#define IPTC_REFERENCE_SERVICE      0x2D
-#define IPTC_TIME_CREATED           0x3C
-#define IPTC_SUB_LOCATION           0x5C
-#define IPTC_IMAGE_TYPE             0x82
-
-//--------------------------------------------------------------------------
-//  Process and display IPTC marker.
-//
-//  IPTC block consists of:
-//      - Marker:               1 byte      (0xED)
-//      - Block length:         2 bytes
-//      - IPTC Signature:       14 bytes    ("Photoshop 3.0\0")
-//      - 8BIM Signature        4 bytes     ("8BIM")
-//      - IPTC Block start      2 bytes     (0x04, 0x04)
-//      - IPTC Header length    1 byte
-//      - IPTC header           Header is padded to even length, counting the length byte
-//      - Length                4 bytes
-//      - IPTC Data which consists of a number of entries, each of which has the following format:
-//              - Signature     2 bytes     (0x1C02)
-//              - Entry type    1 byte      (for defined entry types, see #defines above)
-//              - entry length  2 bytes
-//              - entry data    'entry length' bytes
-//
-//--------------------------------------------------------------------------
-void show_IPTC (unsigned char* Data, unsigned int itemlen)
-{
-    const char IptcSig1[] = "Photoshop 3.0";
-    const char IptcSig2[] = "8BIM";
-    const char IptcSig3[] = {0x04, 0x04};
-
-    unsigned char * pos    = Data + sizeof(short);   // position data pointer after length field
-    unsigned char * maxpos = Data+itemlen;
-    char  headerLen = 0;
-
-    if (itemlen < 25) goto corrupt;
-
-    // Check IPTC signatures
-    if (memcmp(pos, IptcSig1, sizeof(IptcSig1)-1) != 0) goto badsig;
-    pos += sizeof(IptcSig1);      // move data pointer to the next field
-
-    if (memcmp(pos, IptcSig2, sizeof(IptcSig2)-1) != 0) goto badsig;
-    pos += sizeof(IptcSig2)-1;          // move data pointer to the next field
-
-    if (memcmp(pos, IptcSig3, sizeof(IptcSig3)) != 0){
-badsig:
-        if (ShowTags){
-            ErrNonfatal("IPTC type signature mismatch\n",0,0);
-        }
-        return;
-    }
-    pos += sizeof(IptcSig3);          // move data pointer to the next field
-
-    if (pos >= maxpos) goto corrupt;
-
-    // IPTC section found
-
-    // Skip header
-    headerLen = *pos++;                     // get header length and move data pointer to the next field
-    pos += headerLen + 1 - (headerLen % 2); // move data pointer to the next field (Header is padded to even length, counting the length byte)
-
-    if (pos+4 >= maxpos) goto corrupt;
-
-    // Get length (from motorola format)
-    //length = (*pos << 24) | (*(pos+1) << 16) | (*(pos+2) << 8) | *(pos+3);
-
-    pos += 4;                    // move data pointer to the next field
-
-    printf("======= IPTC data: =======\n");
-
-    // Now read IPTC data
-    while (pos < (Data + itemlen-5)) {
-        short  signature;
-        unsigned char   type = 0;
-        short  length = 0;
-        char * description = NULL;
-
-        if (pos+5 > maxpos) goto corrupt;
-
-        signature = (*pos << 8) + (*(pos+1));
-        pos += 2;
-
-        if (signature != 0x1C02){
-            break;
-        }
-
-        type    = *pos++;
-        length  = (*pos << 8) + (*(pos+1));
-        pos    += 2;                          // Skip tag length
-
-        if (pos+length > maxpos) goto corrupt;
-        // Process tag here
-        switch (type) {
-            case IPTC_RECORD_VERSION:
-                printf("Record vers.  : %d\n", (*pos << 8) + (*(pos+1)));
-                break;
-
-            case IPTC_SUPLEMENTAL_CATEGORIES:  description = "SuplementalCategories"; break;
-            case IPTC_KEYWORDS:                description = "Keywords"; break;
-            case IPTC_CAPTION:                 description = "Caption"; break;
-            case IPTC_AUTHOR:                  description = "Author"; break;
-            case IPTC_HEADLINE:                description = "Headline"; break;
-            case IPTC_SPECIAL_INSTRUCTIONS:    description = "Spec. Instr."; break;
-            case IPTC_CATEGORY:                description = "Category"; break;
-            case IPTC_BYLINE:                  description = "Byline"; break;
-            case IPTC_BYLINE_TITLE:            description = "Byline Title"; break;
-            case IPTC_CREDIT:                  description = "Credit"; break;
-            case IPTC_SOURCE:                  description = "Source"; break;
-            case IPTC_COPYRIGHT_NOTICE:        description = "(C)Notice"; break;
-            case IPTC_OBJECT_NAME:             description = "Object Name"; break;
-            case IPTC_CITY:                    description = "City"; break;
-            case IPTC_STATE:                   description = "State"; break;
-            case IPTC_COUNTRY:                 description = "Country"; break;
-            case IPTC_TRANSMISSION_REFERENCE:  description = "OriginalTransmissionReference"; break;
-            case IPTC_DATE:                    description = "DateCreated"; break;
-            case IPTC_COPYRIGHT:               description = "(C)Flag"; break;
-            case IPTC_REFERENCE_SERVICE:       description = "Country Code"; break;
-            case IPTC_COUNTRY_CODE:            description = "Ref. Service"; break;
-            case IPTC_TIME_CREATED:            description = "Time Created"; break;
-            case IPTC_SUB_LOCATION:            description = "Sub Location"; break;
-            case IPTC_IMAGE_TYPE:              description = "Image type"; break;
-
-            default:
-                if (ShowTags){
-                    printf("Unrecognised IPTC tag: %d\n", type );
-                }
-            break;
-        }
-        if (description != NULL) {
-            char TempBuf[32];
-            memset(TempBuf, 0, sizeof(TempBuf));
-            memset(TempBuf, ' ', 14);
-            memcpy(TempBuf, description, strlen(description));
-            strcat(TempBuf, ":"); 
-            printf("%s %*.*s\n", TempBuf, length, length, pos);
-        }
-        pos += length;
-    }
-    return;
-corrupt:
-    ErrNonfatal("Pointer corruption in IPTC\n",0,0);
-}
-
-
-
-//--------------------------------------------------------------------------
-// Dump contents of XMP section
-//--------------------------------------------------------------------------
-void ShowXmp(Section_t XmpSection)
-{
-    unsigned char * Data;
-    char OutLine[101];
-    int OutLineChars;
-    int NonBlank;
-    unsigned a;
-    NonBlank = 0;
-    Data = XmpSection.Data;
-    OutLineChars = 0;
-
-
-    for (a=0;a<XmpSection.Size;a++){
-        if (Data[a] >= 32 && Data[a] < 128){
-            OutLine[OutLineChars++] = Data[a];
-            if (Data[a] != ' ') NonBlank |= 1;
-        }else{
-            if (Data[a] != '\n'){
-                OutLine[OutLineChars++] = '?';
-            }
-        }
-        if (Data[a] == '\n' || OutLineChars >= 100){
-            OutLine[OutLineChars] = 0;
-            if (NonBlank){
-                puts(OutLine);
-            }
-            NonBlank = (NonBlank & 1) << 1;
-            OutLineChars = 0;
-        }
-    }
-}

data/ext/jhead.1

@@ -1,409 +0,0 @@
-.TH JHEAD 1 "06 Nov 2009" "jhead 2.88"
-.SH NAME
-jhead \- Digicam JPEG Exif header manipulation tool
-.SH SYNOPSIS
-.B jhead
-[
-.I options
-]
-[
-.I file\.\.\.
-]
-
-.LP
-.SH DESCRIPTION
-.LP
-.B jhead
-is used to display and manipulate data contained in the Exif header of JPEG
-images from digital cameras.  By default, jhead displays the more useful
-camera settings from the file in a user-friendly format.
-.PP
-.B jhead
-can also be used to manipulate some aspects of the image relating to JPEG and
-Exif headers, such as changing the internal timestamps, removing the thumbnail,
-or transferring Exif headers back into edited images after graphical editors
-deleted the Exif header.
-.B jhead
-can also be used to launch other programs, similar in style to the UNIX
-.B find
-command, but much simpler.
-
-
-.SH GENERAL METADATA OPTIONS
-.TP
-.BI \-\^te \ file
-Transplant Exif header from a JPEG (with Exif header) in
-.I file
-into the image that is manipulated.  This option is
-useful if you like to edit the photos but still want the Exif header on your photos.
-As most photo editing programs will wipe out the Exif header, this option can be used
-to re-copy them back from original copies after editing the photos.
-
-
-This feature has an interesting 'relative path' option for specifying the
-thumbnail name.  Whenever the <name> contains the characters '&i',
-will substitute the original  filename for this name. This allows creating a
-jhead 'relative name' when doing a whole batch  of files. For example, the
-incantation:
-
-.B jhead -te "originals\&i" *.jpg
-
-would transfer the exif header for each .jpg file in the originals directory by
-the same name, Both Win32 and most Unix shells treat the '&' character in a
-special way, so you have to put quotes around that command line option for
-the '&' to even be passed to the program.
-
-.TP
-.B \-dc
-Delete comment field from the JPEG header.  Note that the comment
-is not part of the Exif header.
-.TP
-.B \-de
-Delete the Exif header entirely.  Leaves other metadata sections intact.
-.TP
-.B \-di
-Delete the IPTC section, if present.  Leaves other metadata sections intact.
-.TP
-.B \-dx
-Delete the XMP section, if present.  Leaves other metadata sections intact.
-.TP
-.B \-du
-Delete sections of jpeg that are not Exif, not comment, and otherwise not
-contributing to the image either - such as data that photoshop might leave in the image.
-.TP
-.B \-purejpg
-Delete all JPEG sections that aren't necessary for rendering the image.  Strips any
-metadata that various applications may have left in the image.  A combination of
-the -de -dc and -du options.
-.TP
-.B \-mkexif
-Creates minimal exif header. Exif header contains date/time, and empty thumbnail
-fields only. Date/time set to file time by default. Use with -rgt option if you
-want the exif header to contain a thumbnail. Note that exif header creation is
-very limited at this time, and no other fields can be added to the exif header
-this way.
-.TP
-.B \-ce
-Edit the JPEG header comment field (note, this comment field is outside the Exif structure
-and can be part of Exif and non Exif style JPEG images).
-
-A temporary file containing the comment is created and a text editor is launched to edit
-the file.  The editor is specified in the EDITOR environment variable.  If none is specified
-notepad or vi are used under Windows and Unix respectively.  After the editor exits,
-the data is transferred back into the image, and the temporary file deleted.
-.TP
-.BI \-\^cs \ file
-Save comment section to a
-.I file
-.TP
-.BI \-\^ci \ file
-Replace comment with text from
-.I file
-.TP
-.BI \-\^cl \ string
-Replace comment with specified string from command line
-.IR file
-
-
-
-.SH DATE / TIME MANIPULATION OPTIONS
-
-.TP
-.B \-ft
-Sets the file's system time stamp to what is stored in the Exif header.
-.TP
-.B \-dsft
-Sets the Exif timestamp to the file's timestamp. Requires an Exif header to
-pre-exist. Use -mkexif option to create one if needed.
-.TP
-.BI \-\^n [format_string]
-This option causes files to be renamed and/ or mmoved using the date information from the Exif header
-"DateTimeOriginal" field.
-If the file is not an Exif file, or the DateTimeOriginal does not contain a valid value,
-the file date is used.
-Renaming is by default restricted to files whose names consist largely of digits.
-This effectively restricts renaming to files that have not already been manually renamed, as
-the default sequential names from digital cameras consist largely of digits.
-Use the
-.B -nf
-option to force renaming of all files.
-If the new name contains a '/', this will be interpreted as a new path, and the file will be
-moved accordingly.
-                  
-
-If the
-.I format_string
-is omitted, the file will be renamed to MMDD-HHMMSS.  Note that
-this scheme doesn't include the year (I never have photos from different years together anyway).
-
-If a
-.I format_string
-is provided, it will be passed to the strftime function as the format string.
-In addition, if the format string contains '%f', this will
-substitute the original name of the file (minus extension).  '%i' will substitute a sequence
-number.  Leading zeros can be specified like with printf - i.e. '%04i' pads the number to 4
-digits using leading zeros.
-
-If the name includes '/', this is interpreted as a new path for the file.  
-If the new path does not exist, the path will be created.
-
-If the target name already exists, the name will be appended with "a", "b", "c", etc,
-unless the name ends with a letter, in which case it will be appended with "0", "1", "2", etc.
-
-This feature is especially useful if more than one digital camera was used to take pictures
-of an event.  By renaming them to a scheme according to date, they will automatically
-appear in order of taking in most directory listings and image browsers.  Alternatively,
-if your image browser supports listing by file time, you can use the -ft option to set
-the file time to the time the photo was taken.
-
-Some of the more useful arguments for strftime are:
-
-.BR %H \ Hour\ in\ 24-hour\ format\ (00\ -\ 23)
-.br
-.BR %j \ Day\ of\ year\ as\ decimal\ number\ (001\ -\ 366)
-.br
-.BR %m \ Month\ as\ decimal\ number\ (01\ -\ 12)
-.br
-.BR %M \ Minute\ as\ decimal\ number\ (00\ -\ 59)
-.br
-.BR %S \ Second\ as\ decimal\ number\ (00\ -\ 59)
-.br
-.BR %w \ Weekday\ as\ decimal\ number\ (0\ -\ 6;\ Sunday\ is\ 0)
-.br
-.BR %y \ Year\ without\ century,\ as\ decimal\ number\ (00\ -\ 99)
-.br
-.BR %Y \ Year\ with\ century,\ as\ decimal\ number
-
-Example:
-
-.B jhead -n%Y%m%d-%H%M%S *.jpg
-This will rename files matched by *.jpg in the format YYYYMMDD-HHMMSS
-
-For a full listing of strftime arguments, look up the strftime in them man pages.
-Note that some arguments
-to the strftime function (not listed here) produce strings with characters such as ':' that
-may not be valid as part of a filename on some systems.
-
-.TP
-.B \-nf
-Same as '-n' but renames files regardless of original file name.
-
-
-.TP
-.B \-ta<+|-><timediff>
-Adjust time stored in the Exif header by h:mm backwards or forwards.  Useful when having
-taken pictures with the wrong time set on the camera, such as after travelling across
-time zones, or when daylight savings time has changed.
-
-This option changes all Date/time fields in the exif header, including "DateTimeOriginal" (tag 0x9003)
-and "DateTimeDigitized" (tag 0x9004).
-.TP
-.B \-da<newdate>-<olddate>
-
-Works like -ta, but for specifying large date offsets, to be used when fixing dates from
-cameras where the date was set incorrectly, such as having date and time reset by battery
-removal on some cameras
-
-Because different months and years have different numbers of days in them, a simple offset
-for months, days, years would lead to unexpected results at times.  The time offset is
-thus specified as a difference between two dates, so that jhead can figure out exactly
-how many days the timestamp needs to be adjusted by, including leap years and daylight
-savings time changes.
-The dates are specified as yyyy:mm:dd.  For sub-day adjustments, a time of day can also
-be included, by specifying yyyy:nn:dd/hh:mm or yyyy:mm:dd/hh:mm:ss
-
-Examples:
-
-Year on camera was set to 2005 instead of 2004 for pictures taken in April
-.br
-jhead -da2004:03:01-2005:03:01
-
-Default camera date is 2002:01:01, and date was reset on 2005:05:29 at 11:21 am
-.br
-jhead -da2005:05:29/11:21-2002:01:01
-.TP
-.B \-ts
-Sets the time stored in the Exif header to what is specified on the command line.
-Time must be specified as:
-.I yyyy:mm:dd-hh:mm:ss
-.TP
-.B \-ds
-Sets the date stored in the Exif header to what is specified on the command line.
-Can be used to set date, just year and month, or just year.
-Date is specified as:
-.I yyyy:mm:dd,  yyyy:mm, or yyyy
-
-
-.SH THUMBNAIL MANIPULATION OPTIONS
-
-.TP
-.B \-dt
-Delete thumbnails from the Exif header, but leave the
-interesting parts intact.  This option truncates the thumbnail from the Exif header, provided
-that the thumbnail is the last part of the Exif header (which so far as I know is always the case).
-Exif headers have a built-in thumbnail, which typically
-occupies around 10k of space.  This thumbnail is used by digital cameras.  Windows XP may also
-use this thumbnail if present (but it doesn't need it).  The
-thumbnails are too small to use even full screen on the digicam's LCD.
-I have not encountered any adverse side effects of deleting the thumbnails, even from the
-software provided with my old Olympus digicam.  Use with caution.
-
-.TP
-.BI \-\^st \ file
-Save the integral thumbnail to
-.I file
-The thumbnail lives
-inside the Exif header, and is a very low-res JPEG image.  Note that making
-any changes to a photo, except for with some programs, generally wipes out the Exif header
-and with it the thumbnail.
-
-The thumbnail is too low res to really use for very much.
-
-This feature has an interesting 'relative path' option for specifying the thumbnail name.
-Whenever the name for
-.I file
-contains the characters  '&i',
-.B jhead
-will substitute the original
-filename for this name.  This allows creating a 'relative name' when doing a whole
-batch of files.  For example, the incantation:
-
-.B jhead -st "thumbnails/&i" *.jpg
-
-would create a thumbnail for each .jpg file in the thumbnails directory by the same name,
-(provided that the thumbnails directory exists, of course).
-Both Win32 and UNIX shells treat the '&'character in a special way, so you have to
-put quotes around that command line option for the '&' to even be passed to the program.
-
-If a '-' is specified for the output file, the thumbnail is sent to stdout. (UNIX build only)
-
-.TP
-.B \-rt
-Replace thumbnails from the Exif header.
-This only works if the exif header already contains a thumbnail, and the thumbnail is at the
-end of the header (both always the case if the photo came from a digital camera)
-.TP
-.BI \-\^rgt \ size
-Regenerate exif thumbnail.  'size' specifies maximum height or width of thumbnail.
-Relies on 'mogrify' program (from ImageMagick) to regenerate the thumbnail.
-This only works if the image already contains a thumbnail.
-
-.SH ROTATION OPTIONS
-.TP
-.B \-autorot
-Using the 'Orientation' tag of the Exif header, rotate the image so that it is upright.
-The program
-.B jpegtran
-is used to perform the rotation. This program is present in most
-Linux distributions.  For windows, you need to get a copy of it.  After rotation, the
-orientation tag of the Exif header is set to '1' (normal orientation).  The thumbnail
-is also rotated. Other fields of the Exif header, including
-dimensions are untouched, but the JPEG height/width are adjusted.
-This feature is especially useful with newer Canon cameras, that set the orientation
-tag automatically using a gravity sensor.
-.TP
-.B \-norot
-Clears the rotation field in the Exif header without altering the image.  Useful if
-the images were previously rotated without clearing the Exif rotation tag, as some
-image browsers will auto rotate images when the rotation tag is set.
-Sometimes, thumbnails and rotation  tags can get very out of sync from manipulation
-with various tools.  To reset it all use -norot with -rgt to clear this out.
-
-.SH OUTPUT VERBOSITY CONTROL
-.TP
-.B \-h
-Displays summary of command line options.
-.TP
-.B \-v
-Makes the program even more verbose than it already is.  Like DOS programs, and unlike
-UNIX programs, Jhead gives feedback as to what it is doing, even when nothing goes wrong.
-Windows user that I am, when something doesn't give me feedback for 20 seconds, I assume
-its crashed.
-.TP
-.B \-q
-No output on success, more like Unix programs.
-.TP
-.B \-V
-Print version info and compilation date.
-.B \-exifmap
-Show a map of the bytes in the exif header. Useful when analyzing strange exif headers,
-not of much use to non software developers.
-.TP
-.B \-se
-Suppress error messages relating to corrupt Exif header structure.
-.TP
-.B \-c
-Concise output.  This causes picture info to be summarized on one line instead of several.
-Useful for grep-ing through images, as well as importing into spread sheets (data is space
-delimited with quotes as text qualifier).
-
-.SH FILE MATCHING OPTIONS
-.TP
-.B \-model
-Restricts processing of files to those whose camera model, as indicated by the Exif image
-information, contains the substring specified in the argument after '-model'.
-For example, the following command will list only images that are from an S100 camera:
-
-.B jhead -model S100 *.jpg
-
-.B jhead -model S100 *.jpg
-
-I use this option to restrict my JPEG recompensing to those images that came from my
-Canon S100 digicam, (see the -cmd option).
-.TP
-.B \-exonly
-Skip all files that don't have an Exif header.  Photos straight from a digital camera
-have an Exif header, whereas many photo manipulation tools discard the Exif header.
-.TP
-.B \-cmd
-Executes the specified command on each JPEG file to be processed.
-
-The Exif section of each file is read before running the command, and reinserted
-after the command finishes.
-
-The specified command invoked separately for each JPEG that is processed, even if
-multiple files are specified (explicitly or by wild card).
-
-Example use:
-
-Having a whole directory of photos from my S100, I run the following commands:
-
-.B jhead -cmd "mogrify -quality 80 &i" -model S100 -r *.jpg
-.br
-.B jhead -cmd "jpegtran -progressive &i > &o" -r *.jpg
-
-The first command mogrifies all JPEGs in the tree that indicate that they are from a
-Canon S100 in their Exif header to 80% quality at the same resolution.  This is a 'lossy'
-process, so I only run it on files that are from the Canon, and only run it once.
-The next command then takes a JPEGs and converts them to progressive JPEGs.  The result
-is the same images, with no discernible differences, stored in half the space.  This 
-produces substantial savings on some cameras.
-
-.SH SEE ALSO
-.BR jpegtran (1),
-.BR mogrify (1),
-.BR rdjpgcom (1),
-.BR wrjpgcom (1)
-.SH AUTHOR
-Matthias Wandel
-.SH BUGS
-After jhead runs a program to rotate or resize an image, the image dimensions and thumbnail
-in the Exif header are not adjusted.
-.PP
-Modifying of Exif header data is very limited, as Jhead internally only has a read only
-implementation of the file system contained in the Exif header.  For example, there is no way
-to replace the thumbnail or edit the Exif comment in the Exif header.  There is also no way
-to create minimal exif headers.
-.PP
-Some Canon digital SLR cameras fail to adjust the effective sensor resolution when shooting at less
-than full resolution, causing jhead to incorrectly miscalculate the sensor width and 35mm equivalent
-focal length.  The same can result from resizing photos with Photoshop, which will manipulate
-parts of the exif header.
-This is often reported as a bug in Jhead, but Jhead can't do much about incorrect data.
-.PP
-Send bug reports to mwandel at sentex dot net.
-
-.SH COPYING PERMISSIONS
-Jhead is 'public domain'.  You may freely copy jhead, and reuse part or all of its code
-in free or proprietary programs.   I do however request that you do not post my e-mail
-address in ways that spam robots can harvest it.