# Coppermine Photo Gallery v1.5.x: Documentation and Manual

# EXIF data

## What is EXIF

The "Exchangeable image file" format (Exif) is a specification for the image file format used by digital cameras with the addition of specific metadata tags. The meta data are written by the camera and can be post-processed using certain desktop applications. Coppermine is capable of displaying some of the EXIF data within the pic info section, like date and time information, camera settings, location information, descriptions and copyright information.

## Different flavors

Please note that EXIF is far from being a standard: each camera vendor uses his own "flavor" of EXIF - therefore, the EXIF meta data will differ from camera to camera. Coppermine tries to circumvent this by using different libraries for the most common camera brands and only displaying the exif data that are most common for all brands.

Exif data from the following Camera brands are currently supported:

- Canon
- Fuji
- Nikon
- Olympus
- Panasonic
- Sanyo

The exif libraries reside in the folder `http://yoursite.tld/your_coppermine_folder/include/makers/`, but usually those files should be left alone and don't need editing.

## How it works

It would be very time-consuming if an application would process an image each time it gets displayed to extract the exif data embedded into the image. That's why Coppermine populates a separate exif database table only once per image, during the upload stage of the image when that image get's resized as well (using the exif data embedded into the image). That exif data is being written into the table that works as a sort of cache. Each time the image get's accessed (i.e. when it get's displayed embedded into Coppermine) the exif data stored in the database is being read to populate the exif meta data. This is much faster and less ressources-consuming. The processing of exif data is only being performed if the corresponding config option "Read EXIF data from JPEG files" is enabled.

## No exif support on the server

There are two image libraries Coppermine can use: GD or ImageMagick. If files get edited on the server using one of those image libraries (i.e. if the images get resized, cropped or rotated), all meta information (Exif or IPTC) get lost in the resulting image, as the image libraries simply both don't support the preservation of exif tags. Therefor, if you resize your pics (this includes creation of intermediate sized images and thumbnails), the exif data embedded into the original will be lost - it will not remain inside the resized image. It will remain though within the exif database table and will be displayed inside the file information section. It's not the fault of coppermine that the exif data get's lost in the image, but the fault of the image libraries that coppermine is using. As a workaround, you can resize your images on your client (that includes the intermediate and thumbnail, respecting the prefixes set in in coppermine's config) with a client application that is capable to preserve exif information (like IrfanView and several other apps). Then upload the whole bunch of files using your favorite FTP app and finally just perform a batch-add. This will result in all of your images containing your exif data, as Coppermine (or rather: the image libraries used by coppermine) did not touch them.
Perform your edits on the client (before you upload them) if you do stuff like crop & rotate.

## Limitations

As suggested above, the implementation of Exif in Coppermine is limited. Coppermine is mainly not designed with professional photographers in mind, so the impact of the missing Exif capabilities should be neglible for the majority of coppermine users.

Geotagging meta data are not supported by coppermine yet.

## EXIF manager

Coppermine comes with an EXIF manager that let's the coppermine admin decide what EXIF data should be displayed within coppermine. Please note: if the exif data doesn't exist within a particular image, coppermine will of course not be able to display them. Coppermine is not an editor for exif data - it just displays the exif data that exists in your pics.
To access the exif manager, go to coppermine's config and click within the section File settings at "Manage exif display" next to the line "Read EXIF data in JPEG files" or choose the corresponding admin menu entry.

Tick the checkboxes in the exif manager that you want to show up in coppermine's pic info section (if the image file actually holds this particular set of information). Remember though that there is no guarantee that a particular field will be populated or displayed - as explained above, each camera vendor supplies a set of supported exif fields that differ from other vendors.

The following exif parameters are currently supported:

- AF Focus Position
- Adapter
- Color Mode
- Color Space
- Components Configuration
- Compressed Bits Per Pixel
- Contrast
- Customer Render
- DateTime Original
- DateTime digitized
- Digital Zoom
- Digital Zoom Ratio
- EXIF Image Height
- EXIF Image Width
- EXIF Interoperability Offset
- EXIF Offset
- EXIF Version
- Exposure Bias
- Exposure Mode
- Exposure Program
- Exposure Time
- FNumber
- File Source
- Flash
- Flash Pix Version
- Flash Setting
- Focal length
- Focus Mode
- Gain Control
- IFD1 Offset
- ISO Selection
- ISO Setting
- ISO
- Image Adjustment
- Image Description
- Image Sharpening
- Light Source
- Make
- Manual Focus Distance
- Max Aperture
- Metering Mode
- Model
- Noise Reduction
- Orientation
- Quality
- Resolution Unit
- Saturation
- Scene Capture Mode
- Scene Type
- Sharpness
- Software
- White Balance
- YCbCrPositioning
- X Resolution
- Y Resolution