[[avpicfacexmptagger:main]]
Trace: » avmapsloadermanual_1.x » staticnokiamapstables » start

Differences

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

avpicfacexmptagger:main [2010/03/05 16:16]
andreas_vogel Version 1.6 		avpicfacexmptagger:main [2010/04/08 18:39] (current)
andreas_vogel
Line 1: Line 1:
 +{{AvPicFaceXmpTagger_Main_Tagging.png?nolink}}
 +
====== AvPicFaceXmpTagger ====== ====== AvPicFaceXmpTagger ======
Line 13: Line 15:
**Feature list for AvPicFaceXmpTagger:** **Feature list for AvPicFaceXmpTagger:**
  * Read Picasa 3.5 face definitions for a given list of pictures and write them as XMP metadata tags inside the picture files.   * Read Picasa 3.5 face definitions for a given list of pictures and write them as XMP metadata tags inside the picture files.
-  * Optionally add the person names as XMP keywords and/or IPTC keywords +  * Optionally add the person names as XMP keywords, IPTC and XMP-LR (Lightroom) keywords 
-  * The tagging work is actually done using exiftool+  * Uses and includes a hierarchical keyword manager compatible with Lightroom 
 +  * Optionally add face name path and face name keyword cloud to tags using the hierarchical keyword manager 
 +  * Several tagging options can be set per file type (file extension) 
 +  * Supports XMP sidecar files 
 +  * The tagging work is actually done using exiftool (so MakerNote tags will be preserved)
  * Show detailed information for a picture file:   * Show detailed information for a picture file:
    * Picasa and XMP defined faces     * Picasa and XMP defined faces
Line 59: Line 65:
===== Program Manual ===== ===== Program Manual =====
-==== Menu: File ==== +[[avpicfacexmptagger:manual|AvPicFaceXmpTagger User Manual with screenshots]]
- +
-=== Add Directory... === +
- +
-Choosing this menu item a directory selection dialog box will open. Choose a directory to be added to the Files/Directory selection list. +
- +
-=== Add Files... === +
- +
-Choosing this menu item a file selection dialog box will open. Choose one or more JPEG file(s) to be added the Files/Directory selection list. +
- +
-=== Exit === +
- +
-Terminate the program. If the current directory is writable, the .ini file holding the program option is written/updated prior exit. +
- +
-==== Menu: Extras ==== +
- +
-=== Options... === +
- +
-Choosing this menu item the options dialog will open. +
- +
-== Group Box: ExifTool == +
- +
-This program needs ExifTool for tagging the JPEG files. With this option you can specify where to find the exiftool executable. +
- +
-* Search exiftool in search path +
-* Use this path for exiftool: +
- +
-== Group Box: Picasa Contacs File == +
- +
-As a default this program uses the standard path to the Picasa contacts file. But you can define another path if some reason this standard path is not correct. +
- +
-==== Menu: Help ==== +
- +
-=== Changelog... === +
- +
-This dialog box shows the change log for the different versions of this program. +
- +
-=== About... === +
- +
-Information about this program and copyright notice. +
- +
-==== Tab: Tagging ==== +
- +
-=== Group Box: Picasa Contacts === +
- +
-At the start of the program or whenever the path to the Picasa contacs file was changed in the program options dialog, the Piacasa contacs file is read in. +
-If the contacts file cannot be found, read or if there any contacts defined, an error message is displayed here and tagging will not be possible at all. +
- +
-=== Group Box: Files/Directories Selection === +
- +
-In this tab the directories or files to be tagged are specified. Either use the File->Add Directory... or File->Add Files... menu items or just add files or directories by drag&drop from a explorer window. +
- +
-The checkbox "Include subdirectories" controls if for directories also subdirectories are scanned for pictures with Picasa face definitions. +
- +
-Just for your information and for curious people interested in statistics, the number of directories, files, persons and faces which belongs to the current selection is displayed.  +
- +
-=== Group Box: Options == +
- +
-The option "Create backup files" controls if exiftool is required to create a backup file of the JPEG picture before doing the tagging. As a default this option is turned off as it will create a lot of files in normal operation when turned on. So this option is here mainly for testing and evaluation purposes. +
- +
-The "IPTC:Keyword tags" and the "XMP-DC:Subject tags" options controls what to do with IPTC Keyword and XMP Subject tags. +
-Both tags are string list tags - they can hold an arbitrary number of strings as it's value. +
- +
-The IPTC:Keyword is used by Picasa. The XMP-DC:Subject tag is used by Microsoft. +
-Basically it's a good idea to add the people names as tags. +
- +
-There are following possibilities: +
-  * **Don't touch**: don't touch this tag. Nothing will be deleted or added to this tag. +
-  * **Delete all**: this tag is deleted entirely. +
-  * **Delete persons**: only the person names or the person hash IDs are deleted from the tag. All other tag members remain. +
-  * **Add persons**: the persons are added to the tag. Duplicates are avoided. +
-    * When you check the checkbox "**and add. keywords**" the keywords defined in the keyword list in the "Add. Keywords" tabs are added additionally during the tagging operation. This checkbox can only be checked if there are additional keywords defined. +
- +
-==== Starting the tagging process ==== +
- +
-The tagging process is started by pressing the START button. All directories given in the directory selection list are scanned for picasa.ini files and the corresponding picture files. All files in the selection list are searched in the picasa.ini file in order to find a face definition. +
- +
-For each picture file with face definitions found the program creates/deletes the tags according to the options settings. +
- +
-The tagging process can be cancelled by pressing the Cancel button. +
- +
-==== Tab: Logging ==== +
- +
-The logging tab shows the exiftool command lines which were executed by the last tagging run. This output is mainly used for debugging and by curious people who wanna know how exiftool is called. +
- +
-==== Tab: Picasa Contacs ==== +
- +
-In this tab a simple list with all loaded Picasa contacts is shown. This list is currently just for information and of no real use. +
- +
-===== Screenshots ===== +
- +
-==== Main Window ==== +
- +
-This screenshot shows the main window of AvPicFaceXmpTagger. +
- +
-{{AvPicFaceXmpTagger_Main_Tagging.png?nolink}} +
- +
-==== Additional keyword definitions ==== +
- +
-In this list box you can define additional keywords to be added while tagging the pictures. +
-The keywords are sorted alphabetically in the list. You can delete a keyword by selecting it and then pressing the <DEL> key. +
-By pressing the "Clear" button, all list entries are deleted. +
- +
-It is possible to save the keyword list to as text file (just a simple text file with one keyword on each line) with the "Save to file..." button. And of course a text file can be loaded into the keyword list withe the "Load from file..." button. When loading from file, all existing keywords are deleted. +
- +
-{{avpicfacexmptagger_main_addkeywords.png?nolink}} +
- +
-==== Options Dialog ==== +
- +
-This screenshot shows the options dialog for AvPicFaceXmpTagger. +
- +
-{{AvPicFaceXmpTagger_Options.png?nolink}} +
- +
- +
-==== Picture Information Display ==== +
- +
-This dialog box can be opened either by double-clicking on a filename in the file selection list or by selecting a filename and activating the "File Props..." button. +
- +
-=== Pic Info Display: Main Display === +
- +
-In the main view you can see the picture on the left side. On the right side some basic information fields are shown in the upper half. In the lower half you can see the defined faces and the defined keywords. +
- +
-{{avpicfacexmptagger_picdisplay_main.png?nolink}} +
- +
-=== Pic Info Display: Main with Face 1 === +
- +
-Whenever you move with your mouse on a defined face you'll see it's name below the face box. +
- +
-{{avpicfacexmptagger_picdisplay_main1.png?nolink}} +
- +
-=== Pic Info Display: Main with Face 2 === +
- +
-Whenever you select a person, the picture will be dimmed and only the persons face remains bright. When no person is selected the whole picture will be shown normal again. +
- +
-{{avpicfacexmptagger_picdisplay_main2.png?nolink}} +
- +
-=== Pic Info Display: Google Maps Display === +
- +
-{{avpicfacexmptagger_picdisplay_googlemaps.png?nolink}} +
- +
-=== Pic Info Display: XMP Tree View === +
- +
-The XMP data is an XML structure. You can see here the complete XMP data structure as a tree. The XMP data can be exported to a text file by pressing the "Write XML file..." button. +
- +
-{{avpicfacexmptagger_picdisplay_xmptree.png?nolink}} +
- +
-=== Pic Info Display: IPTC Tags === +
- +
-You can see here all defined IPTC tags. +
- +
-{{avpicfacexmptagger_picdisplay_iptctags.png?nolink}} +
- +
-=== Pic Info Display: EXIF Tags === +
- +
-You can see here all defined EXIF tags. +
- +
-{{avpicfacexmptagger_picdisplay_exiftags.png?nolink}} +
- +
-=== Pic Info Display: JPEG Tags === +
- +
-You can see here all defined JPEG tags. +
- +
-{{avpicfacexmptagger_picdisplay_jpegtags.png?nolink}} +
- +
-=== Pic Info Display: All Tags === +
- +
-You can see here all defined tags (without the XMP data) as a tree. By pressing the "Write XML file..." button you can save the complete tag tree as an XML file. This XML file even contains the DTD. +
- +
-{{avpicfacexmptagger_picdisplay_alltags.png?nolink}} +
===== Links ===== ===== Links =====
Line 257: Line 94:
I don't wanna charge for this program. On the other side, creating and maintaining this program took and takes time and donations are welcome. I don't wanna charge for this program. On the other side, creating and maintaining this program took and takes time and donations are welcome.
-So if you use and like this software you might wanna consider a donation. +So if you use and like this software you might wanna consider a donation. 
 + 
 +Until now I've received 2 donations (thanks to the donators). 
 + 
 +If you wanna donate, 10€/15$ would be quite reasonable, that's about one visit at the movie theatre. Higher donations are welcome though.
<html> <html>
Line 271: Line 112:
===== Download ===== ===== Download =====
 +
 +==== Version 1.7 ====
 +
 +  * **Release Date:** 07.04.2010
 +  * **Download:**\\ __Due to a small bug I've uploaded a corrected version. For the first 19 people who downloaded the previous version please download this version again.__\\ {{AvPicFaceXmpTagger_1.7.zip|AvPicFaceXmpTagger GUI Version 1.7}}\\ AvPicFaceXmpTagger Console Version 1.7 (not released yet)
 +  * **Note:**\\ I've tried hard to test as much as possible. Please, like always with a new version, test it with non-critical pictures or do a backup. And don't forget to report your experiences in the forum.
 +  * **Changes:**
 +    * This release contains a huge amount of changes and fixes. Please check out this version carefully and test it with data for which you have a backup.
 +    * The internal EXIFTOOL executable has been updated to version 8.16.
 +    * The options form now has an additional tab page where you can define various options for different file types. Some new options have been added.
 +    * It's now possible to specify if IPTC tags are written as UTF-8 or LATIN1.
 +    * It's now possible to specify if the file modification time is updated or not.
 +    * It's now possible to specify if XMP data should be created if it doesn't already exist. This applies to embedded XMP data in the picture file and to XMP sidecar files.
 +    * It's now possible to specify if existing EXIF GPS tags are to be copied to XMP.
 +    * The complete keyword handling has been changed. The program now uses hierarchical keywords represented as a keyword tree. The keywords are read from a keyword file in a way Lightroom and other programs are using it.
 +    * The keyword tab showing the hierarchical keyword tree offers editing capabilities. Categories, keywords and synonyms can be created or edited. Keyword files can be loaded, added and saved.
 +    * There is a new XMP extension called AnVoItFaceInfo with the elements FaceNames, HierarchicalFaceNames and FaceKeywords. These tags can be used just to get the face dependant values. The dc:subject and the other keyword tags are used for all kind of keywords, this is the reason why these tags have been created. Writing/deleting these tags is optional.
 +    * Due to the new hierarchical keyword feature, it's now possible to add the hierarchical face name path to the various keyword tags. Furthermore it's possible to add the face name keyword cloud. The face name keyword cloud consists of the face name path elements when walking up the tree including all direct synonyms for each path element.
 +    * It's now possible to specify the default keyword file in the options form.
 +    * A bug has been fixed which caused keyword duplicates in tags.
 +    * The handling of existing faces in a picture has been corrected.
==== Version 1.6 ==== ==== Version 1.6 ====
Line 285: Line 147:
    * New feature: added the possibility to add/delete XMP Lightroom Hierarchical Subject tags.     * New feature: added the possibility to add/delete XMP Lightroom Hierarchical Subject tags.
         
 +
==== Version 1.5 ==== ==== Version 1.5 ====
avpicfacexmptagger/main.1267802219.txt.gz · Last modified: 2010/03/05 16:17 (external edit)
www.chimeric.de Valid CSS Driven by DokuWiki do yourself a favour and use a real browser - get firefox!! Recent changes RSS feed Valid XHTML 1.0