Difference between revisions of "Addon:Photo Tagging Gramplet"

From Gramps
Jump to: navigation, search
m (Installation)
(Added Todo section)
Line 26: Line 26:
  
 
To associate a region with a different person, click within the region and use the toolbar buttons to select or add a person. In this case, the previous association is discarded.
 
To associate a region with a different person, click within the region and use the toolbar buttons to select or add a person. In this case, the previous association is discarded.
 +
 +
== To do ==
 +
* Good manual on this page
 +
* GIMP-like resizing of selection boxes
 +
* Detection of faces across multiple images
 +
* Progress bar while detection is performed
 +
* Settings dialog
 +
* Thumbnail images of people in the list
  
 
[[Category:Plugins]]
 
[[Category:Plugins]]
 
[[Category:Developers/General]]
 
[[Category:Developers/General]]
 
[[Category:Gramplets]]
 
[[Category:Gramplets]]

Revision as of 10:49, 5 October 2013

What is Photo Tagging Gramplet

Photo Tagging Gramplet facilitates tagging people in photographs, i.e. associating regions of images with Gramps persons.

Features

  • Image preview with scrolling and zooming
  • List of persons tagged in the current photograph
  • Adding and modifying regions and associations
  • Detecting faces automatically

Installation

The Photo Tagging gramplet can be installed from within Gramps. Go to Edit -> Preferences and click the Check now button to see a list of plugins which are not installed on your computer.

Automatic detection of faces requires the following to be installed:

  • OpenCV, its dependencies and Python bindings. This library should be available in common Linux distributions. For example, Debian package python-opencv provides the Python bindings for the library. It will require the core library packages (libopencv-*), as well as python-numpy package, to be installed. If OpenCV is not found, the automatic detection feature will be unavailable, but the gramplet should otherwise function correctly.

Usage

To tag a person, select a region of the image by pressing the left mouse button in one of its corners and dragging the pointer across the desired area. A rectangular frame will mark the selected area. Use the toolbar to select an existing person or add a new person to be associated with the region.

To modify a region, press the left mouse button over one of the corners and drag it to its new position.

To associate a region with a different person, click within the region and use the toolbar buttons to select or add a person. In this case, the previous association is discarded.

To do

  • Good manual on this page
  • GIMP-like resizing of selection boxes
  • Detection of faces across multiple images
  • Progress bar while detection is performed
  • Settings dialog
  • Thumbnail images of people in the list