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

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

View file

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