Resync docs to grab README -> Magic updates

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

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>