Differences

This shows you the differences between two versions of the page.

Link to this comparison view

playground:playground [2017/12/26 00:02]
executive [Expanding Piwigo's Metadata Capabilities]
playground:playground [2018/01/06 16:23] (current)
plg move metadata to user_documentation:metadata
Line 20: Line 20:
  
 ----- -----
- 
-==== What's all this 'metadata' stuff, anyway? ==== 
- 
-Metadata is information about information. An example would be the album and artist information contained in the ID3 tag of an MP3 song file. In the case of image files, this includes things such as height and width, as well as Exif and IPTC blocks, which are written to a file when a digital camera takes a photo. Also, additional metadata can be written to the image file later in software, such as keywords. Metadata can be useful to the software you use, as well as to humans. Images may contain so called Exif and IPTC tags (one or both). Metadata can be used with many different types of file formats (JPEG, TIFF, RAW etc.). 
-The future of metadata will likely be decided by [[https://en.wikipedia.org/wiki/Metadata_Working_Group|Metadata Working Group]] 
- 
-=== Basic metadata === 
- 
-Basic metadata are things like filesize, width/height, color depth and sometimes even thumbnails. All images must have this data, and it is needed by browsers and other software to display the image properly. Historically, this data wasn't considered to be metadata, but in reality it is. 
- 
-=== Exif === 
- 
-[[https://en.wikipedia.org/wiki/Exif|Exif]] (Exchangeable image file format) tags are typically used to **describe how a photo was captured**. The standard was created by a consortium of Japanese hardware manufacturers. For example, tags can contain information about the model of camera/smartphone used, lens, aperature size, focal length, exposure duration, date/time, GPS coordinates, etc. It could also contain scanner properties.  There are //many// fields defined by the Exif specification, but the ones used in a particular file will vary by the device used. Since it is an open standard, tag usage should be consistent across various software. 
- 
-=== IPTC === 
- 
-[[https://iptc.org/standards/photo-metadata/iptc-standard/|IPTC]] headers are described by the Information Interchange Model (IIM). The header is named after the International Press Telecommunications Council (based in London), who created the standard in the 1990's to make it easier for news agencies to exchange information using computers. Adobe helped to bring this standard to public use. For our images, the IIM serves a purpose different from Exif; It **describes the content of the image**. Some cameras will allow you to record your name, and other copyright information to a digital photo, using this header. Sometimes, editing software is used to later add information like titles. headlines, captions, descriptions, keywords etc. Again, there are many possible fields described in the standard, and they are readable by most programs. 
- 
-=== MakerNotes === 
- 
-IPTC and Exif are open standards, but hardware manufacturers have their own secret sauce as well. Cameras will often record some metadata to digital photos which is proprietary, and sometimes device specific. Sometimes it is used by the cameras themselves, and sometimes by image processing software distributed by the companies with their cameras. For example, the Makernotes may include points on an image that the camera used for autofocusing, shutter sync, or noise reduction data. Since this metadata may reveal how a particular device works internally, companies do not publish the specifications to protect their business. Despite this, many Makernotes have been [[http://www.exiv2.org/makernote.html|reverse engineered]]. 
- 
-==== How Piwigo Handles Metadata "Out of the Box" ==== 
- 
-Piwigo has many ways to display and use metadata, and improvements are made with every update. Since metadata is stored within each image, it remains intact even if something happens to your Piwigo database.  
- 
-By default, Piwigo displays some **basic** metadata on the photo page (dimensions, filesize etc.).  When the metadata button is clicked (camera icon with 'i'), some additional **Exif** metadata will be shown: Camera Make+Model, image capture date+time, and aperature F-number. Piwigo does not display IPTC metadata. 
- 
-When you import images into Piwigo, the DateTimeOriginal field is extracted from the Exif metadata, and copied into the Piwigo database. It becomes the image's "Created on" property (which is searchable).  
- 
-==== Expanding Piwigo's Metadata Capabilities ==== 
- 
-** Note:** For some functions, in may be necessary to install [[http://piwigo.org/ext/extension_view.php?eid=199|Grum Plugin Classes]] 
- 
-Firstly, it helps to learn exactly what metadata your images contain, and what Piwigo can access. Fortunately, your standard Piwigo installation already has a tool to inspect some of your Exif and IPTC image metadata. Copy any sample jpeg image to this path: (it must have this file name) 
-<code> [your piwigo folder]/tools/sample.jpg</code> 
-Then, open this link in your browser: 
-<code> [your gallery URL]/tools/metadata.php</code> 
-You should see a page of text that looks like this: 
-<code> 
-Informations are read from sample.jpg 
- 
- 
-IPTC Fields in sample.jpg 
- 
-1#090 = %G 
-2#000 =  
-2#005 = exampledocumenttitle 
-2#025 = keyword1,keyword2 
-2#055 = 20170622 
-2#060 = 100209+0000 
-2#062 = 20170622 
-2#063 = 090209+0000 
-2#080 = mrphotographer 
-2#105 = exampleheadline 
-2#120 = exampledescription 
-2#122 = exampledescriptionauthor 
- 
- 
-EXIF Fields in sample.jpg 
- 
-Array 
-( 
-    [FileName] => sample.jpg 
-    [FileDateTime] => 1503177453 
- 
- ( and so on ... )  
-</code> 
-** * Note: ** There is  a plugin that makes this even easier: [[http://piwigo.org/ext/extension_view.php?eid=829|read_metadata]] 
- 
-As the output suggests, codes with a # sign are IPTC field labels, the words between square [brackets] are Exif field labels, and the data after them are the corresponding content in your image. These will be important for later. 
- 
- 
- 
- 
-^   ** * WARNING! * **   ^ 
-|  Changing this Piwigo behavior requires editing the configuration file:     **[your piwigo folder]/local/config/config.inc.php**  \\ Making a mistake here could cause your gallery to become inoperable, so do not modify your files directly. Instead, please refer to the article, [[user_documentation:use:features:conf_locale]], about making these changes safely using a plugin.    | 
- 
-=== Showing more metadata === 
- 
-**Exif** 
- 
-Piwigo already shows Exif metadata (by clicking the "Show file metadata" icon on a photo preview page) by default. You don't need to enable it. The core code that turns this on (or off) looks like this: 
-<code>$conf['show_exif'] = true;</code> 
-Some Exif fields are show by default. This is how it is configured in the core code: 
-<code>$conf['show_exif_fields'] = array( 
-  'Make', 
-  'Model',  
-  'DateTimeOriginal', 
-  'COMPUTED;ApertureFNumber' 
-  );</code> 
-(to view the core code, click the 'Display reference file: "config_default.inc.php"' link at the top of the LocalFiles Editor plugin) 
- 
-To display //more// Exif fields, all you have to do is add their keys (which you obtained from the tool mentioned in this article) to the array in the plugin. Inserting the example code below into your config plugin, will add a few more camera settings: 
-<code> 
-$conf['show_exif_fields'] = array( 
-  'DateTimeOriginal', 
-  'Make', 
-  'Model', 
-  'ExposureProgram', 
-  'FocalLengthIn35mmFilm', 
-  'FNumber', 
-  'ExposureTime', 
-  'ISOSpeedRatings', 
-  'Flash', 
-  'WhiteBalance', 
-  'UserComment' 
-  ); 
-</code> 
- 
-** IPTC ** 
- 
-Piwigo does **not** display any IPTC metadata by default. To enable it, add this code: 
- 
-<code>$conf['show_iptc'] = true;</code> 
-Then you must choose which fields to display. Again, you need key names obtained earlier. Here is an example: 
-<code> 
-$conf['show_iptc_mapping'] = array( 
-  'iptc_creator'         => '2#080', 
-  'iptc_title'           => '2#005', 
-  'iptc_headline'        => '2#105', 
-  'iptc_description'     => '2#120', 
-  'iptc_keywords'        => '2#025', 
-  ); 
-</code> 
- 
-=== Using your metadata to make Piwigo more powerful === 
- 
-([[user_documentation:use:features:conf_locale| Using the LocalFiles Editor]])\\ \\  
-Sometimes, only displaying metadata is actually not //that// useful. The information is retrieved "on-demand" when you open an image page. Since it is not integrated into the Piwigo database, you cannot use it to sort or search your photos. You will probably find that only displaying is satisfactory for Exif metadata such as focal length, shutter speed etc., however you can get more use from your IPTC metadata by adding it to the Piwigo database. 
- 
-Copying metadata into the Piwigo database takes place during the synchronisation step. If you [[user_documentation:learn:add_picture|added images]] to Piwigo using the built-in web interface, this should happen automatically for you. However, there are many different ways to add images, and sometimes the synchronisation step is missed. You will then need to perform it manually. (Administration → Tools → Synchronise ] Also, the changes in this section will only affect images that are imported from that point in time forward. To extract metadata from previously imported images, you need to run the synchronisation step. 
- 
- 
-** Exif ** 
- 
-Piwigo imports some Exif metadata by default. This is enabled by this code variable: 
-<code>$conf['use_exif'] = true;</code> 
-Next, the metadata is mapped. A mapping simply matches one key to another. The default code tells Piwigo to set an image's creation date in the database, to the value stored in the 'DateTimeOriginal' field in the Exif metadata. 
-<code> $conf['use_exif_mapping'] = array('date_creation' => 'DateTimeOriginal' ); </code> 
-This can be expanded by adding more mappings. (again, using Exif fields obtained earlier)\\  
-Here is an example: 
- 
-<code> 
-$conf['use_exif_mapping'] = array( 
-  'date_creation'        => 'DateTimeOriginal', 
-  'comment'              => 'UserComment', 
-  ); 
-</code> 
- 
-However, you will probably discover that there is no additional useful information to extract from Exif.  
- 
-** IPTC **\\  
-\\  
-Default: Not used.\\  
-Enabling variable: 
-<code>$conf['use_iptc'] = true;</code> 
-Example of extended mapping: 
-<code> 
-$conf['use_iptc_mapping'] = array( 
-  'author'          => '2#080', 
-  'name'            => '2#005', 
-  'comment'         => '2#120', 
-  'keywords'        => '2#025', 
-  ); 
-</code> 
-\\  
-** * Tip: ** Using keywords is an //excellent// way to organise your photos, and even to create 'SmartAlbums'. Keywords can be used for search filtering in the Batch Manager. If you already use keywords in Lightroom or other photo software suites, this mapping will make your life much easier. 
-=== Limitations === 
-One limitation to bringing metadata into Piwigo, is the number of database entries. In other words, we can't use all of the Exif metadata, because there is no place to put it. 
  
 
Back to top
playground/playground.1514246563.txt.gz · Last modified: 2017/12/26 00:02 by executive
 
 
github twitter newsletter Donate Piwigo.org © 2002-2024 · Contact