Extensions pour Tux Paint

# Extension
version 0.9.31

Copyright © 2002-2023 by divers contributeurs; see AUTHORS.txt.
https://tuxpaint.org/

mai 29, 2023

Table des matières
Où vont les fichiers Fichiers standards Fichiers personnels Pinceaux Options de pinceau Tampons Images des tampons Texte de description des tampons Effets sonores des tampons Son descriptif du tampon Options des tampons Mise en miroir et retournement Polices '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 Magic Tools

Si vous souhaitez ajouter ou modifier des éléments tels que des pinceaux, des images de démarrage, des tampons en caoutchouc et d'autres contenus utilisés par Tux Paint , vous pouvez le faire assez facilement en ajoutant, modifiant ou supprimant simplement des fichiers là où Tux Paint les recherche.

💡 Note: You'll need to re-launch Tux Paint for the changes to take effect.

# Où vont les fichiers

## Fichiers standards

Tux Paint recherche ses différents fichiers de données dans son répertoire '`data`'.

Linux et Unix

  L'emplacement de ce répertoire dépend de la valeur définie pour "`DATA_PREFIX`" lors de la construction de Tux Paint . Voir INSTALL. pour plus de détails.

  Par défaut, ce répertoire est :

  > `/usr/local/share/tuxpaint/`

  Si vous l'avez installé à partir d'un paquetage, c'est plutôt :

  > `/usr/share/tuxpaint/`

Windows

  Tux Paint recherche un répertoire appelé 'data' dans le même répertoire que l'exécutable. C'est le répertoire que l'installateur a utilisé lors de l'installation de Tux Paint, par exemple :

  > `C:\Program Files\TuxPaint\data`

macOS

  Tux Paint stocke ses fichiers de données dans l'icône de l'application "Tux Paint" (qui est en fait un type spécial de dossier sur macOS & Mac OS X avant lui). Les étapes suivantes expliquent comment accéder aux dossiers qu'il contient :

  1. Affichez un menu «contextuel» en maintenant la touche `[Control]` enfoncée et en cliquant sur l' icône Tux Paint dans le Finder . (Si vous avez une souris avec plus d'un bouton, vous pouvez simplement cliquer avec le bouton droit de la souris sur l'icône.)
  2. Sélectionnez "Afficher le contenu" dans le menu qui apparaît. Une nouvelle fenêtre du Finder apparaîtra avec un dossier à l'intérieur appelé " Contents".
  3. Ouvrez le dossier "Contents " et ouvrez le dossier "Resources" qui se trouve à l'intérieur.
  4. Vous y trouverez divers sous-dossiers, tels que " starters", "stamps", " brushes", etc. Ajouter du nouveau contenu à ces dossiers rendra celui-ci disponible pour tout utilisateur qui lance cette copie (icône) de Tux Paint .

  💡 Remarque : Si vous installez une version plus récente de Tux Paint et remplacez ou supprimez l'ancienne version, vous perdrez les modifications apportées avec les instructions ci-dessus, faites donc des sauvegardes de votre nouveau contenu (tampons,pinceaux, etc.).

  Tux Paint recherche également les fichiers dans un dossier "Tux Paint" que vous pouvez placer dans votre dossier système "Application Support" (situé sous "Library" à la racine de votre système de fichiers) :

  > `/Library/Application Support/TuxPaint/`

  Lorsque vous passez à une version plus récente de Tux Paint , le contenu de ce dossier "TuxPaint" restera à la même place et restera accessible à tous les utilisateurs de Tux Paint .

## Fichiers personnels

Vous pouvez également créer des pinceaux, des images de démarrage, des modèles et des polices dans votre propre répertoire où Tux Paint les retrouvera.

Windows

  Votre dossier personnel Tux Paint est stocké dans votre dossier "Application Data". Par exemple, sur un Windows plus récent :

  > `C:\Documents and Settings\(nom d'utilisateur)\Application Data\TuxPaint\`

macOS

  Votre dossier personnel Tux Paint est stocké dans votre dossier «Application Support» :

  > `/Users/(nom d'utilisateur)/Library/Application Support/TuxPaint/`

Linux et Unix

  Vos fichiers personnels Tux Paint vont dans un 'répertoire caché' que l'on trouve dans votre répertoire personnel "`$(HOME)/.tuxpaint/`" (également appelé "`~/.tuxpaint/`".

  Autrement dit, si votre répertoire personnel est "`/home/tux`", alors votre répertoire Tux Paint est "`/home/tux/.tuxpaint/`".

  N'oubliez pas le point (" `.`") avant le "`tuxpaint`" !

Pour ajouter des pinceaux, des tampons, des 'images de démarrage',des modèles et des polices créez des sous-répertoires dans votre répertoire personnel Tux Paint nommés respectivement "`brushes`", "`stamps`", "`starters`", "`templates`", "`fonts`".

(Par exemple, si vous avez créé un pinceau nommé "`flower.png`", vous le mettrez dans "`~/.tuxpaint/brushes/`" sous Linux ou Unix.)

# Pinceaux

Les pinceaux utilisés pour dessiner avec les outils "Pinceau" et "Lignes" dans Tux Paint sont tout simplement des fichiers image PNG.

L'alpha (transparence) de l'image PNG est utilisée pour déterminer la forme du pinceau, ce qui signifie que la forme peut être «anti-crénelée» et même partiellement transparente !

Les pixels en niveaux de gris dans le pinceau PNG seront dessinés en utilisant la couleur actuellement sélectionnée dans Tux Paint . Les pixels de couleur seront teintés.

## Options de pinceau

Outre une une forme graphique, les pinceaux peuvent également recevoir d'autres attributs. Pour ce faire, vous devez créer un «fichier de données» pour brosse.

Un fichier de données de brush's est simplement un fichier texte ASCII contenant les options pour le brush.

Le fichier porte le même nom que l'image PNG , mais une extension "`.dat`". (par exemple, le fichier de données "`brush.png`" est le fichier texte "`brush.dat`" qui se trouve dans le même répertoire.)

Espacement des pinceaux

  Depuis la version 0.9.16 de Tux Paint , vous pouvez désormais spécifier l'espacement des pinceaux (c'est-à-dire la fréquence à laquelle ils sont dessinés). Par défaut, l'espacement correspond à la hauteur du pinceau, divisée par 4.

  Ajoutez une ligne contenant la ligne "`spacing=N`" au fichier de données du pinceau, où "N" est l'espacement souhaité pour le pinceau. (Plus le nombre est bas, plus le pinceau est dessiné souvent.)

Pinceaux animés

  Depuis la version 0.9.16 de Tux Paint , vous pouvez désormais créer des pinceaux animés. Au fur et à mesure que le pinceau est utilisé, chaque image de l'animation est dessinée.

  Disposez chaque trame sur une grande image PNG. Par exemple, si votre pinceau mesure 30x30 et que vous avez 5 trames, l'image doit être 150x30.

  Ajoutez une ligne contenant la ligne "`frames=N`" au fichier de données du pinceau, où"N" est le nombre d'images dans le pinceau.

  ⚙ Note: If you'd rather the frames be flipped through randomly, rather than sequentially, also add a line containing "`random`" to the brush's data file.

Pinceaux directionnels

  Depuis la version 0.9.16 de Tux Paint , vous pouvez désormais créer des pinceaux orientables. Au fur et à mesure que le pinceau est utilisé, différentes formes sont dessinées, en fonction de la direction du pinceau.

  Les formes orientables sont divisées en carrés de 3x3 dans une image PNG. Par exemple, si votre pinceau fait 30x30, l'image doit être de 90x90 et chacune des formes orientables est placée dans une grille de 3x3. La région centrale n'est pas orientable. Le haut à droite est utilisé pour le mouvement vers le haut, et vers la droite. Etc ...

  Ajoute une ligne contenant le mot "`directional`" au fichier de données brosse.

Pinceaux tournants

  Depuis la version 0.9.27 de Tux Paint , vous pouvez désormais créer des pinceaux tournants. Au fur et à mesure que le pinceau est utilisé, il tourne de 360 degrés, en fonction de la direction du pinceau.

  Ajoute une ligne contenant le mot "`rotate`" au fichier de données brosse.

Pinceaux animés orientables ou tournants

  Vous pouvez mélanger animation et orientation (ou rotation) dans un même pinceau. Utilisez les deux options ("`frames=N`" et "`directional`" ou "`rotate`) en deux lignes séparées dans le fichier "`.dat`" qui concerne le pinceau.

  Pour les pinceaux directionnels, disposez le pinceau de manière à ce que chaque ensemble 3x3 de formes orientables soit disposé sur une grande image PNG. Par exemple, si le pinceau mesure 30x30 et qu'il y a 5 cadres, ce sera 450x90. (Les 150x90 pixels les plus à gauche de l'image représentent les 9 formes de direction pour la première image, par exemple).

Placez les PNG de l'image du pinceau (et tous les fichiers texte de données) dans le répertoire "`brushes`".

💡 Note: If your new pinceaux all come out as solid squares or rectangles, it's because you forgot to use alpha transparency! See the 'PNG documentation' in Tux Paint for more information and tips.

# Tampons

Tous les fichiers liés aux tampons vont dans le répertoire "`stamps`". Il est utile de créer des sous-sous-répertoires pour organiser les tampons. (Par exemple, vous pouvez avoir un dossier "`holidays`" avec "`halloween`" et "`christmas`" comme sous-dossiers.)

## Images des tampons

Les tampons en caoutchouc dans Tux Paint peuvent être constitués d'un certain nombre de fichiers séparés. Le seul fichier requis est, bien entendu, l'image elle-même.

Depuis la version 0.9.17 de Tux Paint , les tampons peuvent être des images bitmap PNG ou bien des images vectorielles SVG. Ils peuvent être en couleur ou en niveaux de gris. Le canal alpha (transparence) des PNG est utilisé pour déterminer la forme réelle de l'image (sinon vous obtiendriez un grand rectangle sur vos dessins).

Les fichiers PNG peuvent être de n'importe quelle taille, et Tux Paint (par défaut) fournit un ensemble de boutons de redimensionnement pour permettre à l'utilisateur d'ajuster le tampon vers le haut (plus grand) et vers le bas (plus petits).

Les SVG sont basés sur des vecteurs et seront mis à l'échelle de manière adéquate pour le canevas utilisé.

💡 Note: If your new des tampons basés sur PNG all come out as solid squares or rectangles, it's because you forgot to use alpha transparency! See the 'PNG documentation' in Tux Paint for more information and tips.

💡 Note: If your new SVG stamps seem to have a lot of whitespace, make sure the SVG 'document' is no larger than the shape(s) within. If they are being clipped, make sure the 'document' is large enough to contain the shape(s). See the 'SVG documentation' in Tux Paint for more information and tips.

⚙ Utilisateurs avancés : Le HOWTO Advanced Stamps décrit, en détail, comment créer des images PNG qui seront parfaitement mises à l'échelle lorsqu'elles seront utilisées comme tampons dans Tux Paint .

## Texte de description des tampons

Tux Paint affichera un texte descriptif quand un tampon est sélectionné. Le texte est mis dans fichier (avec texte simple) ayant le même nom que le PNG ou SVG, mais avec une extension "`.txt`". (par exemple, "`stamp.png`" dont la description est "`stamp.txt`" est placée dans le même répertoire).

La première ligne du fichier texte sera utilisée comme description de l'image du tampon, en anglais américain. Il doit être encodé en UTF-8.

Support pour la régionalisation

  Des lignes supplémentaires peuvent être ajoutées au fichier texte pour fournir des traductions de la description, à afficher lorsque Tux Paint s'exécute dans une langue différente (comme le français ou l'espagnol).

  Le début de la ligne doit correspondre au code de langue de la langue en question (par exemple, "`fr`" pour le français et "`zh_TW`" pour le chinois traditionnel), suivi de "`.utf8=`" et de la description traduite (codée en UTF-8).

  Pour les développeurs de Tux Paint : Il y a des scripts dans le répertoire "`po`" pour convertir les fichiers texte au format PO (et inversement) pour une traduction facile vers différentes langues. Par conséquent, vous ne devez jamais ajouter ni modifier directement les traductions dans les fichiers "`.txt`".

  Si aucune traduction n'est disponible pour la langue dans laquelle Tux Paint est en cours d'exécution, le texte anglais américain sera utilisé.

Utilisateurs de Windows

  Utilisez NotePad ou WordPad pour modifier / créer ces fichiers. Assurez-vous de les enregistrer en texte brut et assurez-vous qu'ils ont une extension "`.txt`" à la fin du nom de fichier.

## Effets sonores des tampons

Tux Paint peut jouer un effet sonore quand un tampon est choisi. Par exemple, le son d'un canard faisant coin-coin, ou un bref morceau de musique quand un instrument est choisi. Les fichiers doivent être aux formats "WAVE ("`.wav`")" ou OGG Vorbis ("`.ogg`"), et porter le même nom que l'image PNG ou SVG.( par ex., l'effet sonore "`stamp.ogg`" est le son du fichier "`stamp.svg`" qui est dans le même répertoire).

Support pour la régionalisation

  Pour les sons de différentes locales (par exemple, si le son est quelqu'un qui dit un mot, et que vous voulez des versions traduites du mot prononcé), créez également des fichiers WAV ou OGG avec l'étiquette de la locale dans le nom de fichier, sous la forme : "`stamp_LOCALE.EXT`"

  L'effet sonore qui sera joué lorsque le tampon correspondant au fichier image "`stamp.png`" est choisi, et que Tux Paint utilise la langue espagnole, sera "`stamp_es.wav`". Avec la langue française, ce sera "`stamp_fr.wav`". Avec le portugais brésilien, "`stamp_pt_BR.wav`", etc ...

  Si aucun effet sonore localisé ne peut être chargé, Tux Paint tentera de charger le fichier son «par défaut». (par exemple, "`stamp.wav`")

💡 Note: Also consider using descriptive sounds; see 'Son descriptif du tampon', below.

## Son descriptif du tampon

Tux Paint peut également jouer un son descriptif quand on choisit un tampon. Par ex., une personne disant le mot "canard" quand on choisit un canard, ou le nom d'un instrument de musique quand on en choisit un. Les fichiers peuvent être au format "WAVE ("`.wav`")" ou "OGG Vorbis ("`.ogg`")", et on le même nom que l'image PNG ou SVG, avec "`_desc`" à la fin (par ex., le son descritid de "`stamp.svg`" est le fichier son "`stamp_desc.ogg`" dans le même répertoire).

Support pour la régionalisation

  Pour les descriptions dans différentes langues, créez également des fichiers WAV ou OGG avec à la fois "`_desc`" et le libellé des paramètres régionaux dans le nom de fichier, sous la forme : "`stamp_desc_LOCALE.EXT`"

  L'son descriptif qui sera joué lorsque le tampon correspondant au fichier image "`stamp.png`" est choisi, et que Tux Paint utilise la langue espagnole, sera "`stamp_desc_es.wav`". Avec la langue française, ce sera "`stamp_desc_fr.wav`". Avec le portugais brésilien, "`stamp_desc_pt_BR.wav`", etc ...

  Si aucun son descriptif localisé ne peut être chargé, Tux Paint tentera de charger le fichier son «par défaut». (par exemple, "`stamp_desc.wav`")

## Options des tampons

Outre une une forme graphique, un texte de description, un effet sonore et une description orale, les tampons peuvent également recevoir d'autres attributs. Pour ce faire, vous devez créer un «fichier de données» pour tampon.

Un fichier de données de tampon est simplement un fichier texte ASCII contenant les options pour le tampon.

Le fichier porte le même nom que l'image PNG ou SVG , mais une extension "`.dat`". (par exemple, le fichier de données "`stamp.png`" est le fichier texte "`stamp.dat`" qui se trouve dans le même répertoire.)

Tampons colorés

  Les tampons peuvent être soit "colorables" soit '"teintables"

  Colorable

    Les tampons "colorables" fonctionnent comme des pinceaux - vous choisissez le tampon pour obtenir la forme, puis choisissez la couleur que vous voulez. (Les tampons de symboles, comme les tampons mathématiques et musicaux, en sont un exemple.)

    Rien sur l'image d'origine n'est utilisé à l'exception de la transparence (du canal "alpha"). La couleur du tampon ressort unie.

    Ajoute une ligne contenant le mot "`colorable`" au fichier de données tampon.

  Teinté

    Les tampons «teintés» sont similaires aux tampons «colorables», sauf que les détails de l'image originale sont conservés. (Pour le dire techniquement, l'image d'origine est utilisée, mais sa teinte est modifiée en fonction de la couleur actuellement sélectionnée.)

    Ajoute une ligne contenant le mot "`tintable`" au fichier de données tampon.

  Options de teinture :

    En fonction du contenu de votre tampon, vous souhaiterez peut-être que Tux Paint utilise l'une des nombreuses méthodes pour le teinter. Ajoutez l'une des lignes suivantes au fichier de données du tampon :

    Coloriage normal — "`tinter=normal`" (par défaut)
      C'est le mode normal de teinture. Tout d'abord, la teinte primaire du tampon est déterminée. (Par exemple, l'image d'une fleur avec sa tige aura la couleur des pétales considérée comme teinte primaire de l'ensemble de l'image). Puis on trouve la partie de l'image la plus saturée. Avec "le mode de teinture normal", l'étendue de la teinte utilisée pour faire cela démarre dans un angle de ±18° de la teinte primaire trouvée dans l'étape 1. (Si aucune n'est trouvée, ce sera dans une étendue de 50 %, puis on réessaie). Tout ce qui est à l'intérieur de l'étendue de 50 % (par ex. ±27°) est modifié pour avoir la teinte de la couleur choisie par l'utilisateur.
    Coloriage étroit — "`tinter=narrow`"
      C'est comme l'option "`normal`" décrite plus haut, mais avec une étendue de teinte plus faible de ±6°. Tout ce qui est trouvé dans l'étendue (par ex. ±9°) est teinté. Si une trop grande partie de vitre image est teintée, essayez cette option.
    Coloriage 'toutes tonalités' — "`tinter=anyhue`"
      Cela rempappe toutes les teintes du tampon. C'est pareil que les options "`anyhue`" et "`narrow`" décrites auparavant, mais l'étendu de teinte est ±180°.
    Coloriage vectoriel — "`tinter=vector`"
      Cela mappe «noir à blanc» à «noir à destination».
Tampons inaltérables

  Par défaut, un tampon peut être retourné, affiché comme une image miroir, ou les deux. Cela se fait à l'aide des boutons de commande sous le sélecteur de tampon, en bas à droite de l'écran dans Tux Paint .

  Parfois, cela n'a pas de sens pour un timbre d'être retourné ou reflété; par exemple, des timbres de lettres ou de chiffres. Parfois, les tampons sont symétriques, il n'est donc pas utile de laisser l'utilisateur les retourner ou les refléter.

  Pour empêcher un tampon d'être qui a été inversé verticalement, ajoutez une ligne contenant le mot «`noflip`» au fichier de données du tampon.

  Pour empêcher un tampon d'être qui a été inversé horizontalement, ajoutez une ligne contenant le mot «`nomirror`» au fichier de données du tampon.

Taille initiale du tampon

  Par défaut, Tux Paint suppose que votre tampon est dimensionné de manière appropriée pour un affichage non mis à l'échelle sur une toile de 608x472. Il s'agit de la taille originale de la toile pour Tux Paint , pour un écran 640x480. Tux Paint ajustera ensuite le tampon en fonction de la taille réelle du canevas et, si c'est activé, des contrôles de taille du tampon définis par l'utilisateur.

  Si votre tampon est trop grand ou trop petit, vous pouvez spécifier un facteur d'échelle. Si votre tampon est 2,5 fois plus large (ou haut) qu'il devrait l'être, ajoutez une des options, représentant toutes le même réglage, à votre fichier de données du tampon.(Un signe égal,"`=`", peut être ajouté après le mot "`scale`".)

  - "`scale 40%`"
  - "`scale 5/2`"
  - "`scale 2.5`"
  - "`scale 2:5`"
Utilisateurs de Windows

  Utilisez NotePad ou WordPad pour modifier / créer ces fichiers. Assurez-vous de les enregistrer en texte brut et assurez-vous qu'ils ont une extension "`.txt`" à la fin du nom de fichier.

## Mise en miroir et retournement

Dans certains cas, vous souhaiterez peut-être fournir une version pré-dessinée de l'image miroir, de l'image inversée ou même des deux d'un tampon. Par exemple, imaginez une photo d'un camion de pompiers avec les mots Service d'incendie écrits sur le côté. Vous ne voulez probablement pas que ce texte apparaisse à l'envers lorsque l'image est retournée !

Pour créer une version miroir d'un tampon que vous voulez que Tux Paint utilise, plutôt que d'en faire un miroir seul, créez simplement un deuxième fichier graphique "`.png`" ou "`.svg`" avec le même nom, sauf avec "`_mirror`" avant l'extension du nom de fichier.

Par exemple, pour le tampon "`stamp.png`", vous créeriez un autre fichier nommé "`stamp_mirror.png`", qui sera utilisé lorsque le tampon est mis en miroir (plutôt que d'utiliser une version à l'envers de "`stamp.png`").

Depuis Tux Paint 0.9.18, vous pouvez également fournir une image pré-retournée avec "`_flip`" dans le nom, et / ou une image qui est à la fois en miroir et retournée, en la nommant " `_mirror_flip`".

💡 Note: If the user flips and mirrors an image, and a pre-drawn "`_mirror_flip`" doesn't exist, but either "`_flip`" or "`_mirror`" does, it will be used, and mirrored or flipped, respectively.

# Polices

Les fontes utilisées par Tux Paint sont des fontes True Type Fonts (TTF).

Placez-les simplement dans répertoire "`fonts`". Tux Paint chargera la police et fournira quatre tailles différentes dans le sélecteur «Lettres» lors de l'utilisation des outils "Texte" ou "Étiquette".

# 'Images de démarrage'

Les images «de démarrage» apparaissent dans la boîte de dialogue «Nouveau», avec des choix d'arrière-plan de couleur unie.

Quand vous utilisez une 'image de démarrage', faites des modifications, puis la sauvegardez, l'image d'origine n'est pas écrasée. De plus, quand vous éditez votre nouvelle image, les contenus de 'l'image de démarrage' initiale peuvent l'affecter.

## Images de démarrage avec style 'livre de coloriage'

Le type le plus élémentaire "d'image de démarrage" est similaire à une image dans un livre de coloriage. C'est le contour d'une forme que vous pouvez ensuite colorier et ajouter des détails. Dans Tux Paint , lorsque vous dessinez, tapez du texte ou des tampons, le contour reste «au-dessus» de ce que vous dessinez. Vous pouvez effacer des parties du dessin que vous avez faites, mais vous ne pouvez pas effacer le contour.

Pour créer ce type "d'image de départ", dessinez simplement une image noir et blanc avec contour dans un programme de dessin, et sauvegardez la en tant fichier PNG ou SVG. Si vous sauvegardez en PNG, vous pouvez optionellement rendre l'image noire et transparente, plutôt que noire et blanche, mais ceci (depuis Tux Paint 0.9.21) n'est pas requis.

## Images de démarrage avec 'style scénique'

En plus de la superposition de style `` livre de coloriage '', vous pouvez également fournir une image d'arrière-plan séparée dans le cadre d'une "image de démarrage''. La superposition agit de la même manière : elle ne peut pas être dessinée, effacée ou affectée par les outils «Magie». Cependant, l'arrière-plan peut l'être !

Lorsque l'outil «Gomme» est utilisé sur une image basée sur ce type d'image de démarrage, plutôt que de transformer la toile en une couleur unie, telle que le blanc, il renvoie cette partie de la toile à l'image d'arrière-plan d'origine à partir de image de démarrage.

En créant à la fois une superposition et un arrière-plan, vous pouvez créer une «image de démarrage» qui simule la profondeur. Imaginez un arrière-plan qui montre l'océan et une superposition qui est l'image d'un récif. Vous pouvez ensuite dessiner (ou tamponner) des poissons sur l'image. Ils apparaîtront dans l'océan, mais jamais «devant» le récif.

Pour créer ce type d'image de départ, créez simplement une superposition (avec transparence) comme décrit ci-dessus et enregistrez-la au format PNG. Créez ensuite une autre image (sans transparence) et enregistrez-la avec le même nom de fichier, mais avec "`-back`" ajouté au nom. (par exemple, "`starter-back.png`" serait l'image d'arrière-plan de l'océan qui correspond à la superposition ou au premier plan.)

Pour de meilleurs résultats, les images de démarrage doivent être de la même taille que la toile de Tux Paint . (Voir la section "Chargement d'autres images dans Tux Paint " du README pour plus de détails sur le dimensionnement.) Si ce n'est pas le cas, elles seront étirées, sans affecter la forme ("rapport hauteur / largeur"); cependant, des bavures peuvent être apparaître sur les bords.

Placez-les dans le répertoire "`starters`". Lorsque la boîte de dialogue «Nouveau» est accessible dans Tux Paint , les images de démarrage apparaîtront avec l'écran qui apparaît, suivant les différents choix de couleurs unies.

💡 Note: '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 "`.dat`" 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.)

## 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 compares 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`").

  See the "Color Palette File" section of "Options documentation" for further details.

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:

  - `center` — prefer the center (the default)
  - `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 «Nouveau», avec les choix d'arrière-plan de couleur unie et les «Images de démarrage». (Remarque: Tux Paint avant la version 0.9.22 ne disposait pas de la fonctionnalité 'Template'.)

À la différence des images dessinées dans Tux Paint par les utilisateurs puis réouvertes plus tard, l'ouverture d'un «modèle» crée un nouveau dessin. Lorsque vous enregistrez, l'image «modèle» n'est pas écrasée. À la différence des «images de démarrage», il n'y a pas de «calque» immuable au-dessus du canevas. Vous pouvez dessiner sur n'importe quelle partie de celui-ci.

Lorsque l'outil «Gomme» est utilisé sur une image basée sur ce type d'image 'modèle', plutôt que de transformer la toile en une couleur unie, telle que le blanc, il renvoie cette partie de la toile à l'image d'arrière-plan d'origine à partir de image 'modèle'.

Les «modèles» sont simplement des fichiers image (au format PNG, JPG, SVG ou KPX (KidPix)). Aucune préparation ou conversion n'est requise.

Pour de meilleurs résultats, les images 'modèle' doivent être de la même taille que la toile de Tux Paint . (Voir la section "Chargement d'autres images dans Tux Paint " du README pour plus de détails sur le dimensionnement.) Si ce n'est pas le cas, elles seront étirées, sans affecter la forme ("rapport hauteur / largeur"); cependant, des bavures peuvent être apparaître sur les bords.

Placez-les dans le répertoire "`templates`". Lorsque la boîte de dialogue «Nouveau» est accessible dans Tux Paint , les images 'modèle' apparaîtront avec l'écran qui apparaît, suivant les différents choix de couleurs unies.

💡 Note: 'Modèles' are 'attached' to saved pictures, via a small text file that has the same name as the saved file, but with "`.dat`" 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.)

## 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 starter options.)

💡 It's also possible to create basic Templates (with no options) from existing saved drawings directly within Tux Paint, from the "Open" dialog. They will be placed in the user's personal templates folder. (Note: Tux Paint prior to version 0.9.31 did not support Template creation from the Open dialog.)

# Traductions

Tux Paint supports numerous languages, thanks to use of the "gettext" localization library. (See the "Languages" section of "Options documentation" for how to change locales in Tux Paint.)

Pour traduire Tux Paint dans une nouvelle langue, copiez le fichier de modèle de traduction, "`tuxpaint.pot`" (trouvé avec le code source de Tux Paint , dans le dossier "`src/po/`"). Renommez la copie en tant que "`.po`", avec le nom approprié aux paramètres régionaux de votre traduction (par exemple, "`es.po`" pour l'espagnol; ou "`pt_BR.po`" pour le portugais brésilien , contre "`pt.po`" ou "`pt_PT.po`" pour le portugais parlé au Portugal).

Ouvrez le fichier nouvellement créé "`.po` - vous pouvez l'éditer à l'aide d'un éditeur de texte simple comme Emacs, Pico ou vi sur Linux ou NotePad sous Windows. Le texte anglais original utilisé dans Tux Paint se trouve dans les lignes commençant par "`msgid`". Entrez vos traductions de chacune de ces parties de texte dans les lignes vides "`msgstr`" directement sous les lignes "`msgid`" correspondantes . ( Remarque : ne supprimez pas les guillemets.)

Exemple :

> `msgid "Smudge"
> msgstr "Manchar"
> msgid "Click and drag to draw large bricks."
> msgstr "Haz clic y arrastra para dibujar ladrillos grandes."`

De nombreux outils existent pour gérer les catalogues de traduction 'gettext', vous n'avez donc pas besoin de les éditer avec un éditeur de texte. En voici quelques uns :

- Poedit
- Gtranslator (GNOME Translator)
- Virtraal
- Lokalize

💡 Note: It is best to always work off of the latest Tux Paint text catalog template ("`tuxpaint.pot`"), since new text is added, and old text is occasionally changed. The text catalog for the upcoming, unreleased version of Tux Paint can be found in Tux Paint's Git repository (see: https://tuxpaint.org/download/source/git/), and on the Tux Paint website at https://tuxpaint.org/help/po/.

Pour modifier une traduction existante, téléchargez le dernier fichier "`.po`" pour cette langue et modifiez-le comme décrit ci-dessus.

Vous pouvez envoyer des fichiers de traduction nouveaux ou modifiés à Bill Kendrick , responsable du développement principal de Tux Paint , à : bill@newbreedsoftware.com, ou les poster sur la liste de diffusion "tuxpaint-i18n" (voir : https://tuxpaint.org/lists/ ).

Autrement, si vous avez un compte chez SourceForge.net , vous pouvez demander à être ajouté au projet "`tuxpaint`" et obtenir un accès en écriture au référentiel de code source Git afin que vous puissiez valider vos modifications directement.

💡 Note: Support for new locales requires making additions to Tux Paint's source code ("`/src/i18n.h`" et "`/src/i18n.c`"), and requires updates to the `Makefile`, pour s'assurer que les fichiers "`.po`" sont compilés en fichiers "`.mo`", et utilisables pendant l'exécution.

# Méthodes alternatives de saisie

Les outils "Texte" et "Étiquette" de Tux Paint peuvent fournir des méthodes de saisie alternatives pour certaines langues. Par exemple, lorsque Tux Paint fonctionne avec un environnement local japonais, la touche droite `[Alt]` droit peut être pressée pour basculer entre les modes Latin, Romanized Hiragana et Romanized Katakana. Cela permet de saisir des caractères et des mots natifs dans l'outil "Texte" ou 'Étiquette' en tapant une ou plusieurs touches sur un clavier avec des caractères latins (par exemple, un clavier US QWERTY ).

Pour créer une méthode d'entrée pour une nouvelle locale, créez un fichier texte avec un nom basé sur la locale (par exemple, "`ja`" pour le japonais), avec "`.im`" comme extension (par exemple, "`ja.im`").

Le fichier "`.im`" peut avoir plusieurs sections configuration de caractères pour différents modes. Par exemple, sur un système de clavier japonais, la saisie de `[K]` `[A]` en mode Hiragana génère un caractère Unicode "か" différent de la saisie de `[K]` `[A]` en mode Katakana ("カ").

Répertoriez les configurations de caractères dans ce fichier, un par ligne. Chaque ligne doit contenir (séparés par des espaces) :

- la valeur Unicode du caractère, en hexadécimal (plusieurs caractères peuvent être listés, séparés par deux points (':'), ce qui permet à certaines séquences de correspondre à des mots)
- la séquence de touches (les caractères ASCII qui doivent être saisis pour générer le caractère Unicode)
- un drapeau (ou "`-`" pour rien)

Commencez les sections de configuration de caractères supplémentaires avec une ligne contenant le mot «`section`».

Exemple :

> `# Hiragana
> 304B ka -
> 304C ga -
> 304D ki -
> 304E gi -
> 304D:3083 kya -
> 3063:305F tta -
> # Katakana
> section
> 30AB ka -
> 30AC ga -
> 30AD ki -
> 30AE gi -`

⚙ Note: Blank lines within the "`.im`" file will be ignored, as will any text following a "`#`" (pound/hash) character — it can be used to denote comments, as seen in the example above.

💡 Note: Meanings of the flags are locale-specific, and are processed by the language-specific source code in "`src/im.c`". For example, "`b`" is used in Korean to handle Batchim, which may carry over to the next character.

💡 Note: Support for new méthodes de saisie requires making additions to Tux Paint's source code ("`/src/im.c`"), and requires updates to the `Makefile`, pour s'assurer que les fichiers "`.im`" sont disponibles pour être utilisés lors de l'exécution du programme.

# Clavier virtuel sur écran

Depuis la version 0.9.22, les outils «Texte» et «Étiquette» de Tux Paint peuvent présenter un clavier à l'écran qui permet d'utiliser le pointeur (via une souris, des systèmes de suivi oculaire, etc.) pour saisir des caractères. Les fichiers qui décrivent la mise en page et les clés disponibles sont stockés dans le répertoire "`osk`" de Tux Paint . Chaque disposition de clavier est définie par un certain nombre de fichiers (dont certains peuvent être partagés par différentes dispositions).

Nous utiliserons le clavier QWERTY comme exemple :

## Fichier d'aperçu de la disposition ("`qwerty.layout`")

Il s'agit d'un fichier texte qui spécifie les autres fichiers utilisés pour décrire l'agencement et la disposition des touches.

> `layout qwerty.h_layout
> keymap us-intl-altgr-dead-keys.keymap
> composemap en_US.UTF-8_Compose
> keysymdefs keysymdef.h
> keyboardlist qwerty.layout default.layout`

⚙ Note: Blank lines within the "`.layout`" file will be ignored, as will any text following a "`#`" (pound/hash) character — it can be used to denote comments, as seen in the example above.

La ligne "`keyboardlist`" décrit les dispositions vers lesquelles on bascule lorsque l'utilisateur clique sur les boutons gauche et droit du clavier. (Voir ci-dessous.)

## Fichier de disposition du clavier (`qwerty.h_layout`")

Ceci décrit la taille du clavier (sous forme de grille L × H), et répertorie chaque touche avec son code numérique (voir le fichier "`keymap`", ci-dessous), la largeur à laquelle il doit être dessiné (généralement "`1.0`", pour en prendre un espace sur le clavier, mais dans l'exemple ci-dessous, notez que les touches "`TAB`" et "`SPACE`" sont beaucoup plus larges), le caractère ou le texte à afficher sur la touche, selon les touches de modification qui ont été enfoncées (une pour chacune : pas de modificateurs, `[Shift]` , `[AltGr]` et `[Shift]` + `[AltGr]` ), et enfin si la touche est affectée ou non par la touche `[CapsLock]` (utilisez "`1`") ou `[AltGr]` (alt graphiques alternatifs) (utilisez "`2`"), ou pas du tout (utilisez "`0`").

> `WIDTH 15
> HEIGHT 5
> KEY 49 1.0 ` ~ ` ~ 0
> KEY 10 1.0 1 ! ¡ ¹ 0
> KEY 11 1.0 2 @ ² ˝ 0
> KEY 12 1.0 3 # · ³ 0
> KEY 13 1.0 4 $ ¤ £ 0
> KEY 14 1.0 5 % € ¸ 0
> KEY 15 1.0 6 ^ ¼ ^ 0
> ...
> KEY 21 1.0 = + × ÷ 0
> KEY 22 2.0 DELETE DELETE DELETE DELETE 0
> NEWLINE
> KEY 23 1.5 TAB TAB TAB TAB 0
> KEY 24 1.0 q Q ä Ä 1
> KEY 25 1.0 w W å Å 1
> KEY 26 1.0 e E é É 1
> KEY 27 1.0 r R ® ® 1
> ...
> NEWLINE
> # Flèche gauche pour revenir au clavier précédent
> KEY 2 1.0 <- <- <- <- 0
> KEY 133 2.0 Cmp Cmp Cmp Cmp 0
> # Les touches ALT ou ALTGR sont utilisées dans im pour changer de mode de saisie
> KEY 64 2.0 Alt Alt Alt Alt 0
> # Espace
> KEY 65 7.0 SPACE SPACE SPACE SPACE 0
> KEY 108 2.0 AltGr AltGr AltGr AltGr 0
> # Flèche droite pour aller au clavier suivant
> KEY 1 1.0 -> -> -> -> 0`

Notez ici que les touches alphabétiques ( `[Q]`, `[W]` , `[1]` , etc.) seront affectées par CapsLock , tandis que les touches numériques ( `[1]` , `[2]` , etc.), `[Espace]` , etc. ne le sont pas.

Les codes clés jusqu'à "`8`" sont réservés à un usage interne. Ceux actuellement utilisés sont décrits ci-dessous.

- `0` — bouton vide
- `1` — disposition suivante (pour le réglage "`keyboardlist`" du fichier d'agencement)
- `2` — disposition précédente (pour le réglage "`keyboardlist`" du fichier d'agencement)

## Fichier keymap ("`us-intl-altgr-dead-keys.keymap`")

Ce fichier définit quels codes de touches numériques (vus dans les fichiers de disposition du clavier, tels que "`qwerty.h_layout`" décrits ci-dessus) doivent correspondre aux caractères réels qu'une application comme Tux Paint s'attend à recevoir lorsque des touches (par exemple, sur un clavier réel) sont enfoncées.

Si vous utilisez un système d'exploitation tel que Linux, qui tourne sous X-Window et qui dispose de l'outil "`xmodmap`" en ligne de commande, vous pouvez l'utiliser avec l'option "`-pke`" ('print keymap expressions') pour générer un fichier keymap.

> `keycode 9 = Escape NoSymbol Escape Escape
> keycode 10 = 1 exclam exclamdown onesuperior 1 exclam 1 exclam NoSymbol onesuperior
> keycode 11 = 2 at twosuperior dead_doubleacute 2 at 2 at onehalf twosuperior
> keycode 12 = 3 numbersign periodcentered threesuperior dead_macron periodcentered
> ...
> keycode 52 = z Z ae AE Arabic_hamzaonyeh asciitilde guillemotright NoSymbol Greek_zeta Greek_ZETA U037D U03FF
> keycode 53 = x X x X Arabic_hamza Arabic_sukun guillemotleft NoSymbol Greek_chi Greek_CHI rightarrow leftarrow
> keycode 54 = c C copyright cent Arabic_hamzaonwaw braceright Greek_psi Greek_PSI copyright
> keycode 55 = v V v V Arabic_ra braceleft Greek_omega Greek_OMEGA U03D6
> keycode 56 = b B b B UFEFB UFEF5 Greek_beta Greek_BETA U03D0
> keycode 57 = n N ntilde Ntilde Arabic_alefmaksura Arabic_maddaonalef Greek_nu Greek_NU U0374 U0375
> keycode 58 = m M mu mu Arabic_tehmarbuta apostrophe Greek_mu Greek_MU U03FB U03FA
> keycode 59 = comma less ccedilla Ccedilla Arabic_waw comma comma less guillemotleft
> keycode 60 = period greater dead_abovedot dead_caron Arabic_zain period period greater guillemotright periodcentered
> keycode 61 = slash question questiondown dead_hook Arabic_zah Arabic_question_mark slash question
> keycode 62 = Shift_R NoSymbol Shift_R Shift_R
> ...
> `

## Fichier Composemap ("`en_US.UTF-8_Compose`")

Ce fichier décrit les caractères qui peuvent être composés avec plusieurs entrées. Par exemple, "`[Compose]`" suivi de "`[A]` " et "`[E]`" peut être utilisé pour créer le caractère "`æ`".

Le fichier fourni avec Tux Paint est basé sur le composemap anglais américain UTF-8 (Unicode) fourni avec le système X Window de X.Org . La version actuelle de la bibliothèque Xlib se trouve sur la page Web à l' adresse https://www.x.org/releases/current/doc/libX11/i18n/compose/en_US.UTF-8.html.

## Fichier de définitions des Keysim ("`keysymdef.h`")

Ce fichier (qui est un fichier d'en-tête du langage de programmation C ) provient également du système X Window . Il définit les valeurs Unicode de chaque keycap (par exemple, "`XK_equal`" correspond à "`U+003D`", pour le caractère "`=`" ("`EQUALS SIGN`").

💡 Note: This file is not compiled into Tux Paint, but is read and parsed at runtime.

Il est peu probable qu'une modification de ce fichier soit requise.

# Magic Tools

Tux Paint's Magic tools are pieces of software, external to the main Tux Paint application, that are loaded as "plugins" at runtime, and interact with the program using a defined Application Programming Interface (API). The plugins that ship with Tux Paint (as well as Tux Paint itself) are written in the C programming language.

Consult the Magic Tool Plugin API Documentation to learn how to write your own.