Add an example figure for the effect of --biggest/--best.

wavexx · Oct 26, 2013 · 299fd59 · 299fd59
1 parent 8fce9e5
commit 299fd59
Show file tree

Hide file tree

Showing 2 changed files with 10 additions and 0 deletions.
diff --git a/README.rst b/README.rst
@@ -48,6 +48,16 @@ The ``--biggest`` flag only outputs the biggest face in the image, while
 ``--best`` will attempt to select the face in focus and/or in the center of the
 frame.
 
+.. figure:: doc/biggest-best.jpg
+  :align: center
+
+  Comparison between ``--best`` (top) and ``--biggest`` (bottom). The actual
+  chosen face is highlighted in yellow.
+
+Unless DOF or motion blur is used effectively by the photographer to separate
+the subject, ``--biggest`` would in most cases select the same face as
+``--best``, while being significantly faster to compute.
+
 
 Examples
 --------

diff --git a/doc/biggest-best.jpg b/doc/biggest-best.jpg