Addon:Photo Tagging Gramplet

From Gramps
Revision as of 09:45, 16 October 2013 by Aglebov (talk | contribs) (Edited the caption for the screenshot)
Jump to: navigation, search
The gramplet window consists of the toolbar, the selection area (center-left) and the list of tagged people (center-right).

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

The gramplet window consists of:

  • the toolbar
  • the selection area
  • the list of people tagged in the image

Selection area

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.

Toolbar

The toolbar contains nine buttons that are made active in accordance with the current state of selection.

The toolbar.

Each buttons carries a specific function.

Photo-Tagging-Select-icon.gif Displays the Gramps 'Select Person' dialog. Once selection is made, the person is tagged in the current box.

Photo-Tagging-New-icon.gif Creates a new person and displays the Gramps 'Person' dialog.

Photo-Tagging-Clear-icon.gif Removes the tag from the current box.

Photo-Tagging-Remove-icon.gif Removes the current box together with the tag.

Photo-Tagging-Edit-icon.gif Displays the Gramps 'Person' dialog for the person tagged in the current box.

Photo-Tagging-Zoomin-icon.gif Zooms the image in.

Photo-Tagging-Zoomout-icon.gif Zooms the image out.

Photo-Tagging-Detect-icon.gif Runs the detection algorithm.

Photo-Tagging-Settings-icon.gif Displays the gramplet settings dialog.

List of tagged people

The list contains the people tagged in the current image, as well as the selection boxes that have not yet been associated with a particular person.

Clicking on a row in the list selects the corresponding region in the image.

Double-clicking on a row with a person opens the Gramps 'Person' dialog for this person. This is equivalent to pressing the 'Edit' button in the gramplet toolbar.

To do

  • Good manual on this page
  • Detection of faces across multiple images
  • Integrate with Picasa