Difference between revisions of "Addon:Photo Tagging Gramplet"

From Gramps
Jump to: navigation, search
m (Aglebov moved page PhotoTaggingGramplet to Photo Tagging Gramplet: Include spaces in the title)
(Created usage section)
Line 18: Line 18:
 
Automatic detection of faces requires the following to be installed:
 
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.
 
* 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.
  
 
[[Category:Plugins]]
 
[[Category:Plugins]]
 
[[Category:Developers/General]]
 
[[Category:Developers/General]]
 
[[Category:Gramplets]]
 
[[Category:Gramplets]]

Revision as of 16:30, 15 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.