From 3b15de46bc1613eeca3cd86201bef56ba5c79616 Mon Sep 17 00:00:00 2001
From: Marc Jeanmougin <marc@jeanmougin.fr>
Date: Tue, 20 Aug 2019 18:44:52 +0200
Subject: Add help text

---
 share/ui/dialog-trace.glade | 50 ++++++++++++++++++++++++++++++++++++---------
 1 file changed, 40 insertions(+), 10 deletions(-)

diff --git a/share/ui/dialog-trace.glade b/share/ui/dialog-trace.glade
index ba4ff6786..92cfd2340 100644
--- a/share/ui/dialog-trace.glade
+++ b/share/ui/dialog-trace.glade
@@ -88,6 +88,25 @@
     <property name="step_increment">1</property>
     <property name="page_increment">10</property>
   </object>
+  <object class="GtkTextBuffer" id="helptext">
+    <property name="text" translatable="yes">
+  This dialogs allows you to automatically convert a bitmap into vector paths. Several options are available depending on your use case :
+ * Brightness cutoff detects area that are darker than the threshold and create a path enclosing them (using potrace);
+ * Edge detection detects changes greater than the given threshold in the brightness of color patches and creates paths to separate them (using potrace)
+ * Color quantization separates the image into the given number of colors, and separates them with a path (using potrace);
+ * Autotrace uses the autotrace algorithm with the given option;
+ * Centerline tracing tries to vectorize a line image (with autotrace);
+ * "Multiple scans" options separate the image into a number of scans, depending on brightness, color separation, or gray levels, and creates several paths for those. It can also use autotrace for those.
+ * The pixel art tab allows to use the depixelize algorithm to vectorize pixel art images.
+
+ * WARNINGS:
+  1) Save your work before tracing
+  2) Watch your pixel count: trace pixel art creates one path per pixel, it is not recommended for images that are not pixel art.
+  3) Autotrace is slower than potrace, it is not recommended for big images. Preprocessing your images to increase contrast is recommended.
+  4) If your goal is to get few nodes and good precision, manual tracing is always best.
+</property>
+</object>
+
   <object class="GtkBox" id="mainBox">
     <property name="visible">True</property>
     <property name="can_focus">False</property>
@@ -167,7 +186,7 @@
                                       <object class="GtkLabel">
                                         <property name="visible">True</property>
                                         <property name="can_focus">False</property>
-                                        <property name="label" translatable="yes">Threshold (1)</property>
+                                        <property name="label" translatable="yes">Brightness threshold</property>
                                       </object>
                                       <packing>
                                         <property name="expand">False</property>
@@ -202,7 +221,7 @@
                                       <object class="GtkLabel">
                                         <property name="visible">True</property>
                                         <property name="can_focus">False</property>
-                                        <property name="label" translatable="yes">Threshold (2)</property>
+                                        <property name="label" translatable="yes">Edge threshold</property>
                                       </object>
                                       <packing>
                                         <property name="expand">False</property>
@@ -867,14 +886,25 @@ Output
               </packing>
             </child>
             <child>
-              <object class="GtkLabel">
+
+<object class="GtkScrolledWindow">
                 <property name="visible">True</property>
-                <property name="can_focus">False</property>
-                <property name="label" translatable="yes">Inkscape bitmap tracing 
-is based on Potrace by Peter Selinger
-and on autotrace</property>
-                <property name="justify">center</property>
-              </object>
+<property name="can_focus">True</property>
+<property name="hscrollbar_policy">never</property>
+<property name="shadow_type">in</property>
+  <child>
+  <object class="GtkTextView">
+    <property name="visible">True</property>
+    <property name="can_focus">True</property>
+    <property name="editable">False</property>
+    <property name="wrap_mode">word</property>
+    <property name="buffer">helptext</property>
+  </object>
+</child>
+</object>
+
+
+
               <packing>
                 <property name="position">2</property>
               </packing>
@@ -883,7 +913,7 @@ and on autotrace</property>
               <object class="GtkLabel">
                 <property name="visible">True</property>
                 <property name="can_focus">False</property>
-                <property name="label" translatable="yes">Credits</property>
+                <property name="label" translatable="yes">Help</property>
               </object>
               <packing>
                 <property name="position">2</property>
-- 
cgit v1.2.3