Addon:Photo Tagging Gramplet

From Gramps
Revision as of 08:33, 16 October 2013 by Aglebov (talk | contribs) (Toolbar: Added toolbar buttons with descriptions)
Jump to: navigation, search

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

Toolbar

The toolbar.

Photo-Tagging-Select-icon.gif Displays the Gramps 'Select Person' dialog.

File:Add.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.

Workflow

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
  • Detection of faces across multiple images
  • Integrate with Picasa