GNOME.org
 

[gimp-help-2] Add mypaint-brush.xml

commit 8eef09aeb6c03f960a7c2d42914cbcdb9cab04d9
Author: Julien Hardelin <jhardlin orange fr>
Date:   Wed Jul 12 08:09:49 2017 +0200

    Add mypaint-brush.xml

 docs/MyPaint-brush-ex-base-opacity.xcf             |  Bin 0 -> 60839 bytes
 docs/MyPaint-brush-ex-hardness.xcf                 |  Bin 0 -> 106315 bytes
 images/C/toolbox/MyPaint-brush-collection.png      |  Bin 0 -> 41316 bytes
 images/C/toolbox/MyPaint-brush-ex-base-opacity.png |  Bin 0 -> 26074 bytes
 images/C/toolbox/MyPaint-brush-ex-hardness.png     |  Bin 0 -> 12604 bytes
 images/C/toolbox/MyPaint-brush-icon.png            |  Bin 0 -> 10431 bytes
 images/C/toolbox/MyPaint-brush-options.png         |  Bin 0 -> 27837 bytes
 images/C/toolbox/MyPaint-brush-toolbox.png         |  Bin 0 -> 35112 bytes
 images/C/toolbox/MyPaint-ex-hardness.png           |  Bin 0 -> 12608 bytes
 src/concepts/brushes.xml                           |    6 +
 src/toolbox/paint-tools.xml                        |    1 +
 src/toolbox/paint/MyPaint-brush.xml                |  289 ++++++++++++++++++++
 src/using/brushes.xml                              |   17 ++
 13 files changed, 313 insertions(+), 0 deletions(-)
---
diff --git a/docs/MyPaint-brush-ex-base-opacity.xcf b/docs/MyPaint-brush-ex-base-opacity.xcf
new file mode 100644
index 0000000..65fd932
Binary files /dev/null and b/docs/MyPaint-brush-ex-base-opacity.xcf differ
diff --git a/docs/MyPaint-brush-ex-hardness.xcf b/docs/MyPaint-brush-ex-hardness.xcf
new file mode 100644
index 0000000..ab6ff99
Binary files /dev/null and b/docs/MyPaint-brush-ex-hardness.xcf differ
diff --git a/images/C/toolbox/MyPaint-brush-collection.png b/images/C/toolbox/MyPaint-brush-collection.png
new file mode 100644
index 0000000..7ed6b2f
Binary files /dev/null and b/images/C/toolbox/MyPaint-brush-collection.png differ
diff --git a/images/C/toolbox/MyPaint-brush-ex-base-opacity.png 
b/images/C/toolbox/MyPaint-brush-ex-base-opacity.png
new file mode 100644
index 0000000..fb5f0e0
Binary files /dev/null and b/images/C/toolbox/MyPaint-brush-ex-base-opacity.png differ
diff --git a/images/C/toolbox/MyPaint-brush-ex-hardness.png b/images/C/toolbox/MyPaint-brush-ex-hardness.png
new file mode 100644
index 0000000..4c02250
Binary files /dev/null and b/images/C/toolbox/MyPaint-brush-ex-hardness.png differ
diff --git a/images/C/toolbox/MyPaint-brush-icon.png b/images/C/toolbox/MyPaint-brush-icon.png
new file mode 100644
index 0000000..b9523fc
Binary files /dev/null and b/images/C/toolbox/MyPaint-brush-icon.png differ
diff --git a/images/C/toolbox/MyPaint-brush-options.png b/images/C/toolbox/MyPaint-brush-options.png
new file mode 100644
index 0000000..1189324
Binary files /dev/null and b/images/C/toolbox/MyPaint-brush-options.png differ
diff --git a/images/C/toolbox/MyPaint-brush-toolbox.png b/images/C/toolbox/MyPaint-brush-toolbox.png
new file mode 100644
index 0000000..2dee07c
Binary files /dev/null and b/images/C/toolbox/MyPaint-brush-toolbox.png differ
diff --git a/images/C/toolbox/MyPaint-ex-hardness.png b/images/C/toolbox/MyPaint-ex-hardness.png
new file mode 100644
index 0000000..c98d863
Binary files /dev/null and b/images/C/toolbox/MyPaint-ex-hardness.png differ
diff --git a/src/concepts/brushes.xml b/src/concepts/brushes.xml
index 04ffaf4..8a2f412 100644
--- a/src/concepts/brushes.xml
+++ b/src/concepts/brushes.xml
@@ -207,4 +207,10 @@
     continuous brushstroke is painted. Each brush has an assigned default
     value for this, which can be modified using the Brushes dialog.
   </para>
+  <note>
+    <para>
+      GIMP-2.10 can use MyPaint brushes. Please refer to 
+      <xref linkend="gimp-tool-mypaint-brush"/> for more information.
+    </para>
+  </note>
 </sect1>
diff --git a/src/toolbox/paint-tools.xml b/src/toolbox/paint-tools.xml
index c555bc1..783a577 100644
--- a/src/toolbox/paint-tools.xml
+++ b/src/toolbox/paint-tools.xml
@@ -39,6 +39,7 @@
   <xi:include href="paint/blend.xml"/>
   <xi:include href="paint/pencil.xml"/>
   <xi:include href="paint/paintbrush.xml"/>
+  <xi:include href="paint/MyPaint-brush.xml"/>
   <xi:include href="paint/eraser.xml"/>
   <xi:include href="paint/airbrush.xml"/>
   <xi:include href="paint/ink.xml"/>
diff --git a/src/toolbox/paint/MyPaint-brush.xml b/src/toolbox/paint/MyPaint-brush.xml
new file mode 100644
index 0000000..aa8ab94
--- /dev/null
+++ b/src/toolbox/paint/MyPaint-brush.xml
@@ -0,0 +1,289 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+                       "http://www.docbook.org/xml/4.3/docbookx.dtd";>
+
+<sect2 id="gimp-tool-mypaint-brush">
+  <title>MyPaint Brush</title>
+
+  <indexterm>
+    <primary>Tools</primary>
+    <secondary>MyPaint Brush</secondary>
+  </indexterm>
+  <indexterm><primary>MyPaint Brush</primary></indexterm>
+
+  <figure>
+    <title>MyPaint Brush Tool</title>
+
+    <mediaobject>
+      <imageobject>
+        <imagedata format="PNG"
+          fileref="images/toolbox/MyPaint-brush-toolbox.png"/>
+      </imageobject>
+    </mediaobject>
+  </figure>
+
+  <para>
+    <acronym>MyPaint</acronym> is a free painting program that comes with a lot 
+    of specific brushes. Libmypaint has been modified in 2016 in a form that 
+    can be used by other programs. <acronym>GIMP-2.10</acronym> can use these 
+    brushes.
+  </para>
+  
+  <para>
+    You can find many collections of MyPaint brushes throughout the Web, in a 
+    compressed format, often in a .zip file. Unzip this file into a temp 
+    folder.
+  </para>
+  
+  <sect3>
+    <title>Installing MyPaint Brushes</title>
+    <para>
+      First go to
+      <menuchoice>
+        <guimenu>Preferences</guimenu>
+        <guisubmenu>Folders</guisubmenu>
+        <guimenuitem>MyPaint Brushes</guimenuitem>
+      </menuchoice>.
+      There, you will find the path to your personal Mypaint folder.
+      <itemizedlist>
+        <listitem>
+          <para>
+            <emphasis>Under Linux</emphasis>:             
+            home/YourUserName/.mypaint/brushes. Take good note it is a hidden 
+            directory.
+          </para>
+          <para>
+            Open your file browser. Check the option <quote>Show hidden 
+            files</quote>. Go to your personal MyPaint folder. If it does not 
+            exist yet, you have to create it, with the brushes directory inside.
+          </para>
+          <para>
+            Copy-paste all the unziped files from your temp folder to 
+            home/YourUserName/.mypaint/brushes.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            <emphasis>Under Windows 10 (and gimp-2.9.5)</emphasis>: 
+            ~\.mypaint\brushes. Click on this item to select it and click on 
+            the icon that opens a file browser. In the root of your home folder, 
+            create a new folder"mypaint". The Mypaint path in Preferences 
+            becomes C:\Users\your-user-name\mypaint.
+          </para>
+          <para>
+            Copy-paste all the unziped files from your temp folder to 
+            C:\Users\your-user-name\mypaint.
+          </para>
+        </listitem>
+      </itemizedlist>
+    </para>
+    <para>
+      Activate the tool as below: you should have got a MyPaint brush icon in 
+      the tool options dialog. Click on this icon to display all MyPaint 
+      brushes.
+    </para>
+  </sect3>
+  
+  <sect3>
+    <title>
+      <phrase>Activating the Tool</phrase>
+    </title>
+
+    <para>
+      There are different possibilities to activate the tool:
+    </para>
+
+    <itemizedlist>
+      <listitem>
+        <para>
+          From the image-menu:
+          <menuchoice>
+            <guimenu>Tools</guimenu>
+            <guisubmenu>Paint Tools</guisubmenu>
+            <guimenuitem>MyPaint Brush</guimenuitem>
+          </menuchoice>,
+        </para>
+      </listitem>
+
+      <listitem>
+        <para>
+          The Tool can also be called by clicking the tool icon:
+          <guiicon>
+            <inlinemediaobject>
+              <imageobject>
+                <imagedata fileref="images/toolbox/MyPaint-brush-icon.png" />
+              </imageobject>
+            </inlinemediaobject>
+          </guiicon>
+        </para>
+      </listitem>
+
+      <listitem>
+        <para>
+          or by clicking on the <keycap>Y</keycap> keyboard shortcut.
+        </para>
+      </listitem>
+    </itemizedlist>
+  </sect3>
+
+  <sect3>
+    <title>Options</title>
+
+    <figure>
+      <title>MyPaint Brush Tool Options</title>
+      <mediaobject>
+        <imageobject>
+        <imagedata format="PNG"
+            fileref="images/toolbox/MyPaint-brush-options.png"/>
+        </imageobject>
+      </mediaobject>
+    </figure>
+
+    <para>
+      The available tool options can be accessed by double clicking the
+      Mypaint brush tool icon.
+      <guiicon>
+        <inlinemediaobject>
+          <imageobject>
+            <imagedata format="PNG"
+              fileref="images/toolbox/MyPaint-brush-icon.png" />
+          </imageobject>
+        </inlinemediaobject>
+      </guiicon>
+    </para>
+    
+    <para>
+      Options may act somewhat differently according to the MyPaint brush you 
+      use.
+    </para>
+
+    <variablelist>
+      <varlistentry>
+        <term>Opacity</term>
+        <listitem>
+          <para>
+            To set the opacity of the brush (0.0 - 100.0). Opacity depends on a 
+            base: please see below.
+          </para>
+        </listitem>
+      </varlistentry>
+      
+      <varlistentry>
+        <term>Smooth stroke</term>
+        <listitem>
+          <para>
+            If this option is checked, strokes are smoother. Two options are 
+            available:
+          </para>
+          <itemizedlist>
+            <listitem>
+              <para>
+                <guilabel>Quality</guilabel>: TODO
+              </para>
+            </listitem>
+            <listitem>
+              <para>
+                <guilabel>Weight</guilabel>: TODO
+              </para>
+            </listitem>
+          </itemizedlist>
+        </listitem>
+      </varlistentry>
+      
+      <varlistentry>
+        <term>Brush</term>
+        <listitem>
+          <para>
+            The icon of the active brush is displayed. If you click on it, the 
+            MyPaint brushes list is displayed and you can select another brush
+          </para>
+          <figure>
+            <title>A collection of MyPaint brushes</title>
+            <mediaobject>
+              <imageobject>
+              <imagedata format="PNG"
+                  fileref="images/toolbox/MyPaint-brush-collection.png"/>
+              </imageobject>
+            </mediaobject>
+          </figure>
+          <para>
+            In the bottom bar of the dialog, you have buttons for smaller or 
+            larger icons, and view as list or as grid.
+          </para>
+        </listitem>
+      </varlistentry>
+      
+      <varlistentry>
+        <term>Erase with this brush</term>
+        <listitem>
+          <para>
+            If this option is checked, the brush acts as an eraser. As for the 
+            Eraser tool, erased areas are transparent if there is an alpha 
+            layer, have the background color if there is no alpha layer.
+          </para>
+        </listitem>
+      </varlistentry>
+      
+      <varlistentry>
+        <term>Radius</term>
+        <listitem>
+          <para>
+            To set the radius of the brush.
+          </para>
+        </listitem>
+      </varlistentry>
+      
+      <varlistentry>
+        <term>Base opacity</term>
+        <listitem>
+          <para>
+            These values (0.00 - 2.00) are multiplying factors: if, for 
+            example, you set this option to 0.50, the maximal opacity becomes 
+            100 * 0.50 = 50, although it is still 100.0 in the Opacity option.
+          </para>
+          <figure>
+            <title>Base opacity example</title>
+            <mediaobject>
+              <imageobject>
+              <imagedata format="PNG"
+                  fileref="images/toolbox/MyPaint-brush-ex-base-opacity.png"/>
+              </imageobject>
+            </mediaobject>
+          </figure>
+          <para>
+            Base opacity can exceed 1.00 up to 2.00. Of course, opacity can not 
+            exceed 100. In the example, you can see that an opacity option 
+            above 50 (100 * 2.00 = 200) is actually an opacity at 100, and 25 * 
+            200 = 50 is equivalent to 50 * 1.00 = 50. But this possibility is 
+            useful when your Mypaint brush has a default opacity less than 100.
+          </para>
+        </listitem>
+      </varlistentry>
+      
+      <varlistentry>
+        <term>Hardness</term>
+        <listitem>
+          <para>
+            The harder the brush the sharper the brush. When you reduce 
+            hardness, the Mypaint brush may not act if the the brush size is 
+            too small.
+          </para>
+          <figure>
+            <title>Hardness example</title>
+            <mediaobject>
+              <imageobject>
+              <imagedata format="PNG"
+                  fileref="images/toolbox/MyPaint-brush-ex-hardness.png"/>
+              </imageobject>
+              <caption>
+              <para>
+                This MyPaint brush doesn't act when hardness is less than 0.70.
+              </para>
+            </caption>
+            </mediaobject>
+          </figure>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+ </sect3>
+</sect2>
diff --git a/src/using/brushes.xml b/src/using/brushes.xml
index 7408358..548e8af 100644
--- a/src/using/brushes.xml
+++ b/src/using/brushes.xml
@@ -108,6 +108,23 @@
         </para>
       </listitem>
     </varlistentry>
+    <varlistentry>
+      <term>MYB</term>
+      <listitem>
+        <indexterm>
+          <primary>MYB</primary>
+        </indexterm>
+        <indexterm>
+          <primary>Formats</primary>
+          <secondary>MYB</secondary>
+        </indexterm>
+        <para>
+          The <filename>.myb</filename> format is used for MyPaint brushes.
+          Please refer to <xref linkend="gimp-tool-mypaint-brush"/> for more 
+          information.
+        </para>
+      </listitem>
+    </varlistentry>
   </variablelist>
   <para>
     To make a brush available, place it in one of the folders in GIMP's brush
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]