Sync'ing docs & adding images for Starter/Template options files
This commit is contained in:
Bill Kendrick
parent
72914158dd
commit
82d5c0c4e7
19 changed files with 1545 additions and 30 deletions
|
|
@ -2,10 +2,10 @@
|
|||
Tux Paint
|
||||
version 0.9.29
|
||||
|
||||
Copyright © 2002-2022 by various contributors; see AUTHORS.txt.
|
||||
Copyright © 2002-2023 by various contributors; see AUTHORS.txt.
|
||||
https://tuxpaint.org/
|
||||
|
||||
June 4, 2022
|
||||
February 12, 2023
|
||||
|
||||
+------------------------------------------+
|
||||
|Table of Contents |
|
||||
|
|
@ -26,7 +26,9 @@
|
|||
| * 'Starters' |
|
||||
| * Coloring-Book Style Starters |
|
||||
| * Scene-Style Starters |
|
||||
| * Starter Options |
|
||||
| * 'Templates' |
|
||||
| * Template Options |
|
||||
| * Translations |
|
||||
| * Alternative Input Methods |
|
||||
| * On-screen Keyboard |
|
||||
|
|
@ -585,6 +587,112 @@ Scene-Style Starters
|
|||
created. (In other words, if you base a drawing on a 'starter' image, it
|
||||
will always be affected by it.)
|
||||
|
||||
Starter Options
|
||||
|
||||
Aside from an image, starters can also be given other attributes. To do
|
||||
this, you need to create a 'data file' for the starter. (Note: Tux Paint
|
||||
prior to version 0.9.29 did not support starter options.)
|
||||
|
||||
A starter's data file is simply a plain ASCII text file containing the
|
||||
options for the starter.
|
||||
|
||||
The file has the same name as the image, but a ".dat" extension. (e.g.,
|
||||
"starter.png"'s data file is the text file "starter.dat", found in the
|
||||
same directory.)
|
||||
|
||||
allowscale
|
||||
|
||||
When a starter image is a different aspect ratio (width-to-height
|
||||
proportions) than Tux Paint's canvas, by default it will be scaled
|
||||
to fit entirely within the canvas, without stretching the starter
|
||||
(changing its aspect ratio); for example, a square starter on a
|
||||
portrait-shaped canvas will be placed in the center of the canvas.
|
||||
By default, Tux Paint will then take the strip of pixels at the
|
||||
edges of the starter and stretch them to the edges of the canvas,
|
||||
"smearing" it.
|
||||
|
||||
If it's acceptable for the starter image to be cropped in one or
|
||||
both directions, the "allowscale" may be used to tell Tux Paint
|
||||
which behavior to allow:
|
||||
|
||||
* For starters where it's alright to crop the left and right
|
||||
edges, but the top and bottom edges must be retained, use
|
||||
"allowscale=horizontal".
|
||||
* If the starter's aspect ratio is wider than that of the
|
||||
canvas, it will be scaled to fit the height of the
|
||||
canvas, and the left and right will be cropped.
|
||||
* If the starter's aspect ratio is taller than that of the
|
||||
canvas, it will be scaled to fit the height of the
|
||||
canvas, and no cropping will occur, and the left and
|
||||
right edges will be smeared.
|
||||
* For starters where it's alright to crop the top and bottom
|
||||
edges, but the left and right edges must be retained, use
|
||||
"allowscale=vertical".
|
||||
* If the starter's aspect ratio is taller than that of the
|
||||
canvas, it will be scaled to fit the width of the
|
||||
canvas, and the top and bottom will be cropped.
|
||||
* If the starter's aspect ratio is wider than that of the
|
||||
canvas, it will be scaled to fit the width of the
|
||||
canvas, and no cropping will occur, and the top and
|
||||
bottom edges will be smeared.
|
||||
* If it's acceptable to crop either the top and bottom or the
|
||||
left and right, use "allowscale=both". Contents from starter
|
||||
will always fill the canvas, regardless of how its aspect
|
||||
ratio compare to that of the canvas.
|
||||
* The default behavior is to not allow cropping. This may be
|
||||
specified explicitly with "allowscale=none".
|
||||
|
||||
background
|
||||
|
||||
This option allows you to specify how Tux Paint should fill the
|
||||
rest of the canvas, when the starter does not fit in one or the
|
||||
other direction. By default, as described above, Tux Paint will
|
||||
"smear" the pixels from the edges of the starter. (This can be
|
||||
specified explicitly with "background=smear".)
|
||||
|
||||
You can instead specify a solid background color (e.g., white for
|
||||
a 'coloring-book' style starter, with "background=#fff").
|
||||
|
||||
Colors may be listed using three decimal numbers (e.g., "255 68
|
||||
136") or a 6- or 3-digit-long hexadecimal 'triplet' (e.g.,
|
||||
"#ff4488" or "#F48").
|
||||
|
||||
gravity
|
||||
|
||||
This option allows you to specify how Tux Paint should position a
|
||||
starter, when it is being cropped in one or the other direction.
|
||||
By default, Tux Paint will place the center of the starter within
|
||||
the canvas. (This can be specified explicitly with
|
||||
"gravity=center".)
|
||||
|
||||
For example, if the top center of the starter contains the most
|
||||
important content, you can specify "gravity=top". Or, if the
|
||||
bottom right is important, specify "gravity=bottom-right".
|
||||
|
||||
The available options are:
|
||||
|
||||
* top — prefer the top center
|
||||
* bottom — prefer the bottom center
|
||||
* left — prefer the left center
|
||||
* right — prefer the right center
|
||||
* top-left — prefer the top left
|
||||
* top-right — prefer the top right
|
||||
* bottom-left — prefer the bottom left
|
||||
* bottom-right — prefer the bottom right
|
||||
Focusing on the center of a starter image stretched to fit the
|
||||
width of the canvas.
|
||||
Focusing on the center of a starter image stretched to fit the
|
||||
height of the canvas.
|
||||
Focusing on the top of a starter image stretched to fit the width
|
||||
of the canvas.
|
||||
Focusing on the bottom of a starter image stretched to fit the
|
||||
width of the canvas.
|
||||
Focusing on the right of a starter image stretched to fit the
|
||||
height of the canvas.
|
||||
|
||||
💡 Note: Templates (described below) may also have options files, and
|
||||
currently support all of the same options as starters.
|
||||
|
||||
'Templates'
|
||||
|
||||
'Template' images also appear in the 'New' dialog, along with solid color
|
||||
|
|
@ -622,6 +730,14 @@ Scene-Style Starters
|
|||
created. (In other words, if you base a drawing on a 'template' image, it
|
||||
will always be affected by it.)
|
||||
|
||||
Template Options
|
||||
|
||||
Like 'starters', a configuration file may be specified that defines how
|
||||
Tux Paint should behave when applying 'template' images to the canvas when
|
||||
they do not have identical proportions (aspect ratio). See "Starter
|
||||
Options", above. (Note: Tux Paint prior to version 0.9.29 did not support
|
||||
template options.)
|
||||
|
||||
Translations
|
||||
|
||||
Tux Paint supports numerous languages, thanks to use of the "gettext"
|
||||
|
|
|
|||
|
|
@ -93,12 +93,12 @@
|
|||
version 0.9.29 </h1>
|
||||
|
||||
<p>
|
||||
Copyright © 2002-2022 by various contributors; see <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>
|
||||
Copyright © 2002-2023 by various contributors; see <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>
|
||||
<a href="https://tuxpaint.org/">https://tuxpaint.org/</a>
|
||||
</p>
|
||||
|
||||
<p>
|
||||
June 4, 2022 </p>
|
||||
February 12, 2023 </p>
|
||||
</center>
|
||||
</header>
|
||||
|
||||
|
|
@ -125,9 +125,12 @@
|
|||
<li><a href="#stamps_images">Stamp Images</a></li> <li><a href="#description_text">Stamp Descriptive Text</a></li> <li><a href="#sound_effects">Stamp Sound Effects</a></li> <li><a href="#descriptive_sound">Stamp Descriptive Sound</a></li> <li><a href="#stamp_options">Stamp Options</a></li> <li><a href="#pre_mirroed_and_flipped_images">Pre-Mirrored and Flipped Stamps</a></li> </ul>
|
||||
</li>
|
||||
<li><a href="#fonts">Fonts</a></li> <li><a href="#starters">'Starters'</a> <ul>
|
||||
<li><a href="#coloring_book_style">Coloring-Book Style Starters</a></li> <li><a href="#scene_style">Scene-Style Starters</a></li> </ul>
|
||||
<li><a href="#coloring_book_style">Coloring-Book Style Starters</a></li> <li><a href="#scene_style">Scene-Style Starters</a></li> <li><a href="#starter_options">Starter Options</a></li> </ul>
|
||||
</li>
|
||||
<li><a href="#templates">'Templates'</a></li> <li><a href="#translations">Translations</a></li> <li><a href="#input_methods">Alternative Input Methods</a></li> <li><a href="#on_screen_keyboard">On-screen Keyboard</a></li> </ul>
|
||||
<li><a href="#templates">'Templates'</a> <ul>
|
||||
<li><a href="#template_options">Template Options</a></li> </ul>
|
||||
</li>
|
||||
<li><a href="#translations">Translations</a></li> <li><a href="#input_methods">Alternative Input Methods</a></li> <li><a href="#on_screen_keyboard">On-screen Keyboard</a></li> </ul>
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
|
@ -712,6 +715,177 @@
|
|||
|
||||
<p class="note">
|
||||
<span title="Information">💡</span> <strong>Note:</strong> 'Starters' are 'attached' to saved pictures, via a small text file that has the same name as the saved file, but with "<code>.dat</code>" as the extension. This allows it to continue to affect the drawing even after Tux Paint has been quit, or another picture is loaded or a new image is created. (In other words, if you base a drawing on a 'starter' image, it will always be affected by it.) </p>
|
||||
|
||||
<section><!-- H2: Starter Options -->
|
||||
<header>
|
||||
<h2>
|
||||
<a name="starter_options"
|
||||
id="starter_options">Starter Options</a>
|
||||
</h2>
|
||||
</header>
|
||||
|
||||
<p>
|
||||
Aside from an image, starters can also be given other attributes. To do this, you need to create a 'data file' for the starter. (Note: Tux Paint prior to version 0.9.29 did not support starter options.) </p>
|
||||
|
||||
<p>
|
||||
A starter's data file is simply a plain ASCII text file containing the options for the starter. </p>
|
||||
|
||||
<p>
|
||||
The file has the same name as the image, but a "<code>.dat</code>" extension. (e.g., "<code>starter.png</code>"'s data file is the text file "<code>starter.dat</code>", found in the same directory.) </p>
|
||||
|
||||
<dl>
|
||||
<dt><strong>allowscale</strong></dt>
|
||||
<dd><!-- allowscale -->
|
||||
<p>
|
||||
When a starter image is a different aspect ratio (width-to-height proportions) than Tux Paint's canvas, by default it will be scaled to fit entirely within the canvas, without stretching the starter (changing its aspect ratio); for example, a square starter on a portrait-shaped canvas will be placed in the center of the canvas. By default, Tux Paint will then take the strip of pixels at the edges of the starter and stretch them to the edges of the canvas, "smearing" it. </p>
|
||||
|
||||
<center>
|
||||
<img src="../../html/images/smear-wide.png"
|
||||
width="320"
|
||||
height="153"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
<img src="../../html/images/smear-tall.png"
|
||||
width="216"
|
||||
height="320"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
</center>
|
||||
|
||||
<p>
|
||||
If it's acceptable for the starter image to be cropped in one or both directions, the "<code><b>allowscale</b></code>" may be used to tell Tux Paint which behavior to allow: </p>
|
||||
<ul>
|
||||
<li><!-- allowscale=horizontal -->
|
||||
<img src="../../html/images/allowscale-horizontal.png"
|
||||
width="108"
|
||||
height="160"
|
||||
alt=""
|
||||
align="right">
|
||||
For starters where it's <em>alright to crop the left and right edges</em>, but the top and bottom edges must be retained, use "<code><b>allowscale=horizontal</b></code>". <ul>
|
||||
<li>
|
||||
If the starter's aspect ratio is wider than that of the canvas, it will be scaled to fit the height of the canvas, and the left and right will be cropped. </li>
|
||||
<li>
|
||||
If the starter's aspect ratio is taller than that of the canvas, it will be scaled to fit the height of the canvas, and no cropping will occur, and the left and right edges will be smeared. </li>
|
||||
</ul>
|
||||
<br clear="all" />
|
||||
</li><!-- allowscale=horizontal -->
|
||||
|
||||
<li><!-- allowscale=vertical -->
|
||||
<img src="../../html/images/allowscale-vertical.png"
|
||||
width="240"
|
||||
height="115"
|
||||
alt=""
|
||||
align="right">
|
||||
For starters where it's <em>alright to crop the top and bottom edges</em>, but the left and right edges must be retained, use "<code><b>allowscale=vertical</b></code>". <ul>
|
||||
<li>
|
||||
If the starter's aspect ratio is taller than that of the canvas, it will be scaled to fit the width of the canvas, and the top and bottom will be cropped. </li>
|
||||
<li>
|
||||
If the starter's aspect ratio is wider than that of the canvas, it will be scaled to fit the width of the canvas, and no cropping will occur, and the top and bottom edges will be smeared. </li>
|
||||
</ul>
|
||||
<br clear="all" />
|
||||
</li><!-- allowscale=vertical -->
|
||||
|
||||
<li><!-- allowscale=both -->
|
||||
If it's acceptable to crop either the top and bottom or the left and right, use "<code><b>allowscale=both</b></code>". Contents from starter will always fill the canvas, regardless of how its aspect ratio compare to that of the canvas. </li><!-- allowscale=both -->
|
||||
|
||||
<li><!-- allowscale=none -->
|
||||
The default behavior is to not allow cropping. This may be specified explicitly with "<code><b>allowscale=none</b></code>". </li><!-- allowscale=none -->
|
||||
</ul>
|
||||
</dd><!-- allowscale -->
|
||||
|
||||
<dt><strong>background</strong></dt>
|
||||
<dd><!-- background -->
|
||||
<p>
|
||||
This option allows you to specify how Tux Paint should fill the rest of the canvas, when the starter does not fit in one or the other direction. By default, as described above, Tux Paint will "smear" the pixels from the edges of the starter. (This can be specified explicitly with "<code><b>background=smear</b></code>".) </p>
|
||||
<p>
|
||||
You can instead specify a solid background color (e.g., white for a 'coloring-book' style starter, with "<code><b>background=#fff</b></code>"). </p>
|
||||
<p>
|
||||
Colors may be listed using three decimal numbers (e.g., "<code>255 68 136</code>") or a 6- or 3-digit-long hexadecimal 'triplet' (e.g., "<code>#ff4488</code>" or "<code>#F48</code>"). </p>
|
||||
</dd><!-- background -->
|
||||
|
||||
<dt><strong>gravity</strong></dt>
|
||||
<dd><!-- gravity -->
|
||||
<p>
|
||||
This option allows you to specify how Tux Paint should position a starter, when it is being cropped in one or the other direction. By default, Tux Paint will place the center of the starter within the canvas. (This can be specified explicitly with "<code><b>gravity=center</b></code>".) </p>
|
||||
<p>
|
||||
For example, if the top center of the starter contains the most important content, you can specify "<code><b>gravity=top</b></code>". Or, if the bottom right is important, specify "<code><b>gravity=bottom-right</b></code>". </p>
|
||||
|
||||
<p>
|
||||
The available options are: </p>
|
||||
<ul>
|
||||
<li><code><b>top</b></code> — prefer the top center</li>
|
||||
<li><code><b>bottom</b></code> — prefer the bottom center</li>
|
||||
<li><code><b>left</b></code> — prefer the left center</li>
|
||||
<li><code><b>right</b></code> — prefer the right center</li>
|
||||
<li><code><b>top-left</b></code> — prefer the top left</li>
|
||||
<li><code><b>top-right</b></code> — prefer the top right</li>
|
||||
<li><code><b>bottom-left</b></code> — prefer the bottom left</li>
|
||||
<li><code><b>bottom-right</b></code> — prefer the bottom right</li>
|
||||
</ul>
|
||||
|
||||
<div style="display: inline-block; border: 1px solid #888; width: 320px;">
|
||||
<figure style="text-align: center;">
|
||||
<img src="../../html/images/gravity-center-landscape.png"
|
||||
width="160"
|
||||
height="72"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
<figcaption style="font-size: smaller;">
|
||||
Focusing on the center of a starter image stretched to fit the width of the canvas. </figcaption>
|
||||
</figure>
|
||||
</div>
|
||||
<div style="display: inline-block; border: 1px solid #888; width: 320px;">
|
||||
<figure style="text-align: center;">
|
||||
<img src="../../html/images/gravity-center-portrait.png"
|
||||
width="84"
|
||||
height="160"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
<figcaption style="font-size: smaller;">
|
||||
Focusing on the center of a starter image stretched to fit the height of the canvas. </figcaption>
|
||||
</figure>
|
||||
</div>
|
||||
<div style="display: inline-block; border: 1px solid #888; width: 320px;">
|
||||
<figure style="text-align: center;">
|
||||
<img src="../../html/images/gravity-top-landscape.png"
|
||||
width="160"
|
||||
height="72"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
<figcaption style="font-size: smaller;">
|
||||
Focusing on the top of a starter image stretched to fit the width of the canvas. </figcaption>
|
||||
</figure>
|
||||
</div>
|
||||
<div style="display: inline-block; border: 1px solid #888; width: 320px;">
|
||||
<figure style="text-align: center;">
|
||||
<img src="../../html/images/gravity-bottom-landscape.png"
|
||||
width="160"
|
||||
height="72"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
<figcaption style="font-size: smaller;">
|
||||
Focusing on the bottom of a starter image stretched to fit the width of the canvas. </figcaption>
|
||||
</figure>
|
||||
</div>
|
||||
<div style="display: inline-block; border: 1px solid #888; width: 320px;">
|
||||
<figure style="text-align: center;">
|
||||
<img src="../../html/images/gravity-right-portrait.png"
|
||||
width="84"
|
||||
height="160"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
<figcaption style="font-size: smaller;">
|
||||
Focusing on the right of a starter image stretched to fit the height of the canvas. </figcaption>
|
||||
</figure>
|
||||
</div>
|
||||
</dd><!-- gravity -->
|
||||
</dl>
|
||||
|
||||
<p class="note">
|
||||
<span title="Information">💡</span> <strong>Note:</strong> Templates (described below) may also have options files, and currently support all of the same options as starters. </p>
|
||||
<br clear="all">
|
||||
</section><!-- H2: Starter Options -->
|
||||
|
||||
</section><!-- H1: Starters -->
|
||||
|
||||
<section class="indent outer"><!-- H1: 'Templates' -->
|
||||
|
|
@ -748,6 +922,19 @@
|
|||
<p class="note">
|
||||
<span title="Information">💡</span> <strong>Note:</strong> 'Templates' are 'attached' to saved pictures, via a small text file that has the same name as the saved file, but with "<code>.dat</code>" as the extension. This allows it to continue to affect the drawing even after Tux Paint has been quit, or another picture is loaded or a new image is created. (In other words, if you base a drawing on a 'template' image, it will always be affected by it.) </p>
|
||||
<br clear="all">
|
||||
|
||||
<section><!-- H2: Template Options -->
|
||||
<header>
|
||||
<h2>
|
||||
<a name="template_options"
|
||||
id="template_options">Template Options</a>
|
||||
</h2>
|
||||
</header>
|
||||
|
||||
<p>
|
||||
Like 'starters', a configuration file may be specified that defines how Tux Paint should behave when applying 'template' images to the canvas when they do not have identical proportions (aspect ratio). See "Starter Options", above. (Note: Tux Paint prior to version 0.9.29 did not support template options.) </p>
|
||||
</section><!-- H2: Template Options -->
|
||||
|
||||
</section><!-- H1: 'Templates' -->
|
||||
|
||||
<section class="indent outer"><!-- H1: Translations -->
|
||||
|
|
|
|||
|
|
@ -2,10 +2,10 @@
|
|||
Tux Paint
|
||||
versión 0.9.29
|
||||
|
||||
Copyright © 2002-2022 by various contributors; see AUTHORS.txt.
|
||||
Copyright © 2002-2023 by various contributors; see AUTHORS.txt.
|
||||
https://tuxpaint.org/
|
||||
|
||||
junio 4, 2022
|
||||
febrero 12, 2023
|
||||
|
||||
+------------------------------------------+
|
||||
|Table of Contents |
|
||||
|
|
@ -26,7 +26,9 @@
|
|||
| * 'Starters' |
|
||||
| * Coloring-Book Style Starters |
|
||||
| * Scene-Style Starters |
|
||||
| * Starter Options |
|
||||
| * 'Templates' |
|
||||
| * Template Options |
|
||||
| * Translations |
|
||||
| * Alternative Input Methods |
|
||||
| * On-screen Keyboard |
|
||||
|
|
@ -585,6 +587,112 @@ Scene-Style Starters
|
|||
created. (In other words, if you base a drawing on a 'starter' image, it
|
||||
will always be affected by it.)
|
||||
|
||||
Starter Options
|
||||
|
||||
Aside from an image, starters can also be given other attributes. To do
|
||||
this, you need to create a 'data file' for the starter. (Note: Tux Paint
|
||||
prior to version 0.9.29 did not support starter options.)
|
||||
|
||||
A starter's data file is simply a plain ASCII text file containing the
|
||||
options for the starter.
|
||||
|
||||
The file has the same name as the image, but a ".dat" extension. (e.g.,
|
||||
"starter.png"'s data file is the text file "starter.dat", found in the
|
||||
same directory.)
|
||||
|
||||
allowscale
|
||||
|
||||
When a starter image is a different aspect ratio (width-to-height
|
||||
proportions) than Tux Paint's canvas, by default it will be scaled
|
||||
to fit entirely within the canvas, without stretching the starter
|
||||
(changing its aspect ratio); for example, a square starter on a
|
||||
portrait-shaped canvas will be placed in the center of the canvas.
|
||||
By default, Tux Paint will then take the strip of pixels at the
|
||||
edges of the starter and stretch them to the edges of the canvas,
|
||||
"smearing" it.
|
||||
|
||||
If it's acceptable for the starter image to be cropped in one or
|
||||
both directions, the "allowscale" may be used to tell Tux Paint
|
||||
which behavior to allow:
|
||||
|
||||
* For starters where it's alright to crop the left and right
|
||||
edges, but the top and bottom edges must be retained, use
|
||||
"allowscale=horizontal".
|
||||
* If the starter's aspect ratio is wider than that of the
|
||||
canvas, it will be scaled to fit the height of the
|
||||
canvas, and the left and right will be cropped.
|
||||
* If the starter's aspect ratio is taller than that of the
|
||||
canvas, it will be scaled to fit the height of the
|
||||
canvas, and no cropping will occur, and the left and
|
||||
right edges will be smeared.
|
||||
* For starters where it's alright to crop the top and bottom
|
||||
edges, but the left and right edges must be retained, use
|
||||
"allowscale=vertical".
|
||||
* If the starter's aspect ratio is taller than that of the
|
||||
canvas, it will be scaled to fit the width of the
|
||||
canvas, and the top and bottom will be cropped.
|
||||
* If the starter's aspect ratio is wider than that of the
|
||||
canvas, it will be scaled to fit the width of the
|
||||
canvas, and no cropping will occur, and the top and
|
||||
bottom edges will be smeared.
|
||||
* If it's acceptable to crop either the top and bottom or the
|
||||
left and right, use "allowscale=both". Contents from starter
|
||||
will always fill the canvas, regardless of how its aspect
|
||||
ratio compare to that of the canvas.
|
||||
* The default behavior is to not allow cropping. This may be
|
||||
specified explicitly with "allowscale=none".
|
||||
|
||||
background
|
||||
|
||||
This option allows you to specify how Tux Paint should fill the
|
||||
rest of the canvas, when the starter does not fit in one or the
|
||||
other direction. By default, as described above, Tux Paint will
|
||||
"smear" the pixels from the edges of the starter. (This can be
|
||||
specified explicitly with "background=smear".)
|
||||
|
||||
You can instead specify a solid background color (e.g., white for
|
||||
a 'coloring-book' style starter, with "background=#fff").
|
||||
|
||||
Colors may be listed using three decimal numbers (e.g., "255 68
|
||||
136") or a 6- or 3-digit-long hexadecimal 'triplet' (e.g.,
|
||||
"#ff4488" or "#F48").
|
||||
|
||||
gravity
|
||||
|
||||
This option allows you to specify how Tux Paint should position a
|
||||
starter, when it is being cropped in one or the other direction.
|
||||
By default, Tux Paint will place the center of the starter within
|
||||
the canvas. (This can be specified explicitly with
|
||||
"gravity=center".)
|
||||
|
||||
For example, if the top center of the starter contains the most
|
||||
important content, you can specify "gravity=top". Or, if the
|
||||
bottom right is important, specify "gravity=bottom-right".
|
||||
|
||||
The available options are:
|
||||
|
||||
* top — prefer the top center
|
||||
* bottom — prefer the bottom center
|
||||
* left — prefer the left center
|
||||
* right — prefer the right center
|
||||
* top-left — prefer the top left
|
||||
* top-right — prefer the top right
|
||||
* bottom-left — prefer the bottom left
|
||||
* bottom-right — prefer the bottom right
|
||||
Focusing on the center of a starter image stretched to fit the
|
||||
width of the canvas.
|
||||
Focusing on the center of a starter image stretched to fit the
|
||||
height of the canvas.
|
||||
Focusing on the top of a starter image stretched to fit the width
|
||||
of the canvas.
|
||||
Focusing on the bottom of a starter image stretched to fit the
|
||||
width of the canvas.
|
||||
Focusing on the right of a starter image stretched to fit the
|
||||
height of the canvas.
|
||||
|
||||
💡 Note: Templates (described below) may also have options files, and
|
||||
currently support all of the same options as starters.
|
||||
|
||||
'Templates'
|
||||
|
||||
'Template' images also appear in the 'New' dialog, along with solid color
|
||||
|
|
@ -622,6 +730,14 @@ Scene-Style Starters
|
|||
created. (In other words, if you base a drawing on a 'template' image, it
|
||||
will always be affected by it.)
|
||||
|
||||
Template Options
|
||||
|
||||
Like 'starters', a configuration file may be specified that defines how
|
||||
Tux Paint should behave when applying 'template' images to the canvas when
|
||||
they do not have identical proportions (aspect ratio). See "Starter
|
||||
Options", above. (Note: Tux Paint prior to version 0.9.29 did not support
|
||||
template options.)
|
||||
|
||||
Translations
|
||||
|
||||
Tux Paint supports numerous languages, thanks to use of the "gettext"
|
||||
|
|
|
|||
|
|
@ -93,12 +93,12 @@
|
|||
versión 0.9.29 </h1>
|
||||
|
||||
<p>
|
||||
Copyright © 2002-2022 by various contributors; see <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>
|
||||
Copyright © 2002-2023 by various contributors; see <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>
|
||||
<a href="https://tuxpaint.org/">https://tuxpaint.org/</a>
|
||||
</p>
|
||||
|
||||
<p>
|
||||
junio 4, 2022 </p>
|
||||
febrero 12, 2023 </p>
|
||||
</center>
|
||||
</header>
|
||||
|
||||
|
|
@ -125,9 +125,12 @@
|
|||
<li><a href="#stamps_images">Stamp Images</a></li> <li><a href="#description_text">Stamp Descriptive Text</a></li> <li><a href="#sound_effects">Stamp Sound Effects</a></li> <li><a href="#descriptive_sound">Stamp Descriptive Sound</a></li> <li><a href="#stamp_options">Stamp Options</a></li> <li><a href="#pre_mirroed_and_flipped_images">Pre-Mirrored and Flipped Stamps</a></li> </ul>
|
||||
</li>
|
||||
<li><a href="#fonts">Fonts</a></li> <li><a href="#starters">'Starters'</a> <ul>
|
||||
<li><a href="#coloring_book_style">Coloring-Book Style Starters</a></li> <li><a href="#scene_style">Scene-Style Starters</a></li> </ul>
|
||||
<li><a href="#coloring_book_style">Coloring-Book Style Starters</a></li> <li><a href="#scene_style">Scene-Style Starters</a></li> <li><a href="#starter_options">Starter Options</a></li> </ul>
|
||||
</li>
|
||||
<li><a href="#templates">'Templates'</a></li> <li><a href="#translations">Translations</a></li> <li><a href="#input_methods">Alternative Input Methods</a></li> <li><a href="#on_screen_keyboard">On-screen Keyboard</a></li> </ul>
|
||||
<li><a href="#templates">'Templates'</a> <ul>
|
||||
<li><a href="#template_options">Template Options</a></li> </ul>
|
||||
</li>
|
||||
<li><a href="#translations">Translations</a></li> <li><a href="#input_methods">Alternative Input Methods</a></li> <li><a href="#on_screen_keyboard">On-screen Keyboard</a></li> </ul>
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
|
@ -712,6 +715,177 @@
|
|||
|
||||
<p class="note">
|
||||
<span title="Information">💡</span> <strong>Note:</strong> 'Starters' are 'attached' to saved pictures, via a small text file that has the same name as the saved file, but with "<code>.dat</code>" as the extension. This allows it to continue to affect the drawing even after Tux Paint has been quit, or another picture is loaded or a new image is created. (In other words, if you base a drawing on a 'starter' image, it will always be affected by it.) </p>
|
||||
|
||||
<section><!-- H2: Starter Options -->
|
||||
<header>
|
||||
<h2>
|
||||
<a name="starter_options"
|
||||
id="starter_options">Starter Options</a>
|
||||
</h2>
|
||||
</header>
|
||||
|
||||
<p>
|
||||
Aside from an image, starters can also be given other attributes. To do this, you need to create a 'data file' for the starter. (Note: Tux Paint prior to version 0.9.29 did not support starter options.) </p>
|
||||
|
||||
<p>
|
||||
A starter's data file is simply a plain ASCII text file containing the options for the starter. </p>
|
||||
|
||||
<p>
|
||||
The file has the same name as the image, but a "<code>.dat</code>" extension. (e.g., "<code>starter.png</code>"'s data file is the text file "<code>starter.dat</code>", found in the same directory.) </p>
|
||||
|
||||
<dl>
|
||||
<dt><strong>allowscale</strong></dt>
|
||||
<dd><!-- allowscale -->
|
||||
<p>
|
||||
When a starter image is a different aspect ratio (width-to-height proportions) than Tux Paint's canvas, by default it will be scaled to fit entirely within the canvas, without stretching the starter (changing its aspect ratio); for example, a square starter on a portrait-shaped canvas will be placed in the center of the canvas. By default, Tux Paint will then take the strip of pixels at the edges of the starter and stretch them to the edges of the canvas, "smearing" it. </p>
|
||||
|
||||
<center>
|
||||
<img src="../../html/images/smear-wide.png"
|
||||
width="320"
|
||||
height="153"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
<img src="../../html/images/smear-tall.png"
|
||||
width="216"
|
||||
height="320"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
</center>
|
||||
|
||||
<p>
|
||||
If it's acceptable for the starter image to be cropped in one or both directions, the "<code><b>allowscale</b></code>" may be used to tell Tux Paint which behavior to allow: </p>
|
||||
<ul>
|
||||
<li><!-- allowscale=horizontal -->
|
||||
<img src="../../html/images/allowscale-horizontal.png"
|
||||
width="108"
|
||||
height="160"
|
||||
alt=""
|
||||
align="right">
|
||||
For starters where it's <em>alright to crop the left and right edges</em>, but the top and bottom edges must be retained, use "<code><b>allowscale=horizontal</b></code>". <ul>
|
||||
<li>
|
||||
If the starter's aspect ratio is wider than that of the canvas, it will be scaled to fit the height of the canvas, and the left and right will be cropped. </li>
|
||||
<li>
|
||||
If the starter's aspect ratio is taller than that of the canvas, it will be scaled to fit the height of the canvas, and no cropping will occur, and the left and right edges will be smeared. </li>
|
||||
</ul>
|
||||
<br clear="all" />
|
||||
</li><!-- allowscale=horizontal -->
|
||||
|
||||
<li><!-- allowscale=vertical -->
|
||||
<img src="../../html/images/allowscale-vertical.png"
|
||||
width="240"
|
||||
height="115"
|
||||
alt=""
|
||||
align="right">
|
||||
For starters where it's <em>alright to crop the top and bottom edges</em>, but the left and right edges must be retained, use "<code><b>allowscale=vertical</b></code>". <ul>
|
||||
<li>
|
||||
If the starter's aspect ratio is taller than that of the canvas, it will be scaled to fit the width of the canvas, and the top and bottom will be cropped. </li>
|
||||
<li>
|
||||
If the starter's aspect ratio is wider than that of the canvas, it will be scaled to fit the width of the canvas, and no cropping will occur, and the top and bottom edges will be smeared. </li>
|
||||
</ul>
|
||||
<br clear="all" />
|
||||
</li><!-- allowscale=vertical -->
|
||||
|
||||
<li><!-- allowscale=both -->
|
||||
If it's acceptable to crop either the top and bottom or the left and right, use "<code><b>allowscale=both</b></code>". Contents from starter will always fill the canvas, regardless of how its aspect ratio compare to that of the canvas. </li><!-- allowscale=both -->
|
||||
|
||||
<li><!-- allowscale=none -->
|
||||
The default behavior is to not allow cropping. This may be specified explicitly with "<code><b>allowscale=none</b></code>". </li><!-- allowscale=none -->
|
||||
</ul>
|
||||
</dd><!-- allowscale -->
|
||||
|
||||
<dt><strong>background</strong></dt>
|
||||
<dd><!-- background -->
|
||||
<p>
|
||||
This option allows you to specify how Tux Paint should fill the rest of the canvas, when the starter does not fit in one or the other direction. By default, as described above, Tux Paint will "smear" the pixels from the edges of the starter. (This can be specified explicitly with "<code><b>background=smear</b></code>".) </p>
|
||||
<p>
|
||||
You can instead specify a solid background color (e.g., white for a 'coloring-book' style starter, with "<code><b>background=#fff</b></code>"). </p>
|
||||
<p>
|
||||
Colors may be listed using three decimal numbers (e.g., "<code>255 68 136</code>") or a 6- or 3-digit-long hexadecimal 'triplet' (e.g., "<code>#ff4488</code>" or "<code>#F48</code>"). </p>
|
||||
</dd><!-- background -->
|
||||
|
||||
<dt><strong>gravity</strong></dt>
|
||||
<dd><!-- gravity -->
|
||||
<p>
|
||||
This option allows you to specify how Tux Paint should position a starter, when it is being cropped in one or the other direction. By default, Tux Paint will place the center of the starter within the canvas. (This can be specified explicitly with "<code><b>gravity=center</b></code>".) </p>
|
||||
<p>
|
||||
For example, if the top center of the starter contains the most important content, you can specify "<code><b>gravity=top</b></code>". Or, if the bottom right is important, specify "<code><b>gravity=bottom-right</b></code>". </p>
|
||||
|
||||
<p>
|
||||
The available options are: </p>
|
||||
<ul>
|
||||
<li><code><b>top</b></code> — prefer the top center</li>
|
||||
<li><code><b>bottom</b></code> — prefer the bottom center</li>
|
||||
<li><code><b>left</b></code> — prefer the left center</li>
|
||||
<li><code><b>right</b></code> — prefer the right center</li>
|
||||
<li><code><b>top-left</b></code> — prefer the top left</li>
|
||||
<li><code><b>top-right</b></code> — prefer the top right</li>
|
||||
<li><code><b>bottom-left</b></code> — prefer the bottom left</li>
|
||||
<li><code><b>bottom-right</b></code> — prefer the bottom right</li>
|
||||
</ul>
|
||||
|
||||
<div style="display: inline-block; border: 1px solid #888; width: 320px;">
|
||||
<figure style="text-align: center;">
|
||||
<img src="../../html/images/gravity-center-landscape.png"
|
||||
width="160"
|
||||
height="72"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
<figcaption style="font-size: smaller;">
|
||||
Focusing on the center of a starter image stretched to fit the width of the canvas. </figcaption>
|
||||
</figure>
|
||||
</div>
|
||||
<div style="display: inline-block; border: 1px solid #888; width: 320px;">
|
||||
<figure style="text-align: center;">
|
||||
<img src="../../html/images/gravity-center-portrait.png"
|
||||
width="84"
|
||||
height="160"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
<figcaption style="font-size: smaller;">
|
||||
Focusing on the center of a starter image stretched to fit the height of the canvas. </figcaption>
|
||||
</figure>
|
||||
</div>
|
||||
<div style="display: inline-block; border: 1px solid #888; width: 320px;">
|
||||
<figure style="text-align: center;">
|
||||
<img src="../../html/images/gravity-top-landscape.png"
|
||||
width="160"
|
||||
height="72"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
<figcaption style="font-size: smaller;">
|
||||
Focusing on the top of a starter image stretched to fit the width of the canvas. </figcaption>
|
||||
</figure>
|
||||
</div>
|
||||
<div style="display: inline-block; border: 1px solid #888; width: 320px;">
|
||||
<figure style="text-align: center;">
|
||||
<img src="../../html/images/gravity-bottom-landscape.png"
|
||||
width="160"
|
||||
height="72"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
<figcaption style="font-size: smaller;">
|
||||
Focusing on the bottom of a starter image stretched to fit the width of the canvas. </figcaption>
|
||||
</figure>
|
||||
</div>
|
||||
<div style="display: inline-block; border: 1px solid #888; width: 320px;">
|
||||
<figure style="text-align: center;">
|
||||
<img src="../../html/images/gravity-right-portrait.png"
|
||||
width="84"
|
||||
height="160"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
<figcaption style="font-size: smaller;">
|
||||
Focusing on the right of a starter image stretched to fit the height of the canvas. </figcaption>
|
||||
</figure>
|
||||
</div>
|
||||
</dd><!-- gravity -->
|
||||
</dl>
|
||||
|
||||
<p class="note">
|
||||
<span title="Information">💡</span> <strong>Note:</strong> Templates (described below) may also have options files, and currently support all of the same options as starters. </p>
|
||||
<br clear="all">
|
||||
</section><!-- H2: Starter Options -->
|
||||
|
||||
</section><!-- H1: Starters -->
|
||||
|
||||
<section class="indent outer"><!-- H1: 'Templates' -->
|
||||
|
|
@ -748,6 +922,19 @@
|
|||
<p class="note">
|
||||
<span title="Information">💡</span> <strong>Note:</strong> 'Templates' are 'attached' to saved pictures, via a small text file that has the same name as the saved file, but with "<code>.dat</code>" as the extension. This allows it to continue to affect the drawing even after Tux Paint has been quit, or another picture is loaded or a new image is created. (In other words, if you base a drawing on a 'template' image, it will always be affected by it.) </p>
|
||||
<br clear="all">
|
||||
|
||||
<section><!-- H2: Template Options -->
|
||||
<header>
|
||||
<h2>
|
||||
<a name="template_options"
|
||||
id="template_options">Template Options</a>
|
||||
</h2>
|
||||
</header>
|
||||
|
||||
<p>
|
||||
Like 'starters', a configuration file may be specified that defines how Tux Paint should behave when applying 'template' images to the canvas when they do not have identical proportions (aspect ratio). See "Starter Options", above. (Note: Tux Paint prior to version 0.9.29 did not support template options.) </p>
|
||||
</section><!-- H2: Template Options -->
|
||||
|
||||
</section><!-- H1: 'Templates' -->
|
||||
|
||||
<section class="indent outer"><!-- H1: Translations -->
|
||||
|
|
|
|||
|
|
@ -2,10 +2,10 @@
|
|||
Tux Paint
|
||||
version 0.9.29
|
||||
|
||||
Copyright © 2002-2022 by divers contributeurs; see AUTHORS.txt.
|
||||
Copyright © 2002-2023 by divers contributeurs; see AUTHORS.txt.
|
||||
https://tuxpaint.org/
|
||||
|
||||
juin 4, 2022
|
||||
février 12, 2023
|
||||
|
||||
+--------------------------------------------------------------+
|
||||
|Table des matières |
|
||||
|
|
@ -26,7 +26,9 @@
|
|||
| * 'Images de démarrage' |
|
||||
| * Images de démarrage avec style 'livre de coloriage' |
|
||||
| * Images de démarrage avec 'style scénique' |
|
||||
| * Starter Options |
|
||||
| * 'Modèles' |
|
||||
| * Template Options |
|
||||
| * Traductions |
|
||||
| * Méthodes alternatives de saisie |
|
||||
| * Clavier virtuel sur écran |
|
||||
|
|
@ -630,6 +632,113 @@ Images de démarrage avec 'style scénique'
|
|||
is created. (In other words, if you base a drawing on a image de
|
||||
démarrage, it will always be affected by it.)
|
||||
|
||||
Starter Options
|
||||
|
||||
Outre une an image, les starters peuvent également recevoir d'autres
|
||||
attributs. Pour ce faire, vous devez créer un «fichier de données» pour
|
||||
starter. (Note: Tux Paint prior to version 0.9.29 did not support starter
|
||||
options.)
|
||||
|
||||
Un fichier de données de starter's est simplement un fichier texte ASCII
|
||||
contenant les options pour le starter.
|
||||
|
||||
Le fichier porte le même nom que l'image , mais une extension ".dat". (par
|
||||
exemple, le fichier de données "starter.png" est le fichier texte
|
||||
"starter.dat" qui se trouve dans le même répertoire.)
|
||||
|
||||
allowscale
|
||||
|
||||
When a starter image is a different aspect ratio (width-to-height
|
||||
proportions) than Tux Paint's canvas, by default it will be scaled
|
||||
to fit entirely within the canvas, without stretching the starter
|
||||
(changing its aspect ratio); for example, a square starter on a
|
||||
portrait-shaped canvas will be placed in the center of the canvas.
|
||||
By default, Tux Paint will then take the strip of pixels at the
|
||||
edges of the starter and stretch them to the edges of the canvas,
|
||||
"smearing" it.
|
||||
|
||||
If it's acceptable for the starter image to be cropped in one or
|
||||
both directions, the "allowscale" may be used to tell Tux Paint
|
||||
which behavior to allow:
|
||||
|
||||
* For starters where it's alright to crop the left and right
|
||||
edges, but the top and bottom edges must be retained, use
|
||||
"allowscale=horizontal".
|
||||
* If the starter's aspect ratio is wider than that of the
|
||||
canvas, it will be scaled to fit the height of the
|
||||
canvas, and the left and right will be cropped.
|
||||
* If the starter's aspect ratio is taller than that of the
|
||||
canvas, it will be scaled to fit the height of the
|
||||
canvas, and no cropping will occur, and the left and
|
||||
right edges will be smeared.
|
||||
* For starters where it's alright to crop the top and bottom
|
||||
edges, but the left and right edges must be retained, use
|
||||
"allowscale=vertical".
|
||||
* If the starter's aspect ratio is taller than that of the
|
||||
canvas, it will be scaled to fit the width of the
|
||||
canvas, and the top and bottom will be cropped.
|
||||
* If the starter's aspect ratio is wider than that of the
|
||||
canvas, it will be scaled to fit the width of the
|
||||
canvas, and no cropping will occur, and the top and
|
||||
bottom edges will be smeared.
|
||||
* If it's acceptable to crop either the top and bottom or the
|
||||
left and right, use "allowscale=both". Contents from starter
|
||||
will always fill the canvas, regardless of how its aspect
|
||||
ratio compare to that of the canvas.
|
||||
* The default behavior is to not allow cropping. This may be
|
||||
specified explicitly with "allowscale=none".
|
||||
|
||||
background
|
||||
|
||||
This option allows you to specify how Tux Paint should fill the
|
||||
rest of the canvas, when the starter does not fit in one or the
|
||||
other direction. By default, as described above, Tux Paint will
|
||||
"smear" the pixels from the edges of the starter. (This can be
|
||||
specified explicitly with "background=smear".)
|
||||
|
||||
You can instead specify a solid background color (e.g., white for
|
||||
a 'coloring-book' style starter, with "background=#fff").
|
||||
|
||||
Les couleurs peuvent être listées en utilisant trois nombres
|
||||
décimaux (par exemple, "255 68 136") ou un 'triplet' hexadécimal
|
||||
de 6 ou 3 chiffres (par exemple, " #ff4488" ou "#F48").
|
||||
|
||||
gravity
|
||||
|
||||
This option allows you to specify how Tux Paint should position a
|
||||
starter, when it is being cropped in one or the other direction.
|
||||
By default, Tux Paint will place the center of the starter within
|
||||
the canvas. (This can be specified explicitly with
|
||||
"gravity=center".)
|
||||
|
||||
For example, if the top center of the starter contains the most
|
||||
important content, you can specify "gravity=top". Or, if the
|
||||
bottom right is important, specify "gravity=bottom-right".
|
||||
|
||||
The available options are:
|
||||
|
||||
* top — prefer the top center
|
||||
* bottom — prefer the bottom center
|
||||
* left — prefer the left center
|
||||
* right — prefer the right center
|
||||
* top-left — prefer the top left
|
||||
* top-right — prefer the top right
|
||||
* bottom-left — prefer the bottom left
|
||||
* bottom-right — prefer the bottom right
|
||||
Focusing on the center of a starter image stretched to fit the
|
||||
width of the canvas.
|
||||
Focusing on the center of a starter image stretched to fit the
|
||||
height of the canvas.
|
||||
Focusing on the top of a starter image stretched to fit the width
|
||||
of the canvas.
|
||||
Focusing on the bottom of a starter image stretched to fit the
|
||||
width of the canvas.
|
||||
Focusing on the right of a starter image stretched to fit the
|
||||
height of the canvas.
|
||||
|
||||
💡 Note: Templates (described below) may also have options files, and
|
||||
currently support all of the same options as starters.
|
||||
|
||||
'Modèles'
|
||||
|
||||
Les images «Modèle» apparaissent également dans la boîte de dialogue
|
||||
|
|
@ -670,6 +779,14 @@ Images de démarrage avec 'style scénique'
|
|||
created. (In other words, if you base a drawing on a image 'modèle', it
|
||||
will always be affected by it.)
|
||||
|
||||
Template Options
|
||||
|
||||
Like 'starters', a configuration file may be specified that defines how
|
||||
Tux Paint should behave when applying 'template' images to the canvas when
|
||||
they do not have identical proportions (aspect ratio). See "Starter
|
||||
Options", above. (Note: Tux Paint prior to version 0.9.29 did not support
|
||||
template options.)
|
||||
|
||||
Traductions
|
||||
|
||||
Tux Paint supporte de nombreux langages, grâce à l'utilisation de la
|
||||
|
|
|
|||
|
|
@ -93,12 +93,12 @@
|
|||
version 0.9.29 </h1>
|
||||
|
||||
<p>
|
||||
Copyright © 2002-2022 by divers contributeurs; see <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>
|
||||
Copyright © 2002-2023 by divers contributeurs; see <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>
|
||||
<a href="https://tuxpaint.org/">https://tuxpaint.org/</a>
|
||||
</p>
|
||||
|
||||
<p>
|
||||
juin 4, 2022 </p>
|
||||
février 12, 2023 </p>
|
||||
</center>
|
||||
</header>
|
||||
|
||||
|
|
@ -125,9 +125,12 @@
|
|||
<li><a href="#stamps_images">Images des tampons</a></li> <li><a href="#description_text">Texte de description des tampons</a></li> <li><a href="#sound_effects">Effets sonores des tampons</a></li> <li><a href="#descriptive_sound">Son descriptif du tampon</a></li> <li><a href="#stamp_options">Options des tampons</a></li> <li><a href="#pre_mirroed_and_flipped_images">Mise en miroir et retournement</a></li> </ul>
|
||||
</li>
|
||||
<li><a href="#fonts">Polices</a></li> <li><a href="#starters">'Images de démarrage'</a> <ul>
|
||||
<li><a href="#coloring_book_style">Images de démarrage avec style 'livre de coloriage'</a></li> <li><a href="#scene_style">Images de démarrage avec 'style scénique'</a></li> </ul>
|
||||
<li><a href="#coloring_book_style">Images de démarrage avec style 'livre de coloriage'</a></li> <li><a href="#scene_style">Images de démarrage avec 'style scénique'</a></li> <li><a href="#starter_options">Starter Options</a></li> </ul>
|
||||
</li>
|
||||
<li><a href="#templates">'Modèles'</a></li> <li><a href="#translations">Traductions</a></li> <li><a href="#input_methods">Méthodes alternatives de saisie</a></li> <li><a href="#on_screen_keyboard">Clavier virtuel sur écran</a></li> </ul>
|
||||
<li><a href="#templates">'Modèles'</a> <ul>
|
||||
<li><a href="#template_options">Template Options</a></li> </ul>
|
||||
</li>
|
||||
<li><a href="#translations">Traductions</a></li> <li><a href="#input_methods">Méthodes alternatives de saisie</a></li> <li><a href="#on_screen_keyboard">Clavier virtuel sur écran</a></li> </ul>
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
|
@ -712,6 +715,177 @@
|
|||
|
||||
<p class="note">
|
||||
<span title="Information">💡</span> <strong>Note:</strong> 'Images de démarrage' are 'attached' to saved pictures, via a small text file that has the same name as the saved file, but with "<code>.dat</code>" as the extension. This allows it to continue to affect the drawing even after Tux Paint has been quit, or another picture is loaded or a new image is created. (In other words, if you base a drawing on a image de démarrage, it will always be affected by it.) </p>
|
||||
|
||||
<section><!-- H2: Starter Options -->
|
||||
<header>
|
||||
<h2>
|
||||
<a name="starter_options"
|
||||
id="starter_options">Starter Options</a>
|
||||
</h2>
|
||||
</header>
|
||||
|
||||
<p>
|
||||
Outre une an image, les starters peuvent également recevoir d'autres attributs. Pour ce faire, vous devez créer un «fichier de données» pour starter. (Note: Tux Paint prior to version 0.9.29 did not support starter options.) </p>
|
||||
|
||||
<p>
|
||||
Un fichier de données de starter's est simplement un fichier texte ASCII contenant les options pour le starter. </p>
|
||||
|
||||
<p>
|
||||
Le fichier porte le même nom que l'image , mais une extension "<code>.dat</code>". (par exemple, le fichier de données "<code>starter.png</code>" est le fichier texte "<code>starter.dat</code>" qui se trouve dans le même répertoire.) </p>
|
||||
|
||||
<dl>
|
||||
<dt><strong>allowscale</strong></dt>
|
||||
<dd><!-- allowscale -->
|
||||
<p>
|
||||
When a starter image is a different aspect ratio (width-to-height proportions) than Tux Paint's canvas, by default it will be scaled to fit entirely within the canvas, without stretching the starter (changing its aspect ratio); for example, a square starter on a portrait-shaped canvas will be placed in the center of the canvas. By default, Tux Paint will then take the strip of pixels at the edges of the starter and stretch them to the edges of the canvas, "smearing" it. </p>
|
||||
|
||||
<center>
|
||||
<img src="../../html/images/smear-wide.png"
|
||||
width="320"
|
||||
height="153"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
<img src="../../html/images/smear-tall.png"
|
||||
width="216"
|
||||
height="320"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
</center>
|
||||
|
||||
<p>
|
||||
If it's acceptable for the starter image to be cropped in one or both directions, the "<code><b>allowscale</b></code>" may be used to tell Tux Paint which behavior to allow: </p>
|
||||
<ul>
|
||||
<li><!-- allowscale=horizontal -->
|
||||
<img src="../../html/images/allowscale-horizontal.png"
|
||||
width="108"
|
||||
height="160"
|
||||
alt=""
|
||||
align="right">
|
||||
For starters where it's <em>alright to crop the left and right edges</em>, but the top and bottom edges must be retained, use "<code><b>allowscale=horizontal</b></code>". <ul>
|
||||
<li>
|
||||
If the starter's aspect ratio is wider than that of the canvas, it will be scaled to fit the height of the canvas, and the left and right will be cropped. </li>
|
||||
<li>
|
||||
If the starter's aspect ratio is taller than that of the canvas, it will be scaled to fit the height of the canvas, and no cropping will occur, and the left and right edges will be smeared. </li>
|
||||
</ul>
|
||||
<br clear="all" />
|
||||
</li><!-- allowscale=horizontal -->
|
||||
|
||||
<li><!-- allowscale=vertical -->
|
||||
<img src="../../html/images/allowscale-vertical.png"
|
||||
width="240"
|
||||
height="115"
|
||||
alt=""
|
||||
align="right">
|
||||
For starters where it's <em>alright to crop the top and bottom edges</em>, but the left and right edges must be retained, use "<code><b>allowscale=vertical</b></code>". <ul>
|
||||
<li>
|
||||
If the starter's aspect ratio is taller than that of the canvas, it will be scaled to fit the width of the canvas, and the top and bottom will be cropped. </li>
|
||||
<li>
|
||||
If the starter's aspect ratio is wider than that of the canvas, it will be scaled to fit the width of the canvas, and no cropping will occur, and the top and bottom edges will be smeared. </li>
|
||||
</ul>
|
||||
<br clear="all" />
|
||||
</li><!-- allowscale=vertical -->
|
||||
|
||||
<li><!-- allowscale=both -->
|
||||
If it's acceptable to crop either the top and bottom or the left and right, use "<code><b>allowscale=both</b></code>". Contents from starter will always fill the canvas, regardless of how its aspect ratio compare to that of the canvas. </li><!-- allowscale=both -->
|
||||
|
||||
<li><!-- allowscale=none -->
|
||||
The default behavior is to not allow cropping. This may be specified explicitly with "<code><b>allowscale=none</b></code>". </li><!-- allowscale=none -->
|
||||
</ul>
|
||||
</dd><!-- allowscale -->
|
||||
|
||||
<dt><strong>background</strong></dt>
|
||||
<dd><!-- background -->
|
||||
<p>
|
||||
This option allows you to specify how Tux Paint should fill the rest of the canvas, when the starter does not fit in one or the other direction. By default, as described above, Tux Paint will "smear" the pixels from the edges of the starter. (This can be specified explicitly with "<code><b>background=smear</b></code>".) </p>
|
||||
<p>
|
||||
You can instead specify a solid background color (e.g., white for a 'coloring-book' style starter, with "<code><b>background=#fff</b></code>"). </p>
|
||||
<p>
|
||||
Les couleurs peuvent être listées en utilisant trois nombres décimaux (par exemple, "<code>255 68 136</code>") ou un 'triplet' hexadécimal de 6 ou 3 chiffres (par exemple, " <code>#ff4488</code>" ou "<code>#F48</code>"). </p>
|
||||
</dd><!-- background -->
|
||||
|
||||
<dt><strong>gravity</strong></dt>
|
||||
<dd><!-- gravity -->
|
||||
<p>
|
||||
This option allows you to specify how Tux Paint should position a starter, when it is being cropped in one or the other direction. By default, Tux Paint will place the center of the starter within the canvas. (This can be specified explicitly with "<code><b>gravity=center</b></code>".) </p>
|
||||
<p>
|
||||
For example, if the top center of the starter contains the most important content, you can specify "<code><b>gravity=top</b></code>". Or, if the bottom right is important, specify "<code><b>gravity=bottom-right</b></code>". </p>
|
||||
|
||||
<p>
|
||||
The available options are: </p>
|
||||
<ul>
|
||||
<li><code><b>top</b></code> — prefer the top center</li>
|
||||
<li><code><b>bottom</b></code> — prefer the bottom center</li>
|
||||
<li><code><b>left</b></code> — prefer the left center</li>
|
||||
<li><code><b>right</b></code> — prefer the right center</li>
|
||||
<li><code><b>top-left</b></code> — prefer the top left</li>
|
||||
<li><code><b>top-right</b></code> — prefer the top right</li>
|
||||
<li><code><b>bottom-left</b></code> — prefer the bottom left</li>
|
||||
<li><code><b>bottom-right</b></code> — prefer the bottom right</li>
|
||||
</ul>
|
||||
|
||||
<div style="display: inline-block; border: 1px solid #888; width: 320px;">
|
||||
<figure style="text-align: center;">
|
||||
<img src="../../html/images/gravity-center-landscape.png"
|
||||
width="160"
|
||||
height="72"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
<figcaption style="font-size: smaller;">
|
||||
Focusing on the center of a starter image stretched to fit the width of the canvas. </figcaption>
|
||||
</figure>
|
||||
</div>
|
||||
<div style="display: inline-block; border: 1px solid #888; width: 320px;">
|
||||
<figure style="text-align: center;">
|
||||
<img src="../../html/images/gravity-center-portrait.png"
|
||||
width="84"
|
||||
height="160"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
<figcaption style="font-size: smaller;">
|
||||
Focusing on the center of a starter image stretched to fit the height of the canvas. </figcaption>
|
||||
</figure>
|
||||
</div>
|
||||
<div style="display: inline-block; border: 1px solid #888; width: 320px;">
|
||||
<figure style="text-align: center;">
|
||||
<img src="../../html/images/gravity-top-landscape.png"
|
||||
width="160"
|
||||
height="72"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
<figcaption style="font-size: smaller;">
|
||||
Focusing on the top of a starter image stretched to fit the width of the canvas. </figcaption>
|
||||
</figure>
|
||||
</div>
|
||||
<div style="display: inline-block; border: 1px solid #888; width: 320px;">
|
||||
<figure style="text-align: center;">
|
||||
<img src="../../html/images/gravity-bottom-landscape.png"
|
||||
width="160"
|
||||
height="72"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
<figcaption style="font-size: smaller;">
|
||||
Focusing on the bottom of a starter image stretched to fit the width of the canvas. </figcaption>
|
||||
</figure>
|
||||
</div>
|
||||
<div style="display: inline-block; border: 1px solid #888; width: 320px;">
|
||||
<figure style="text-align: center;">
|
||||
<img src="../../html/images/gravity-right-portrait.png"
|
||||
width="84"
|
||||
height="160"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
<figcaption style="font-size: smaller;">
|
||||
Focusing on the right of a starter image stretched to fit the height of the canvas. </figcaption>
|
||||
</figure>
|
||||
</div>
|
||||
</dd><!-- gravity -->
|
||||
</dl>
|
||||
|
||||
<p class="note">
|
||||
<span title="Information">💡</span> <strong>Note:</strong> Templates (described below) may also have options files, and currently support all of the same options as starters. </p>
|
||||
<br clear="all">
|
||||
</section><!-- H2: Starter Options -->
|
||||
|
||||
</section><!-- H1: Starters -->
|
||||
|
||||
<section class="indent outer"><!-- H1: 'Templates' -->
|
||||
|
|
@ -748,6 +922,19 @@
|
|||
<p class="note">
|
||||
<span title="Information">💡</span> <strong>Note:</strong> 'Modèles' are 'attached' to saved pictures, via a small text file that has the same name as the saved file, but with "<code>.dat</code>" as the extension. This allows it to continue to affect the drawing even after Tux Paint has been quit, or another picture is loaded or a new image is created. (In other words, if you base a drawing on a image 'modèle', it will always be affected by it.) </p>
|
||||
<br clear="all">
|
||||
|
||||
<section><!-- H2: Template Options -->
|
||||
<header>
|
||||
<h2>
|
||||
<a name="template_options"
|
||||
id="template_options">Template Options</a>
|
||||
</h2>
|
||||
</header>
|
||||
|
||||
<p>
|
||||
Like 'starters', a configuration file may be specified that defines how Tux Paint should behave when applying 'template' images to the canvas when they do not have identical proportions (aspect ratio). See "Starter Options", above. (Note: Tux Paint prior to version 0.9.29 did not support template options.) </p>
|
||||
</section><!-- H2: Template Options -->
|
||||
|
||||
</section><!-- H1: 'Templates' -->
|
||||
|
||||
<section class="indent outer"><!-- H1: Translations -->
|
||||
|
|
|
|||
|
|
@ -2,10 +2,10 @@
|
|||
Tux Paint
|
||||
versión 0.9.29
|
||||
|
||||
Copyright © 2002-2022 by varios colaboradores; see AUTHORS.txt.
|
||||
Copyright © 2002-2023 by varios colaboradores; see AUTHORS.txt.
|
||||
https://tuxpaint.org/
|
||||
|
||||
4 de Xuño de 2022
|
||||
12 de Febreiro de 2023
|
||||
|
||||
+--------------------------------------------------------------+
|
||||
|Índice |
|
||||
|
|
@ -26,7 +26,9 @@
|
|||
| * «Imaxes de comezo» |
|
||||
| * Imaxes «de comezo» ao estilo dun libro para colorar |
|
||||
| * Imaxes «de comezo» ao estilo dunha escena |
|
||||
| * Starter Options |
|
||||
| * «Modelos» |
|
||||
| * Template Options |
|
||||
| * Traducións |
|
||||
| * Métodos de entrada alternativos |
|
||||
| * Teclado en pantalla |
|
||||
|
|
@ -601,6 +603,112 @@ Imaxes «de comezo» ao estilo dunha escena
|
|||
created. (In other words, if you base a drawing on a imaxe «de comezo», it
|
||||
will always be affected by it.)
|
||||
|
||||
Starter Options
|
||||
|
||||
Ademais de an image, a starters tamén se lle poden dar outros atributos.
|
||||
Para facelo, cómpre crear un «ficheiro de datos» para starter. (Note: Tux
|
||||
Paint prior to version 0.9.29 did not support starter options.)
|
||||
|
||||
Un ficheiro de datos de starter's é simplemente un ficheiro de texto ASCII
|
||||
simple que contén as opcións de starter.
|
||||
|
||||
O ficheiro ten o mesmo nome que a imaxe , pero unha extensión «.dat». (p.
|
||||
ex.: o ficheiro de datos de «starter.png» é o ficheiro de texto
|
||||
«starter.dat», que se atopa no mesmo directorio.)
|
||||
|
||||
allowscale
|
||||
|
||||
When a starter image is a different aspect ratio (width-to-height
|
||||
proportions) than Tux Paint's canvas, by default it will be scaled
|
||||
to fit entirely within the canvas, without stretching the starter
|
||||
(changing its aspect ratio); for example, a square starter on a
|
||||
portrait-shaped canvas will be placed in the center of the canvas.
|
||||
By default, Tux Paint will then take the strip of pixels at the
|
||||
edges of the starter and stretch them to the edges of the canvas,
|
||||
"smearing" it.
|
||||
|
||||
If it's acceptable for the starter image to be cropped in one or
|
||||
both directions, the "allowscale" may be used to tell Tux Paint
|
||||
which behavior to allow:
|
||||
|
||||
* For starters where it's alright to crop the left and right
|
||||
edges, but the top and bottom edges must be retained, use
|
||||
"allowscale=horizontal".
|
||||
* If the starter's aspect ratio is wider than that of the
|
||||
canvas, it will be scaled to fit the height of the
|
||||
canvas, and the left and right will be cropped.
|
||||
* If the starter's aspect ratio is taller than that of the
|
||||
canvas, it will be scaled to fit the height of the
|
||||
canvas, and no cropping will occur, and the left and
|
||||
right edges will be smeared.
|
||||
* For starters where it's alright to crop the top and bottom
|
||||
edges, but the left and right edges must be retained, use
|
||||
"allowscale=vertical".
|
||||
* If the starter's aspect ratio is taller than that of the
|
||||
canvas, it will be scaled to fit the width of the
|
||||
canvas, and the top and bottom will be cropped.
|
||||
* If the starter's aspect ratio is wider than that of the
|
||||
canvas, it will be scaled to fit the width of the
|
||||
canvas, and no cropping will occur, and the top and
|
||||
bottom edges will be smeared.
|
||||
* If it's acceptable to crop either the top and bottom or the
|
||||
left and right, use "allowscale=both". Contents from starter
|
||||
will always fill the canvas, regardless of how its aspect
|
||||
ratio compare to that of the canvas.
|
||||
* The default behavior is to not allow cropping. This may be
|
||||
specified explicitly with "allowscale=none".
|
||||
|
||||
background
|
||||
|
||||
This option allows you to specify how Tux Paint should fill the
|
||||
rest of the canvas, when the starter does not fit in one or the
|
||||
other direction. By default, as described above, Tux Paint will
|
||||
"smear" the pixels from the edges of the starter. (This can be
|
||||
specified explicitly with "background=smear".)
|
||||
|
||||
You can instead specify a solid background color (e.g., white for
|
||||
a 'coloring-book' style starter, with "background=#fff").
|
||||
|
||||
As cores pódense enumerar usando tres números decimais (por
|
||||
exemplo, «255 68 136») ou un «triplete» hexadecimal de 6 ou 3
|
||||
díxitos de longo (por exemplo, «#ff4488» ou «#F48»).
|
||||
|
||||
gravity
|
||||
|
||||
This option allows you to specify how Tux Paint should position a
|
||||
starter, when it is being cropped in one or the other direction.
|
||||
By default, Tux Paint will place the center of the starter within
|
||||
the canvas. (This can be specified explicitly with
|
||||
"gravity=center".)
|
||||
|
||||
For example, if the top center of the starter contains the most
|
||||
important content, you can specify "gravity=top". Or, if the
|
||||
bottom right is important, specify "gravity=bottom-right".
|
||||
|
||||
The available options are:
|
||||
|
||||
* top — prefer the top center
|
||||
* bottom — prefer the bottom center
|
||||
* left — prefer the left center
|
||||
* right — prefer the right center
|
||||
* top-left — prefer the top left
|
||||
* top-right — prefer the top right
|
||||
* bottom-left — prefer the bottom left
|
||||
* bottom-right — prefer the bottom right
|
||||
Focusing on the center of a starter image stretched to fit the
|
||||
width of the canvas.
|
||||
Focusing on the center of a starter image stretched to fit the
|
||||
height of the canvas.
|
||||
Focusing on the top of a starter image stretched to fit the width
|
||||
of the canvas.
|
||||
Focusing on the bottom of a starter image stretched to fit the
|
||||
width of the canvas.
|
||||
Focusing on the right of a starter image stretched to fit the
|
||||
height of the canvas.
|
||||
|
||||
💡 Note: Templates (described below) may also have options files, and
|
||||
currently support all of the same options as starters.
|
||||
|
||||
«Modelos»
|
||||
|
||||
As imaxes «modelo» tamén aparecen no diálogo «Novo», xunto coas opcións de
|
||||
|
|
@ -640,6 +748,14 @@ Imaxes «de comezo» ao estilo dunha escena
|
|||
created. (In other words, if you base a drawing on a imaxe «modelo», it
|
||||
will always be affected by it.)
|
||||
|
||||
Template Options
|
||||
|
||||
Like 'starters', a configuration file may be specified that defines how
|
||||
Tux Paint should behave when applying 'template' images to the canvas when
|
||||
they do not have identical proportions (aspect ratio). See "Starter
|
||||
Options", above. (Note: Tux Paint prior to version 0.9.29 did not support
|
||||
template options.)
|
||||
|
||||
Traducións
|
||||
|
||||
Tux Paint admite numerosos idiomas grazas ao uso da biblioteca de
|
||||
|
|
|
|||
|
|
@ -93,12 +93,12 @@
|
|||
versión 0.9.29 </h1>
|
||||
|
||||
<p>
|
||||
Copyright © 2002-2022 by varios colaboradores; see <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>
|
||||
Copyright © 2002-2023 by varios colaboradores; see <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>
|
||||
<a href="https://tuxpaint.org/">https://tuxpaint.org/</a>
|
||||
</p>
|
||||
|
||||
<p>
|
||||
4 de Xuño de 2022 </p>
|
||||
12 de Febreiro de 2023 </p>
|
||||
</center>
|
||||
</header>
|
||||
|
||||
|
|
@ -125,9 +125,12 @@
|
|||
<li><a href="#stamps_images">Imaxes de selos</a></li> <li><a href="#description_text">Texto descritivo do selo</a></li> <li><a href="#sound_effects">Efectos de son dos selos</a></li> <li><a href="#descriptive_sound">Son descritivo do selo</a></li> <li><a href="#stamp_options">Opcións de selos</a></li> <li><a href="#pre_mirroed_and_flipped_images">Selos prereflectidos e invertidos</a></li> </ul>
|
||||
</li>
|
||||
<li><a href="#fonts">Tipos de letra</a></li> <li><a href="#starters">«Imaxes de comezo»</a> <ul>
|
||||
<li><a href="#coloring_book_style">Imaxes «de comezo» ao estilo dun libro para colorar</a></li> <li><a href="#scene_style">Imaxes «de comezo» ao estilo dunha escena</a></li> </ul>
|
||||
<li><a href="#coloring_book_style">Imaxes «de comezo» ao estilo dun libro para colorar</a></li> <li><a href="#scene_style">Imaxes «de comezo» ao estilo dunha escena</a></li> <li><a href="#starter_options">Starter Options</a></li> </ul>
|
||||
</li>
|
||||
<li><a href="#templates">«Modelos»</a></li> <li><a href="#translations">Traducións</a></li> <li><a href="#input_methods">Métodos de entrada alternativos</a></li> <li><a href="#on_screen_keyboard">Teclado en pantalla</a></li> </ul>
|
||||
<li><a href="#templates">«Modelos»</a> <ul>
|
||||
<li><a href="#template_options">Template Options</a></li> </ul>
|
||||
</li>
|
||||
<li><a href="#translations">Traducións</a></li> <li><a href="#input_methods">Métodos de entrada alternativos</a></li> <li><a href="#on_screen_keyboard">Teclado en pantalla</a></li> </ul>
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
|
@ -712,6 +715,177 @@
|
|||
|
||||
<p class="note">
|
||||
<span title="Information">💡</span> <strong>Note:</strong> «Imaxes de comezo» are 'attached' to saved pictures, via a small text file that has the same name as the saved file, but with "<code>.dat</code>" as the extension. This allows it to continue to affect the drawing even after Tux Paint has been quit, or another picture is loaded or a new image is created. (In other words, if you base a drawing on a imaxe «de comezo», it will always be affected by it.) </p>
|
||||
|
||||
<section><!-- H2: Starter Options -->
|
||||
<header>
|
||||
<h2>
|
||||
<a name="starter_options"
|
||||
id="starter_options">Starter Options</a>
|
||||
</h2>
|
||||
</header>
|
||||
|
||||
<p>
|
||||
Ademais de an image, a starters tamén se lle poden dar outros atributos. Para facelo, cómpre crear un «ficheiro de datos» para starter. (Note: Tux Paint prior to version 0.9.29 did not support starter options.) </p>
|
||||
|
||||
<p>
|
||||
Un ficheiro de datos de starter's é simplemente un ficheiro de texto ASCII simple que contén as opcións de starter. </p>
|
||||
|
||||
<p>
|
||||
O ficheiro ten o mesmo nome que a imaxe , pero unha extensión «<code>.dat</code>». (p. ex.: o ficheiro de datos de «<code>starter.png</code>» é o ficheiro de texto «<code>starter.dat</code>», que se atopa no mesmo directorio.) </p>
|
||||
|
||||
<dl>
|
||||
<dt><strong>allowscale</strong></dt>
|
||||
<dd><!-- allowscale -->
|
||||
<p>
|
||||
When a starter image is a different aspect ratio (width-to-height proportions) than Tux Paint's canvas, by default it will be scaled to fit entirely within the canvas, without stretching the starter (changing its aspect ratio); for example, a square starter on a portrait-shaped canvas will be placed in the center of the canvas. By default, Tux Paint will then take the strip of pixels at the edges of the starter and stretch them to the edges of the canvas, "smearing" it. </p>
|
||||
|
||||
<center>
|
||||
<img src="../../html/images/smear-wide.png"
|
||||
width="320"
|
||||
height="153"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
<img src="../../html/images/smear-tall.png"
|
||||
width="216"
|
||||
height="320"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
</center>
|
||||
|
||||
<p>
|
||||
If it's acceptable for the starter image to be cropped in one or both directions, the "<code><b>allowscale</b></code>" may be used to tell Tux Paint which behavior to allow: </p>
|
||||
<ul>
|
||||
<li><!-- allowscale=horizontal -->
|
||||
<img src="../../html/images/allowscale-horizontal.png"
|
||||
width="108"
|
||||
height="160"
|
||||
alt=""
|
||||
align="right">
|
||||
For starters where it's <em>alright to crop the left and right edges</em>, but the top and bottom edges must be retained, use "<code><b>allowscale=horizontal</b></code>". <ul>
|
||||
<li>
|
||||
If the starter's aspect ratio is wider than that of the canvas, it will be scaled to fit the height of the canvas, and the left and right will be cropped. </li>
|
||||
<li>
|
||||
If the starter's aspect ratio is taller than that of the canvas, it will be scaled to fit the height of the canvas, and no cropping will occur, and the left and right edges will be smeared. </li>
|
||||
</ul>
|
||||
<br clear="all" />
|
||||
</li><!-- allowscale=horizontal -->
|
||||
|
||||
<li><!-- allowscale=vertical -->
|
||||
<img src="../../html/images/allowscale-vertical.png"
|
||||
width="240"
|
||||
height="115"
|
||||
alt=""
|
||||
align="right">
|
||||
For starters where it's <em>alright to crop the top and bottom edges</em>, but the left and right edges must be retained, use "<code><b>allowscale=vertical</b></code>". <ul>
|
||||
<li>
|
||||
If the starter's aspect ratio is taller than that of the canvas, it will be scaled to fit the width of the canvas, and the top and bottom will be cropped. </li>
|
||||
<li>
|
||||
If the starter's aspect ratio is wider than that of the canvas, it will be scaled to fit the width of the canvas, and no cropping will occur, and the top and bottom edges will be smeared. </li>
|
||||
</ul>
|
||||
<br clear="all" />
|
||||
</li><!-- allowscale=vertical -->
|
||||
|
||||
<li><!-- allowscale=both -->
|
||||
If it's acceptable to crop either the top and bottom or the left and right, use "<code><b>allowscale=both</b></code>". Contents from starter will always fill the canvas, regardless of how its aspect ratio compare to that of the canvas. </li><!-- allowscale=both -->
|
||||
|
||||
<li><!-- allowscale=none -->
|
||||
The default behavior is to not allow cropping. This may be specified explicitly with "<code><b>allowscale=none</b></code>". </li><!-- allowscale=none -->
|
||||
</ul>
|
||||
</dd><!-- allowscale -->
|
||||
|
||||
<dt><strong>background</strong></dt>
|
||||
<dd><!-- background -->
|
||||
<p>
|
||||
This option allows you to specify how Tux Paint should fill the rest of the canvas, when the starter does not fit in one or the other direction. By default, as described above, Tux Paint will "smear" the pixels from the edges of the starter. (This can be specified explicitly with "<code><b>background=smear</b></code>".) </p>
|
||||
<p>
|
||||
You can instead specify a solid background color (e.g., white for a 'coloring-book' style starter, with "<code><b>background=#fff</b></code>"). </p>
|
||||
<p>
|
||||
As cores pódense enumerar usando tres números decimais (por exemplo, «<code>255 68 136</code>») ou un «triplete» hexadecimal de 6 ou 3 díxitos de longo (por exemplo, «<code>#ff4488</code>» ou «<code>#F48</code>»). </p>
|
||||
</dd><!-- background -->
|
||||
|
||||
<dt><strong>gravity</strong></dt>
|
||||
<dd><!-- gravity -->
|
||||
<p>
|
||||
This option allows you to specify how Tux Paint should position a starter, when it is being cropped in one or the other direction. By default, Tux Paint will place the center of the starter within the canvas. (This can be specified explicitly with "<code><b>gravity=center</b></code>".) </p>
|
||||
<p>
|
||||
For example, if the top center of the starter contains the most important content, you can specify "<code><b>gravity=top</b></code>". Or, if the bottom right is important, specify "<code><b>gravity=bottom-right</b></code>". </p>
|
||||
|
||||
<p>
|
||||
The available options are: </p>
|
||||
<ul>
|
||||
<li><code><b>top</b></code> — prefer the top center</li>
|
||||
<li><code><b>bottom</b></code> — prefer the bottom center</li>
|
||||
<li><code><b>left</b></code> — prefer the left center</li>
|
||||
<li><code><b>right</b></code> — prefer the right center</li>
|
||||
<li><code><b>top-left</b></code> — prefer the top left</li>
|
||||
<li><code><b>top-right</b></code> — prefer the top right</li>
|
||||
<li><code><b>bottom-left</b></code> — prefer the bottom left</li>
|
||||
<li><code><b>bottom-right</b></code> — prefer the bottom right</li>
|
||||
</ul>
|
||||
|
||||
<div style="display: inline-block; border: 1px solid #888; width: 320px;">
|
||||
<figure style="text-align: center;">
|
||||
<img src="../../html/images/gravity-center-landscape.png"
|
||||
width="160"
|
||||
height="72"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
<figcaption style="font-size: smaller;">
|
||||
Focusing on the center of a starter image stretched to fit the width of the canvas. </figcaption>
|
||||
</figure>
|
||||
</div>
|
||||
<div style="display: inline-block; border: 1px solid #888; width: 320px;">
|
||||
<figure style="text-align: center;">
|
||||
<img src="../../html/images/gravity-center-portrait.png"
|
||||
width="84"
|
||||
height="160"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
<figcaption style="font-size: smaller;">
|
||||
Focusing on the center of a starter image stretched to fit the height of the canvas. </figcaption>
|
||||
</figure>
|
||||
</div>
|
||||
<div style="display: inline-block; border: 1px solid #888; width: 320px;">
|
||||
<figure style="text-align: center;">
|
||||
<img src="../../html/images/gravity-top-landscape.png"
|
||||
width="160"
|
||||
height="72"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
<figcaption style="font-size: smaller;">
|
||||
Focusing on the top of a starter image stretched to fit the width of the canvas. </figcaption>
|
||||
</figure>
|
||||
</div>
|
||||
<div style="display: inline-block; border: 1px solid #888; width: 320px;">
|
||||
<figure style="text-align: center;">
|
||||
<img src="../../html/images/gravity-bottom-landscape.png"
|
||||
width="160"
|
||||
height="72"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
<figcaption style="font-size: smaller;">
|
||||
Focusing on the bottom of a starter image stretched to fit the width of the canvas. </figcaption>
|
||||
</figure>
|
||||
</div>
|
||||
<div style="display: inline-block; border: 1px solid #888; width: 320px;">
|
||||
<figure style="text-align: center;">
|
||||
<img src="../../html/images/gravity-right-portrait.png"
|
||||
width="84"
|
||||
height="160"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
<figcaption style="font-size: smaller;">
|
||||
Focusing on the right of a starter image stretched to fit the height of the canvas. </figcaption>
|
||||
</figure>
|
||||
</div>
|
||||
</dd><!-- gravity -->
|
||||
</dl>
|
||||
|
||||
<p class="note">
|
||||
<span title="Information">💡</span> <strong>Note:</strong> Templates (described below) may also have options files, and currently support all of the same options as starters. </p>
|
||||
<br clear="all">
|
||||
</section><!-- H2: Starter Options -->
|
||||
|
||||
</section><!-- H1: Starters -->
|
||||
|
||||
<section class="indent outer"><!-- H1: 'Templates' -->
|
||||
|
|
@ -748,6 +922,19 @@
|
|||
<p class="note">
|
||||
<span title="Information">💡</span> <strong>Note:</strong> «Modelos» are 'attached' to saved pictures, via a small text file that has the same name as the saved file, but with "<code>.dat</code>" as the extension. This allows it to continue to affect the drawing even after Tux Paint has been quit, or another picture is loaded or a new image is created. (In other words, if you base a drawing on a imaxe «modelo», it will always be affected by it.) </p>
|
||||
<br clear="all">
|
||||
|
||||
<section><!-- H2: Template Options -->
|
||||
<header>
|
||||
<h2>
|
||||
<a name="template_options"
|
||||
id="template_options">Template Options</a>
|
||||
</h2>
|
||||
</header>
|
||||
|
||||
<p>
|
||||
Like 'starters', a configuration file may be specified that defines how Tux Paint should behave when applying 'template' images to the canvas when they do not have identical proportions (aspect ratio). See "Starter Options", above. (Note: Tux Paint prior to version 0.9.29 did not support template options.) </p>
|
||||
</section><!-- H2: Template Options -->
|
||||
|
||||
</section><!-- H1: 'Templates' -->
|
||||
|
||||
<section class="indent outer"><!-- H1: Translations -->
|
||||
|
|
|
|||
BIN
docs/html/images/allowscale-horizontal.png
Normal file
BIN
docs/html/images/allowscale-horizontal.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 24 KiB |
BIN
docs/html/images/allowscale-vertical.png
Normal file
BIN
docs/html/images/allowscale-vertical.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 26 KiB |
BIN
docs/html/images/gravity-bottom-landscape.png
Normal file
BIN
docs/html/images/gravity-bottom-landscape.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 7.5 KiB |
BIN
docs/html/images/gravity-center-landscape.png
Normal file
BIN
docs/html/images/gravity-center-landscape.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 12 KiB |
BIN
docs/html/images/gravity-center-portrait.png
Normal file
BIN
docs/html/images/gravity-center-portrait.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 12 KiB |
BIN
docs/html/images/gravity-right-portrait.png
Normal file
BIN
docs/html/images/gravity-right-portrait.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 12 KiB |
BIN
docs/html/images/gravity-top-landscape.png
Normal file
BIN
docs/html/images/gravity-top-landscape.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 10 KiB |
BIN
docs/html/images/smear-tall.png
Normal file
BIN
docs/html/images/smear-tall.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 77 KiB |
BIN
docs/html/images/smear-wide.png
Normal file
BIN
docs/html/images/smear-wide.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 56 KiB |
|
|
@ -2,10 +2,10 @@
|
|||
Tux Paint
|
||||
バージョン 0.9.29
|
||||
|
||||
Copyright © 2002-2022 by various contributors; AUTHORS.txt 参照.
|
||||
Copyright © 2002-2023 by various contributors; AUTHORS.txt 参照.
|
||||
https://tuxpaint.org/
|
||||
|
||||
2022年6月 4日
|
||||
2023年2月12日
|
||||
|
||||
+------------------------------------------+
|
||||
|目次 |
|
||||
|
|
@ -26,7 +26,9 @@
|
|||
| * 'Starters' |
|
||||
| * Coloring-Book Style Starters |
|
||||
| * Scene-Style Starters |
|
||||
| * Starter Options |
|
||||
| * 'Templates' |
|
||||
| * Template Options |
|
||||
| * Translations |
|
||||
| * Alternative Input Methods |
|
||||
| * 画面キーボード |
|
||||
|
|
@ -585,6 +587,111 @@ Scene-Style Starters
|
|||
created. (In other words, if you base a drawing on a 'starter' image, it
|
||||
will always be affected by it.)
|
||||
|
||||
Starter Options
|
||||
|
||||
Aside from an image, starters can also be given other attributes. To do
|
||||
this, you need to create a 'data file' for the starter. (Note: Tux Paint
|
||||
prior to version 0.9.29 did not support starter options.)
|
||||
|
||||
A starter's data file is simply a plain ASCII text file containing the
|
||||
options for the starter.
|
||||
|
||||
The file has the same name as the image, but a ".dat" extension. (e.g.,
|
||||
"starter.png"'s data file is the text file "starter.dat", found in the
|
||||
same directory.)
|
||||
|
||||
allowscale
|
||||
|
||||
When a starter image is a different aspect ratio (width-to-height
|
||||
proportions) than Tux Paint's canvas, by default it will be scaled
|
||||
to fit entirely within the canvas, without stretching the starter
|
||||
(changing its aspect ratio); for example, a square starter on a
|
||||
portrait-shaped canvas will be placed in the center of the canvas.
|
||||
By default, Tux Paint will then take the strip of pixels at the
|
||||
edges of the starter and stretch them to the edges of the canvas,
|
||||
"smearing" it.
|
||||
|
||||
If it's acceptable for the starter image to be cropped in one or
|
||||
both directions, the "allowscale" may be used to tell Tux Paint
|
||||
which behavior to allow:
|
||||
|
||||
* For starters where it's alright to crop the left and right
|
||||
edges, but the top and bottom edges must be retained, use
|
||||
"allowscale=horizontal".
|
||||
* If the starter's aspect ratio is wider than that of the
|
||||
canvas, it will be scaled to fit the height of the
|
||||
canvas, and the left and right will be cropped.
|
||||
* If the starter's aspect ratio is taller than that of the
|
||||
canvas, it will be scaled to fit the height of the
|
||||
canvas, and no cropping will occur, and the left and
|
||||
right edges will be smeared.
|
||||
* For starters where it's alright to crop the top and bottom
|
||||
edges, but the left and right edges must be retained, use
|
||||
"allowscale=vertical".
|
||||
* If the starter's aspect ratio is taller than that of the
|
||||
canvas, it will be scaled to fit the width of the
|
||||
canvas, and the top and bottom will be cropped.
|
||||
* If the starter's aspect ratio is wider than that of the
|
||||
canvas, it will be scaled to fit the width of the
|
||||
canvas, and no cropping will occur, and the top and
|
||||
bottom edges will be smeared.
|
||||
* If it's acceptable to crop either the top and bottom or the
|
||||
left and right, use "allowscale=both". Contents from starter
|
||||
will always fill the canvas, regardless of how its aspect
|
||||
ratio compare to that of the canvas.
|
||||
* The default behavior is to not allow cropping. This may be
|
||||
specified explicitly with "allowscale=none".
|
||||
|
||||
background
|
||||
|
||||
This option allows you to specify how Tux Paint should fill the
|
||||
rest of the canvas, when the starter does not fit in one or the
|
||||
other direction. By default, as described above, Tux Paint will
|
||||
"smear" the pixels from the edges of the starter. (This can be
|
||||
specified explicitly with "background=smear".)
|
||||
|
||||
You can instead specify a solid background color (e.g., white for
|
||||
a 'coloring-book' style starter, with "background=#fff").
|
||||
|
||||
各行の色は、３つの十進数の組み（例: "255 68 136"）、あるいは、3つの16 進数の組からなる6桁または3桁の表記（例:
|
||||
"#ff4488" または "#F48”）で指定します。
|
||||
|
||||
gravity
|
||||
|
||||
This option allows you to specify how Tux Paint should position a
|
||||
starter, when it is being cropped in one or the other direction.
|
||||
By default, Tux Paint will place the center of the starter within
|
||||
the canvas. (This can be specified explicitly with
|
||||
"gravity=center".)
|
||||
|
||||
For example, if the top center of the starter contains the most
|
||||
important content, you can specify "gravity=top". Or, if the
|
||||
bottom right is important, specify "gravity=bottom-right".
|
||||
|
||||
The available options are:
|
||||
|
||||
* top — prefer the top center
|
||||
* bottom — prefer the bottom center
|
||||
* left — prefer the left center
|
||||
* right — prefer the right center
|
||||
* top-left — prefer the top left
|
||||
* top-right — prefer the top right
|
||||
* bottom-left — prefer the bottom left
|
||||
* bottom-right — prefer the bottom right
|
||||
Focusing on the center of a starter image stretched to fit the
|
||||
width of the canvas.
|
||||
Focusing on the center of a starter image stretched to fit the
|
||||
height of the canvas.
|
||||
Focusing on the top of a starter image stretched to fit the width
|
||||
of the canvas.
|
||||
Focusing on the bottom of a starter image stretched to fit the
|
||||
width of the canvas.
|
||||
Focusing on the right of a starter image stretched to fit the
|
||||
height of the canvas.
|
||||
|
||||
💡 Note: Templates (described below) may also have options files, and
|
||||
currently support all of the same options as starters.
|
||||
|
||||
'Templates'
|
||||
|
||||
'Template' images also appear in the 'New' dialog, along with solid color
|
||||
|
|
@ -622,6 +729,14 @@ Scene-Style Starters
|
|||
created. (In other words, if you base a drawing on a 'template' image, it
|
||||
will always be affected by it.)
|
||||
|
||||
Template Options
|
||||
|
||||
Like 'starters', a configuration file may be specified that defines how
|
||||
Tux Paint should behave when applying 'template' images to the canvas when
|
||||
they do not have identical proportions (aspect ratio). See "Starter
|
||||
Options", above. (Note: Tux Paint prior to version 0.9.29 did not support
|
||||
template options.)
|
||||
|
||||
Translations
|
||||
|
||||
Tux Paint supports numerous languages, thanks to use of the "gettext"
|
||||
|
|
|
|||
|
|
@ -93,12 +93,12 @@
|
|||
バージョン 0.9.29 </h1>
|
||||
|
||||
<p>
|
||||
Copyright © 2002-2022 by various contributors; <a href="../../AUTHORS.txt">AUTHORS.txt</a> 参照.<br>
|
||||
Copyright © 2002-2023 by various contributors; <a href="../../AUTHORS.txt">AUTHORS.txt</a> 参照.<br>
|
||||
<a href="https://tuxpaint.org/">https://tuxpaint.org/</a>
|
||||
</p>
|
||||
|
||||
<p>
|
||||
2022年6月 4日 </p>
|
||||
2023年2月12日 </p>
|
||||
</center>
|
||||
</header>
|
||||
|
||||
|
|
@ -125,9 +125,12 @@
|
|||
<li><a href="#stamps_images">Stamp Images</a></li> <li><a href="#description_text">Stamp Descriptive Text</a></li> <li><a href="#sound_effects">Stamp Sound Effects</a></li> <li><a href="#descriptive_sound">Stamp Descriptive Sound</a></li> <li><a href="#stamp_options">Stamp Options</a></li> <li><a href="#pre_mirroed_and_flipped_images">Pre-Mirrored and Flipped Stamps</a></li> </ul>
|
||||
</li>
|
||||
<li><a href="#fonts">フォント</a></li> <li><a href="#starters">'Starters'</a> <ul>
|
||||
<li><a href="#coloring_book_style">Coloring-Book Style Starters</a></li> <li><a href="#scene_style">Scene-Style Starters</a></li> </ul>
|
||||
<li><a href="#coloring_book_style">Coloring-Book Style Starters</a></li> <li><a href="#scene_style">Scene-Style Starters</a></li> <li><a href="#starter_options">Starter Options</a></li> </ul>
|
||||
</li>
|
||||
<li><a href="#templates">'Templates'</a></li> <li><a href="#translations">Translations</a></li> <li><a href="#input_methods">Alternative Input Methods</a></li> <li><a href="#on_screen_keyboard">画面キーボード</a></li> </ul>
|
||||
<li><a href="#templates">'Templates'</a> <ul>
|
||||
<li><a href="#template_options">Template Options</a></li> </ul>
|
||||
</li>
|
||||
<li><a href="#translations">Translations</a></li> <li><a href="#input_methods">Alternative Input Methods</a></li> <li><a href="#on_screen_keyboard">画面キーボード</a></li> </ul>
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
|
@ -712,6 +715,177 @@
|
|||
|
||||
<p class="note">
|
||||
<span title="Information">💡</span> <strong>Note:</strong> 'Starters' are 'attached' to saved pictures, via a small text file that has the same name as the saved file, but with "<code>.dat</code>" as the extension. This allows it to continue to affect the drawing even after Tux Paint has been quit, or another picture is loaded or a new image is created. (In other words, if you base a drawing on a 'starter' image, it will always be affected by it.) </p>
|
||||
|
||||
<section><!-- H2: Starter Options -->
|
||||
<header>
|
||||
<h2>
|
||||
<a name="starter_options"
|
||||
id="starter_options">Starter Options</a>
|
||||
</h2>
|
||||
</header>
|
||||
|
||||
<p>
|
||||
Aside from an image, starters can also be given other attributes. To do this, you need to create a 'data file' for the starter. (Note: Tux Paint prior to version 0.9.29 did not support starter options.) </p>
|
||||
|
||||
<p>
|
||||
A starter's data file is simply a plain ASCII text file containing the options for the starter. </p>
|
||||
|
||||
<p>
|
||||
The file has the same name as the image, but a "<code>.dat</code>" extension. (e.g., "<code>starter.png</code>"'s data file is the text file "<code>starter.dat</code>", found in the same directory.) </p>
|
||||
|
||||
<dl>
|
||||
<dt><strong>allowscale</strong></dt>
|
||||
<dd><!-- allowscale -->
|
||||
<p>
|
||||
When a starter image is a different aspect ratio (width-to-height proportions) than Tux Paint's canvas, by default it will be scaled to fit entirely within the canvas, without stretching the starter (changing its aspect ratio); for example, a square starter on a portrait-shaped canvas will be placed in the center of the canvas. By default, Tux Paint will then take the strip of pixels at the edges of the starter and stretch them to the edges of the canvas, "smearing" it. </p>
|
||||
|
||||
<center>
|
||||
<img src="../../html/images/smear-wide.png"
|
||||
width="320"
|
||||
height="153"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
<img src="../../html/images/smear-tall.png"
|
||||
width="216"
|
||||
height="320"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
</center>
|
||||
|
||||
<p>
|
||||
If it's acceptable for the starter image to be cropped in one or both directions, the "<code><b>allowscale</b></code>" may be used to tell Tux Paint which behavior to allow: </p>
|
||||
<ul>
|
||||
<li><!-- allowscale=horizontal -->
|
||||
<img src="../../html/images/allowscale-horizontal.png"
|
||||
width="108"
|
||||
height="160"
|
||||
alt=""
|
||||
align="right">
|
||||
For starters where it's <em>alright to crop the left and right edges</em>, but the top and bottom edges must be retained, use "<code><b>allowscale=horizontal</b></code>". <ul>
|
||||
<li>
|
||||
If the starter's aspect ratio is wider than that of the canvas, it will be scaled to fit the height of the canvas, and the left and right will be cropped. </li>
|
||||
<li>
|
||||
If the starter's aspect ratio is taller than that of the canvas, it will be scaled to fit the height of the canvas, and no cropping will occur, and the left and right edges will be smeared. </li>
|
||||
</ul>
|
||||
<br clear="all" />
|
||||
</li><!-- allowscale=horizontal -->
|
||||
|
||||
<li><!-- allowscale=vertical -->
|
||||
<img src="../../html/images/allowscale-vertical.png"
|
||||
width="240"
|
||||
height="115"
|
||||
alt=""
|
||||
align="right">
|
||||
For starters where it's <em>alright to crop the top and bottom edges</em>, but the left and right edges must be retained, use "<code><b>allowscale=vertical</b></code>". <ul>
|
||||
<li>
|
||||
If the starter's aspect ratio is taller than that of the canvas, it will be scaled to fit the width of the canvas, and the top and bottom will be cropped. </li>
|
||||
<li>
|
||||
If the starter's aspect ratio is wider than that of the canvas, it will be scaled to fit the width of the canvas, and no cropping will occur, and the top and bottom edges will be smeared. </li>
|
||||
</ul>
|
||||
<br clear="all" />
|
||||
</li><!-- allowscale=vertical -->
|
||||
|
||||
<li><!-- allowscale=both -->
|
||||
If it's acceptable to crop either the top and bottom or the left and right, use "<code><b>allowscale=both</b></code>". Contents from starter will always fill the canvas, regardless of how its aspect ratio compare to that of the canvas. </li><!-- allowscale=both -->
|
||||
|
||||
<li><!-- allowscale=none -->
|
||||
The default behavior is to not allow cropping. This may be specified explicitly with "<code><b>allowscale=none</b></code>". </li><!-- allowscale=none -->
|
||||
</ul>
|
||||
</dd><!-- allowscale -->
|
||||
|
||||
<dt><strong>background</strong></dt>
|
||||
<dd><!-- background -->
|
||||
<p>
|
||||
This option allows you to specify how Tux Paint should fill the rest of the canvas, when the starter does not fit in one or the other direction. By default, as described above, Tux Paint will "smear" the pixels from the edges of the starter. (This can be specified explicitly with "<code><b>background=smear</b></code>".) </p>
|
||||
<p>
|
||||
You can instead specify a solid background color (e.g., white for a 'coloring-book' style starter, with "<code><b>background=#fff</b></code>"). </p>
|
||||
<p>
|
||||
各行の色は、３つの十進数の組み（例: "<code>255 68 136</code>"）、あるいは、3つの16 進数の組からなる6桁または3桁の表記（例: "<code>#ff4488</code>" または "<code>#F48</code>”）で指定します。 </p>
|
||||
</dd><!-- background -->
|
||||
|
||||
<dt><strong>gravity</strong></dt>
|
||||
<dd><!-- gravity -->
|
||||
<p>
|
||||
This option allows you to specify how Tux Paint should position a starter, when it is being cropped in one or the other direction. By default, Tux Paint will place the center of the starter within the canvas. (This can be specified explicitly with "<code><b>gravity=center</b></code>".) </p>
|
||||
<p>
|
||||
For example, if the top center of the starter contains the most important content, you can specify "<code><b>gravity=top</b></code>". Or, if the bottom right is important, specify "<code><b>gravity=bottom-right</b></code>". </p>
|
||||
|
||||
<p>
|
||||
The available options are: </p>
|
||||
<ul>
|
||||
<li><code><b>top</b></code> — prefer the top center</li>
|
||||
<li><code><b>bottom</b></code> — prefer the bottom center</li>
|
||||
<li><code><b>left</b></code> — prefer the left center</li>
|
||||
<li><code><b>right</b></code> — prefer the right center</li>
|
||||
<li><code><b>top-left</b></code> — prefer the top left</li>
|
||||
<li><code><b>top-right</b></code> — prefer the top right</li>
|
||||
<li><code><b>bottom-left</b></code> — prefer the bottom left</li>
|
||||
<li><code><b>bottom-right</b></code> — prefer the bottom right</li>
|
||||
</ul>
|
||||
|
||||
<div style="display: inline-block; border: 1px solid #888; width: 320px;">
|
||||
<figure style="text-align: center;">
|
||||
<img src="../../html/images/gravity-center-landscape.png"
|
||||
width="160"
|
||||
height="72"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
<figcaption style="font-size: smaller;">
|
||||
Focusing on the center of a starter image stretched to fit the width of the canvas. </figcaption>
|
||||
</figure>
|
||||
</div>
|
||||
<div style="display: inline-block; border: 1px solid #888; width: 320px;">
|
||||
<figure style="text-align: center;">
|
||||
<img src="../../html/images/gravity-center-portrait.png"
|
||||
width="84"
|
||||
height="160"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
<figcaption style="font-size: smaller;">
|
||||
Focusing on the center of a starter image stretched to fit the height of the canvas. </figcaption>
|
||||
</figure>
|
||||
</div>
|
||||
<div style="display: inline-block; border: 1px solid #888; width: 320px;">
|
||||
<figure style="text-align: center;">
|
||||
<img src="../../html/images/gravity-top-landscape.png"
|
||||
width="160"
|
||||
height="72"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
<figcaption style="font-size: smaller;">
|
||||
Focusing on the top of a starter image stretched to fit the width of the canvas. </figcaption>
|
||||
</figure>
|
||||
</div>
|
||||
<div style="display: inline-block; border: 1px solid #888; width: 320px;">
|
||||
<figure style="text-align: center;">
|
||||
<img src="../../html/images/gravity-bottom-landscape.png"
|
||||
width="160"
|
||||
height="72"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
<figcaption style="font-size: smaller;">
|
||||
Focusing on the bottom of a starter image stretched to fit the width of the canvas. </figcaption>
|
||||
</figure>
|
||||
</div>
|
||||
<div style="display: inline-block; border: 1px solid #888; width: 320px;">
|
||||
<figure style="text-align: center;">
|
||||
<img src="../../html/images/gravity-right-portrait.png"
|
||||
width="84"
|
||||
height="160"
|
||||
alt=""
|
||||
valign="middle" />
|
||||
<figcaption style="font-size: smaller;">
|
||||
Focusing on the right of a starter image stretched to fit the height of the canvas. </figcaption>
|
||||
</figure>
|
||||
</div>
|
||||
</dd><!-- gravity -->
|
||||
</dl>
|
||||
|
||||
<p class="note">
|
||||
<span title="Information">💡</span> <strong>Note:</strong> Templates (described below) may also have options files, and currently support all of the same options as starters. </p>
|
||||
<br clear="all">
|
||||
</section><!-- H2: Starter Options -->
|
||||
|
||||
</section><!-- H1: Starters -->
|
||||
|
||||
<section class="indent outer"><!-- H1: 'Templates' -->
|
||||
|
|
@ -748,6 +922,19 @@
|
|||
<p class="note">
|
||||
<span title="Information">💡</span> <strong>Note:</strong> 'Templates' are 'attached' to saved pictures, via a small text file that has the same name as the saved file, but with "<code>.dat</code>" as the extension. This allows it to continue to affect the drawing even after Tux Paint has been quit, or another picture is loaded or a new image is created. (In other words, if you base a drawing on a 'template' image, it will always be affected by it.) </p>
|
||||
<br clear="all">
|
||||
|
||||
<section><!-- H2: Template Options -->
|
||||
<header>
|
||||
<h2>
|
||||
<a name="template_options"
|
||||
id="template_options">Template Options</a>
|
||||
</h2>
|
||||
</header>
|
||||
|
||||
<p>
|
||||
Like 'starters', a configuration file may be specified that defines how Tux Paint should behave when applying 'template' images to the canvas when they do not have identical proportions (aspect ratio). See "Starter Options", above. (Note: Tux Paint prior to version 0.9.29 did not support template options.) </p>
|
||||
</section><!-- H2: Template Options -->
|
||||
|
||||
</section><!-- H1: 'Templates' -->
|
||||
|
||||
<section class="indent outer"><!-- H1: Translations -->
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue