diff --git a/docs/en/MAGIC-API.txt b/docs/en/MAGIC-API.txt
index dc632456b..89ad7b38e 100644
--- a/docs/en/MAGIC-API.txt
+++ b/docs/en/MAGIC-API.txt
@@ -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
diff --git a/docs/en/html/MAGIC-API.html b/docs/en/html/MAGIC-API.html
index 29a3b1beb..c0b785343 100644
--- a/docs/en/html/MAGIC-API.html
+++ b/docs/en/html/MAGIC-API.html
@@ -102,7 +102,7 @@
- January 29, 2024
+ June 1, 2024
@@ -678,6 +678,20 @@
Similar to SPECIAL_FLIP, but for magic tools that mirror the contents of the canvas horizontally.
+
+ 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.
+
diff --git a/docs/es_ES.UTF-8/MAGIC-API.txt b/docs/es_ES.UTF-8/MAGIC-API.txt
index 86d5804bc..fa56bcf19 100644
--- a/docs/es_ES.UTF-8/MAGIC-API.txt
+++ b/docs/es_ES.UTF-8/MAGIC-API.txt
@@ -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
diff --git a/docs/es_ES.UTF-8/html/MAGIC-API.html b/docs/es_ES.UTF-8/html/MAGIC-API.html
index 80c57bb47..926708ad1 100644
--- a/docs/es_ES.UTF-8/html/MAGIC-API.html
+++ b/docs/es_ES.UTF-8/html/MAGIC-API.html
@@ -102,7 +102,7 @@
- enero 29, 2024
+ junio 1, 2024
@@ -678,6 +678,20 @@
Similar to SPECIAL_FLIP, but for magic tools that mirror the contents of the canvas horizontally.
+
+ 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.
+
diff --git a/docs/fr_FR.UTF-8/MAGIC-API.txt b/docs/fr_FR.UTF-8/MAGIC-API.txt
index fd905fae1..b12ed71fa 100644
--- a/docs/fr_FR.UTF-8/MAGIC-API.txt
+++ b/docs/fr_FR.UTF-8/MAGIC-API.txt
@@ -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
diff --git a/docs/fr_FR.UTF-8/html/MAGIC-API.html b/docs/fr_FR.UTF-8/html/MAGIC-API.html
index 351e6ad53..d61c98263 100644
--- a/docs/fr_FR.UTF-8/html/MAGIC-API.html
+++ b/docs/fr_FR.UTF-8/html/MAGIC-API.html
@@ -102,7 +102,7 @@
- janvier 29, 2024
+ juin 1, 2024
@@ -678,6 +678,20 @@
Similar to SPECIAL_FLIP, but for magic tools that mirror the contents of the canvas horizontally.
+
+ 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.
+
diff --git a/docs/gl_ES.UTF-8/MAGIC-API.txt b/docs/gl_ES.UTF-8/MAGIC-API.txt
index 742759d8e..d7c24f712 100644
--- a/docs/gl_ES.UTF-8/MAGIC-API.txt
+++ b/docs/gl_ES.UTF-8/MAGIC-API.txt
@@ -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
diff --git a/docs/gl_ES.UTF-8/html/MAGIC-API.html b/docs/gl_ES.UTF-8/html/MAGIC-API.html
index 1f4c138c0..b6e25bd88 100644
--- a/docs/gl_ES.UTF-8/html/MAGIC-API.html
+++ b/docs/gl_ES.UTF-8/html/MAGIC-API.html
@@ -102,7 +102,7 @@
- Xaneiro 29, 2024
+ Xuño 1, 2024
@@ -678,6 +678,20 @@
Similar to SPECIAL_FLIP, but for magic tools that mirror the contents of the canvas horizontally.
+
+ 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.
+
diff --git a/docs/is_IS.UTF-8/MAGIC-API.txt b/docs/is_IS.UTF-8/MAGIC-API.txt
index 05ff4e131..2d1672545 100644
--- a/docs/is_IS.UTF-8/MAGIC-API.txt
+++ b/docs/is_IS.UTF-8/MAGIC-API.txt
@@ -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
diff --git a/docs/is_IS.UTF-8/html/MAGIC-API.html b/docs/is_IS.UTF-8/html/MAGIC-API.html
index 5e0adf477..84f97347c 100644
--- a/docs/is_IS.UTF-8/html/MAGIC-API.html
+++ b/docs/is_IS.UTF-8/html/MAGIC-API.html
@@ -102,7 +102,7 @@
- 29. janúar 2024
+ 1. júní 2024
@@ -678,6 +678,20 @@
Similar to SPECIAL_FLIP, but for magic tools that mirror the contents of the canvas horizontally.
+
+ 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.
+
diff --git a/docs/ja_JP.UTF-8/MAGIC-API.txt b/docs/ja_JP.UTF-8/MAGIC-API.txt
index e2f1a8f15..3f9fd24bc 100644
--- a/docs/ja_JP.UTF-8/MAGIC-API.txt
+++ b/docs/ja_JP.UTF-8/MAGIC-API.txt
@@ -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
diff --git a/docs/ja_JP.UTF-8/html/MAGIC-API.html b/docs/ja_JP.UTF-8/html/MAGIC-API.html
index 508147c35..205e30e34 100644
--- a/docs/ja_JP.UTF-8/html/MAGIC-API.html
+++ b/docs/ja_JP.UTF-8/html/MAGIC-API.html
@@ -102,7 +102,7 @@
- 1月 29, 2024
+ 6月 1, 2024
@@ -678,6 +678,20 @@
Similar to SPECIAL_FLIP, but for magic tools that mirror the contents of the canvas horizontally.
+
+ 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.
+
diff --git a/docs/sq_AL.UTF-8/MAGIC-API.txt b/docs/sq_AL.UTF-8/MAGIC-API.txt
index 260fe56c1..56d0f67c2 100644
--- a/docs/sq_AL.UTF-8/MAGIC-API.txt
+++ b/docs/sq_AL.UTF-8/MAGIC-API.txt
@@ -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
diff --git a/docs/sq_AL.UTF-8/html/MAGIC-API.html b/docs/sq_AL.UTF-8/html/MAGIC-API.html
index 4efb426f4..1e7f20a08 100644
--- a/docs/sq_AL.UTF-8/html/MAGIC-API.html
+++ b/docs/sq_AL.UTF-8/html/MAGIC-API.html
@@ -102,7 +102,7 @@
- janar 29, 2024
+ qershor 1, 2024
@@ -678,6 +678,20 @@
Similar to SPECIAL_FLIP, but for magic tools that mirror the contents of the canvas horizontally.
+
+ 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.
+