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

Expanded explanation: how stamp tinting modes work

Browse source
This commit is contained in:
Bill Kendrick 2021-09-19 12:40:06 -07:00
parent 65a565d7a7
commit 2f8ec50556
11 changed files with 158 additions and 94 deletions
Download patch file Download diff file Expand all files Collapse all files

3
docs/CHANGES.txt
View file

@ -85,6 +85,9 @@ $Id$
* Moved Windows and macOS compilation instructions into main * Moved Windows and macOS compilation instructions into main
"Installation Documentation" (docs/.../INSTALL...). "Installation Documentation" (docs/.../INSTALL...).
* Expanded explanation of how stamp tinting modes work
in "Extending Tux Paint" documentation.
* Documentation translation updates: * Documentation translation updates:
+ French translation + French translation
Jacques Chion <jacques.chion@orange.fr> Jacques Chion <jacques.chion@orange.fr>

29
docs/en/EXTENDING.txt
View file

@ -5,7 +5,7 @@
Copyright © 2002-2021 by various contributors; see AUTHORS. Copyright © 2002-2021 by various contributors; see AUTHORS.
http://www.tuxpaint.org/ http://www.tuxpaint.org/
September 6, 2021 September 19, 2021
---------------------------------------------------------------------- ----------------------------------------------------------------------
@ -426,15 +426,28 @@ Stamps
one of the following lines to the stamp's data file: one of the following lines to the stamp's data file:
Normal tinter — "tinter=normal" (the default) Normal tinter — "tinter=normal" (the default)
This is the normal tinting mode. (Hue range is ±18°, 27 This is the normal tinting mode. First, the primary hue
replace.) of the stamp is determined. (For example, a picture of a
flower with a stem will have the petal color seen as the
'Any hue' tinter — "tinter=anyhue" primary hue of the overall image.) Next, the most highly
This remaps all hues in the stamp. (Hue range is ±180°.) saturated part of the picture is found. With "normal
tinter", the range of hue used to do this starts out
within ±18° of the pimary hue found in step 1. (If none
can be found, it widens the range by 50% and tries
again.) Finally, the image is tinted. Anything falling
within 50% of the range (e.g., ±27°) is altered to have
the hue of the color chosen by the user.
Narrow tinter — "tinter=narrow" Narrow tinter — "tinter=narrow"
This like the "anyhue" option, but with a narrower hue This like the "normal" option described above, but
angle. (Hue range is ±6°, 9 replace.) starts a narrower hue range of ±6°. Anything found
within 50% of the range (e.g. ±9°) is tinted. If too
much of your stamp is being tinted, try this option.
'Any hue' tinter — "tinter=anyhue"
This remaps all hues in the stamp. It works similarly to
the "anyhue" and "narrow" options described above, but
the hue range is ±180°.)
Vector tinter — "tinter=vector" Vector tinter — "tinter=vector"
This maps 'black through white' to 'black through This maps 'black through white' to 'black through

20
docs/en/html/EXTENDING.html
View file

@ -26,7 +26,7 @@
</p> </p>
<p> <p>
September 6, 2021 </p> September 19, 2021 </p>
</center> </center>
<hr size="2" <hr size="2"
@ -612,21 +612,21 @@
Normal tinter &mdash; "<code><b>tinter=normal</b></code>" (the default) </dt> Normal tinter &mdash; "<code><b>tinter=normal</b></code>" (the default) </dt>
<dd> <dd>
This is the normal tinting mode. (Hue range is ±18°, 27 replace.) </dd> This is the normal tinting mode. First, the primary hue of the stamp is determined. (For example, a picture of a flower with a stem will have the petal color seen as the primary hue of the overall image.) Next, the most highly saturated part of the picture is found. With "normal tinter", the range of hue used to do this starts out within ±18° of the pimary hue found in step 1. (If none can be found, it widens the range by 50% and tries again.) Finally, the image is tinted. Anything falling within 50% of the range (e.g., ±27°) is altered to have the hue of the color chosen by the user. </dd>
<dt>
'Any hue' tinter &mdash; "<code><b>tinter=anyhue</b></code>"
</dt>
<dd>
This remaps all hues in the stamp. (Hue range is ±180°.) </dd>
<dt> <dt>
Narrow tinter &mdash; "<code><b>tinter=narrow</b></code>" Narrow tinter &mdash; "<code><b>tinter=narrow</b></code>"
</dt> </dt>
<dd> <dd>
This like the "<code>anyhue</code>" option, but with a narrower hue angle. (Hue range is ±6°, 9 replace.) </dd> This like the "<code>normal</code>" option described above, but starts a narrower hue range of ±6°. Anything found within 50% of the range (e.g. ±9°) is tinted. If too much of your stamp is being tinted, try this option. </dd>
<dt>
'Any hue' tinter &mdash; "<code><b>tinter=anyhue</b></code>"
</dt>
<dd>
This remaps <em>all</em> hues in the stamp. It works similarly to the "<code>anyhue</code>" and "<code>narrow</code>" options described above, but the hue range is ±180°. </dd>
<dt> <dt>
Vector tinter &mdash; "<code><b>tinter=vector</b></code>" Vector tinter &mdash; "<code><b>tinter=vector</b></code>"

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

@ -5,7 +5,7 @@
Copyright © 2002-2021 by various contributors; see AUTHORS. Copyright © 2002-2021 by various contributors; see AUTHORS.
http://www.tuxpaint.org/ http://www.tuxpaint.org/
septiembre 6, 2021 septiembre 19, 2021
---------------------------------------------------------------------- ----------------------------------------------------------------------
@ -426,15 +426,28 @@ Stamps
one of the following lines to the stamp's data file: one of the following lines to the stamp's data file:
Normal tinter — "tinter=normal" (the default) Normal tinter — "tinter=normal" (the default)
This is the normal tinting mode. (Hue range is ±18°, 27 This is the normal tinting mode. First, the primary hue
replace.) of the stamp is determined. (For example, a picture of a
flower with a stem will have the petal color seen as the
'Any hue' tinter — "tinter=anyhue" primary hue of the overall image.) Next, the most highly
This remaps all hues in the stamp. (Hue range is ±180°.) saturated part of the picture is found. With "normal
tinter", the range of hue used to do this starts out
within ±18° of the pimary hue found in step 1. (If none
can be found, it widens the range by 50% and tries
again.) Finally, the image is tinted. Anything falling
within 50% of the range (e.g., ±27°) is altered to have
the hue of the color chosen by the user.
Narrow tinter — "tinter=narrow" Narrow tinter — "tinter=narrow"
This like the "anyhue" option, but with a narrower hue This like the "normal" option described above, but
angle. (Hue range is ±6°, 9 replace.) starts a narrower hue range of ±6°. Anything found
within 50% of the range (e.g. ±9°) is tinted. If too
much of your stamp is being tinted, try this option.
'Any hue' tinter — "tinter=anyhue"
This remaps all hues in the stamp. It works similarly to
the "anyhue" and "narrow" options described above, but
the hue range is ±180°.)
Vector tinter — "tinter=vector" Vector tinter — "tinter=vector"
This maps 'black through white' to 'black through This maps 'black through white' to 'black through

20
docs/es_ES.UTF-8/html/EXTENDING.html
View file

@ -26,7 +26,7 @@
</p> </p>
<p> <p>
septiembre 6, 2021 </p> septiembre 19, 2021 </p>
</center> </center>
<hr size="2" <hr size="2"
@ -612,21 +612,21 @@
Normal tinter &mdash; "<code><b>tinter=normal</b></code>" (the default) </dt> Normal tinter &mdash; "<code><b>tinter=normal</b></code>" (the default) </dt>
<dd> <dd>
This is the normal tinting mode. (Hue range is ±18°, 27 replace.) </dd> This is the normal tinting mode. First, the primary hue of the stamp is determined. (For example, a picture of a flower with a stem will have the petal color seen as the primary hue of the overall image.) Next, the most highly saturated part of the picture is found. With "normal tinter", the range of hue used to do this starts out within ±18° of the pimary hue found in step 1. (If none can be found, it widens the range by 50% and tries again.) Finally, the image is tinted. Anything falling within 50% of the range (e.g., ±27°) is altered to have the hue of the color chosen by the user. </dd>
<dt>
'Any hue' tinter &mdash; "<code><b>tinter=anyhue</b></code>"
</dt>
<dd>
This remaps all hues in the stamp. (Hue range is ±180°.) </dd>
<dt> <dt>
Narrow tinter &mdash; "<code><b>tinter=narrow</b></code>" Narrow tinter &mdash; "<code><b>tinter=narrow</b></code>"
</dt> </dt>
<dd> <dd>
This like the "<code>anyhue</code>" option, but with a narrower hue angle. (Hue range is ±6°, 9 replace.) </dd> This like the "<code>normal</code>" option described above, but starts a narrower hue range of ±6°. Anything found within 50% of the range (e.g. ±9°) is tinted. If too much of your stamp is being tinted, try this option. </dd>
<dt>
'Any hue' tinter &mdash; "<code><b>tinter=anyhue</b></code>"
</dt>
<dd>
This remaps <em>all</em> hues in the stamp. It works similarly to the "<code>anyhue</code>" and "<code>narrow</code>" options described above, but the hue range is ±180°. </dd>
<dt> <dt>
Vector tinter &mdash; "<code><b>tinter=vector</b></code>" Vector tinter &mdash; "<code><b>tinter=vector</b></code>"

31
docs/fr_FR.UTF-8/EXTENDING.txt
View file

@ -5,7 +5,7 @@
Copyright &copie; 2002-2021 par divers contributeurs; voir AUTHORS. Copyright &copie; 2002-2021 par divers contributeurs; voir AUTHORS.
http://www.tuxpaint.org/ http://www.tuxpaint.org/
septembre 6, 2021 septembre 19, 2021
---------------------------------------------------------------------- ----------------------------------------------------------------------
@ -462,17 +462,28 @@ Tampons
de données du tampon : de données du tampon :
Coloriage normal — "tinter=normal" (par défaut) Coloriage normal — "tinter=normal" (par défaut)
C'est le mode normal pour teinter. (La gamme de teinte This is the normal tinting mode. First, the primary hue
est de +/- 18°) of the stamp is determined. (For example, a picture of a
flower with a stem will have the petal color seen as the
Coloriage 'toutes tonalités' — "tinter=anyhue" primary hue of the overall image.) Next, the most highly
Cela remappe toutes les teintes du tampon. (La plage de saturated part of the picture is found. With "normal
teinte est de ± 180°.) tinter", the range of hue used to do this starts out
within ±18° of the pimary hue found in step 1. (If none
can be found, it widens the range by 50% and tries
again.) Finally, the image is tinted. Anything falling
within 50% of the range (e.g., ±27°) is altered to have
the hue of the color chosen by the user.
Coloriage étroit — "tinter=narrow" Coloriage étroit — "tinter=narrow"
Cela ressemble à "anyhue", mais avec un angle de teinte This like the "normal" option described above, but
plus étroit. (La gamme de teinte est de ± 6 °, 9 starts a narrower hue range of ±6°. Anything found
remplacer.) within 50% of the range (e.g. ±9°) is tinted. If too
much of your stamp is being tinted, try this option.
Coloriage 'toutes tonalités' — "tinter=anyhue"
This remaps all hues in the stamp. It works similarly to
the "anyhue" and "narrow" options described above, but
the hue range is ±180°.)
Coloriage vectoriel — "tinter=vector" Coloriage vectoriel — "tinter=vector"
Cela mappe «noir à blanc» à «noir à destination». Cela mappe «noir à blanc» à «noir à destination».

20
docs/fr_FR.UTF-8/html/EXTENDING.html
View file

@ -26,7 +26,7 @@
</p> </p>
<p> <p>
septembre 6, 2021 </p> septembre 19, 2021 </p>
</center> </center>
<hr size="2" <hr size="2"
@ -612,21 +612,21 @@
Coloriage normal &mdash; "<code><b>tinter=normal</b></code>" (par défaut) </dt> Coloriage normal &mdash; "<code><b>tinter=normal</b></code>" (par défaut) </dt>
<dd> <dd>
C'est le mode normal pour teinter. (La gamme de teinte est de +/- 18°) </dd> This is the normal tinting mode. First, the primary hue of the stamp is determined. (For example, a picture of a flower with a stem will have the petal color seen as the primary hue of the overall image.) Next, the most highly saturated part of the picture is found. With "normal tinter", the range of hue used to do this starts out within ±18° of the pimary hue found in step 1. (If none can be found, it widens the range by 50% and tries again.) Finally, the image is tinted. Anything falling within 50% of the range (e.g., ±27°) is altered to have the hue of the color chosen by the user. </dd>
<dt>
Coloriage 'toutes tonalités' &mdash; "<code><b>tinter=anyhue</b></code>"
</dt>
<dd>
Cela remappe toutes les teintes du tampon. (La plage de teinte est de ± 180°.) </dd>
<dt> <dt>
Coloriage étroit &mdash; "<code><b>tinter=narrow</b></code>" Coloriage étroit &mdash; "<code><b>tinter=narrow</b></code>"
</dt> </dt>
<dd> <dd>
Cela ressemble à "<code>anyhue</code>", mais avec un angle de teinte plus étroit. (La gamme de teinte est de ± 6 °, 9 remplacer.) </dd> This like the "<code>normal</code>" option described above, but starts a narrower hue range of ±6°. Anything found within 50% of the range (e.g. ±9°) is tinted. If too much of your stamp is being tinted, try this option. </dd>
<dt>
Coloriage 'toutes tonalités' &mdash; "<code><b>tinter=anyhue</b></code>"
</dt>
<dd>
This remaps <em>all</em> hues in the stamp. It works similarly to the "<code>anyhue</code>" and "<code>narrow</code>" options described above, but the hue range is ±180°. </dd>
<dt> <dt>
Coloriage vectoriel &mdash; "<code><b>tinter=vector</b></code>" Coloriage vectoriel &mdash; "<code><b>tinter=vector</b></code>"

31
docs/gl_ES.UTF-8/EXTENDING.txt
View file

@ -5,7 +5,7 @@
Copyright © 2002-2021 por varios colaboradores; vexa AUTHORS (AUTORES). Copyright © 2002-2021 por varios colaboradores; vexa AUTHORS (AUTORES).
http://www.tuxpaint.org/ http://www.tuxpaint.org/
6 de Setembro de 2021 19 de Setembro de 2021
---------------------------------------------------------------------- ----------------------------------------------------------------------
@ -441,17 +441,28 @@ Selos
seguintes liñas ao ficheiro de datos do selo: seguintes liñas ao ficheiro de datos do selo:
Tinguido normal — "tinter=normal" (o predeterminado) Tinguido normal — "tinter=normal" (o predeterminado)
Este é o modo normal de tinguido. (O rango de tonalidade This is the normal tinting mode. First, the primary hue
é de ± 18 °, 27 como substituto). of the stamp is determined. (For example, a picture of a
flower with a stem will have the petal color seen as the
Tinguir de «calquera tonalidade» — "tinter=anyhue" primary hue of the overall image.) Next, the most highly
Isto volve asignar todas as tonalidades do selo. (O saturated part of the picture is found. With "normal
rango de tonalidades é de ± 180°). tinter", the range of hue used to do this starts out
within ±18° of the pimary hue found in step 1. (If none
can be found, it widens the range by 50% and tries
again.) Finally, the image is tinted. Anything falling
within 50% of the range (e.g., ±27°) is altered to have
the hue of the color chosen by the user.
Tinguido estreito — "tinter=narrow" Tinguido estreito — "tinter=narrow"
Isto é como a opción «anyhue», pero cun ángulo de This like the "normal" option described above, but
tonalidade máis reducido. (O intervalo de tonalidade é starts a narrower hue range of ±6°. Anything found
de ± 6 °, 9 como substituto). within 50% of the range (e.g. ±9°) is tinted. If too
much of your stamp is being tinted, try this option.
Tinguir de «calquera tonalidade» — "tinter=anyhue"
This remaps all hues in the stamp. It works similarly to
the "anyhue" and "narrow" options described above, but
the hue range is ±180°.)
Tinguido vectorial — "tinter=vector" Tinguido vectorial — "tinter=vector"
Isto asigna de «negro a través branco» a «negro a través Isto asigna de «negro a través branco» a «negro a través

20
docs/gl_ES.UTF-8/html/EXTENDING.html
View file

@ -26,7 +26,7 @@
</p> </p>
<p> <p>
6 de Setembro de 2021 </p> 19 de Setembro de 2021 </p>
</center> </center>
<hr size="2" <hr size="2"
@ -612,21 +612,21 @@
Tinguido normal &mdash; "<code><b>tinter=normal</b></code>" (o predeterminado) </dt> Tinguido normal &mdash; "<code><b>tinter=normal</b></code>" (o predeterminado) </dt>
<dd> <dd>
Este é o modo normal de tinguido. (O rango de tonalidade é de ± 18 °, 27 como substituto). </dd> This is the normal tinting mode. First, the primary hue of the stamp is determined. (For example, a picture of a flower with a stem will have the petal color seen as the primary hue of the overall image.) Next, the most highly saturated part of the picture is found. With "normal tinter", the range of hue used to do this starts out within ±18° of the pimary hue found in step 1. (If none can be found, it widens the range by 50% and tries again.) Finally, the image is tinted. Anything falling within 50% of the range (e.g., ±27°) is altered to have the hue of the color chosen by the user. </dd>
<dt>
Tinguir de «calquera tonalidade» &mdash; "<code><b>tinter=anyhue</b></code>"
</dt>
<dd>
Isto volve asignar todas as tonalidades do selo. (O rango de tonalidades é de ± 180°). </dd>
<dt> <dt>
Tinguido estreito &mdash; "<code><b>tinter=narrow</b></code>" Tinguido estreito &mdash; "<code><b>tinter=narrow</b></code>"
</dt> </dt>
<dd> <dd>
Isto é como a opción «<code>anyhue</code>», pero cun ángulo de tonalidade máis reducido. (O intervalo de tonalidade é de ± 6 °, 9 como substituto). </dd> This like the "<code>normal</code>" option described above, but starts a narrower hue range of ±6°. Anything found within 50% of the range (e.g. ±9°) is tinted. If too much of your stamp is being tinted, try this option. </dd>
<dt>
Tinguir de «calquera tonalidade» &mdash; "<code><b>tinter=anyhue</b></code>"
</dt>
<dd>
This remaps <em>all</em> hues in the stamp. It works similarly to the "<code>anyhue</code>" and "<code>narrow</code>" options described above, but the hue range is ±180°. </dd>
<dt> <dt>
Tinguido vectorial &mdash; "<code><b>tinter=vector</b></code>" Tinguido vectorial &mdash; "<code><b>tinter=vector</b></code>"

29
docs/ja_JP.UTF-8/EXTENDING.txt
View file

@ -5,7 +5,7 @@
Copyright © 2002-2021 by various contributors; "AUTHORS" 参照. Copyright © 2002-2021 by various contributors; "AUTHORS" 参照.
http://www.tuxpaint.org/ http://www.tuxpaint.org/
2021年9月 6日 2021年9月19日
---------------------------------------------------------------------- ----------------------------------------------------------------------
@ -426,15 +426,28 @@ Stamps
one of the following lines to the stamp's data file: one of the following lines to the stamp's data file:
Normal tinter — "tinter=normal" (the default) Normal tinter — "tinter=normal" (the default)
This is the normal tinting mode. (Hue range is ±18°, 27 This is the normal tinting mode. First, the primary hue
replace.) of the stamp is determined. (For example, a picture of a
flower with a stem will have the petal color seen as the
'Any hue' tinter — "tinter=anyhue" primary hue of the overall image.) Next, the most highly
This remaps all hues in the stamp. (Hue range is ±180°.) saturated part of the picture is found. With "normal
tinter", the range of hue used to do this starts out
within ±18° of the pimary hue found in step 1. (If none
can be found, it widens the range by 50% and tries
again.) Finally, the image is tinted. Anything falling
within 50% of the range (e.g., ±27°) is altered to have
the hue of the color chosen by the user.
Narrow tinter — "tinter=narrow" Narrow tinter — "tinter=narrow"
This like the "anyhue" option, but with a narrower hue This like the "normal" option described above, but
angle. (Hue range is ±6°, 9 replace.) starts a narrower hue range of ±6°. Anything found
within 50% of the range (e.g. ±9°) is tinted. If too
much of your stamp is being tinted, try this option.
'Any hue' tinter — "tinter=anyhue"
This remaps all hues in the stamp. It works similarly to
the "anyhue" and "narrow" options described above, but
the hue range is ±180°.)
Vector tinter — "tinter=vector" Vector tinter — "tinter=vector"
This maps 'black through white' to 'black through This maps 'black through white' to 'black through

20
docs/ja_JP.UTF-8/html/EXTENDING.html
View file

@ -26,7 +26,7 @@
</p> </p>
<p> <p>
2021年9月 6日 </p> 2021年9月19日 </p>
</center> </center>
<hr size="2" <hr size="2"
@ -612,21 +612,21 @@
Normal tinter &mdash; "<code><b>tinter=normal</b></code>" (the default) </dt> Normal tinter &mdash; "<code><b>tinter=normal</b></code>" (the default) </dt>
<dd> <dd>
This is the normal tinting mode. (Hue range is ±18°, 27 replace.) </dd> This is the normal tinting mode. First, the primary hue of the stamp is determined. (For example, a picture of a flower with a stem will have the petal color seen as the primary hue of the overall image.) Next, the most highly saturated part of the picture is found. With "normal tinter", the range of hue used to do this starts out within ±18° of the pimary hue found in step 1. (If none can be found, it widens the range by 50% and tries again.) Finally, the image is tinted. Anything falling within 50% of the range (e.g., ±27°) is altered to have the hue of the color chosen by the user. </dd>
<dt>
'Any hue' tinter &mdash; "<code><b>tinter=anyhue</b></code>"
</dt>
<dd>
This remaps all hues in the stamp. (Hue range is ±180°.) </dd>
<dt> <dt>
Narrow tinter &mdash; "<code><b>tinter=narrow</b></code>" Narrow tinter &mdash; "<code><b>tinter=narrow</b></code>"
</dt> </dt>
<dd> <dd>
This like the "<code>anyhue</code>" option, but with a narrower hue angle. (Hue range is ±6°, 9 replace.) </dd> This like the "<code>normal</code>" option described above, but starts a narrower hue range of ±6°. Anything found within 50% of the range (e.g. ±9°) is tinted. If too much of your stamp is being tinted, try this option. </dd>
<dt>
'Any hue' tinter &mdash; "<code><b>tinter=anyhue</b></code>"
</dt>
<dd>
This remaps <em>all</em> hues in the stamp. It works similarly to the "<code>anyhue</code>" and "<code>narrow</code>" options described above, but the hue range is ±180°. </dd>
<dt> <dt>
Vector tinter &mdash; "<code><b>tinter=vector</b></code>" Vector tinter &mdash; "<code><b>tinter=vector</b></code>"