WIP Magic size option; regen docs for 0.9.30 version

Makefile

@@ -4,7 +4,7 @@
 # Various contributors (see AUTHORS.txt)
 # https://tuxpaint.org/
 
-# June 14, 2002 - April 3, 2023
+# June 14, 2002 - April 9, 2023
 
 
 # The version number, for release:
@@ -17,7 +17,7 @@ ifdef SOURCE_DATE_EPOCH
 else
   VER_DATE=$(shell date "+%Y-%m-%d")
 endif
-MAGIC_API_VERSION:=0x00000007
+MAGIC_API_VERSION:=0x00000008
 
 # Need to know the OS
 

docs/CHANGES.txt

@@ -22,6 +22,13 @@ https://tuxpaint.org/
     * Slight improvement to shape calculations
       Bill Kendrick <bill@newbreedsoftware.com>
 
+  * Improvements to Magic tools:
+    ----------------------------
+    * WIP Support for sizes in Magic tools via the plugin API.
+      Closes https://sourceforge.net/p/tuxpaint/feature-requests/220/
+      Note: Bumps `TP_MAGIC_API_VERSION` to 0x00000008.
+      Bill Kendrick <bill@newbreedsoftware.com>
+
   * Localization Updates:
     ---------------------
     * Chinese (Simplified) translation

docs/en/MAGIC-API.txt

@@ -6,7 +6,7 @@ Magic Tool Plugin API Documentation
         Copyright © 2007-2023 by various contributors; see AUTHORS.txt.
                              https://tuxpaint.org/
 
-                                January 25, 2023
+                                 April 9, 2023
 
              +----------------------------------------------------+
              |Table of Contents                                   |
@@ -295,6 +295,15 @@ Magic Tool Plugin API Documentation
            Note: Called once for each Magic tool your plugin claims to
            contain (by your "get_tool_count()").
 
+   int accepted_sizes(magic_api * api, int which)
+
+           Return how many size variations the 'Magic' tool accepts. Return a
+           '0' if the 'Magic' tool should not offer sizing options. Returning
+           '1' is the same as returning '0'.
+
+           Note: Called once for each Magic tool your plugin claims to
+           contain (by your "get_tool_count()").
+
    void shutdown(magic_api * api)
 
            The plugin should do any cleanup here. If you allocated any memory
@@ -367,6 +376,20 @@ Magic Tool Plugin API Documentation
            Note: Changed most recently in Tux Paint 0.9.29; Magic API version
            0x00000007.
 
+   void set_size(magic_api * api, int which, SDL_Surface * canvas,
+   SDL_Surface * last, Uint8 size, SDL_Rect * update_rect)
+
+           Tux Paint will call this function to inform the plugin of the
+           'Magic' tool size option chosen. (It will be called whenever one
+           of the plugin's Magic tools that accept sizes becomes active, and
+           whenever the user picks a new size while such a tool is currently
+           active.)
+
+           Generally, Magic tools will not alter the canvas in any way when
+           receiving an updated size, but it is possible.
+
+           Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008.
+
    void click(magic_api * api, int which, int mode, SDL_Surface * snapshot,
    SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect)
 

docs/en/html/MAGIC-API.html

@@ -102,7 +102,7 @@
           </p>
 
           <p>
-            January 25, 2023          </p>
+            April  9, 2023          </p>
         </center>
       </header>
 
@@ -385,6 +385,14 @@
                   <b>Note:</b> Called once for each Magic tool your plugin claims to contain (by your "<code>get_tool_count()</code>").                </p>
               </dd>
 
+              <dt><code><b>int accepted_sizes(magic_api * api, int which)</b></code></dt>
+              <dd>
+                <p>
+                  Return how many size variations the 'Magic' tool accepts. Return a '0' if the 'Magic' tool should not offer sizing options. Returning '1' is the same as returning '0'.                </p>
+                <p>
+                  <b>Note:</b> Called once for each Magic tool your plugin claims to contain (by your "<code>get_tool_count()</code>").                </p>
+              </dd>
+
               <dt><code><b>void shutdown(magic_api * api)</b></code></dt>
               <dd>
                 <p>
@@ -431,6 +439,16 @@
                   <b>Note:</b> Changed most recently in Tux Paint 0.9.29; Magic API version 0x00000007.                </p>
               </dd>
 
+              <dt><code><b>void set_size(magic_api * api, int which, SDL_Surface * canvas, SDL_Surface * last, Uint8 size, SDL_Rect * update_rect) </b></code></dt>
+              <dd>
+                <p>
+                  Tux Paint will call this function to inform the plugin of the 'Magic' tool size option chosen. (It will be called whenever one of the plugin's Magic tools that accept sizes becomes active, and whenever the user picks a new size while such a tool is currently active.)                </p>
+                <p>
+                  Generally, Magic tools will not alter the canvas in any way when receiving an updated size, but it is possible.                </p>
+                <p>
+                  <b>Note:</b> Added to Tux Paint 0.9.30; Magic API version 0x00000008.                </p>
+              </dd>
+
               <dt><code><b>void click(magic_api * api, int which, int mode, SDL_Surface * snapshot, SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect) </b></code></dt>
               <dd>
                 <p>

docs/es_ES.UTF-8/ADVANCED-STAMPS-HOWTO.txt

@@ -1,5 +1,5 @@
                                    Tux Paint
-                    versión 0.9.29 Advanced Stamps 'How-To'
+                    versión 0.9.30 Advanced Stamps 'How-To'
 
       Copyright © 2006-2022 by Albert Cahalan and others; see AUTHORS.txt.
                              https://tuxpaint.org/

docs/es_ES.UTF-8/ENVVARS.txt

@@ -1,5 +1,5 @@
                                    Tux Paint
-                                 versión 0.9.29
+                                 versión 0.9.30
                       Environment Variables Documentation
 
         Copyright © 2021-2022 by various contributors; see AUTHORS.txt.

docs/es_ES.UTF-8/EXTENDING.txt

@@ -1,6 +1,6 @@
                                    Extending
                                    Tux Paint
-                                 versión 0.9.29
+                                 versión 0.9.30
 
         Copyright © 2002-2023 by various contributors; see AUTHORS.txt.
                              https://tuxpaint.org/

docs/es_ES.UTF-8/FAQ.txt

@@ -1,5 +1,5 @@
                                    Tux Paint
-                   versión 0.9.29 Frequently Asked Questions
+                   versión 0.9.30 Frequently Asked Questions
 
         Copyright © 2002-2023 by various contributors; see AUTHORS.txt.
                              https://tuxpaint.org/

docs/es_ES.UTF-8/INSTALL.txt

@@ -1,5 +1,5 @@
                                    Tux Paint
-                                 versión 0.9.29
+                                 versión 0.9.30
                            Installation Documentation
 
         Copyright © 2002-2023 by various contributors; see AUTHORS.txt.

docs/es_ES.UTF-8/MAGIC-API.txt

@@ -1,12 +1,12 @@
                                    Tux Paint
-                                 version 0.9.29
+                                 version 0.9.30
 
 Magic Tool Plugin API Documentation
 
         Copyright © 2007-2023 by various contributors; see AUTHORS.txt.
                              https://tuxpaint.org/
 
-                                 enero 25, 2023
+                                 abril 9, 2023
 
              +----------------------------------------------------+
              |Table of Contents                                   |
@@ -295,6 +295,15 @@ Magic Tool Plugin API Documentation
            Note: Called once for each Magic tool your plugin claims to
            contain (by your "get_tool_count()").
 
+   int accepted_sizes(magic_api * api, int which)
+
+           Return how many size variations the 'Magic' tool accepts. Return a
+           '0' if the 'Magic' tool should not offer sizing options. Returning
+           '1' is the same as returning '0'.
+
+           Note: Called once for each Magic tool your plugin claims to
+           contain (by your "get_tool_count()").
+
    void shutdown(magic_api * api)
 
            The plugin should do any cleanup here. If you allocated any memory
@@ -367,6 +376,20 @@ Magic Tool Plugin API Documentation
            Note: Changed most recently in Tux Paint 0.9.29; Magic API version
            0x00000007.
 
+   void set_size(magic_api * api, int which, SDL_Surface * canvas,
+   SDL_Surface * last, Uint8 size, SDL_Rect * update_rect)
+
+           Tux Paint will call this function to inform the plugin of the
+           'Magic' tool size option chosen. (It will be called whenever one
+           of the plugin's Magic tools that accept sizes becomes active, and
+           whenever the user picks a new size while such a tool is currently
+           active.)
+
+           Generally, Magic tools will not alter the canvas in any way when
+           receiving an updated size, but it is possible.
+
+           Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008.
+
    void click(magic_api * api, int which, int mode, SDL_Surface * snapshot,
    SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect)
 
@@ -518,7 +541,7 @@ Tux Paint Functions and Data
 
    char * tp_version
            A string containing the version of Tux Paint that's running (e.g.,
-           "0.9.29").
+           "0.9.30").
 
    int canvas_w
    int canvas_h
@@ -663,7 +686,7 @@ Constant Defintions in "tp_magic_api.h"
            your plugin is compatible.
 
            Note: This version number does not correspond to Tux Paint's own
-           release number (e.g., "0.9.29"). The API will not change every
+           release number (e.g., "0.9.30"). The API will not change every
            time a new version of Tux Paint is released, which means plugins
            compiled for earlier versions of Tux Paint will often run under
            newer versions.

docs/es_ES.UTF-8/OPTIONS.txt

@@ -1,5 +1,5 @@
                                    Tux Paint
-                                 versión 0.9.29
+                                 versión 0.9.30
 
 Options Documentation
 

docs/es_ES.UTF-8/PNG.txt

@@ -1,5 +1,5 @@
                                    Tux Paint
-                                 versión 0.9.29
+                                 versión 0.9.30
                                PNG Documentation
 
         Copyright © 2007-2022 by various contributors; see AUTHORS.txt.

docs/es_ES.UTF-8/SIGNALS.txt

@@ -1,5 +1,5 @@
                                    Tux Paint
-                                 versión 0.9.29
+                                 versión 0.9.30
                              Signals Documentation
 
         Copyright © 2019-2022 by various contributors; see AUTHORS.txt.

docs/es_ES.UTF-8/SVG.txt

@@ -1,5 +1,5 @@
                                    Tux Paint
-                                 versión 0.9.29
+                                 versión 0.9.30
                                SVG Documentation
 
         Copyright © 2007-2022 by various contributors; see AUTHORS.txt.

docs/es_ES.UTF-8/html/ADVANCED-STAMPS-HOWTO.html

@@ -17,7 +17,7 @@
             width="205"
             height="210"
             alt="Tux Paint"><br>
-        versi&oacute;n 0.9.29        Advanced Stamps 'How-To'      </h1>
+        versi&oacute;n 0.9.30        Advanced Stamps 'How-To'      </h1>
 
       <p>
         Copyright &copy; 2006-2022 by Albert Cahalan and others; see <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>

docs/es_ES.UTF-8/html/ENVVARS.html

@@ -17,7 +17,7 @@
             width="205"
             height="210"
             alt="Tux Paint"><br>
-        versi&oacute;n 0.9.29<br/>
+        versi&oacute;n 0.9.30<br/>
         Environment Variables Documentation      </h1>
 
       <p>

docs/es_ES.UTF-8/html/EXTENDING.html

@@ -92,7 +92,7 @@
                 width="205"
                 height="210"
                 alt="Tux Paint"><br>
-            versi&oacute;n 0.9.29          </h1>
+            versi&oacute;n 0.9.30          </h1>
     
           <p>
             Copyright &copy; 2002-2023 by various contributors; see <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>

docs/es_ES.UTF-8/html/FAQ.html

@@ -17,7 +17,7 @@
             width="205"
             height="210"
             alt="Tux Paint"><br>
-        versi&oacute;n 0.9.29        Frequently Asked Questions      </h1>
+        versi&oacute;n 0.9.30        Frequently Asked Questions      </h1>
 
       <p>
         Copyright &copy; 2002-2023 by various contributors; see <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>

docs/es_ES.UTF-8/html/INSTALL.html

@@ -89,7 +89,7 @@
                 width="205"
                 height="210"
                 alt="Tux Paint"><br>
-            versi&oacute;n 0.9.29<br/>
+            versi&oacute;n 0.9.30<br/>
             Installation Documentation          </h1>
 
           <p>

docs/es_ES.UTF-8/html/MAGIC-API.html

@@ -91,7 +91,7 @@
                 width="205"
                 height="210"
                 alt="Tux Paint"><br>
-            version 0.9.29          </h1>
+            version 0.9.30          </h1>
 
           <h2>
             Magic Tool Plugin API Documentation          </h2>
@@ -102,7 +102,7 @@
           </p>
 
           <p>
-            enero 25, 2023          </p>
+            abril  9, 2023          </p>
         </center>
       </header>
 
@@ -385,6 +385,14 @@
                   <b>Note:</b> Called once for each Magic tool your plugin claims to contain (by your "<code>get_tool_count()</code>").                </p>
               </dd>
 
+              <dt><code><b>int accepted_sizes(magic_api * api, int which)</b></code></dt>
+              <dd>
+                <p>
+                  Return how many size variations the 'Magic' tool accepts. Return a '0' if the 'Magic' tool should not offer sizing options. Returning '1' is the same as returning '0'.                </p>
+                <p>
+                  <b>Note:</b> Called once for each Magic tool your plugin claims to contain (by your "<code>get_tool_count()</code>").                </p>
+              </dd>
+
               <dt><code><b>void shutdown(magic_api * api)</b></code></dt>
               <dd>
                 <p>
@@ -431,6 +439,16 @@
                   <b>Note:</b> Changed most recently in Tux Paint 0.9.29; Magic API version 0x00000007.                </p>
               </dd>
 
+              <dt><code><b>void set_size(magic_api * api, int which, SDL_Surface * canvas, SDL_Surface * last, Uint8 size, SDL_Rect * update_rect) </b></code></dt>
+              <dd>
+                <p>
+                  Tux Paint will call this function to inform the plugin of the 'Magic' tool size option chosen. (It will be called whenever one of the plugin's Magic tools that accept sizes becomes active, and whenever the user picks a new size while such a tool is currently active.)                </p>
+                <p>
+                  Generally, Magic tools will not alter the canvas in any way when receiving an updated size, but it is possible.                </p>
+                <p>
+                  <b>Note:</b> Added to Tux Paint 0.9.30; Magic API version 0x00000008.                </p>
+              </dd>
+
               <dt><code><b>void click(magic_api * api, int which, int mode, SDL_Surface * snapshot, SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect) </b></code></dt>
               <dd>
                 <p>
@@ -557,7 +575,7 @@
           <dl>
             <dt><code><b>char * tp_version</b></code></dt>
             <dd>
-              A string containing the version of Tux Paint that's running (e.g., "0.9.29").            </dd>
+              A string containing the version of Tux Paint that's running (e.g., "0.9.30").            </dd>
 
             <dt>
               <code><b>int canvas_w</b></code><br/>
@@ -704,7 +722,7 @@
             <p>
               It should be referenced by your magic tool's "<code>api_version()</code>" function, to inform the running copy of Tux Paint whether or not your plugin is compatible.            </p>
             <p>
-              <b>Note:</b> This version number does not correspond to Tux Paint's own release number (e.g., "0.9.29").  The API will not change every time a new version of Tux Paint is released, which means plugins compiled for earlier versions of Tux Paint will often run under newer versions.            </p>
+              <b>Note:</b> This version number does not correspond to Tux Paint's own release number (e.g., "0.9.30").  The API will not change every time a new version of Tux Paint is released, which means plugins compiled for earlier versions of Tux Paint will often run under newer versions.            </p>
           </dd>
 
           <dt>

docs/es_ES.UTF-8/html/OPTIONS.html

@@ -91,7 +91,7 @@
                 width="205"
                 height="210"
                 alt="Tux Paint"><br>
-            versi&oacute;n 0.9.29          </h1>
+            versi&oacute;n 0.9.30          </h1>
 
           <h2>
             Options Documentation          </h2>

docs/es_ES.UTF-8/html/PNG.html

@@ -89,7 +89,7 @@
                 width="205"
                 height="210"
                 alt="Tux Paint"><br>
-            versi&oacute;n 0.9.29<br/>
+            versi&oacute;n 0.9.30<br/>
             PNG Documentation          </h1>
     
           <p>

docs/es_ES.UTF-8/html/SIGNALS.html

@@ -89,7 +89,7 @@
                 width="205"
                 height="210"
                 alt="Tux Paint"><br>
-            versi&oacute;n 0.9.29<br/>
+            versi&oacute;n 0.9.30<br/>
             Signals Documentation          </h1>
 
           <p>

docs/es_ES.UTF-8/html/SVG.html

@@ -91,7 +91,7 @@
                 width="205"
                 height="210"
                 alt="Tux Paint"><br>
-            versi&oacute;n 0.9.29<br/>
+            versi&oacute;n 0.9.30<br/>
             SVG Documentation          </h1>
     
           <p>

docs/fr_FR.UTF-8/ADVANCED-STAMPS-HOWTO.txt

@@ -1,5 +1,5 @@
                                    Tux Paint
-       version 0.9.29 'Guide pratique" pour les tampons de haute qualité
+       version 0.9.30 'Guide pratique" pour les tampons de haute qualité
 
      Copyright © 2006-2022 by Albert Cahalan et d'autres; see AUTHORS.txt.
                              https://tuxpaint.org/

docs/fr_FR.UTF-8/ENVVARS.txt

@@ -1,5 +1,5 @@
                                    Tux Paint
-                                 version 0.9.29
+                                 version 0.9.30
                 Documentation sur les variables d'environnement
 
         Copyright © 2021-2022 by divers contributeurs; see AUTHORS.txt.

docs/fr_FR.UTF-8/EXTENDING.txt

@@ -1,6 +1,6 @@
                                    Extension
                                    Tux Paint
-                                 version 0.9.29
+                                 version 0.9.30
 
         Copyright © 2002-2023 by divers contributeurs; see AUTHORS.txt.
                              https://tuxpaint.org/

docs/fr_FR.UTF-8/FAQ.txt

@@ -1,5 +1,5 @@
                                    Tux Paint
-                  version 0.9.29 Questions fréquemment posées
+                  version 0.9.30 Questions fréquemment posées
 
         Copyright © 2002-2023 by divers contributeurs; see AUTHORS.txt.
                              https://tuxpaint.org/

docs/fr_FR.UTF-8/INSTALL.txt

@@ -1,5 +1,5 @@
                                    Tux Paint
-                                 version 0.9.29
+                                 version 0.9.30
                         Documentation sur l'installation
 
         Copyright © 2002-2023 by divers contributeurs; see AUTHORS.txt.

docs/fr_FR.UTF-8/MAGIC-API.txt

@@ -1,12 +1,12 @@
                                    Tux Paint
-                                 version 0.9.29
+                                 version 0.9.30
 
 Magic Tool Plugin API Documentation
 
         Copyright © 2007-2023 by various contributors; see AUTHORS.txt.
                              https://tuxpaint.org/
 
-                                janvier 25, 2023
+                                 avril 9, 2023
 
              +----------------------------------------------------+
              |Table of Contents                                   |
@@ -295,6 +295,15 @@ Magic Tool Plugin API Documentation
            Note: Called once for each Magic tool your plugin claims to
            contain (by your "get_tool_count()").
 
+   int accepted_sizes(magic_api * api, int which)
+
+           Return how many size variations the 'Magic' tool accepts. Return a
+           '0' if the 'Magic' tool should not offer sizing options. Returning
+           '1' is the same as returning '0'.
+
+           Note: Called once for each Magic tool your plugin claims to
+           contain (by your "get_tool_count()").
+
    void shutdown(magic_api * api)
 
            The plugin should do any cleanup here. If you allocated any memory
@@ -367,6 +376,20 @@ Magic Tool Plugin API Documentation
            Note: Changed most recently in Tux Paint 0.9.29; Magic API version
            0x00000007.
 
+   void set_size(magic_api * api, int which, SDL_Surface * canvas,
+   SDL_Surface * last, Uint8 size, SDL_Rect * update_rect)
+
+           Tux Paint will call this function to inform the plugin of the
+           'Magic' tool size option chosen. (It will be called whenever one
+           of the plugin's Magic tools that accept sizes becomes active, and
+           whenever the user picks a new size while such a tool is currently
+           active.)
+
+           Generally, Magic tools will not alter the canvas in any way when
+           receiving an updated size, but it is possible.
+
+           Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008.
+
    void click(magic_api * api, int which, int mode, SDL_Surface * snapshot,
    SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect)
 
@@ -518,7 +541,7 @@ Tux Paint Functions and Data
 
    char * tp_version
            A string containing the version of Tux Paint that's running (e.g.,
-           "0.9.29").
+           "0.9.30").
 
    int canvas_w
    int canvas_h
@@ -663,7 +686,7 @@ Constant Defintions in "tp_magic_api.h"
            your plugin is compatible.
 
            Note: This version number does not correspond to Tux Paint's own
-           release number (e.g., "0.9.29"). The API will not change every
+           release number (e.g., "0.9.30"). The API will not change every
            time a new version of Tux Paint is released, which means plugins
            compiled for earlier versions of Tux Paint will often run under
            newer versions.

docs/fr_FR.UTF-8/OPTIONS.txt

@@ -1,5 +1,5 @@
                                    Tux Paint
-                                 version 0.9.29
+                                 version 0.9.30
 
 Documentation sur les options
 

docs/fr_FR.UTF-8/PNG.txt

@@ -1,5 +1,5 @@
                                    Tux Paint
-                                 version 0.9.29
+                                 version 0.9.30
                       Documentation sur PNG pour Tux Paint
 
         Copyright © 2007-2022 by divers contributeurs; see AUTHORS.txt.

docs/fr_FR.UTF-8/SIGNALS.txt

@@ -1,5 +1,5 @@
                                    Tux Paint
-                                 version 0.9.29
+                                 version 0.9.30
                          Documentation sur les signaux
 
         Copyright © 2019-2022 by divers contributeurs; see AUTHORS.txt.

docs/fr_FR.UTF-8/SVG.txt

@@ -1,5 +1,5 @@
                                    Tux Paint
-                                 version 0.9.29
+                                 version 0.9.30
                              Documentation sur SVG
 
         Copyright © 2007-2022 by divers contributeurs; see AUTHORS.txt.

docs/fr_FR.UTF-8/html/ADVANCED-STAMPS-HOWTO.html

@@ -17,7 +17,7 @@
             width="205"
             height="210"
             alt="Tux Paint"><br>
-        version 0.9.29        'Guide pratique" pour les tampons de haute qualité      </h1>
+        version 0.9.30        'Guide pratique" pour les tampons de haute qualité      </h1>
 
       <p>
         Copyright &copy; 2006-2022 by Albert Cahalan et d'autres; see <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>

docs/fr_FR.UTF-8/html/ENVVARS.html

@@ -17,7 +17,7 @@
             width="205"
             height="210"
             alt="Tux Paint"><br>
-        version 0.9.29<br/>
+        version 0.9.30<br/>
         Documentation sur les variables d'environnement      </h1>
 
       <p>

docs/fr_FR.UTF-8/html/EXTENDING.html

@@ -92,7 +92,7 @@
                 width="205"
                 height="210"
                 alt="Tux Paint"><br>
-            version 0.9.29          </h1>
+            version 0.9.30          </h1>
     
           <p>
             Copyright &copy; 2002-2023 by divers contributeurs; see <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>

docs/fr_FR.UTF-8/html/FAQ.html

@@ -17,7 +17,7 @@
             width="205"
             height="210"
             alt="Tux Paint"><br>
-        version 0.9.29        Questions fréquemment posées      </h1>
+        version 0.9.30        Questions fréquemment posées      </h1>
 
       <p>
         Copyright &copy; 2002-2023 by divers contributeurs; see <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>

docs/fr_FR.UTF-8/html/INSTALL.html

@@ -89,7 +89,7 @@
                 width="205"
                 height="210"
                 alt="Tux Paint"><br>
-            version 0.9.29<br/>
+            version 0.9.30<br/>
             Documentation sur l'installation          </h1>
 
           <p>

docs/fr_FR.UTF-8/html/MAGIC-API.html

@@ -91,7 +91,7 @@
                 width="205"
                 height="210"
                 alt="Tux Paint"><br>
-            version 0.9.29          </h1>
+            version 0.9.30          </h1>
 
           <h2>
             Magic Tool Plugin API Documentation          </h2>
@@ -102,7 +102,7 @@
           </p>
 
           <p>
-            janvier 25, 2023          </p>
+            avril  9, 2023          </p>
         </center>
       </header>
 
@@ -385,6 +385,14 @@
                   <b>Note:</b> Called once for each Magic tool your plugin claims to contain (by your "<code>get_tool_count()</code>").                </p>
               </dd>
 
+              <dt><code><b>int accepted_sizes(magic_api * api, int which)</b></code></dt>
+              <dd>
+                <p>
+                  Return how many size variations the 'Magic' tool accepts. Return a '0' if the 'Magic' tool should not offer sizing options. Returning '1' is the same as returning '0'.                </p>
+                <p>
+                  <b>Note:</b> Called once for each Magic tool your plugin claims to contain (by your "<code>get_tool_count()</code>").                </p>
+              </dd>
+
               <dt><code><b>void shutdown(magic_api * api)</b></code></dt>
               <dd>
                 <p>
@@ -431,6 +439,16 @@
                   <b>Note:</b> Changed most recently in Tux Paint 0.9.29; Magic API version 0x00000007.                </p>
               </dd>
 
+              <dt><code><b>void set_size(magic_api * api, int which, SDL_Surface * canvas, SDL_Surface * last, Uint8 size, SDL_Rect * update_rect) </b></code></dt>
+              <dd>
+                <p>
+                  Tux Paint will call this function to inform the plugin of the 'Magic' tool size option chosen. (It will be called whenever one of the plugin's Magic tools that accept sizes becomes active, and whenever the user picks a new size while such a tool is currently active.)                </p>
+                <p>
+                  Generally, Magic tools will not alter the canvas in any way when receiving an updated size, but it is possible.                </p>
+                <p>
+                  <b>Note:</b> Added to Tux Paint 0.9.30; Magic API version 0x00000008.                </p>
+              </dd>
+
               <dt><code><b>void click(magic_api * api, int which, int mode, SDL_Surface * snapshot, SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect) </b></code></dt>
               <dd>
                 <p>
@@ -557,7 +575,7 @@
           <dl>
             <dt><code><b>char * tp_version</b></code></dt>
             <dd>
-              A string containing the version of Tux Paint that's running (e.g., "0.9.29").            </dd>
+              A string containing the version of Tux Paint that's running (e.g., "0.9.30").            </dd>
 
             <dt>
               <code><b>int canvas_w</b></code><br/>
@@ -704,7 +722,7 @@
             <p>
               It should be referenced by your magic tool's "<code>api_version()</code>" function, to inform the running copy of Tux Paint whether or not your plugin is compatible.            </p>
             <p>
-              <b>Note:</b> This version number does not correspond to Tux Paint's own release number (e.g., "0.9.29").  The API will not change every time a new version of Tux Paint is released, which means plugins compiled for earlier versions of Tux Paint will often run under newer versions.            </p>
+              <b>Note:</b> This version number does not correspond to Tux Paint's own release number (e.g., "0.9.30").  The API will not change every time a new version of Tux Paint is released, which means plugins compiled for earlier versions of Tux Paint will often run under newer versions.            </p>
           </dd>
 
           <dt>

docs/fr_FR.UTF-8/html/OPTIONS.html

@@ -91,7 +91,7 @@
                 width="205"
                 height="210"
                 alt="Tux Paint"><br>
-            version 0.9.29          </h1>
+            version 0.9.30          </h1>
 
           <h2>
             Documentation sur les options          </h2>

docs/fr_FR.UTF-8/html/PNG.html

@@ -89,7 +89,7 @@
                 width="205"
                 height="210"
                 alt="Tux Paint"><br>
-            version 0.9.29<br/>
+            version 0.9.30<br/>
             Documentation sur PNG pour Tux Paint          </h1>
     
           <p>

docs/fr_FR.UTF-8/html/SIGNALS.html

@@ -89,7 +89,7 @@
                 width="205"
                 height="210"
                 alt="Tux Paint"><br>
-            version 0.9.29<br/>
+            version 0.9.30<br/>
             Documentation sur les signaux          </h1>
 
           <p>

docs/fr_FR.UTF-8/html/SVG.html

@@ -91,7 +91,7 @@
                 width="205"
                 height="210"
                 alt="Tux Paint"><br>
-            version 0.9.29<br/>
+            version 0.9.30<br/>
             Documentation sur SVG          </h1>
     
           <p>

docs/gl_ES.UTF-8/ADVANCED-STAMPS-HOWTO.txt

@@ -1,5 +1,5 @@
                                    Tux Paint
-                 versión 0.9.29 «Como facer» os selos avanzados
+                 versión 0.9.30 «Como facer» os selos avanzados
 
        Copyright © 2006-2022 by Albert Cahalan e outros; see AUTHORS.txt.
                              https://tuxpaint.org/

docs/gl_ES.UTF-8/ENVVARS.txt

@@ -1,5 +1,5 @@
                                    Tux Paint
-                                 versión 0.9.29
+                                 versión 0.9.30
                      Documentación de variábeis de contorno
 
         Copyright © 2021-2022 by varios colaboradores; see AUTHORS.txt.

docs/gl_ES.UTF-8/EXTENDING.txt

@@ -1,6 +1,6 @@
                                     Ampliar
                                    Tux Paint
-                                 versión 0.9.29
+                                 versión 0.9.30
 
         Copyright © 2002-2023 by varios colaboradores; see AUTHORS.txt.
                              https://tuxpaint.org/

docs/gl_ES.UTF-8/FAQ.txt

@@ -1,5 +1,5 @@
                                    Tux Paint
-                    versión 0.9.29 Preguntas máis frecuentes
+                    versión 0.9.30 Preguntas máis frecuentes
 
         Copyright © 2002-2023 by varios colaboradores; see AUTHORS.txt.
                              https://tuxpaint.org/

docs/gl_ES.UTF-8/INSTALL.txt

@@ -1,5 +1,5 @@
                                    Tux Paint
-                                 versión 0.9.29
+                                 versión 0.9.30
                           Documentación da instalación
 
         Copyright © 2002-2023 by varios colaboradores; see AUTHORS.txt.

docs/gl_ES.UTF-8/MAGIC-API.txt

@@ -1,12 +1,12 @@
                                    Tux Paint
-                                 version 0.9.29
+                                 version 0.9.30
 
 Magic Tool Plugin API Documentation
 
         Copyright © 2007-2023 by various contributors; see AUTHORS.txt.
                              https://tuxpaint.org/
 
-                                Xaneiro 25, 2023
+                                 Abril 9, 2023
 
              +----------------------------------------------------+
              |Table of Contents                                   |
@@ -295,6 +295,15 @@ Magic Tool Plugin API Documentation
            Note: Called once for each Magic tool your plugin claims to
            contain (by your "get_tool_count()").
 
+   int accepted_sizes(magic_api * api, int which)
+
+           Return how many size variations the 'Magic' tool accepts. Return a
+           '0' if the 'Magic' tool should not offer sizing options. Returning
+           '1' is the same as returning '0'.
+
+           Note: Called once for each Magic tool your plugin claims to
+           contain (by your "get_tool_count()").
+
    void shutdown(magic_api * api)
 
            The plugin should do any cleanup here. If you allocated any memory
@@ -367,6 +376,20 @@ Magic Tool Plugin API Documentation
            Note: Changed most recently in Tux Paint 0.9.29; Magic API version
            0x00000007.
 
+   void set_size(magic_api * api, int which, SDL_Surface * canvas,
+   SDL_Surface * last, Uint8 size, SDL_Rect * update_rect)
+
+           Tux Paint will call this function to inform the plugin of the
+           'Magic' tool size option chosen. (It will be called whenever one
+           of the plugin's Magic tools that accept sizes becomes active, and
+           whenever the user picks a new size while such a tool is currently
+           active.)
+
+           Generally, Magic tools will not alter the canvas in any way when
+           receiving an updated size, but it is possible.
+
+           Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008.
+
    void click(magic_api * api, int which, int mode, SDL_Surface * snapshot,
    SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect)
 
@@ -518,7 +541,7 @@ Tux Paint Functions and Data
 
    char * tp_version
            A string containing the version of Tux Paint that's running (e.g.,
-           "0.9.29").
+           "0.9.30").
 
    int canvas_w
    int canvas_h
@@ -663,7 +686,7 @@ Constant Defintions in "tp_magic_api.h"
            your plugin is compatible.
 
            Note: This version number does not correspond to Tux Paint's own
-           release number (e.g., "0.9.29"). The API will not change every
+           release number (e.g., "0.9.30"). The API will not change every
            time a new version of Tux Paint is released, which means plugins
            compiled for earlier versions of Tux Paint will often run under
            newer versions.

docs/gl_ES.UTF-8/OPTIONS.txt

@@ -1,5 +1,5 @@
                                    Tux Paint
-                                 versión 0.9.29
+                                 versión 0.9.30
 
 Documentación de opcións
 

docs/gl_ES.UTF-8/PNG.txt

@@ -1,5 +1,5 @@
                                    Tux Paint
-                                 versión 0.9.29
+                                 versión 0.9.30
                                Documentación PNG
 
         Copyright © 2007-2022 by varios colaboradores; see AUTHORS.txt.

docs/gl_ES.UTF-8/SIGNALS.txt

@@ -1,5 +1,5 @@
                                    Tux Paint
-                                 versión 0.9.29
+                                 versión 0.9.30
                             Documentación de sinais
 
         Copyright © 2019-2022 by varios colaboradores; see AUTHORS.txt.

docs/gl_ES.UTF-8/SVG.txt

@@ -1,5 +1,5 @@
                                    Tux Paint
-                                 versión 0.9.29
+                                 versión 0.9.30
                                Documentación SVG
 
         Copyright © 2007-2022 by varios colaboradores; see AUTHORS.txt.

docs/gl_ES.UTF-8/html/ADVANCED-STAMPS-HOWTO.html

@@ -17,7 +17,7 @@
             width="205"
             height="210"
             alt="Tux Paint"><br>
-        versión 0.9.29        «Como facer» os selos avanzados      </h1>
+        versión 0.9.30        «Como facer» os selos avanzados      </h1>
 
       <p>
         Copyright &copy; 2006-2022 by Albert Cahalan e outros; see <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>

docs/gl_ES.UTF-8/html/ENVVARS.html

@@ -17,7 +17,7 @@
             width="205"
             height="210"
             alt="Tux Paint"><br>
-        versión 0.9.29<br/>
+        versión 0.9.30<br/>
         Documentación de variábeis de contorno      </h1>
 
       <p>

docs/gl_ES.UTF-8/html/EXTENDING.html

@@ -92,7 +92,7 @@
                 width="205"
                 height="210"
                 alt="Tux Paint"><br>
-            versión 0.9.29          </h1>
+            versión 0.9.30          </h1>
     
           <p>
             Copyright &copy; 2002-2023 by varios colaboradores; see <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>

docs/gl_ES.UTF-8/html/FAQ.html

@@ -17,7 +17,7 @@
             width="205"
             height="210"
             alt="Tux Paint"><br>
-        versión 0.9.29        Preguntas máis frecuentes      </h1>
+        versión 0.9.30        Preguntas máis frecuentes      </h1>
 
       <p>
         Copyright &copy; 2002-2023 by varios colaboradores; see <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>

docs/gl_ES.UTF-8/html/INSTALL.html

@@ -89,7 +89,7 @@
                 width="205"
                 height="210"
                 alt="Tux Paint"><br>
-            versión 0.9.29<br/>
+            versión 0.9.30<br/>
             Documentación da instalación          </h1>
 
           <p>

docs/gl_ES.UTF-8/html/MAGIC-API.html

@@ -91,7 +91,7 @@
                 width="205"
                 height="210"
                 alt="Tux Paint"><br>
-            version 0.9.29          </h1>
+            version 0.9.30          </h1>
 
           <h2>
             Magic Tool Plugin API Documentation          </h2>
@@ -102,7 +102,7 @@
           </p>
 
           <p>
-            Xaneiro 25, 2023          </p>
+            Abril  9, 2023          </p>
         </center>
       </header>
 
@@ -385,6 +385,14 @@
                   <b>Note:</b> Called once for each Magic tool your plugin claims to contain (by your "<code>get_tool_count()</code>").                </p>
               </dd>
 
+              <dt><code><b>int accepted_sizes(magic_api * api, int which)</b></code></dt>
+              <dd>
+                <p>
+                  Return how many size variations the 'Magic' tool accepts. Return a '0' if the 'Magic' tool should not offer sizing options. Returning '1' is the same as returning '0'.                </p>
+                <p>
+                  <b>Note:</b> Called once for each Magic tool your plugin claims to contain (by your "<code>get_tool_count()</code>").                </p>
+              </dd>
+
               <dt><code><b>void shutdown(magic_api * api)</b></code></dt>
               <dd>
                 <p>
@@ -431,6 +439,16 @@
                   <b>Note:</b> Changed most recently in Tux Paint 0.9.29; Magic API version 0x00000007.                </p>
               </dd>
 
+              <dt><code><b>void set_size(magic_api * api, int which, SDL_Surface * canvas, SDL_Surface * last, Uint8 size, SDL_Rect * update_rect) </b></code></dt>
+              <dd>
+                <p>
+                  Tux Paint will call this function to inform the plugin of the 'Magic' tool size option chosen. (It will be called whenever one of the plugin's Magic tools that accept sizes becomes active, and whenever the user picks a new size while such a tool is currently active.)                </p>
+                <p>
+                  Generally, Magic tools will not alter the canvas in any way when receiving an updated size, but it is possible.                </p>
+                <p>
+                  <b>Note:</b> Added to Tux Paint 0.9.30; Magic API version 0x00000008.                </p>
+              </dd>
+
               <dt><code><b>void click(magic_api * api, int which, int mode, SDL_Surface * snapshot, SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect) </b></code></dt>
               <dd>
                 <p>
@@ -557,7 +575,7 @@
           <dl>
             <dt><code><b>char * tp_version</b></code></dt>
             <dd>
-              A string containing the version of Tux Paint that's running (e.g., "0.9.29").            </dd>
+              A string containing the version of Tux Paint that's running (e.g., "0.9.30").            </dd>
 
             <dt>
               <code><b>int canvas_w</b></code><br/>
@@ -704,7 +722,7 @@
             <p>
               It should be referenced by your magic tool's "<code>api_version()</code>" function, to inform the running copy of Tux Paint whether or not your plugin is compatible.            </p>
             <p>
-              <b>Note:</b> This version number does not correspond to Tux Paint's own release number (e.g., "0.9.29").  The API will not change every time a new version of Tux Paint is released, which means plugins compiled for earlier versions of Tux Paint will often run under newer versions.            </p>
+              <b>Note:</b> This version number does not correspond to Tux Paint's own release number (e.g., "0.9.30").  The API will not change every time a new version of Tux Paint is released, which means plugins compiled for earlier versions of Tux Paint will often run under newer versions.            </p>
           </dd>
 
           <dt>

docs/gl_ES.UTF-8/html/OPTIONS.html

@@ -91,7 +91,7 @@
                 width="205"
                 height="210"
                 alt="Tux Paint"><br>
-            versión 0.9.29          </h1>
+            versión 0.9.30          </h1>
 
           <h2>
             Documentación de opcións          </h2>

docs/gl_ES.UTF-8/html/PNG.html

@@ -89,7 +89,7 @@
                 width="205"
                 height="210"
                 alt="Tux Paint"><br>
-            versión 0.9.29<br/>
+            versión 0.9.30<br/>
             Documentación PNG          </h1>
     
           <p>

docs/gl_ES.UTF-8/html/SIGNALS.html

@@ -89,7 +89,7 @@
                 width="205"
                 height="210"
                 alt="Tux Paint"><br>
-            versión 0.9.29<br/>
+            versión 0.9.30<br/>
             Documentación de sinais          </h1>
 
           <p>

docs/gl_ES.UTF-8/html/SVG.html

@@ -91,7 +91,7 @@
                 width="205"
                 height="210"
                 alt="Tux Paint"><br>
-            versión 0.9.29<br/>
+            versión 0.9.30<br/>
             Documentación SVG          </h1>
     
           <p>

docs/ja_JP.UTF-8/ADVANCED-STAMPS-HOWTO.txt

@@ -1,5 +1,5 @@
                                    Tux Paint
-                           バージョン 0.9.29 スタンプ作成の詳細について
+                           バージョン 0.9.30 スタンプ作成の詳細について
 
           Copyright © 2006-2022 by Albert Cahalan ほか; AUTHORS.txt 参照.
                              https://tuxpaint.org/

docs/ja_JP.UTF-8/ENVVARS.txt

@@ -1,5 +1,5 @@
                                    Tux Paint
-                                  バージョン 0.9.29
+                                  バージョン 0.9.30
                       Environment Variables Documentation
 
          Copyright © 2021-2022 by various contributors; AUTHORS.txt 参照.

docs/ja_JP.UTF-8/EXTENDING.txt

@@ -1,6 +1,6 @@
                                    Extending
                                    Tux Paint
-                                  バージョン 0.9.29
+                                  バージョン 0.9.30
 
          Copyright © 2002-2023 by various contributors; AUTHORS.txt 参照.
                              https://tuxpaint.org/

docs/ja_JP.UTF-8/FAQ.txt

@@ -1,5 +1,5 @@
                                    Tux Paint
-                    バージョン 0.9.29 Frequently Asked Questions
+                    バージョン 0.9.30 Frequently Asked Questions
 
          Copyright © 2002-2023 by various contributors; AUTHORS.txt 参照.
                              https://tuxpaint.org/

docs/ja_JP.UTF-8/INSTALL.txt

@@ -1,5 +1,5 @@
                                    Tux Paint
-                                  バージョン 0.9.29
+                                  バージョン 0.9.30
                            Installation Documentation
 
          Copyright © 2002-2023 by various contributors; AUTHORS.txt 参照.

docs/ja_JP.UTF-8/MAGIC-API.txt

@@ -1,12 +1,12 @@
                                    Tux Paint
-                                 version 0.9.29
+                                 version 0.9.30
 
 Magic Tool Plugin API Documentation
 
         Copyright © 2007-2023 by various contributors; see AUTHORS.txt.
                              https://tuxpaint.org/
 
-                                  1月 25, 2023
+                                   4月 9, 2023
 
              +----------------------------------------------------+
              |Table of Contents                                   |
@@ -295,6 +295,15 @@ Magic Tool Plugin API Documentation
            Note: Called once for each Magic tool your plugin claims to
            contain (by your "get_tool_count()").
 
+   int accepted_sizes(magic_api * api, int which)
+
+           Return how many size variations the 'Magic' tool accepts. Return a
+           '0' if the 'Magic' tool should not offer sizing options. Returning
+           '1' is the same as returning '0'.
+
+           Note: Called once for each Magic tool your plugin claims to
+           contain (by your "get_tool_count()").
+
    void shutdown(magic_api * api)
 
            The plugin should do any cleanup here. If you allocated any memory
@@ -367,6 +376,20 @@ Magic Tool Plugin API Documentation
            Note: Changed most recently in Tux Paint 0.9.29; Magic API version
            0x00000007.
 
+   void set_size(magic_api * api, int which, SDL_Surface * canvas,
+   SDL_Surface * last, Uint8 size, SDL_Rect * update_rect)
+
+           Tux Paint will call this function to inform the plugin of the
+           'Magic' tool size option chosen. (It will be called whenever one
+           of the plugin's Magic tools that accept sizes becomes active, and
+           whenever the user picks a new size while such a tool is currently
+           active.)
+
+           Generally, Magic tools will not alter the canvas in any way when
+           receiving an updated size, but it is possible.
+
+           Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008.
+
    void click(magic_api * api, int which, int mode, SDL_Surface * snapshot,
    SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect)
 
@@ -518,7 +541,7 @@ Tux Paint Functions and Data
 
    char * tp_version
            A string containing the version of Tux Paint that's running (e.g.,
-           "0.9.29").
+           "0.9.30").
 
    int canvas_w
    int canvas_h
@@ -663,7 +686,7 @@ Constant Defintions in "tp_magic_api.h"
            your plugin is compatible.
 
            Note: This version number does not correspond to Tux Paint's own
-           release number (e.g., "0.9.29"). The API will not change every
+           release number (e.g., "0.9.30"). The API will not change every
            time a new version of Tux Paint is released, which means plugins
            compiled for earlier versions of Tux Paint will often run under
            newer versions.

docs/ja_JP.UTF-8/OPTIONS.txt

@@ -1,5 +1,5 @@
                                    Tux Paint
-                                  バージョン 0.9.29
+                                  バージョン 0.9.30
 
 各種設定について
 

docs/ja_JP.UTF-8/PNG.txt

@@ -1,5 +1,5 @@
                                    Tux Paint
-                                  バージョン 0.9.29
+                                  バージョン 0.9.30
                                PNG Documentation
 
          Copyright © 2007-2022 by various contributors; AUTHORS.txt 参照.

docs/ja_JP.UTF-8/SIGNALS.txt

@@ -1,5 +1,5 @@
                                    Tux Paint
-                                  バージョン 0.9.29
+                                  バージョン 0.9.30
                              Signals Documentation
 
          Copyright © 2019-2022 by various contributors; AUTHORS.txt 参照.

docs/ja_JP.UTF-8/SVG.txt

@@ -1,5 +1,5 @@
                                    Tux Paint
-                                  バージョン 0.9.29
+                                  バージョン 0.9.30
                                SVG Documentation
 
          Copyright © 2007-2022 by various contributors; AUTHORS.txt 参照.

docs/ja_JP.UTF-8/html/ADVANCED-STAMPS-HOWTO.html

@@ -17,7 +17,7 @@
             width="205"
             height="210"
             alt="Tux Paint"><br>
-        バージョン 0.9.29        スタンプ作成の詳細について      </h1>
+        バージョン 0.9.30        スタンプ作成の詳細について      </h1>
 
       <p>
         Copyright &copy; 2006-2022 by Albert Cahalan ほか; <a href="../../AUTHORS.txt">AUTHORS.txt</a> 参照.<br>

docs/ja_JP.UTF-8/html/ENVVARS.html

@@ -17,7 +17,7 @@
             width="205"
             height="210"
             alt="Tux Paint"><br>
-        バージョン 0.9.29<br/>
+        バージョン 0.9.30<br/>
         Environment Variables Documentation      </h1>
 
       <p>

docs/ja_JP.UTF-8/html/EXTENDING.html

@@ -92,7 +92,7 @@
                 width="205"
                 height="210"
                 alt="Tux Paint"><br>
-            バージョン 0.9.29          </h1>
+            バージョン 0.9.30          </h1>
     
           <p>
             Copyright &copy; 2002-2023 by various contributors; <a href="../../AUTHORS.txt">AUTHORS.txt</a> 参照.<br>

docs/ja_JP.UTF-8/html/FAQ.html

@@ -17,7 +17,7 @@
             width="205"
             height="210"
             alt="Tux Paint"><br>
-        バージョン 0.9.29        Frequently Asked Questions      </h1>
+        バージョン 0.9.30        Frequently Asked Questions      </h1>
 
       <p>
         Copyright &copy; 2002-2023 by various contributors; <a href="../../AUTHORS.txt">AUTHORS.txt</a> 参照.<br>

docs/ja_JP.UTF-8/html/INSTALL.html

@@ -89,7 +89,7 @@
                 width="205"
                 height="210"
                 alt="Tux Paint"><br>
-            バージョン 0.9.29<br/>
+            バージョン 0.9.30<br/>
             Installation Documentation          </h1>
 
           <p>

docs/ja_JP.UTF-8/html/MAGIC-API.html

@@ -91,7 +91,7 @@
                 width="205"
                 height="210"
                 alt="Tux Paint"><br>
-            version 0.9.29          </h1>
+            version 0.9.30          </h1>
 
           <h2>
             Magic Tool Plugin API Documentation          </h2>
@@ -102,7 +102,7 @@
           </p>
 
           <p>
-            1月 25, 2023          </p>
+            4月  9, 2023          </p>
         </center>
       </header>
 
@@ -385,6 +385,14 @@
                   <b>Note:</b> Called once for each Magic tool your plugin claims to contain (by your "<code>get_tool_count()</code>").                </p>
               </dd>
 
+              <dt><code><b>int accepted_sizes(magic_api * api, int which)</b></code></dt>
+              <dd>
+                <p>
+                  Return how many size variations the 'Magic' tool accepts. Return a '0' if the 'Magic' tool should not offer sizing options. Returning '1' is the same as returning '0'.                </p>
+                <p>
+                  <b>Note:</b> Called once for each Magic tool your plugin claims to contain (by your "<code>get_tool_count()</code>").                </p>
+              </dd>
+
               <dt><code><b>void shutdown(magic_api * api)</b></code></dt>
               <dd>
                 <p>
@@ -431,6 +439,16 @@
                   <b>Note:</b> Changed most recently in Tux Paint 0.9.29; Magic API version 0x00000007.                </p>
               </dd>
 
+              <dt><code><b>void set_size(magic_api * api, int which, SDL_Surface * canvas, SDL_Surface * last, Uint8 size, SDL_Rect * update_rect) </b></code></dt>
+              <dd>
+                <p>
+                  Tux Paint will call this function to inform the plugin of the 'Magic' tool size option chosen. (It will be called whenever one of the plugin's Magic tools that accept sizes becomes active, and whenever the user picks a new size while such a tool is currently active.)                </p>
+                <p>
+                  Generally, Magic tools will not alter the canvas in any way when receiving an updated size, but it is possible.                </p>
+                <p>
+                  <b>Note:</b> Added to Tux Paint 0.9.30; Magic API version 0x00000008.                </p>
+              </dd>
+
               <dt><code><b>void click(magic_api * api, int which, int mode, SDL_Surface * snapshot, SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect) </b></code></dt>
               <dd>
                 <p>
@@ -557,7 +575,7 @@
           <dl>
             <dt><code><b>char * tp_version</b></code></dt>
             <dd>
-              A string containing the version of Tux Paint that's running (e.g., "0.9.29").            </dd>
+              A string containing the version of Tux Paint that's running (e.g., "0.9.30").            </dd>
 
             <dt>
               <code><b>int canvas_w</b></code><br/>
@@ -704,7 +722,7 @@
             <p>
               It should be referenced by your magic tool's "<code>api_version()</code>" function, to inform the running copy of Tux Paint whether or not your plugin is compatible.            </p>
             <p>
-              <b>Note:</b> This version number does not correspond to Tux Paint's own release number (e.g., "0.9.29").  The API will not change every time a new version of Tux Paint is released, which means plugins compiled for earlier versions of Tux Paint will often run under newer versions.            </p>
+              <b>Note:</b> This version number does not correspond to Tux Paint's own release number (e.g., "0.9.30").  The API will not change every time a new version of Tux Paint is released, which means plugins compiled for earlier versions of Tux Paint will often run under newer versions.            </p>
           </dd>
 
           <dt>

docs/ja_JP.UTF-8/html/OPTIONS.html

@@ -91,7 +91,7 @@
                 width="205"
                 height="210"
                 alt="Tux Paint"><br>
-            バージョン 0.9.29          </h1>
+            バージョン 0.9.30          </h1>
 
           <h2>
             各種設定について          </h2>

docs/ja_JP.UTF-8/html/PNG.html

@@ -89,7 +89,7 @@
                 width="205"
                 height="210"
                 alt="Tux Paint"><br>
-            バージョン 0.9.29<br/>
+            バージョン 0.9.30<br/>
             PNG Documentation          </h1>
     
           <p>

docs/ja_JP.UTF-8/html/SIGNALS.html

@@ -89,7 +89,7 @@
                 width="205"
                 height="210"
                 alt="Tux Paint"><br>
-            バージョン 0.9.29<br/>
+            バージョン 0.9.30<br/>
             Signals Documentation          </h1>
 
           <p>

docs/ja_JP.UTF-8/html/SVG.html

@@ -91,7 +91,7 @@
                 width="205"
                 height="210"
                 alt="Tux Paint"><br>
-            バージョン 0.9.29<br/>
+            バージョン 0.9.30<br/>
             SVG Documentation          </h1>
     
           <p>

magic/magic-docs/es_ES.UTF-8/html/3dglasses.html

@@ -10,5 +10,5 @@ Bill Kendrick &lt;<a href="mailto:bill@newbreedsoftware.com">bill@newbreedsoftwa
 <p>This tool horizontally separates your entire picture's red and cyan color channels, letting you create anaglyphic pictures that can be viewed with 3D glasses.</p>
 <p>See also: <a href="colorsep.html">Color Sep.</a> &amp; <a href="doublevision.html">Double Vision</a>.</p>
 <hr size="1" noshade />
-<p align="center">Tux Paint 0.9.29</p>
+<p align="center">Tux Paint 0.9.30</p>
 </body></html>

magic/magic-docs/es_ES.UTF-8/html/blinds.html

@@ -9,5 +9,5 @@
 Pere Pujal i Carabantes &lt;<a href="mailto:pere@fornol.no-ip.org">pere@fornol.no-ip.org</a>&gt;</h3>
 <p>Click towards the edge of your picture to pull window blinds over it. Move perpendicularly to open or close the blinds.</p>
 <hr size="1" noshade />
-<p align="center">Tux Paint 0.9.29</p>
+<p align="center">Tux Paint 0.9.30</p>
 </body></html>

magic/magic-docs/es_ES.UTF-8/html/blocks.html

@@ -11,5 +11,5 @@ Albert Cahalan &lt;<a href="mailto:albert@users.sf.net">albert@users.sf.net</a>&
 </h3>
 <p>This makes the picture blocky looking ("pixelated") wherever you drag the mouse.</p>
 <hr size="1" noshade />
-<p align="center">Tux Paint 0.9.29</p>
+<p align="center">Tux Paint 0.9.30</p>
 </body></html>

magic/magic-docs/es_ES.UTF-8/html/bloom.html

@@ -9,5 +9,5 @@
 Bill Kendrick &lt;<a href="mailto:bill@newbreedsoftware.com">bill@newbreedsoftware.com</a>&gt;</h3>
 <p>Add a glowing \"bloom\" effect to pictures.</p>
 <hr size="1" noshade />
-<p align="center">Tux Paint 0.9.29</p>
+<p align="center">Tux Paint 0.9.30</p>
 </body></html>

magic/magic-docs/es_ES.UTF-8/html/blur.html

@@ -12,5 +12,5 @@ Albert Cahalan &lt;<a href="mailto:albert@users.sf.net">albert@users.sf.net</a>&
 <p>This makes the picture fuzzy wherever you drag the mouse.</p>
 <p>See also: <a href="sharpen.html">Sharpen</a> &amp; <a href="smudge.html">Smudge</a>.</p>
 <hr size="1" noshade />
-<p align="center">Tux Paint 0.9.29</p>
+<p align="center">Tux Paint 0.9.30</p>
 </body></html>

magic/magic-docs/es_ES.UTF-8/html/bricks.html

@@ -10,5 +10,5 @@ Albert Cahalan &lt;<a href="mailto:albert@users.sf.net">albert@users.sf.net</a>&
 <p>These two tools intelligently paint large and small brick patterns on the canvas.  The bricks can be tinted various redish hues by selecting different colors in the color palette.</p>
 <p>See also: <a href="pixels.html">Pixels</a>.</p>
 <hr size="1" noshade />
-<p align="center">Tux Paint 0.9.29</p>
+<p align="center">Tux Paint 0.9.30</p>
 </body></html>

magic/magic-docs/es_ES.UTF-8/html/calligraphy.html

@@ -9,5 +9,5 @@
 Bill Kendrick &lt;<a href="mailto:bill@newbreedsoftware.com">bill@newbreedsoftware.com</a>&gt;</h3>
 <p>This paints on the canvas with a calligraphy pen. The quicker you move, the thinner the lines.</p>
 <hr size="1" noshade />
-<p align="center">Tux Paint 0.9.29</p>
+<p align="center">Tux Paint 0.9.30</p>
 </body></html>

magic/magic-docs/es_ES.UTF-8/html/cartoon.html

@@ -9,5 +9,5 @@
 Bill Kendrick &lt;<a href="mailto:bill@newbreedsoftware.com">bill@newbreedsoftware.com</a>&gt;</h3>
 <p>This makes the picture look like a cartoon &mdash; with thick outlines and bright, solid colors &mdash; wherever you move the mouse.</p>
 <hr size="1" noshade />
-<p align="center">Tux Paint 0.9.29</p>
+<p align="center">Tux Paint 0.9.30</p>
 </body></html>

magic/magic-docs/es_ES.UTF-8/html/chalk.html

@@ -9,5 +9,5 @@
 Bill Kendrick &lt;<a href="mailto:bill@newbreedsoftware.com">bill@newbreedsoftware.com</a>&gt;</h3>
 <p>This makes parts of the picture (where you move the mouse) look like a chalk drawing.</p>
 <hr size="1" noshade />
-<p align="center">Tux Paint 0.9.29</p>
+<p align="center">Tux Paint 0.9.30</p>
 </body></html>

magic/magic-docs/es_ES.UTF-8/html/checkerboard.html

@@ -9,5 +9,5 @@
 Bill Kendrick &lt;<a href="mailto:bill@newbreedsoftware.com">bill@newbreedsoftware.com</a>&gt;</h3>
 <p>This covers the entire canvas with a checkboard pattern using the current color. Drag to change the size of the squares.</p>
 <hr size="1" noshade />
-<p align="center">Tux Paint 0.9.29</p>
+<p align="center">Tux Paint 0.9.30</p>
 </body></html>

magic/magic-docs/es_ES.UTF-8/html/circles.html

@@ -10,5 +10,5 @@ Bill Kendrick &lt;<a href="mailto:bill@newbreedsoftware.com">bill@newbreedsoftwa
 <p>This transforms the picture into circular brush strokes around where you clicked.</p>
 <p>See also: <a href="rays.html">Rays</a>.</p>
 <hr size="1" noshade />
-<p align="center">Tux Paint 0.9.29</p>
+<p align="center">Tux Paint 0.9.30</p>
 </body></html>

magic/magic-docs/es_ES.UTF-8/html/clone.html

@@ -9,5 +9,5 @@
 Bill Kendrick &lt;<a href="mailto:bill@newbreedsoftware.com">bill@newbreedsoftware.com</a>&gt;</h3>
 <p>Clone (copy, via painting) part of the picture. Click ones to choose the source, then click and drag to clone it elsewhere in the drawing. Once you release, click to choose another source and start again.</p>
 <hr size="1" noshade />
-<p align="center">Tux Paint 0.9.29</p>
+<p align="center">Tux Paint 0.9.30</p>
 </body></html>

magic/magic-docs/es_ES.UTF-8/html/color_and_white.html

@@ -9,5 +9,5 @@
 Andrew Corcoran &lt;<a href="mailto:akanewbie@gmail.com">akanewbie@gmail.com</a>&gt;</h3>
 <p>This makes parts of your picture two colors: white, and the color chosen in the palette. (i.e., if you choose black, you'll get a black and white picture).</p>
 <hr size="1" noshade />
-<p align="center">Tux Paint 0.9.29</p>
+<p align="center">Tux Paint 0.9.30</p>
 </body></html>

magic/magic-docs/es_ES.UTF-8/html/color_shift.html

@@ -9,5 +9,5 @@
 Andrew Corcoran &lt;<a href="mailto:akanewbie@gmail.com">akanewbie@gmail.com</a>&gt;</h3>
 <p>This shifts the colors in your picture.</p>
 <hr size="1" noshade />
-<p align="center">Tux Paint 0.9.29</p>
+<p align="center">Tux Paint 0.9.30</p>
 </body></html>

magic/magic-docs/es_ES.UTF-8/html/colorsep.html

@@ -10,5 +10,5 @@ Bill Kendrick &lt;<a href="mailto:bill@newbreedsoftware.com">bill@newbreedsoftwa
 <p>This tool separates one color out of your entire picture, shifting colors away from each other (similar to '3D Glasses', but you may choose the any color to separate, and may move in any direction).</p>
 <p>See also: <a href="3dglasses.html">3D Glasses</a> &amp; <a href="doublevision.html">Double Vision</a>.</p>
 <hr size="1" noshade />
-<p align="center">Tux Paint 0.9.29</p>
+<p align="center">Tux Paint 0.9.30</p>
 </body></html>

magic/magic-docs/es_ES.UTF-8/html/confetti.html

@@ -9,5 +9,5 @@
 Adam Rakowski &lt;<a href="mailto:foo-script@o2.pl">foo-script@o2.pl</a>&gt;</h3>
 <p>Throw confetti around your picture!</p>
 <hr size="1" noshade />
-<p align="center">Tux Paint 0.9.29</p>
+<p align="center">Tux Paint 0.9.30</p>
 </body></html>