<?php

/******************************************************************************
*
* Filename:     olympus.php
*
* Description:  Olympus Makernote Parser
*               Provides functions to decode an Olympus EXIF makernote and to interpret
*               the resulting array into html.
*
*               Olympus Makernote Format:
*
*               Field           Size            Description
*               ----------------------------------------------------------------
*               Header          7 Bytes         "OLYMP\x00\x01" or "OLYMP\x00\x02"
*               Unknown         1 Bytes         Unknown
*               IFD Data        Variable        Standard IFD Data using Olympus Tags
*               ----------------------------------------------------------------
*
*
* Author:       Evan Hunter
*
* Date:         30/7/2004
*
* Project:      JPEG Metadata
*
* Revision:     1.00
*
* URL:          http://electronics.ozhiker.com
*
* Copyright:    Copyright Evan Hunter 2004
*               This file may be used freely for non-commercial purposes.For
*               commercial uses please contact the author: evan@ozhiker.com
*
******************************************************************************/


// Add the parser and interpreter functions to the list of Makernote parsers and interpreters.

$GLOBALS['Makernote_Function_Array']['Read_Makernote_Tag'][] = "get_Olympus_Makernote";
$GLOBALS['Makernote_Function_Array']['get_Makernote_Text_Value'][] = "get_Olympus_Text_Value";
$GLOBALS['Makernote_Function_Array']['Interpret_Makernote_to_HTML'][] = "get_Olympus_Makernote_Html";


/******************************************************************************
*
* Function:     get_Olympus_Makernote
*
* Description:  Decodes the Makernote tag and returns the new tag with the decoded
*               information attached. Returns false if this is not a makernote
*               that can be processed with this script
*
* Parameters:   Makernote_Tag - the element of an EXIF array containing the
*                               makernote, as returned from get_EXIF_JPEG
*               EXIF_Array - the entire EXIF array containing the
*                            makernote, as returned from get_EXIF_JPEG, in
*                            case more information is required for decoding
*               filehnd - an open file handle for the file containing the
*                         makernote - does not have to be positioned at the
*                         start of the makernote
*               Make_Field - The contents of the EXIF Make field, to aid
*                            determining whether this script can decode
*                            the makernote
*
*
* Returns:      Makernote_Tag - the Makernote_Tag from the parameters, but
*                               modified to contain the decoded information
*               FALSE - If this script could not decode the makernote, or if
*                       an error occured in decoding
*
******************************************************************************/

function get_Olympus_Makernote( $Makernote_Tag, $EXIF_Array, $filehnd, $Make_Field )
{

        // Check if the Make Field contains the word Olympus
        if ( stristr( $Make_Field, "Olympus" ) === FALSE )
        {
                return FALSE;
        }

        // Check if the header exists at the start of the Makernote
        if ( ( substr( $Makernote_Tag['Data'], 0, 7 ) != "OLYMP\x00\x01" ) &&
             ( substr( $Makernote_Tag['Data'], 0, 7 ) != "OLYMP\x00\x02" ) )
        {
                // This isn't a Olympus Makernote, abort
                return FALSE ;
        }


        // Seek to the start of the IFD
        fseek($filehnd, $Makernote_Tag['Tiff Offset'] + $Makernote_Tag['Offset'] + 8 );

        // Read the IFD(s) into an array
        $Makernote_Tag['Decoded Data'] = read_Multiple_IFDs( $filehnd, $Makernote_Tag['Tiff Offset'], $Makernote_Tag['ByteAlign'], "Olympus" );

        // Save some information into the Tag element to aid interpretation
        $Makernote_Tag['Decoded'] = TRUE;
        $Makernote_Tag['Makernote Type'] = "Olympus";
        $Makernote_Tag['Makernote Tags'] = "Olympus";


        // Return the new tag
        return $Makernote_Tag;
}

/******************************************************************************
* End of Function:     get_Olympus_Makernote
******************************************************************************/


/******************************************************************************
*
* Function:     get_Olympus_Text_Value
*
* Description:  Provides a text value for any tag marked as special for makernotes
*               that this script can decode. Returns false if this is not a makernote
*               that can be processed with this script
*
* Parameters:   Exif_Tag - the element of an the Makernote array containing the
*                          tag in question, as returned from get_Olympus_Makernote
*               Tag_Definitions_Name - The name of the Tag Definitions group
*                                      within the global array IFD_Tag_Definitions
*
*
* Returns:      output - the text value for the tag
*               FALSE - If this script could not decode the makernote, or if
*                       an error occured in decoding
*
******************************************************************************/

function get_Olympus_Text_Value( $Exif_Tag, $Tag_Definitions_Name )
{
        // Check that this tag uses the Olympus tags, otherwise it can't be decoded here
        if ( $Tag_Definitions_Name !== "Olympus" )
        {
                // Not an Olympus tag - can't decode it
                return FALSE;
        }
        
        
        // Process the tag acording to it's tag number, to produce a text value
        if ( $Exif_Tag['Tag Number'] == 0x200 )
        {
                // Special Mode Tag

                // Add info from the first value to the output string
                switch ( $Exif_Tag['Data'][0] )
                {
                        case 0: $outputstr = "Normal\n";
                                break;
                        case 2: $outputstr = "Fast\n";
                                break;
                        case 3: $outputstr = "Panorama\n";
                                break;
                        default: $outputstr = "Unknown Mode ( " . $Exif_Tag['Data'][0] . " )\n";
                                        break;
                }
                        
                // Add info from the second value to the output string
                $outputstr .= "Sequence Number: " . $Exif_Tag['Data'][1] . "\n";
                        
                // Add info from the third value to the output string
                switch ( $Exif_Tag['Data'][2] )
                {
                        case 0: // Do nothing
                                break;
                        case 1: $outputstr .= "Panorama Direction: Left to Right\n";
                                break;
                        case 2: $outputstr .= "Panorama Direction: Right to Left\n";
                                break;
                        case 3: $outputstr .= "Panorama Direction: Bottom to Top\n";
                                break;
                        case 4: $outputstr .= "Panorama Direction: Top to Bottom\n";
                                break;
                        default: $outputstr .= "Unknown Panorama Direction\n";
                                        break;
                }
                
                // Return the output string
                return $outputstr;
        }
        else
        {
                // Unknown special tag - can't process it here
                return FALSE;
        }

        // Unknown special tag - can't process it here
        return FALSE;

}

/******************************************************************************
* End of Function:     get_Olympus_Text_Value
******************************************************************************/


/******************************************************************************
*
* Function:     get_Olympus_Makernote_Html
*
* Description:  Attempts to interpret a makernote into html. Returns false if
*               it is not a makernote that can be processed with this script
*
* Parameters:   Makernote_Tag - the element of an EXIF array containing the
*                               makernote, as returned from get_EXIF_JPEG
*               filename - the name of the JPEG file being processed ( used
*                          by scripts which display embedded thumbnails)
*
*
* Returns:      output - the html representing the makernote
*               FALSE - If this script could not interpret the makernote, or if
*                       an error occured in decoding
*
******************************************************************************/

function get_Olympus_Makernote_Html( $Makernote_tag, $filename )
{

        // Check that this tag uses the Olympus tags, otherwise it can't be interpreted here
        if ( $Makernote_tag['Makernote Tags'] != "Olympus" )
        {
                // Not Olympus tags - can't interpret with this function
                return FALSE;
        }

        // Check if the Decoded data is valid
        if ( $Makernote_tag['Decoded Data'][0] === FALSE )
        {
                // Decoded data is not valid - can't interpret with this function
                return FALSE;
        }
        
        // Minolta Thumbnail 1
        if ( ( array_key_exists( 0x0088, $Makernote_tag['Decoded Data'][0] ) ) &&
             ( $Makernote_tag['Makernote Tags'] == "Olympus" ) )
        {
                $Makernote_tag['Decoded Data'][0][0x0088]['Text Value'] = "<a class=\"EXIF_Minolta_Thumb_Link\" href=\"get_minolta_thumb.php?filename=$filename\" ><img class=\"EXIF_Minolta_Thumb\" src=\"get_minolta_thumb.php?filename=$filename\"></a>";
                $Makernote_tag['Decoded Data'][0][0x0088]['Type'] = "String";
        }
        // Minolta Thumbnail 2
        if ( ( array_key_exists( 0x0081, $Makernote_tag['Decoded Data'][0] ) ) &&
             ( $Makernote_tag['Makernote Tags'] == "Olympus" ) )
        {
                $Makernote_tag['Decoded Data'][0][0x0081]['Text Value'] = "<a class=\"EXIF_Minolta_Thumb_Link\" href=\"get_minolta_thumb.php?filename=$filename\" ><img class=\"EXIF_Minolta_Thumb\" src=\"get_minolta_thumb.php?filename=$filename\"></a>";
                $Makernote_tag['Decoded Data'][0][0x0081]['Type'] = "String";
        }

        // Interpret the IFD and return the HTML
        return interpret_IFD( $Makernote_tag['Decoded Data'][0], $filename );

}

/******************************************************************************
* End of Function:     get_Olympus_Makernote_Html
******************************************************************************/


/******************************************************************************
* Global Variable:      IFD_Tag_Definitions, Olympus
*
* Contents:     This global variable provides definitions of the known Olympus
*               Makernote tags, indexed by their tag number.
*               It also includes Minolta and Agfa tags, as they use many of the
*               same tags
*
******************************************************************************/

$GLOBALS[ "IFD_Tag_Definitions" ]["Olympus"] = array(

0x0000 => array( 'Name' => "Makernote Version",           // Minolta
                 'Type' => "String" ),

0x0001 => array( 'Name' => "Camera Settings",           // Minolta
                 'Type' => "Special" ),

0x0003 => array( 'Name' => "Camera Settings",           // Minolta
                 'Type' => "Special" ),

0x0040 => array( 'Name' => "Compressed Image Size",           // Minolta
                 'Type' => "Numeric",
                 'Units' => "Bytes" ),

0x0081 => array( 'Name' => "Minolta Thumbnail",           // Minolta
                 'Type' => "Special" ),

0x0088 => array( 'Name' => "Minolta Thumbnail",           // Minolta
                 'Type' => "Special" ),

0x0089 => array( 'Name' => "Minolta Thumbnail Length",           // Minolta
                 'Type' => "Numeric",
                 'Units' => "bytes" ),

0x0101 => array( 'Name' => "Colour Mode",           // Minolta
                 'Type' => "Lookup",
                 0 => "Natural Colour",
                 1 => "Black & White",
                 2 => "Vivid colour",
                 3 => "Solarization",
                 4 => "AdobeRGB" ),

0x0102 => array( 'Name' => "Image Quality",           // Minolta
                 'Type' => "Lookup",
                 0 => "Raw",
                 1 => "Super Fine",
                 2 => "Fine",
                 3 => "Standard",
                 4 => "Extra Fine" ),

0x0103 => array( 'Name' => "Image Quality?",           // Minolta
                 'Type' => "Lookup",
                 0 => "Raw",
                 1 => "Super Fine",
                 2 => "Fine",
                 3 => "Standard",
                 4 => "Extra Fine" ),


0x0200 => array( 'Name' => "Special Mode",
                'Type' => "Special" ),


0x0201 => array( 'Name' => "JPEG Quality",
                 'Type' => "Lookup",
                 1 => "Standard Quality",
                 2 => "High Quality",
                 3 => "Super High Quality" ),

0x0202 => array( 'Name' => "Macro",
                 'Type' => "Lookup",
                 0 => "Normal (Not Macro)",
                 1 => "Macro" ),

0x0204 => array( 'Name' => "Digital Zoom",
                 'Type' => "Numeric",
                 'Units' => " x Digital Zoom, (0 or 1 = normal)" ),

0x0207 => array( 'Name' => "Firmware Version",
                'Type' => "String" ),


0x0208 => array( 'Name' => "Picture Info Data",
                'Type' => "String" ),

0x0209 => array( 'Name' => "Camera ID",
                'Type' => "String" ),


0x020B => array( 'Name' => "Image Width",        // Epson Tag
                'Type' => "Pixels" ),

0x020C => array( 'Name' => "Image Height",        // Epson Tag
                'Type' => "Pixels" ),

0x020D => array( 'Name' => "Original Manufacturer Model?",        // Epson Tag
                'Type' => "String" ),

0x0E00 => array( 'Name'=> "Print Image Matching Info",     // Minolta Tag
                 'Type' => "PIM" ),

0x1004 => array( 'Name' => "Flash Mode",
                 'Type' => "Numeric" ),

0x1006 => array( 'Name' => "Bracket",
                 'Type' => "Numeric" ),

0x100B => array( 'Name' => "Focus Mode",
                 'Type' => "Numeric" ),

0x100C => array( 'Name' => "Focus Distance",
                 'Type' => "Numeric" ),

0x100D => array( 'Name' => "Zoom",
                 'Type' => "Numeric" ),

0x100E => array( 'Name' => "Macro Focus",
                 'Type' => "Numeric" ),

0x100F => array( 'Name' => "Sharpness",
                 'Type' => "Numeric" ),

0x1011 => array( 'Name' => "Colour Matrix",
                 'Type' => "Numeric" ),

0x1012 => array( 'Name' => "Black Level",
                 'Type' => "Numeric" ),

0x1015 => array( 'Name' => "White Balance",
                 'Type' => "Numeric" ),

0x1017 => array( 'Name' => "Red Bias",
                 'Type' => "Numeric" ),

0x1018 => array( 'Name' => "Blue Bias",
                 'Type' => "Numeric" ),

0x101A => array( 'Name' => "Serial Number",
                 'Type' => "Numeric" ),

0x1023 => array( 'Name' => "Flash Bias",
                 'Type' => "Numeric" ),

0x1029 => array( 'Name' => "Contrast",
                 'Type' => "Numeric" ),

0x102A => array( 'Name' => "Sharpness Factor",
                 'Type' => "Numeric" ),

0x102B => array( 'Name' => "Colour Control",
                 'Type' => "Numeric" ),

0x102C => array( 'Name' => "Valid Bits",
                 'Type' => "Numeric" ),

0x102D => array( 'Name' => "Coring Filter",
                 'Type' => "Numeric" ),

0x102E => array( 'Name' => "Final Width",
                 'Type' => "Numeric" ),

0x102F => array( 'Name' => "Final Height",
                 'Type' => "Numeric" ),

0x1034 => array( 'Name' => "Compression Ratio",
                 'Type' => "Numeric" ),


);


/******************************************************************************
* End of Global Variable:     IFD_Tag_Definitions, Olympus
******************************************************************************/


?>