Difference between revisions of "Addon:Photo Tagging Gramplet"

From Gramps
Jump to: navigation, search
(Created usage section)
m (Installation)
Line 14: Line 14:
 
== Installation ==
 
== 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.
+
The Photo Tagging gramplet can be installed from within Gramps. Go to {{man menu|Edit -> Preferences}} and click the {{man button|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:
 
Automatic detection of faces requires the following to be installed:

Revision as of 09:10, 16 September 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.