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

Resync docs to grab README -> Magic updates

Browse source 
...mentioning magic sizing, and updating magic controls section.
This commit is contained in:
Bill Kendrick 2023-04-18 22:57:41 -07:00
parent db62ccbb7b
commit 7964091a23
20 changed files with 296 additions and 41 deletions
Download patch file Download diff file Expand all files Collapse all files

2
docs/en/OPTIONS.txt
View file

@ -440,7 +440,7 @@ Simplification
Some Magic tools offer various size settings. This option disables
the sizing control, and only provides the tools' default sizes.
(Some plugins may offer additional variations of a Magic tool, to
make a few sizes possible, e.g. "Bricks" and "Googly Eyes".
make a few sizes possible, e.g. "Bricks" and "Googly Eyes".)
⚙ Note: If used in a system-wide configuration file, may be
overridden by the user's configuration file using

36
docs/en/README.txt
View file

@ -588,11 +588,37 @@ Available Tools
picture, and/or simply click the picture once, to apply the
effect.
If the tool can be used by clicking and dragging, a 'painting'
button will be available on the left, below the list of Magic
tools on the right side of the screen. If the tool can affect the
entire picture at once, an 'entire picture' button will be
available on the right.
Magic Controls
If the tool can be used by clicking and dragging, a 'painting'
button will be available on the left, below the list of Magic
tools on the right side of the screen. If the tool can affect
the entire picture at once, an 'entire picture' button will be
available on the right.
⚙ Note: If the "nomagiccontrols" option is set, Tux Paint won't
display the painting or entire picture controls. See the
"Options" documentation.
💡 If the magic controls are disabled, the Magic plugin may make
separate tools available, one for painting and one that affects
the entire pictre.
Magic Sizing
Some tools offer different sizing options. If so, a slider will
appear at the bottom right side of the screen. This may affect
the radius of a special effect (e.g., Darken) or painted object
(e.g., Patterns), or other attributes (e.g., large versus small
Brick shapes).
⚙ Note: If the "nomagicsizes" option is set, Tux Paint won't
display the sizing controls. See the "Options" documentation.
💡 If the sizing option is disabled, the Magic plugin may simply
offer a default size (e.g., Patterns), or it may make separate
tools available with different pre-set sizes (e.g., Bricks and
Googly Eyes).
See the instructions for each Magic tool (in the 'magic-docs'
folder).

2
docs/en/html/OPTIONS.html
View file

@ -671,7 +671,7 @@
<dd>
<p>
Some <b>Magic</b> tools offer various size settings. This option disables the sizing control, and only provides the tools' default sizes. (Some plugins may offer additional variations of a Magic tool, to make a few sizes possible, e.g. "Bricks" and "Googly Eyes". </p>
Some <b>Magic</b> tools offer various size settings. This option disables the sizing control, and only provides the tools' default sizes. (Some plugins may offer additional variations of a Magic tool, to make a few sizes possible, e.g. "Bricks" and "Googly Eyes".) </p>
<p class="note">
<span title="Configuration option">&#9881;</span> <strong>Note:</strong> If used in a system-wide configuration file, may be overridden by the user's configuration file using "<code>nomagicsizes=no</code>" or "<code>magicsizes=yes</code>". In both cases, may be overridden by the command-line option "<code>--magicsizes</code>". </p>
</dd>

29
docs/en/html/README.html
View file

@ -912,8 +912,33 @@
<p>
The Magic tool is actually a set of special tools. Select one of the 'magic' effects from the selector on the right. Then, depending on the tool, you can either click and drag around the picture, and/or simply click the picture once, to apply the effect. </p>
<p>
If the tool can be used by clicking and dragging, a 'painting' button will be available on the left, below the list of Magic tools on the right side of the screen. If the tool can affect the entire picture at once, an 'entire picture' button will be available on the right. </p>
<strong>Magic Controls</strong>
<blockquote>
<p>
If the tool can be used by clicking and dragging, a 'painting' button will be available on the left, below the list of Magic tools on the right side of the screen. If the tool can affect the entire picture at once, an 'entire picture' button will be available on the right. </p>
<p class="note">
<span title="Configuration option">&#9881;</span> <strong>Note</strong>: If the "<code>nomagiccontrols</code>" option is set, Tux Paint won't display the painting or entire picture controls. See the "<a href="OPTIONS.html"><em>Options</em></a>" documentation. </p>
<p class="note">
<span title="Information">&#128161;</span> If the magic controls are disabled, the Magic plugin may make separate tools available, one for painting and one that affects the entire pictre. </p>
</blockquote>
<strong>Magic Sizing</strong>
<blockquote>
<p>
Some tools offer different sizing options. If so, a slider will appear at the bottom right side of the screen. This may affect the radius of a special effect (e.g., Darken) or painted object (e.g., Patterns), or other attributes (e.g., large versus small Brick shapes). </p>
<div class="screenshot-center">
<img src=
"../../html/images/tool_slider.png"
width="96"
height="48"
alt="">
</div>
<p class="note">
<span title="Configuration option">&#9881;</span> <strong>Note</strong>: If the "<code>nomagicsizes</code>" option is set, Tux Paint won't display the sizing controls. See the "<a href="OPTIONS.html"><em>Options</em></a>" documentation. </p>
<p class="note">
<span title="Information">&#128161;</span> If the sizing option is disabled, the Magic plugin may simply offer a default size (e.g., Patterns), or it may make separate tools available with different pre-set sizes (e.g., Bricks and Googly Eyes). </p>
</blockquote>
<p>
See the <a href="../magic-docs/html/index.html">instructions for each Magic tool</a> (in the 'magic-docs' folder). </p>