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

Sync'ing docs & adding images for Starter/Template options files

Browse source
This commit is contained in:
Bill Kendrick 2023-02-12 12:45:28 -08:00
parent 72914158dd
commit 82d5c0c4e7
19 changed files with 1545 additions and 30 deletions
Download patch file Download diff file Expand all files Collapse all files

120
docs/es_ES.UTF-8/EXTENDING.txt
View file

@ -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"