WIP Magic size option; regen docs for 0.9.30 version

This commit is contained in:
Bill Kendrick 2023-04-09 23:25:48 -07:00
parent 9dd95721d5
commit e49c55fbe6
456 changed files with 692 additions and 480 deletions

View file

@ -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/

View file

@ -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.

View file

@ -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/

View file

@ -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/

View file

@ -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.

View file

@ -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.

View file

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

View file

@ -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.

View file

@ -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.

View file

@ -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.

View file

@ -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>

View file

@ -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>

View file

@ -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>

View file

@ -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>

View file

@ -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>

View file

@ -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>

View file

@ -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>

View file

@ -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>

View file

@ -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>

View file

@ -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>