Skip to content

Microos/FaceAnnotationTool

Repository files navigation

FAT- Face Annotation Tool

This is an Java implementation of Face Annotation Tool. It helps you to mark faces using ellipses (FDDB style) in stead of common bounding boxes.

Usage:

1. Load Images

Choose a txt file contains absolute paths of images.

2. Load Image Annotations (Optional)

Choose a txt file has the following format:

<image name i>
<number of faces in this image =im>
<face i1>
<face i2>
...
<face im>
...

Here, each face is denoted by:
<major_axis_radius minor_axis_radius angle center_x center_y 1>.
(The 1 in the last of each face can be any value since it won't be read.)

The image names have to be identical to the absolute paths of images you loaded in previous step.
Or you can have relative paths in the annotation file but with prefix and suffix
set up in prompts.

3. Mark Faces

  1. Left click to add a key point. Three key points to form an ellipse mark.
  2. Shift + Mouse Move to activate a new marked ellipse.
  3. Right click to cancel a key point of an activated ellipse or an unfinished key point.
  4. Click the coordinates on the right table to highlight the corresponding ellipse.

4. Output Your Work

Output your work to a txt file with an identical format of input annotation file.

Testing with FDDB images:

Get fddb images and annotations by executing download_fddb.sh

Demo:

  1. Left click to add key points.

  2. Click a coordinate on the right table to highlight an ellipse.

  3. Shift + Mouse Move to active a new marked ellipse.

  4. Right click to cancel a key point of an activated ellipse or an unfinished key point.

TODO:

  • basic functions
  • ask for prefix and suffix when load imglist
  • shift choose on ellipse -> highlight right table row
  • click on right table row(if static) -> enlarge stroke
  • click on right table row(if non-static) -> set as activated ellipse
  • load imglist -> disable load img button
  • one click after load -> disable load annotation button
  • load annotation -> disable load annotation button
  • output file function
  • switch to another image -> clear the unfinished key point stack.

About

An interactive face bounding ellipse annotating (FDDB style) tool.

Resources

License

Stars

Watchers

Forks

Packages

No packages published