Het handboek van KTuberling
Het handboek van KTuberling
Volgende

Het handboek van KTuberling

Eric Bischoff

Paul E. Ahlquist, Jr.

Nalezer: Lauri Watts
Vertaling van het handboek: Niels Reedijk
Vertaler/Nalezer: Rinse de Vries
Herziening 0.03.02 (2002-04-15)

Het is toegestaan dit document te kopiëren, te verdelen en/of te wijzigen onder de voorwaarden van de GNU vrije-documentatie-licentie, versie 1.1 of een latere versie, gepubliceerd door de Free Software Foundation; zonder invariante paragrafen, zonder vooromslagteksten, en zonder achteromslagteksten. Een kopie van de licentie vindt u hier: de paragraaf "GNU vrije-documentatielicentie".

KTuberling is een spel bedoeld voor kleine kinderen.


Lijst van tabellen

2.1. Werkbalkknoppen
Hoofdstuk 1. Inleiding
Inleiding
Terug
Volgende

Hoofdstuk 1. Inleiding

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

Het is een de virtuele versie van het welbekende “aardappelmannetje”. U kunt ogen, monden, snorren en andere objecten op een aardappel plaatsen. Naast de aardappel kunt u ook een pinguin aankleden of een aquarium inrichten.

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

Er is een museum (soort van “Madame Tusseaud” galerij) beschikbaar, waarin u vele grappige voorbeelden van gedecoreerde aardappelen, pinguins en aquariums kunt terugvinden. U kunt uiteraard uw eigen creaties naar de programmeur Eric Bischoff sturen. Hij zal ze toevoegen aan het museum zodra hij tijd heeft.

KTuberling kan ook “praten”. Het zal de naam van de objecten die u versleept uitspreken. Het “spreekt” in de taal die u hebt uitgekozen. U kunt het programma zo ook gebruiken om een paar vreemde woorden te leren. KTuberlingspreekt” momenteel Deens, Duits, Engels, Spaans, Frans, Italiaans, Portugees, Roemeens, Slowaaks, Sloveens, Zweeds en natuurlijk Nederlands.

Terug
Volgende
Begin


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Hoofdstuk 2. Grondbeginselen
Grondbeginselen
Terug
Volgende

Hoofdstuk 2. Grondbeginselen

De muis

Er bevinden zich twee gebieden in het hoofdvenster:

  • Het “Speelveld”, links.

  • Het “objecten”veld, rechts. Hier kunt u de objecten kiezen die u wilt plaatsen in het speelveld.


Hoofdvenster

Een object plaatsen

Om een object te verslepen, verplaats de muisaanwijzer naar het “objecten”gebied rechts. Klik op het object dat u wilt verslepen en houdt de muisknop ingedrukt terwijl u het object met de muisaanwijzer naar de plek in het “speelveld” hebt gesleept waar u het wilt neerzetten.

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. Als u op een object klikt wordt deze boven alle andere objecten geplaatst die het eerder 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”.

De werkbalk
De werkbalk

De werkbalk


Werkbalk

De werkbalk bevat knoppen voor de meestgebruikte functies.

Tabel 2.1. Werkbalkknoppen

KnopNaamBijhorende menuoptieActie
Knop voor nieuw spel Nieuw Spel->Nieuw Wist het “speelveld”-gebied. Dit verwijdert alle onderdelen van het speelveld zodat er een nieuwe decoratie kan worden gemaakt.
Knop laden Laden Spel->Laden... Opent een bestaand Tuberling-bestand uit het museum of uit een andere map.
Knop opslaan Opslaan Spel->Opslaan Bewaart uw creatie in uw persoonlijke map, of in een andere map als u dat liever hebt. De Tuberling wordt opgeslagen in een klein bestandje waarin alleen de posities van de objecten zijn geplaatst.
Knop afdrukken Afdrukken Spel->Afdrukken Drukt uw afbeelding af (PostScript®-formaat).
Knop ongedaan maken Ongedaan maken Bewerken->Ongedaan maken Maakt de laatste handeling ongedaan.
Knop opnieuw Opnieuw Bewerken->Opnieuw Voert de laatste ongedaan gemaakte handeling opnieuw uit.


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

De menuopties
De menuopties

De menuopties


Menubalk

Het menu Spel


Bestand Menu
Spel->Nieuw (Ctrl+N)

Wist het “speelveld”-gebied.

Spel->Laden... (Ctrl+O)

Opent een bestaand Tuberling-bestand uit het museum of een andere locatie.

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 illustratie van uw Tuberling en slaat deze op in een bestand. De beschikbare afbeeldingsformaten zijn XPM, JPEG, PNG en BMP.

Spel->Afdrukken... (Ctrl+P)

Drukt uw Tuberling-illustratie af met behulp van het PostScript®-formaat.

Spel->Afsluiten (Ctrl+Q)

Beëindigt KTuberling.

Het menu Bewerken


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”-gebied naar het klembord.

Het menu Speelveld


Menu Speelveld
Speelveld->Aardappelmannetje

Schakelt naar het speelveld met de aardappel. KTuberling onthoudt de laatst gekozen speelveld de volgende keer dat het programma wordt gestart.

Speelveld->Pinguin

Schakelt naar het speelveld met de pinguin. KTuberling onthoudt de laatst gekozen speelveld de volgende keer dat het programma wordt gestart.

Speelveld->Aquarium

Schakelt het speelveld naar het aquarium. KTuberling onthoudt de laatst gekozen speelveld de volgende keer dat het programma wordt gestart.

Het menu Spraak


Menu Spraak

Onthoud dat u kdemultimedia geïnstalleerd dient te hebben en dat het geluidssysteem artsd dient te draaien om geluiden te kunnen horen.

Spraak->Geen geluid

Zet het geluid uit. KTuberling onthoudt deze instelling bij de volgende programmastart.

Spraak->Deens

Zet het geluid aan en spreekt Deens. Als de Deense geluiden niet zijn geïnstalleerd, dan is deze optie inactief en grijs gemaakt. KTuberling onthoudt deze optie bij de volgende programmastart.

Spraak->Nederlands

Zet het geluid aan en spreekt Nederlands. Als de Nederlandse geluiden niet zijn geïnstalleerd, dan is deze optie inactief en grijs gemaakt. KTuberling onthoudt deze optie bij de volgende programmastart.

Spraak->Engels

Zet het geluid aan en spreekt Engels. Als de Engelse geluiden niet zijn geïnstalleerd, dan is deze optie inactief en grijs gemaakt. KTuberling onthoudt deze optie bij de volgende programmastart.

etc...

Hetzelfde geldt voor de andere talen.

Het menu Help


Menu Help
Help->KTuberling handboek...

Roept het handboek van KTuberling op (dit document).

Help->Wat is dit? (Shift+F1)

Verandert de muiscursor in de combinatie pijltje en vraagteken. Het klikken op items in KTuberling zal een tekstballon tonen (als er een beschikbaar is voor dat specifieke item) met een omschrijving van de functie van dat item.

Help->Bug rapporteren...

Opent het bugrapport-dialoogvenster waar u een een bug kunt melden of een “suggestie” kunt indienen die deze toepassing beter, handiger of nuttiger zou kunnen maken.

Help->Info over KTuberling

Deze optie zal informatie over de versie en de auteurs tonen.

Help->Over KDE

Dit zal de KDE-versie en andere standaardinformatie tonen.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Terug
Volgende
Begin


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Hoofdstuk 3. Technische referentie
Technische referentie
Terug
Volgende

Hoofdstuk 3. Technische referentie

Eric Bischoff

Vertaling van het handboek: Niels Reedijk
Herziening 0.03.02 (2002-04-10)

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 ontwikkelaar Eric Bischoff zodat ze in toekomstige versies kunnen worden bijgesloten.

Voor artiesten

De grootte en vorm van het speelveld en het aantal objecten kan worden gewijzigd. Nieuwe speelvelden kunnen worden toegevoegd. U hoeft slechts twee afbeeldingsbestanden te maken voor elk speelveld: een spelbord en een masker. Er zijn maximaal 8 speelvelden mogelijk, waarvan momenteel slechts 3 worden gebruikt.

Er worden zes afbeeldingen gebruikt in KTuberling: potato-game.png, potato-mask.png, penguin-game.png, penguin-mask.png, aquarium-game.png en aquarium-mask.png. De standaardlocatie voor deze bestanden is de map $KDEDIR/share/apps/ktuberling/pics/.

Het eerste type afbeeldingen, *-game.png bevatten het speelveld en de objecten die de gebruiker selecteert. Het is de illustratie die de gebruiker ziet tijdens het spelen van het spel.

Het tweede type afbeeldingen, *-mask.png bevat alleen de masker van de objecten. De maskers worden gebruikt om de randen van de objecten te bepalen, en, in sommige gevallen, het object enige transparantie te geven (bijv. de brillenglazen). Het is vereist dat de objecten op dezelfde positie in het spelbord-bestand en maskerbestand worden geplaatst.

In dezelfde map is een bestand genaamd layout.xml te vinden ($KDEDIR/share/apps/ktuberling/pics/layout.xml). Dit bestand vertelt welke afbeeldingen gebruikt dienen te worden en koppelt ze aan menuopties. Het bevat ook de positieparameters van het speelveld en de objecten in het spelbord en in de maskers. Het koppelt de geluiden aan objecten en plaatst de objecten in groepen. Tot slot declareert het talen als sets vertaalde geluiden. Het volgt de standaard XML-syntaxis (zie hieronder voor meer details).

In dezelfde map bevindt zich ook een bestand genaamd layout.i18n ($KDEDIR/share/apps/ktuberling/pics/layout.i18n). Deze bevat de tekenreeksen uit layout.xml die kunnen worden vertaald:

  • De menuopties die gebruikt worden om het speelveld en de taal te selecteren

  • De namen van de objectcategorieën

Een map hoger bevindt zich een bestand genaamd ktuberlingui.rc ($KDEDIR/share/apps/ktuberling/ktuberlingui.rc). Dit is een XML-bestand dat de menu's van KTuberling beschrijft. Dit bestand dient één <action>-tag per speelveld en taal te bevatten. De symbolische naam van de actie in dit bestand dient identiek te zijn aan de symbolische naam van de actie in layout.xml.

Vertaling
Vertaling

Vertaling

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

Als vertalers hun stem kunnen opnemen als .ogg of .wav-bestand dan kunnen ze deze opslaan in de taalspecifieke submap van de geluidenmap. (.wav-bestanden dient u eerst om te zetten naar .ogg, lees verderop in de documentatie hoe u dat doet.) De naam van het geluid dient dan te worden toegewezen aan een bestand in het bestand layout.xml. Bijvoorbeeld, als de doeltaal Italiaans is, dan kunnen de vertalers hun stem opnemen in .ogg-bestanden in de map $KDEDIR/share/apps/ktuberling/sounds/it. Vervolgens kunnen ze het geluid genaamd “hat” toewijzen aan de bestandsnaam it/cappello.ogg.

De huidige versies van KTuberling maken gebruik van het bestandsformaat OGG Vorbis rc3 voor de geluiden. U kunt uw WAV-bestanden omzetten naar OGG Vorbis rc3 door middel van het volgende commando:

$ oggenc_rc3 -o geluid.ogg geluid.wav

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



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Voor programmeurs
Voor programmeurs

Voor programmeurs

KTuberling is voor programmeurs niet moeilijk om uit te breiden.

C++-klassen

TopLevel

TopLevel window en basic program management

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

Action

Een van de gebruikers' manipulatie in de undo/redo stack

Bestandsstructuur van .tuberling

Een .tuberling-bestand bevat alle nodige gegevens om een tuberling te hertekenen. Het kan worden bewerkt met een doorsnee teksteditor.

De eerste regel bevat het nummer van het speelveld.

Op alle andere regels is er een grafisch object per regel, in de volgorde die is gebruikt om ze te tekenen. Elke regel bevat 5 getallen: de identifier van het object en de rechthoek waar het getekend dient te worden (links, boven, rechts, onder). De getallen worden van elkaar gescheiden met witruimtes.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

De structuur van het layout-bestand (layout.xml)
De structuur van het layout-bestand (layout.xml)

De structuur van het layout-bestand (layout.xml)

De tag top-level is uniek en heet <ktuberling>. Het bevat enkele <playground>-tags, een per speelveld, en enkele <language>-tags, een per taal.

De tag <playground> heeft twee attributen: gameboard en masks. Deze attributen geven de naam van de bestanden die de afbeeldingen bevatten. De tag <playground> bevat ook een <menuitem>-tag, een <editablearea>-tag, meerdere <category>-tags en enkele <object>-tags.

De tag <menuitem> beschrijft de action identifier van de menuoptie voor het selecteren van de positie ban het gebied waar u objecten kan plaatsen, en het label voor deze menuoptie. Deze action identifier dient identiek te zijn aan degene in ktuberlingui.rc.

De tag <editablearea> beschrijft de positie van het gebied waar u objecten kunt plaatsen, en de naam van het geluid dat er mee is geassocieerd.

De tag <category> beschrijft de positie en het label van een tekst die een groep objecten beschrijft. Bijvoorbeeld, het kan de positie en de tekst van de groep met “hebbedingetjes” beschrijven.

De tag <object> beschrijft de positie (in het spelbord en in de maskers) van een object en de naam van het bijhorende geluid.

De tag <language> bevat één attribuut: code. Dit attribuut geeft de code van de taal. De tag <language> bevat een <menuitem>-tag en enkele <sound>-tags.

De tags op een lager niveau worden hier niet uitgelegd, aangezien hun betekenis voor zich spreekt. Als u layout.xml bewerkt, vergeet dan niet om ook layout.i18n en ktuberlingui.rc te wijzigen.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Terug
Volgende
Begin


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Hoofdstuk 4. Dankbetuigingen en licentie
Dankbetuigingen en licentie
Terug
Volgende

Hoofdstuk 4. Dankbetuigingen en licentie

KTuberling

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

  • Eric Bischoff - KDE-programmering

  • François-Xavier Duranceau - Tests, advies en hulp

  • Agnieszka Czajkowska - Pinguin-illustraties

  • Bas Willems - grafische verbeteringen en aquarium-thema

  • Roger Larsson - Verbetering van de geluiden

  • Peter Silva - proeflezen van de documentatie

  • Paul Ahlquist - verbeteren van de documentatie

Dit spel is toegewijd aan mijn dochtertje Sunniva Bischoff

Bedankt aan Apple Computer en het LinuxPPC™-project voor het maken van ports van Linux® naar Mac®. KTuberling had nooit bestaan zonder dit!

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.

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

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

Terug
Volgende
Begin


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Bijlage A. Installatie
Installatie
Terug
Volgende

Bijlage A. Installatie

Hoe ktuberling te verkrijgen

KTuberling is een onderdeel van het KDE-project http://www.kde.org/.

KTuberling is een onderdeel van de module kdegames. Deze module kunt u vinden op de FTP-site van het KDE-project: ftp://ftp.kde.org/pub/kde/.

Benodigdheden
Benodigdheden

Benodigdheden

Om KTuberling met succes te compileren hebt u KDE 3.0 nodig. Alle benodigde bibliotheken en KTuberling zelf zijn te vinden op ftp://ftp.kde.org/pub/kde/.

Om de geluiden te kunnen horen hebt u kdemultimedia nodig.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Compilatie en installatie
Compilatie en installatie

Compilatie en installatie

Er zijn een aantal stappen nodig om KTuberling op uw systeem te compileren en te installeren. Voer de volgende commando's uit in de hoofdmap van de broncode van KTuberling:

% ./configure
% make
% make install

Aangezien KTuberling autoconf en automake gebruikt, zouden er bij de compilatie geen problemen mogen voorkomen. Indien u toch problemen tegenkomt, meldt u ze dan in de betreffende KDE-mailinglists.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Terug
Volgende
Begin


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Volgende
 


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team