Het handboek van KTuberling

# Het handboek van KTuberling

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

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

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

Nalezer: Lauri Watts
Vertaling van het handboek: Niels Reedijk
Vertaler/Nalezer: Rinse de Vries
Vertaler/Nalezer: Freek de Kruijf
herziening KDE Gear 21.08 (2021-10-04)

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

Copyright © 2001 Paul E. Ahlquist, Jr.

Juridische kennisgeving

Potato Guy is een spel bedoeld voor kleine kinderen.

Lijst van tabellen

4.1. Werkbalkknoppen

Hoofdstuk 1. Inleiding
Inleiding

# Hoofdstuk 1. Inleiding

Speltype: speelgoed

Aantal mogelijke spelers: één

Potato Guy is een eenvoudig opbouwspel zowel voor kinderen als volwassenen. Het idee van het spel is gebaseerd op een eens populair concept voor poppen maken. Een aardappel werd versiert met verschillende kleine dingetjes om het te laten lijken op een klein mensje. Potato Guy echter, gaat veel verder in termen van inhoud en voegt een verbazende hoeveelheid verschillende thema's toe.

Hoofdstuk 2. Hoe te spelen
Hoe te spelen

# Hoofdstuk 2. Hoe te spelen

Potato Guy is een spel bedoeld voor kleine kinderen. Uiteraard is het ook geschikt voor volwassen die jong van geest zijn gebleven.

Het is een “aardappelmannetjebewerker”. Dit betekent dat je ogen, monden, snorren en andere dingen op een aardappelmannetje kunt plaatsen. Daarnaast zijn er andere speelvelden met verschillende thema's.

Het spel kent geen winnaar. Het enige doel is om zo grappig mogelijke gezichten of situaties te maken.

Potato Guy kan ook “praten”. Het zal de naam van de objecten die je versleept uitspreken. Het “spreekt” in de taal die je hebt uitgekozen. Je kunt het programma zo ook gebruiken om een paar vreemde woorden te leren.

Hoofdstuk 3. Regels en tips
Regels en tips

# Hoofdstuk 3. Regels en tips

## De muis

Er bevinden zich twee gebieden in het hoofdvenster:

- Het “speelveld”.

- Het “objecten”veld. Hier kunt u de objecten kiezen die je in het speelveld wilt plaatsen.

### Opmerking

Een actueel uiterlijk van het programmascherm kan wijzigen afhankelijk van een gekozen “speelveld”.

### Een object plaatsen

Om een object te verslepen, verplaats je de muisaanwijzer naar het “objecten”gebied en klik erop. Versleep het dan naar het “speelveld” en klik opnieuw.

### Opmerking

De grootte van de objecten kan zich wijzigen tijdens het verslepen. Sommige van de te grote objecten worden omlaag geschaald in het “objecten”gebied.

### Een object verplaatsen

Als u een object in het “speelveld” hebt geplaatst, dan kunt u het nog verplaatsen. Klik erop en sleep het naar een andere positie en klik er opnieuw op om het te laten vallen. Als je het laat vallen dan komt het bovenop andere objecten, die het eerder gedeeltelijk overlapten. Dit is handig om bijvoorbeeld de bril voor de ogen geplaatst te krijgen.

### Een object verwijderen

Om een object uit het “speelveld” te verwijderen sleept u het terug naar het “objectveld”.

Hoofdstuk 4. Overzicht van het interface
Overzicht van het interface

# Hoofdstuk 4. Overzicht van het interface

## De werkbalk

De werkbalk bevat knoppen voor de meestgebruikte functies.

Tabel 4.1. Werkbalkknoppen

Knop | Naam | Bijhorende menuoptie | Actie
--- | --- | --- | ---
| Nieuw | Spel → Nieuw | Wist het “speelveld”. Dit verwijdert alle onderdelen van het speelveld zodat er een nieuwe versiering kan worden gemaakt.
| Laden… | Spel → Laden… | Opent een bestaand `.tuberling`-bestand op de schijf.
| Opslaan | Spel → Opslaan | Bewaart jouw creatie in jouw persoonlijke map of in een andere map op jouw schijf. Het `.tuberling` wordt opgeslagen in een klein bestandje waarin alleen de posities van de objecten zijn opgeslagen.
| Afdrukken… | Spel → Afdrukken… | Drukt uw afbeelding af.
| Ongedaan maken | Bewerken → Ongedaan maken | Maakt de laatste handeling ongedaan.
| Opnieuw | Bewerken → Opnieuw | Voert de laatste ongedaan gemaakte handeling opnieuw uit.

De menuopties
De menuopties

## De menuopties

### Het menu Spel

Spel → Nieuw (Ctrl+N)

  Wist het “speelveld”.

Spel → Laden… (Ctrl+O)

  Opent een bestaand `.tuberling`-bestand vanaf jouw schijf.

Spel → Opslaan (Ctrl+S)

  Bewaart uw creatie. De tuberling wordt opgeslagen in een klein bestand waar alleen de positie van de objecten in is geplaatst.

Spel → Opslaan als afbeelding…

  Maakt een afbeeldingsbestand met een plaatje van jouw tuberling.

Spel → Afdrukken… (Ctrl+P)

  Drukt jouw tuberling-illustratie af.

Spel → Afsluiten (Ctrl+Q)

  Beëindigt Potato Guy.

### Het menu Bewerken

Bewerken → Ongedaan maken (Ctrl+Z)

  Maakt de laatste plaatsing van een “object” ongedaan.

Bewerken → Opnieuw (Ctrl+Shift+Z)

  Voert de laatste ongedaan gemaakte verplaatsing van een “object” opnieuw uit. Deze menuoptie is alleen actief als u eerder Ongedaan maken hebt gebruikt.

Bewerken → Kopiëren (Ctrl+C)

  Kopieert het “speelveld” naar het klembord.

### Het menu Beeld

Instellingen → Volledig scherm (Ctrl+Shift+F)

  Zet de modus Volledig scherm aan/uit.

### Het menu Speelveld

Speelveld → Vergrendel de beeldverhouding

  Deze optie behoudt de beeldverhouding van het speelveld bij het veranderen van het venster van Potato Guy. Als de beeldverhouding van het speelveld niet overeenkomt met die van het venster dan wordt de achtergrond gevuld met wat is gespecificeerd in het thema.

Speelveld → `Speelveldnaam`

  Schakelt om naar het speelveld.

Het zal de speelvelden bevatten die zijn geïnstalleerd in uw systeem.

Potato Guy onthoudt het laatst gekozen speelveld de volgende keer dat het programma wordt gestart.

### Het menu Spraak

Spraak → Geen geluid

  Schakelt geluid uit.

Spraak → `Naam van de taal`

  Schakelt geluid aan en spreekt de geselecteerde taal.

Potato Guy onthoudt deze instelling bij de volgende programmastart.

### De menu's Instellingen en Help

Bovendien heeft Potato Guy de gezamenlijke menu-items van KDE Instellingen en Help, voor meer informatie lees de secties over de Menu Instellingen en Menu Help van KDE-fundamentals.

Hoofdstuk 5. Veel gestelde vragen
Veel gestelde vragen

# Hoofdstuk 5. Veel gestelde vragen

5.1. Ik wil het uiterlijk van dit spel wijzigen. Kan dat?
5.2. Kan ik het toetsenbord gebruiken om dit spel te spelen?
5.3. Ik heb een heel mooi plaatje gemaakt en ik wil het delen met mijn vrienden. Kan ik het opslaan als een afbeelding?

5.1. | Ik wil het uiterlijk van dit spel wijzigen. Kan dat?
| Ja dat kan. Ga naar deze sectie van 'Overzicht van het interface' voor details.
5.2. | Kan ik het toetsenbord gebruiken om dit spel te spelen?
| Nee, dit spel kan niet met het toetsenbord worden gespeeld.
5.3. | Ik heb een heel mooi plaatje gemaakt en ik wil het delen met mijn vrienden. Kan ik het opslaan als een afbeelding?
| Ja. Om de huidige sessie als een afbeelding op te slaan ga naar deze sectie van 'Overzicht interface' voor details.

Hoofdstuk 6. Technische referentie
Technische referentie

# Hoofdstuk 6. Technische referentie

Éric Bischoff

Vertaler/Nalezer: Freek de Kruijf
herziening KDE Gear 21.08 (2021-10-04)

KTuberling biedt een elegante en belonende inleiding in het programmeren voor en aanpassen van KDE. Het programma kan worden uitgebreid. Bijvoorbeeld, zonder dat u hoeft te programmaren kunt u nieuwe speelvelden toevoegen door de grafische bestanden te wijzigen. Door de juiste geluidsbestanden kunnen vertalers de geluiden aanpassen aan hun eigen taal!

Als u het spel uitbreidt, overweeg dan om uw toevoegingen te sturen aan de onderhouder Alex Fiestas zodat ze in toekomstige versies kunnen worden bijgesloten.

## Voor artiesten

Om een nieuwe KTuberling speelveld aan te maken dient u:

- Het te tekenen speelveld in een een SVG-bestand, waarin u:

  - De plaats waar items naar toe gesleept worden “background” wordt genoemd.

  - Geef elk van de versleepbare items een unieke naam.

- Maak een `.thema`-bestand aan, met het volgende schema:

      <playground gameboard="uwSVGbestand" name="hetBureaubladBestand">
      <object name="itemNaam" sound="geluidNaam" scale="eenWaarde" />
      ...
      ...
      ...
      </playground>

  - `uwSVGbestand` is de naam van het SVG-bestand dat de tekening bevat.

  - `hetBureaubladBestand` is de naam van het bureaubladbestand dat de naam van het thema bevat.

  - Voor elk object hebt u een `<object>`-item nodig. `itemNaam` is de unieke naam die u gebruikt voor het SVG-bestand, `geluidNaam` is de naam van het geluid dat zal worden afgespeeld bij het slepen, zie het bestand `sounds/soundthemes.HOWTO` uit de broncode voor meer informatie.

  - `scale` is optioneel en `eenWaarde` is de schaalfactor die zal worden gebruikt bij het tekenen van dit object buiten de opslagplaats, als deze niet is gespecificeerd dan is deze 1.

- Maak een `.desktop`-bestand aan, met dit schema:

      [KTuberlingTheme]
      Name=themaNaam

  - `themaNaam` is de naam die het thema identificeert en zal worden getoond in het menu Speelveld.

- Als u het thema toevoegt aan de KTuberling-opslagruimte, voeg dan `.svg`-, `.theme`- en `.desktop`-bestanden toe aan de sectie FILES van CMakeLists.txt in de map `pics/`.

- Als u het wilt installeren voor uzelf, plaats `.svg`-, `.theme`- en `.desktop`-bestanden in de map `ktuberling/pics` in `qtpaths `--paths GenericDataLocation``

Voor vertalers
Voor vertalers

## Voor vertalers

Naast de gebruikelijke mechanisme met `.po`-bestanden voor het vertalen van programmateksten en documentatie kunnen ook de geluiden worden overgezet naar andere talen.

Om een nieuw KTuberling geluid aan te maken dient u:

- Neem de geluiden op in OGG Vorbis rc3 bestandsformaat.

- Maak een bestand ``uwTaalTweeLetterCode`.soundtheme`, het moet dit schema volgen:

      <language code="uwTaalTweeLetterCode">
      <sound name="geluidsNaam" file="relatiefPad" />
      ...
      ...
      ...
      </language>

  - `uwTaalTweeLetterCode` is de twee lettercode van uw taal, bijvoorbeeld nl voor Nederlands.

  - Voor elke klank moet een `<sound>`-item. `geluidsNaam` overeenkomen met de geluidsNaam gespecificeerd in het playground-thema (zie de `pics/themes.HOWTO` uit de broncode). `relatievePad` zou het relatieve pad moeten zijn waar u het bestand met deze klank in gaat installeren, dit is typisch ``eenUniekPad`/`geluidNaam`.`format`` (`eenUniekPad` kan bijvoorbeeld uw tweeletterige taalcode zijn).

- Als u het geluidsthema toevoegt aan de KTuberling in uw taalmap:

  - Voeg de klankbestanden en de `.soundtheme`-bestanden toe in de map `data/kdegames/ktuberling` van de vertalingen in uw taal.

  - In diezelfde map hebt u een `CMakeLists.txt` nodig die beschrijft hoe de bestanden te installeren, dit is typisch:

        FILE( GLOB ogg-bestanden *.ogg)
        install( FILES ${datafiles} DESTINATION ${DATA_INSTALL_DIR}/ktuberling/sounds/uwTaalTweeLetterCode )
        install( FILES uwTaalTweeLetterCode.soundtheme DESTINATION ${DATA_INSTALL_DIR}/ktuberling/sounds/ )

- Als u het wilt installeren voor uzelf:

  - Plaats het bestand ``uwTweeletterigeTaalcode`.soundtheme` in de map `ktuberling/sounds` in `qtpaths `--paths GenericDataLocation``

  - Plaats uw geluidsbestanden in de map `ktuberling/sounds/`eenUniekPad`` in `qtpaths `--paths GenericDataLocation``

Informatie over hoe u gebruik kunt maken met de vertaalmechanismen van KDE is beschikbaar in The KDE HOWTO voor vertalen. Kijk ook op de vertalerswebsite van het Nederlandse KDE-team.

Voor programmeurs
Voor programmeurs

## Voor programmeurs

KTuberling is voor programmeurs niet moeilijk om uit te breiden.

### C++-klassen

`TopLevel`

  Topniveau venster en basis programmabeheer.

`PlayGround`

  Beschrijving van een van de spelniveaus.

`ToDraw`

  Beschrijving van een van de grafische “objecten” om te tekenen.

`SoundFactory`

  Beschrijving van een van de talen en diens geluiden.

`Actie`

  Een van de gebruikers' manipulatie in de ongedaan maken/opnieuw maken stapel.

Hoofdstuk 7. Dankbetuigingen en licentie
Dankbetuigingen en licentie

# Hoofdstuk 7. Dankbetuigingen en licentie

KTuberling

- Alex Fiestas `(alex AT eyeos.org)` - huidige onderhouder

- John Calhoun - oorspronkelijk idee, oorspronkelijke afbeeldingen en Engelstalige geluiden

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

- François-Xavier Duranceau `(duranceau AT free.fr)` - Testen, advies en hulp

- Peter Silva `(peter.silva AT videotron.ca)` - proeflezen van de documentatie

- Paul E. Ahlquist, Jr. `(pea AT ahlquist.org)` - verbeteren van de documentatie

Op- of aanmerkingen over de vertalingen van de toepassing en haar documentatie kunt u melden op http://www.kde.nl/bugs.

Dit document is vertaald in het Nederlands door Niels Reedijk.

Dit document is vertaald in het Nederlands door Freek de Kruijf.

Deze documentatie valt onder de bepalingen van de GNU vrije-documentatie-licentie.

Deze toepassing valt onder de bepalingen van de GNU General Public License.