notgne2/tuxpaint-pencil-sharpener
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Syncing docs to get Magic API update re: retract_undo()

Browse source
This commit is contained in:
Bill Kendrick 2024-06-01 02:07:12 -07:00
parent 05181f73af
commit 7507ea7217
14 changed files with 301 additions and 14 deletions
Download patch file Download diff file Expand all files Collapse all files

29
docs/en/MAGIC-API.txt
View file

@ -6,7 +6,7 @@
Copyright © 2007-2024 by various contributors; see AUTHORS.txt.
https://tuxpaint.org/
January 29, 2024
June 1, 2024
+--------------------------------------------------+
| Table of Contents |
@ -694,6 +694,33 @@ void special_notify(int flag)
void retract_undo(void)
Each time the user clicks in the canvas while using your Magic tool, a new
snapshot of the canvas is added to the "Undo" history. This allows the user
to click "Undo" to return the image to the state it was in just before they
clicked with your Magic tool. They may click "Redo" to bring the change
back.
However, some more sophisticated Magic tools require one or more steps to
take place before the final "effect" is reached. For example, "Filled
Polygon" requires placing at least three connected points, then connecting
the first and last point together, to create a shape that gets added to the
canvas. In the meantime, an interactive preview of the shape — an outline
with large dots representing each point — is drawn onto the canvas. (The
points may be moved, or even removed, prior to finishing the shape.)
The retract_undo() API function may be used by a Magic tool to tell it to
discard the "Undo" snapshot it just took, as a way to prevent previews
shown during multi-step actions from appearing on the canvas when using the
"Undo" and "Redo" commands.
💡 This is an advanced feature.
Note: Added to Tux Paint 0.9.33; Magic API version 0x0000000A.
Color Conversions

16
docs/en/html/MAGIC-API.html
View file

@ -102,7 +102,7 @@
</p>
<p>
January 29, 2024 </p>
June 1, 2024 </p>
</center>
</header>
@ -678,6 +678,20 @@
Similar to <code>SPECIAL_FLIP</code>, but for magic tools that mirror the contents of the canvas horizontally. </dd>
</dl>
</dd>
<dt id="retract_undo"><code><b>void retract_undo(void)</b></code></dt>
<dd>
<p>
Each time the user clicks in the canvas while using your Magic tool, a new snapshot of the canvas is added to the "Undo" history. This allows the user to click "Undo" to return the image to the state it was in just before they clicked with your Magic tool. They may click "Redo" to bring the change back. </p>
<p>
However, some more sophisticated Magic tools require one or more steps to take place before the final "effect" is reached. For example, "Filled Polygon" requires placing at least three connected points, then connecting the first and last point together, to create a shape that gets added to the canvas. In the meantime, an interactive preview of the shape &mdash; an outline with large dots representing each point &mdash; is drawn onto the canvas. (The points may be moved, or even removed, prior to finishing the shape.) </p>
<p>
The <code>retract_undo()</code> API function may be used by a Magic tool to tell it to discard the "Undo" snapshot it just took, as a way to prevent previews shown during multi-step actions from appearing on the canvas when using the "Undo" and "Redo" commands. </p>
<p class="note">
<span title="Information">&#128161;</span> This is an advanced feature. </p>
<p>
<b>Note:</b> Added to Tux Paint 0.9.33; Magic API version 0x0000000A. </p>
</dd>
</dl>
</section><!-- H3: Tux Paint System Calls -->

29
docs/es_ES.UTF-8/MAGIC-API.txt
View file

@ -6,7 +6,7 @@
Copyright © 2007-2024 by various contributors; see AUTHORS.txt.
https://tuxpaint.org/
enero 29, 2024
junio 1, 2024
+--------------------------------------------------+
| Table of Contents |
@ -694,6 +694,33 @@ void special_notify(int flag)
void retract_undo(void)
Each time the user clicks in the canvas while using your Magic tool, a new
snapshot of the canvas is added to the "Undo" history. This allows the user
to click "Undo" to return the image to the state it was in just before they
clicked with your Magic tool. They may click "Redo" to bring the change
back.
However, some more sophisticated Magic tools require one or more steps to
take place before the final "effect" is reached. For example, "Filled
Polygon" requires placing at least three connected points, then connecting
the first and last point together, to create a shape that gets added to the
canvas. In the meantime, an interactive preview of the shape — an outline
with large dots representing each point — is drawn onto the canvas. (The
points may be moved, or even removed, prior to finishing the shape.)
The retract_undo() API function may be used by a Magic tool to tell it to
discard the "Undo" snapshot it just took, as a way to prevent previews
shown during multi-step actions from appearing on the canvas when using the
"Undo" and "Redo" commands.
💡 This is an advanced feature.
Note: Added to Tux Paint 0.9.33; Magic API version 0x0000000A.
Color Conversions

16
docs/es_ES.UTF-8/html/MAGIC-API.html
View file

@ -102,7 +102,7 @@
</p>
<p>
enero 29, 2024 </p>
junio 1, 2024 </p>
</center>
</header>
@ -678,6 +678,20 @@
Similar to <code>SPECIAL_FLIP</code>, but for magic tools that mirror the contents of the canvas horizontally. </dd>
</dl>
</dd>
<dt id="retract_undo"><code><b>void retract_undo(void)</b></code></dt>
<dd>
<p>
Each time the user clicks in the canvas while using your Magic tool, a new snapshot of the canvas is added to the "Undo" history. This allows the user to click "Undo" to return the image to the state it was in just before they clicked with your Magic tool. They may click "Redo" to bring the change back. </p>
<p>
However, some more sophisticated Magic tools require one or more steps to take place before the final "effect" is reached. For example, "Filled Polygon" requires placing at least three connected points, then connecting the first and last point together, to create a shape that gets added to the canvas. In the meantime, an interactive preview of the shape &mdash; an outline with large dots representing each point &mdash; is drawn onto the canvas. (The points may be moved, or even removed, prior to finishing the shape.) </p>
<p>
The <code>retract_undo()</code> API function may be used by a Magic tool to tell it to discard the "Undo" snapshot it just took, as a way to prevent previews shown during multi-step actions from appearing on the canvas when using the "Undo" and "Redo" commands. </p>
<p class="note">
<span title="Information">&#128161;</span> This is an advanced feature. </p>
<p>
<b>Note:</b> Added to Tux Paint 0.9.33; Magic API version 0x0000000A. </p>
</dd>
</dl>
</section><!-- H3: Tux Paint System Calls -->

29
docs/fr_FR.UTF-8/MAGIC-API.txt
View file

@ -6,7 +6,7 @@
Copyright © 2007-2024 by various contributors; see AUTHORS.txt.
https://tuxpaint.org/
janvier 29, 2024
juin 1, 2024
+--------------------------------------------------+
| Table of Contents |
@ -694,6 +694,33 @@ void special_notify(int flag)
void retract_undo(void)
Each time the user clicks in the canvas while using your Magic tool, a new
snapshot of the canvas is added to the "Undo" history. This allows the user
to click "Undo" to return the image to the state it was in just before they
clicked with your Magic tool. They may click "Redo" to bring the change
back.
However, some more sophisticated Magic tools require one or more steps to
take place before the final "effect" is reached. For example, "Filled
Polygon" requires placing at least three connected points, then connecting
the first and last point together, to create a shape that gets added to the
canvas. In the meantime, an interactive preview of the shape — an outline
with large dots representing each point — is drawn onto the canvas. (The
points may be moved, or even removed, prior to finishing the shape.)
The retract_undo() API function may be used by a Magic tool to tell it to
discard the "Undo" snapshot it just took, as a way to prevent previews
shown during multi-step actions from appearing on the canvas when using the
"Undo" and "Redo" commands.
💡 This is an advanced feature.
Note: Added to Tux Paint 0.9.33; Magic API version 0x0000000A.
Color Conversions

16
docs/fr_FR.UTF-8/html/MAGIC-API.html
View file

@ -102,7 +102,7 @@
</p>
<p>
janvier 29, 2024 </p>
juin 1, 2024 </p>
</center>
</header>
@ -678,6 +678,20 @@
Similar to <code>SPECIAL_FLIP</code>, but for magic tools that mirror the contents of the canvas horizontally. </dd>
</dl>
</dd>
<dt id="retract_undo"><code><b>void retract_undo(void)</b></code></dt>
<dd>
<p>
Each time the user clicks in the canvas while using your Magic tool, a new snapshot of the canvas is added to the "Undo" history. This allows the user to click "Undo" to return the image to the state it was in just before they clicked with your Magic tool. They may click "Redo" to bring the change back. </p>
<p>
However, some more sophisticated Magic tools require one or more steps to take place before the final "effect" is reached. For example, "Filled Polygon" requires placing at least three connected points, then connecting the first and last point together, to create a shape that gets added to the canvas. In the meantime, an interactive preview of the shape &mdash; an outline with large dots representing each point &mdash; is drawn onto the canvas. (The points may be moved, or even removed, prior to finishing the shape.) </p>
<p>
The <code>retract_undo()</code> API function may be used by a Magic tool to tell it to discard the "Undo" snapshot it just took, as a way to prevent previews shown during multi-step actions from appearing on the canvas when using the "Undo" and "Redo" commands. </p>
<p class="note">
<span title="Information">&#128161;</span> This is an advanced feature. </p>
<p>
<b>Note:</b> Added to Tux Paint 0.9.33; Magic API version 0x0000000A. </p>
</dd>
</dl>
</section><!-- H3: Tux Paint System Calls -->

29
docs/gl_ES.UTF-8/MAGIC-API.txt
View file

@ -6,7 +6,7 @@
Copyright © 2007-2024 by various contributors; see AUTHORS.txt.
https://tuxpaint.org/
Xaneiro 29, 2024
Xuño 1, 2024
+--------------------------------------------------+
| Table of Contents |
@ -694,6 +694,33 @@ void special_notify(int flag)
void retract_undo(void)
Each time the user clicks in the canvas while using your Magic tool, a new
snapshot of the canvas is added to the "Undo" history. This allows the user
to click "Undo" to return the image to the state it was in just before they
clicked with your Magic tool. They may click "Redo" to bring the change
back.
However, some more sophisticated Magic tools require one or more steps to
take place before the final "effect" is reached. For example, "Filled
Polygon" requires placing at least three connected points, then connecting
the first and last point together, to create a shape that gets added to the
canvas. In the meantime, an interactive preview of the shape — an outline
with large dots representing each point — is drawn onto the canvas. (The
points may be moved, or even removed, prior to finishing the shape.)
The retract_undo() API function may be used by a Magic tool to tell it to
discard the "Undo" snapshot it just took, as a way to prevent previews
shown during multi-step actions from appearing on the canvas when using the
"Undo" and "Redo" commands.
💡 This is an advanced feature.
Note: Added to Tux Paint 0.9.33; Magic API version 0x0000000A.
Color Conversions

16
docs/gl_ES.UTF-8/html/MAGIC-API.html
View file

@ -102,7 +102,7 @@
</p>
<p>
Xaneiro 29, 2024 </p>
Xuño 1, 2024 </p>
</center>
</header>
@ -678,6 +678,20 @@
Similar to <code>SPECIAL_FLIP</code>, but for magic tools that mirror the contents of the canvas horizontally. </dd>
</dl>
</dd>
<dt id="retract_undo"><code><b>void retract_undo(void)</b></code></dt>
<dd>
<p>
Each time the user clicks in the canvas while using your Magic tool, a new snapshot of the canvas is added to the "Undo" history. This allows the user to click "Undo" to return the image to the state it was in just before they clicked with your Magic tool. They may click "Redo" to bring the change back. </p>
<p>
However, some more sophisticated Magic tools require one or more steps to take place before the final "effect" is reached. For example, "Filled Polygon" requires placing at least three connected points, then connecting the first and last point together, to create a shape that gets added to the canvas. In the meantime, an interactive preview of the shape &mdash; an outline with large dots representing each point &mdash; is drawn onto the canvas. (The points may be moved, or even removed, prior to finishing the shape.) </p>
<p>
The <code>retract_undo()</code> API function may be used by a Magic tool to tell it to discard the "Undo" snapshot it just took, as a way to prevent previews shown during multi-step actions from appearing on the canvas when using the "Undo" and "Redo" commands. </p>
<p class="note">
<span title="Information">&#128161;</span> This is an advanced feature. </p>
<p>
<b>Note:</b> Added to Tux Paint 0.9.33; Magic API version 0x0000000A. </p>
</dd>
</dl>
</section><!-- H3: Tux Paint System Calls -->

29
docs/is_IS.UTF-8/MAGIC-API.txt
View file

@ -6,7 +6,7 @@
Höfundarréttur © 2007-2024 eftir various contributors; sjá AUTHORS-skrá.
https://tuxpaint.org/
29. janúar 2024
1. júní 2024
+--------------------------------------------------+
| Efnisyfirlit |
@ -694,6 +694,33 @@ void special_notify(int flag)
void retract_undo(void)
Each time the user clicks in the canvas while using your Magic tool, a new
snapshot of the canvas is added to the "Undo" history. This allows the user
to click "Undo" to return the image to the state it was in just before they
clicked with your Magic tool. They may click "Redo" to bring the change
back.
However, some more sophisticated Magic tools require one or more steps to
take place before the final "effect" is reached. For example, "Filled
Polygon" requires placing at least three connected points, then connecting
the first and last point together, to create a shape that gets added to the
canvas. In the meantime, an interactive preview of the shape — an outline
with large dots representing each point — is drawn onto the canvas. (The
points may be moved, or even removed, prior to finishing the shape.)
The retract_undo() API function may be used by a Magic tool to tell it to
discard the "Undo" snapshot it just took, as a way to prevent previews
shown during multi-step actions from appearing on the canvas when using the
"Undo" and "Redo" commands.
💡 This is an advanced feature.
Note: Added to Tux Paint 0.9.33; Magic API version 0x0000000A.
Color Conversions

16
docs/is_IS.UTF-8/html/MAGIC-API.html
View file

@ -102,7 +102,7 @@
</p>
<p>
29. janúar 2024 </p>
1. júní 2024 </p>
</center>
</header>
@ -678,6 +678,20 @@
Similar to <code>SPECIAL_FLIP</code>, but for magic tools that mirror the contents of the canvas horizontally. </dd>
</dl>
</dd>
<dt id="retract_undo"><code><b>void retract_undo(void)</b></code></dt>
<dd>
<p>
Each time the user clicks in the canvas while using your Magic tool, a new snapshot of the canvas is added to the "Undo" history. This allows the user to click "Undo" to return the image to the state it was in just before they clicked with your Magic tool. They may click "Redo" to bring the change back. </p>
<p>
However, some more sophisticated Magic tools require one or more steps to take place before the final "effect" is reached. For example, "Filled Polygon" requires placing at least three connected points, then connecting the first and last point together, to create a shape that gets added to the canvas. In the meantime, an interactive preview of the shape &mdash; an outline with large dots representing each point &mdash; is drawn onto the canvas. (The points may be moved, or even removed, prior to finishing the shape.) </p>
<p>
The <code>retract_undo()</code> API function may be used by a Magic tool to tell it to discard the "Undo" snapshot it just took, as a way to prevent previews shown during multi-step actions from appearing on the canvas when using the "Undo" and "Redo" commands. </p>
<p class="note">
<span title="Information">&#128161;</span> This is an advanced feature. </p>
<p>
<b>Note:</b> Added to Tux Paint 0.9.33; Magic API version 0x0000000A. </p>
</dd>
</dl>
</section><!-- H3: Tux Paint System Calls -->

29
docs/ja_JP.UTF-8/MAGIC-API.txt
View file

@ -6,7 +6,7 @@
Copyright © 2007-2024 by various contributors; see AUTHORS.txt.
https://tuxpaint.org/
1月 29, 2024
6月 1, 2024
+--------------------------------------------------+
| Table of Contents |
@ -694,6 +694,33 @@ void special_notify(int flag)
void retract_undo(void)
Each time the user clicks in the canvas while using your Magic tool, a new
snapshot of the canvas is added to the "Undo" history. This allows the user
to click "Undo" to return the image to the state it was in just before they
clicked with your Magic tool. They may click "Redo" to bring the change
back.
However, some more sophisticated Magic tools require one or more steps to
take place before the final "effect" is reached. For example, "Filled
Polygon" requires placing at least three connected points, then connecting
the first and last point together, to create a shape that gets added to the
canvas. In the meantime, an interactive preview of the shape — an outline
with large dots representing each point — is drawn onto the canvas. (The
points may be moved, or even removed, prior to finishing the shape.)
The retract_undo() API function may be used by a Magic tool to tell it to
discard the "Undo" snapshot it just took, as a way to prevent previews
shown during multi-step actions from appearing on the canvas when using the
"Undo" and "Redo" commands.
💡 This is an advanced feature.
Note: Added to Tux Paint 0.9.33; Magic API version 0x0000000A.
Color Conversions

16
docs/ja_JP.UTF-8/html/MAGIC-API.html
View file

@ -102,7 +102,7 @@
</p>
<p>
1月 29, 2024 </p>
6月 1, 2024 </p>
</center>
</header>
@ -678,6 +678,20 @@
Similar to <code>SPECIAL_FLIP</code>, but for magic tools that mirror the contents of the canvas horizontally. </dd>
</dl>
</dd>
<dt id="retract_undo"><code><b>void retract_undo(void)</b></code></dt>
<dd>
<p>
Each time the user clicks in the canvas while using your Magic tool, a new snapshot of the canvas is added to the "Undo" history. This allows the user to click "Undo" to return the image to the state it was in just before they clicked with your Magic tool. They may click "Redo" to bring the change back. </p>
<p>
However, some more sophisticated Magic tools require one or more steps to take place before the final "effect" is reached. For example, "Filled Polygon" requires placing at least three connected points, then connecting the first and last point together, to create a shape that gets added to the canvas. In the meantime, an interactive preview of the shape &mdash; an outline with large dots representing each point &mdash; is drawn onto the canvas. (The points may be moved, or even removed, prior to finishing the shape.) </p>
<p>
The <code>retract_undo()</code> API function may be used by a Magic tool to tell it to discard the "Undo" snapshot it just took, as a way to prevent previews shown during multi-step actions from appearing on the canvas when using the "Undo" and "Redo" commands. </p>
<p class="note">
<span title="Information">&#128161;</span> This is an advanced feature. </p>
<p>
<b>Note:</b> Added to Tux Paint 0.9.33; Magic API version 0x0000000A. </p>
</dd>
</dl>
</section><!-- H3: Tux Paint System Calls -->

29
docs/sq_AL.UTF-8/MAGIC-API.txt
View file

@ -6,7 +6,7 @@
Copyright © 2007-2024 by various contributors; see AUTHORS.txt.
https://tuxpaint.org/
janar 29, 2024
qershor 1, 2024
+--------------------------------------------------+
| Table of Contents |
@ -694,6 +694,33 @@ void special_notify(int flag)
void retract_undo(void)
Each time the user clicks in the canvas while using your Magic tool, a new
snapshot of the canvas is added to the "Undo" history. This allows the user
to click "Undo" to return the image to the state it was in just before they
clicked with your Magic tool. They may click "Redo" to bring the change
back.
However, some more sophisticated Magic tools require one or more steps to
take place before the final "effect" is reached. For example, "Filled
Polygon" requires placing at least three connected points, then connecting
the first and last point together, to create a shape that gets added to the
canvas. In the meantime, an interactive preview of the shape — an outline
with large dots representing each point — is drawn onto the canvas. (The
points may be moved, or even removed, prior to finishing the shape.)
The retract_undo() API function may be used by a Magic tool to tell it to
discard the "Undo" snapshot it just took, as a way to prevent previews
shown during multi-step actions from appearing on the canvas when using the
"Undo" and "Redo" commands.
💡 This is an advanced feature.
Note: Added to Tux Paint 0.9.33; Magic API version 0x0000000A.
Color Conversions

16
docs/sq_AL.UTF-8/html/MAGIC-API.html
View file

@ -102,7 +102,7 @@
</p>
<p>
janar 29, 2024 </p>
qershor 1, 2024 </p>
</center>
</header>
@ -678,6 +678,20 @@
Similar to <code>SPECIAL_FLIP</code>, but for magic tools that mirror the contents of the canvas horizontally. </dd>
</dl>
</dd>
<dt id="retract_undo"><code><b>void retract_undo(void)</b></code></dt>
<dd>
<p>
Each time the user clicks in the canvas while using your Magic tool, a new snapshot of the canvas is added to the "Undo" history. This allows the user to click "Undo" to return the image to the state it was in just before they clicked with your Magic tool. They may click "Redo" to bring the change back. </p>
<p>
However, some more sophisticated Magic tools require one or more steps to take place before the final "effect" is reached. For example, "Filled Polygon" requires placing at least three connected points, then connecting the first and last point together, to create a shape that gets added to the canvas. In the meantime, an interactive preview of the shape &mdash; an outline with large dots representing each point &mdash; is drawn onto the canvas. (The points may be moved, or even removed, prior to finishing the shape.) </p>
<p>
The <code>retract_undo()</code> API function may be used by a Magic tool to tell it to discard the "Undo" snapshot it just took, as a way to prevent previews shown during multi-step actions from appearing on the canvas when using the "Undo" and "Redo" commands. </p>
<p class="note">
<span title="Information">&#128161;</span> This is an advanced feature. </p>
<p>
<b>Note:</b> Added to Tux Paint 0.9.33; Magic API version 0x0000000A. </p>
</dd>
</dl>
</section><!-- H3: Tux Paint System Calls -->