[documentation/digikam-doc/sphinx] /: add face tagging

[Gilles Caulier]

Git commit 56e943765ebbe454519f28f6975d0caaa3f86c3a by Gilles Caulier.
Committed on 19/12/2022 at 15:31.
Pushed by cgilles into branch 'sphinx'.

add face tagging

D  +-    --    attic/digikam/using-facetagging-addfacetag.png
D  +-    --    attic/digikam/using-facetagging-drawregion.png
D  +0    -60   attic/digikam/using-facetagging.docbook
A  +-    --    main_window/images/using-mainwindow-addfacetag.png
A  +-    --    main_window/images/using-mainwindow-drawregion.png
M  +19   -0    main_window/people_view.rst

https://invent.kde.org/documentation/digikam-doc/commit/56e943765ebbe454519f28f6975d0caaa3f86c3a

diff --git a/attic/digikam/using-facetagging-addfacetag.png b/attic/digikam/using-facetagging-addfacetag.png
deleted file mode 100644
index b4e9a70..0000000
Binary files a/attic/digikam/using-facetagging-addfacetag.png and /dev/null differ
diff --git a/attic/digikam/using-facetagging-drawregion.png b/attic/digikam/using-facetagging-drawregion.png
deleted file mode 100644
index f8b6b5e..0000000
Binary files a/attic/digikam/using-facetagging-drawregion.png and /dev/null differ
diff --git a/attic/digikam/using-facetagging.docbook b/attic/digikam/using-facetagging.docbook
deleted file mode 100644
index 2929e02..0000000
--- a/attic/digikam/using-facetagging.docbook
+++ /dev/null
@@ -1,60 +0,0 @@
-<sect1 id="using-facetagging">
-    <title>Face tagging with &digikam;</title>
-
-    <para>
-        &digikam; allows for either manual or automatic face tagging.
-    </para> 
-     
-    <para>
-    For more information about face tagging using &digikam;'s face recognition engine see <link linkend="tool-maintenance-features-faces">The Face Management Tool</link> and <link linkend="using-mainwindow-peopleview">People View</link>.
-    </para>
-    
-    <para>
-    For tagging people manually, you can preview an image, click on <guilabel>Add a Face Tag</guilabel> icon highlighted on the screenshot below.
-    </para>
-    
-    <screenshot>
-        <screeninfo>Adding a Face Tag</screeninfo>
-        <mediaobject>
-            <imageobject>
-                <imagedata fileref="&path;using-facetagging-addfacetag.png" format="PNG" />
-            </imageobject>
-            <textobject>
-                <phrase>
-                    Adding a Face Tag
-                </phrase>
-            </textobject>
-        </mediaobject>
-    </screenshot>
-    
-    <para>
-        And then draw a rectangle around the face while holding &LMB; followed by entering the person's name and pressing &Enter;.
-    </para>
-        
-    <screenshot>
-        <screeninfo>Drawing a Face Tag</screeninfo>
-        <mediaobject>
-            <imageobject>
-                <imagedata fileref="&path;using-facetagging-addfacetag.png" format="PNG" />
-            </imageobject>
-            <textobject>
-                <phrase>
-                    Drawing a Face Tag
-                </phrase>
-            </textobject>
-        </mediaobject>
-    </screenshot>
-    <para>
-        Instead of clicking on <guilabel>Add a Face Tag</guilabel> icon you can draw a face region while holding &Ctrl; key.
-    </para>
-    
-</sect1>
-
-<!--
-Local Variables:
-mode: sgml
-sgml-omittag: nil
-sgml-shorttag: t
-End:
--->
-        
diff --git a/main_window/images/using-mainwindow-addfacetag.png b/main_window/images/using-mainwindow-addfacetag.png
new file mode 100644
index 0000000..0a180c3
Binary files /dev/null and b/main_window/images/using-mainwindow-addfacetag.png differ
diff --git a/main_window/images/using-mainwindow-drawregion.png b/main_window/images/using-mainwindow-drawregion.png
new file mode 100644
index 0000000..7aef0e2
Binary files /dev/null and b/main_window/images/using-mainwindow-drawregion.png differ
diff --git a/main_window/people_view.rst b/main_window/people_view.rst
index ad7b4e2..a6f4e2e 100644
--- a/main_window/people_view.rst
+++ b/main_window/people_view.rst
@@ -67,3 +67,22 @@ Face Recognition is faster than Face Detection but it still makes sense to click
 In case of unsatisfying results it might be helpful to use Clear and rebuild all training data. One reason can be that there are too many face tags assigned to a person which shows this person in a way that doesn't really help the search algorithm, e.g. with sunglasses, blurred, unusual colors, carnival make up, dark shaded areas in the face, baby/kid/adult photographs mixed... Another reason to use that option can be false face recognition due to a wrong accuracy setting in the Parameters tab.
 
 To start the Face Recognition you click Scan. The process will tag every recognized face with the appropriate People tag out of your tag tree and the corresponding thumbnail will disappear from the "Unknown" tag selection.
+
+Manual Face tagging
+~~~~~~~~~~~~~~~~~~~
+
+digiKam allows for either manual face tagging.
+
+For more information about face tagging using digiKam's face recognition engine see The Face Management Tool.
+
+For tagging people manually, you can preview an image, click on Add a Face Tag icon or select option on context menu, as highlighted on the screenshot below.
+
+.. figure:: images/using-mainwindow-addfacetag.png
+
+And then draw a rectangle around the face while holding left mouse button followed by entering the person's name and pressing Enter.
+
+.. figure:: images/using-mainwindow-drawregion.png
+
+.. note::
+
+    Instead of clicking on Add a Face Tag icon you can draw a face region while holding Ctrl key.