Manuel utilisateur de KTuberling

# Manuel utilisateur de KTuberling

Éric Bischoff `<e.bischoff@noos.fr>`

Paul E. Ahlquist, Jr. `<pea@ahlquist.org>`

Eugene Trounev `<eugene.trounev@gmail.com>`

Relecteur: Lauri Watts
Traduction française : Benoit Cosandier
Traduction française : Stanislas Zeller
Relecture de la documentation française : Ludovic Grossard
Traduction française : Xavier Besnard
Version KDE Gear 21.08 (04-10-2021)

Copyright © 1999, 2000, 2002, 2006 Éric Bischoff

Copyright © 2001 Paul E. Ahlquist, Jr.

Note légale

Potato Guy est un jeu destiné aux jeunes enfants.

Liste des tableaux

4.1. Les boutons de la barre d'outils

Chapitre 1. Introduction
Introduction

# Chapitre 1. Introduction

Type de jeu : jouet

Nombre possible de joueurs : un

Potato Guy est un jeu de construction simple, adapté aux enfants et également pour les parents. L'idée de ce jeu est adapté d'un concept de création de poupée très populaire. Une pomme de terre est décorée avec divers petits objets pour la faire ressembler à une personne. Potato Guy va cependant plus loin en terme de contenu et ajoute une diversité surprenante de thèmes différents.

Chapitre 2. Comment jouer
Comment jouer

# Chapitre 2. Comment jouer

Potato Guy est un jeu conçu pour les jeunes enfants. Bien sûr, il peut être aussi joué par des adultes qui sont resté, au fond d'eux, jeunes.

C'est un « éditeur de patate ». Cela signifie que vous pouvez glisser-déposer des yeux, des bouches, des moustaches et d'autres parties du visage sur un bonhomme ressemblant à une patate. De même, vous disposez d'autres aires de jeu avec différents thèmes.

Il n'y a pas de gagnant dans ce jeu. Le seul but est de créer des figures les plus amusantes que vous pouvez.

Potato Guy peut également « parler ». Il prononcera le nom des objets que vous glissez et déposez. Il « parlera » dans la langue de votre choix. Vous pouvez même l'utiliser pour apprendre un peu de vocabulaire dans des langues étrangères.

Chapitre 3. Règles et astuces
Règles et astuces

# Chapitre 3. Règles et astuces

## Manipulations avec la souris

Il y a deux zones dans la fenêtre principale :

- Aire de « jeu »

- Zone « d'objets », où vous sélectionnez les objets que vous placez sur votre aire de jeu.

### Note

L'aspect de l'écran d'application peut être modifié en appliquant un « thème » sélectionné.

### Placer un objet

Pour faire glisser un objet, déplacez le pointeur de la souris dans la zone « d'objets » et cliquez dessus. et ensuite déplacez-le vers « l'aire de jeu » et cliquez encore une fois.

### Note

La taille des objets peut être modifiée pendant le déplacement. Certain objets trop grands ont été réduits pour s'adapter à la zone des « objets ».

### Déplacer un objet

Une fois déposé dans l'aire « de jeu », un objet peut être déplacé. Il suffit simplement de cliquer sur l'objet pour le sélectionner, de le déplacer vers sa nouvelle place et cliquer encore une fois dessus pour le relâcher. Quand vous l'avez déplacé, il se positionne au dessus des autres objets qui sont partiellement cachés. Cette astuce est utile pour placer correctement les lunettes et les yeux.

### Enlever un objet

Pour enlever un objet qui a été déposé dans la zone « de jeu », faites-le glisser depuis la zone « de jeu » vers la zone « d'objets ».

Chapitre 4. Vue d'ensemble de l'interface
Vue d'ensemble de l'interface

# Chapitre 4. Vue d'ensemble de l'interface

## La barre d'outils

La barre d'outils fournit des boutons pour les fonctions couramment utilisées.

Tableau 4.1. Les boutons de la barre d'outils

Bouton | Nom | Équivalent de menus | Action
--- | --- | --- | ---
| Nouveau | Jeu → Nouveau | Réinitialise la zone de « jeu ». Ceci nettoie toutes les parties de l'aire de jeu afin de créer un nouveau tableau et donc une nouvelle décoration peut être créée.
| Charger… | Jeu → Charger... | Ouvre un fichier existant `.tuberling` depuis le disque.
| Enregistrer | Jeu → Enregistrer | Enregistre votre création dans votre dossier personnel ou dans un autre dossier sur le disque. Le fichier `.tuberling` est enregistré dans un petit fichier ne contenant que les positions des objets.
| Imprimer… | Jeu → Imprimer... | Imprime votre image.
| Annuler | Édition → Annuler | Annule la dernière opération.
| Refaire | Édition → Refaire | Refait la dernière opération.

Les éléments des menus
Les éléments des menus

## Les éléments des menus

### Le menu « Jeu »

Jeu → Nouveau (Ctrl+N)

  Efface la « zone de jeu ».

Jeu → Charger... (Ctrl+O)

  Ouvrir un fichier existant `.tuberling` depuis votre disque.

Jeu → Enregistrer (Ctrl+S)

  Enregistre votre création. La « patate » est enregistrée dans un petit fichier qui contient les positions des objets.

Jeu → Enregistrer comme image...

  Crée un fichier graphique contenant une image de votre création.

Jeu → Imprimer... (Ctrl+P)

  Imprime votre image créée.

Jeu → Quitter (Ctrl+Q)

  Quitte Potato Guy.

### Le menu « Édition »

Édition → Annuler (Ctrl+Z)

  Annule le dernier « objet » placé.

Édition → Refaire (Ctrl+Maj+Z)

  Refait le dernier placement « d'objet ». Ce menu optionnel n'est actif que si vous avez au préalable utilisé Annuler.

Édition → Copier (Ctrl+C)

  Copie la zone de « jeu » dans le presse-papiers.

### Le menu « Affichage »

Affichage → Mode Plein écran (Ctrl+Maj+F)

  Bascule l'interface graphique en mode « Plein écran ».

### Le menu « Aire de jeu »

Aire de jeu → Verrouillez le ratio d'affichage

  Cette option préserve le ratio d'aspect de la zone de jeu lors du re-dimensionnement de la fenêtre de Potato Guy. Quand ce ration ne correspond pas à celle de la fenêtre, l'arrière-plan est rempli avec celui spécifié dans le thème.

Aire de jeu → Nom de l'aire de jeu

  Se déplace vers l'aire de jeu.

Contient l'aire de jeu installée sur votre système.

Potato Guy se rappelle de la dernière zone de jeu sélectionnée au prochain démarrage.

### Le menu « Paroles »

Paroles → Pas de son

  Éteint le son.

Paroles → Nom de la langue

  Active le son et parle la langue sélectionnée.

Potato Guy se rappelle de cette option au prochain démarrage.

### Les menus « Configuration » et « Aide »

De plus, Potato Guy possède des éléments de menus communs de KDE Configuration et Aide. Pour plus d'informations, veuillez consulter les sections Menu de configuration et Menu d'aide des fondamentaux de KDE.

Chapitre 5. Foire aux questions
Foire aux questions

# Chapitre 5. Foire aux questions

5.1. Je veux modifier la façon dont le jeux s'affiche. Est-ce possible ?
5.2. Puis-je utiliser le clavier pour jouer à ce jeu ?
5.3. J'ai créé une magnifique image et je veux la partager avec mes ami(e)s. Puis-je l'enregistrer ?

5.1. | Je veux modifier la façon dont le jeux s'affiche. Est-ce possible ?
| Oui vous pouvez. Veuillez consulter cette section de la vue d'ensemble de l'interface pour plus de détails.
5.2. | Puis-je utiliser le clavier pour jouer à ce jeu ?
| Non. Ce jeu n'inclut pas de fonctionnalité d'utilisation du clavier.
5.3. | J'ai créé une magnifique image et je veux la partager avec mes ami(e)s. Puis-je l'enregistrer ?
| Oui. Pour enregistrer la session actuelle comme une image, consultez cette section de la vue d'ensemble de l'interface pour plus de détails.

Chapitre 6. Références techniques
Références techniques

# Chapitre 6. Références techniques

Éric Bischoff

Traduction française : Benoit Cosandier
Traduction française : Stanislas Zeller
Traduction française : Xavier Besnard
Version KDE Gear 21.08 (04-10-2021)

KTuberling offre une agréable et gratifiante introduction à la personnalisation et à la programmation de KDE Cette application peut être étendue. Par exemple vous pouvez ajouter un nouveau terrain de jeu, sans modifier le code source, en modifiant les fichiers graphiques. En ajoutant les fichiers de son adéquats, les traducteurs peuvent adapter les sons à leur langue d'origine.

Si vous étendez ou ajoutez des choses au jeu, veuillez penser à envoyer vos modifications au développeur Alex Fiestas (en anglais) pour qu'elles soient incluses dans la future version.

## Pour les graphistes

Pour créer une nouvelle aire de jeu KTuberling, vous devez :

- Dessiner l'aire de jeu dans un fichier au format « SVG », vous devez :

  - Nommer l'emplacement où les éléments sont déposés en « background ».

  - Saisir un titre pour chaque élément à déposer avec un nom unique,

- Créer un fichier `.theme`. Il doit suivre ce schéma :

      <Zone de jeu= « Votre-Fichier-SVG » nom= « Votre-Fichier.bureau » >
      <nom de l'objet= « Nom-Objet » son= « Nom-Du-Son » échelle= « Valeur » >
        ..
        ...
        ...
        </playground>

  - `Votre-Fichier-SVG` est le nom du fichier au format « SVG » ayant été dessiné.

  - `Votre-Fichier.desktop` est le nom du fichier desktop qui a le nom du thème.

  - Pour chaque objet, vous devez faire une correspondance avec une entrée <objet>. `Nom-Objet` est la dénomination unique que vous utilisez pour un fichier « SVG », `Nom-Du-Son` est le nom du son que vous jouerez quand vous le déplacerez. Veuillez consulter le fichier `sounds/soundthemes.HOWTO` à partir du code source pour plus d'informations sur les thèmes sonores.

  - `L'échelle` est optionnelle et la `valeur fournie` est le facteur d'échelle qui sera utilisé quand vous dessinerez un objet en dehors de la zone. Si ce paramètre est non défini, la valeur par défaut est de 1.

- Créer un fichier `.desktop`. Il doit suivre ce schéma :

      [KTuberlingTheme]
      Name=Nom-du-thème

  - `Nom-Du-Thème` est le nom qui identifie le thème qui sera affiché dans le menu de l'aire de jeu.

- Si vous ajoutez un thème au dépôt de KTuberling, veuillez ajouter les fichiers avec les extensions `.svg`, `.theme` et `.desktop` à la section `FICHIERS` du fichier `CMakeLists.txt` dans le dossier `pics/`.

- Si vous voulez l'installer par vous même, veuillez placer les fichiers avec les extensions `.svg`, `.theme` et `.desktop` dans le dossier `ktuberling/pics` grâce à la commande `qtpaths `--paths GenericDataLocation``.

Pour les traducteurs
Pour les traducteurs

## Pour les traducteurs

À coté de l'habituel mécanisme utilisé sur les fichiers `.po` pour traduire les chaines du programme, les sons peuvent être également localisés.

Pour créer un nouveau thème de son pour KTuberling, vous devez :

- Enregistrer les sons dans le format « OGG Vorbis rc3 ».

- Créer un fichier ``Code-de-votre-langue-deux-lettres`.soundtheme`. Cela doit suivre ce schéma :

      <code langue= « Votre-Langue-En-Deux-Lettres »>
      <nom du son= « Nom-Du-Son » fichier= « Emplacement-Relatif » />
      ...
      ...
      ...
      </langue>

  - `Votre-Langue-En-Deux-Lettres` représente votre langue d'un code de deux lettres. Par exemple, fr pour Français.

  - Pour chaque son il y a une entrée `<son>`. `Nom-Du-Son` doit correspondre avec le nom du son spécifié dans l'aire de jeu (Veuillez consulter la page `pics/themes.HOWTO` à partir du code source). `Emplacement-Relatif` doit être l'emplacement relatif où vous installez le fichier avec le son, typiquement cela sera ``Emplacement-Unique`/`Nom-Son`. Le `format`` (`Emplacement-Unique` peut être le code à deux lettres de votre langue par exemple).

- Si vous ajoutez le thème de son à KTuberling dans votre dossier de langues :

  - Ajoutez des fichiers de sons et les fichiers `.soundtheme` dans votre dossier `data/kdegames/ktuberling` pour vos traductions de langues.

  - Dans le même dossier, vous avez besoin d'un fichier `CMakeLists.txt` décrivant comment installer ces fichiers, cela de façon classique.

        FILE( GLOB oggfiles *.ogg )
        INSTALL( FILES ${oggfiles} DESTINATION ${KDE_INSTALL_DATADIR}/ktuberling/sounds/Votre-Langue-En-Deux-Lettres )
        INSTALL( FILES Votre-Langue-En-Deux-Lettres.soundtheme DESTINATION ${KDE_INSTALL_DATADIR}/ktuberling/sounds/ )

- Si vous voulez l'installer vous même :

  - Placer le fichier ``Code-de-votre-langue-deux-lettres`.soundtheme` dans le dossier `ktuberling/sounds` dans la commande `qtpaths `--paths GenericDataLocation``.

  - Placer vos fichiers de sons dans le dossier `ktuberling/sounds/`Emplacement-unique`` dans la commande `qtpaths `--paths GenericDataLocation``

Des informations sur la façon dont fonctionnent les mécanismes de traduction dans KDE sont disponible à l'adresse Le guide pratique de la traduction dans KDE.

Pour les programmeurs
Pour les programmeurs

## Pour les programmeurs

KTuberling n'est pas réellement difficile à améliorer pour les programmeurs.

### Classes C++

`Niveau supérieur`

  Gestion de la fenêtre principale et du programme de base.

`Aire de jeu`

  Description d'un des niveaux du jeu.

`A-Dessiner`

  Description de l'un des « objets » graphiques à dessiner.

`Fabrique-de-sons`

  Description de l'une des langues et de ses sons.

`Action`

  Une des manipulations de l'utilisateur, rangée dans la pile « Annuler / refaire ».

Chapitre 7. Remerciements et licence
Remerciements et licence

# Chapitre 7. Remerciements et licence

KTuberling

- Alex Fiestas `(alex AT eyeos.org)` - Mainteneur actuel

- John Calhoun - Idée originale, images originelles et sons en anglais

- Éric Bischoff `(e.bischoff AT noos.fr)`, programmeur KDE

- François-Xavier Duranceau `(duranceau AT free.fr)` - tests, conseil et aide

- Peter Silva `(peter.silva AT videotron.ca)` - relecture de la documentation

- Paul E. Ahlquist, Jr. `(pea AT ahlquist.org)` - Amélioration de la documentation

Traduction française par Benoit Cosandier `(cosandier.benoit AT bluewin.ch)` et Stanislas Zeller `(uncensored.assault AT gmail.com)`..

Relecture par Ludovic Grossard `(grossard AT kde.org)`.

Cette documentation est soumise aux termes de la Licence de Documentation Libre GNU (GNU Free Documentation License).

Ce programme est soumis aux termes de la Licence Générale Publique GNU (GNU General Public License).