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.

Reply via email to