# &ktuberling; håndbog

Eric
Bischoff

    e.bischoff@noos.fr

Paul
E.
Ahlquist
Jr.

    pea@ahlquist.org

Lauri
Watts
Tester
Erik Kjær
Pedersen

    erik@binghamton.edu

Oversætter
2001-02-23
0.01.00
1999
2000
Eric Bischoff
2001
Paul E. Ahlquist Jr.
&FDLNotice;

&ktuberling; er et spil beregnet til små børn.

KDE
KTuberling
spil
kartoffel
tuberling
børn

## Indledning

&ktuberling; er et spil beregnet til små børn. Det kan selvfølgelig også nydes af voksne der er forblevet unge af sind.

Det er en kartoffelredigerer. Det betyder du kan trække og slippe øjne, munde, overskæg, og andre dele af ansigtet og sjove ting på en kartoffellignende fyr.

Der er ingen vinder i spillet. Det eneste formål er at lave det sjovest mulige ansigt.

Der er et museum (ligesom Madame Tusseau galleriet) hvor man kan finde mange morsomme eksempler på dekorerede kartofler. Du kan selvfølgelig sende dine egne kreationer til programmøren, Eric Bischoff, som vil inkludere dem i museet hvis han får noget tid til overs.

## Fundamentale ting på skærmen

### Museoperation

Der er to områder i hovedvinduet:

- Kartoffel området til venstre.

- Objekt området til højre, hvor du vælger objekter til at placere på din kartoffel!

Hovedvinduet for &ktuberling; :
Hovedvinduer

#### Placering af objekt

Flyt musemarkøren hen i objekt området i højre side for at trække et objekt. Klik på objektet du ønsker at trække, men giv ikke slip på museknappen før du har flyttet musemarkøren hen til det sted i kartoffel området hvor du ønsker at droppe objektet.

#### Flytning af et objekt

Efter det er droppet i kartoffel området, kan objektet stadig flyttes. Klik blot på et objekt for at vælge det til yderligere træk og slip. Når du klikker på det kommer det ovenpå de andre objekter der delvist skjulte det. Dette trick er nyttigt når briller og øjne skal placeres rigtigt.

#### Fjerne et objekt

For at fjerne et objekt der er blevet droppet i kartoffel området, skal man trække det tilbage fra kartoffel området til objekt området.

### Værktøjslinien

Værktøjslinie

Værktøjslinien giver knapper til de oftest brugte funktioner.

#### Værktøjslinieknapper

Knap | Navn | Handling
--- | --- | ---
| Ny | Nulstiller kartoffel området. Dette rydder alle dele af kartoflen så en ny kartoffelfyr kan laves.
| Åbn | Åbner en eksisterende tuberling fil fra museet eller fra andre mapper.
Gem knap | Gem | Gemmer din kreation til museet, eller til en anden mappe efter ønske. Kartoffelfyren gemmes til en lille fil, hvor kun objekternes position er gemt.
Udskriftsknap | Udskriv | Udskriver dit billede (&PostScript; format).
Fortryd knap | Fortryd | Fortryder sidste operation
Omgør knap | Omgør | Omgør sidste operation.

### Menupunkter

Menulinie

#### Filmenuen

Filmenu

&Ctrl;N Fil Ny

  Rydder kartoffel området

&Ctrl;O Fil Åbn

  Åbner en eksisterende tuberling fil fra museet eller fra et vilkårligt andet sted hvis du ønsker det.

&Ctrl;S Fil Gem

  Gemmer din kreation. Kartoffelfyren gemmes til en lille fil hvor kun objekternes position gemmes.

Fil Gem som billede...

  Laver en grafik fil der indeholder et billede af din kartoffelfyr. Tilgængelige formater er XPM, JPEG, PNG og BMP.

&Ctrl;P Fil Udskriv

  Udskriver dit kartoffelfyrbillede ved brug af &PostScript; formatet.

&Ctrl;Q Fil Afslut

  Afslutter &ktuberling;.

#### Redigeringsmenuen

Redigeringsmenuen

&Ctrl;C Redigér Kopiér

  Kopiér kartoffel området til klippebordet.

&Ctrl;Z Redigér Fortryd

  Fortryd sidste objekt placering.

&Ctrl;Shift Z Redigér Omgør

  Omgør den sidste objekt placering. Dette menuvalg er kun aktivt hvis du tidligere har brugt Fortryd.

#### Indstillingsmenuen

Indstillingsmenu

Indstillinger Lyd

  Slår lyd effekter til/fra. Hvis `artsd` ikke kører er dette menupunkt deaktiveret.

#### Hjælpemenuen

Hjælpemenu

F1 Hjælp Indhold

  Viser denne håndbog.

Shift F1 Hjælp Hvad er dette

  Få hjælp til et punkt ved at klikke på det. Denne egenskab er ikke fuldt ud implementeret. Det skader ikke at lege med dette valg.

Hjælp Rapportér problem...

  Rapportér et problem eller bed om en forbedring af &ktuberling;.

Hjælp Om kTuberling

  Viser information om programmet. Er også godt for forfatternes egoer.

Hjælp Om KDE

  Fortæller om et af de bedste &UNIX; relaterede projekter.

## Teknisk reference

&ktuberling; tilbyder en blid og taknemlig introduktion til &kde; brugerindstilling og programmering. Programmet kan udvides. For eksempel, kan man tilføje nye grønsagsfyre ved at ændre grafikfilerne uden nogen kodning. Ved at tilføje passende lydfiler, kan oversættere ændre lyden til deres eget sprog.

Hvis du udvider eller tilføjer til spillet, så overvej venligst at sende dine tilføjelser til udvikleren Eric Bischoff for inklusion i fremtidige udgaver.

### Grafik

Størrelsen og formen af spillebrættet og antallet af objekter kan ændres. Kun to filer behøver at blive oprettede: et spillebræt og en maske.

To billeder bruges i &ktuberling;: `gameboard.xpm` og `masks.xpm`. Standard placeringen af disse filer er i mappen `$KDE/share/apps/ktuberling/pics/`. `gameboard.xpm` holder spillebrætter og objekterne som brugeren vælger. Det er den grafik som brugeren ser når spillet kører.

Den anden fil, `masks.xpm`, indeholder kun masker for objekterne. Maskerne bruges til at begrænse kanterne af objekterne og i visse tilfælde, give objekterne noget gennemsigtighed (for eksempel, brillerne). I de distribuerede `masks.xpm` er objekterne duplikerede fra `gameboard.xpm`. Dette stammer fra den oprindelige kunstners teknik. Kun masker, de stencillignende billeder, i `masks.xpm` bruges af programmet.

Den tredje fil i mappen, `layout.txt`. (`$KDE/share/apps/ktuberling/pics/layout.txt`) indeholder positionsparametre for objekterne og maskerne. Den tilknytter også lyde til objekterne og placerer objekterne i grupper. Denne fil ændres for at beskrive grafikken til programmet. Den indeholder kun decimaltal, adskilt af mellemrum, fulgt af en kommentar.

       0   0  240 320          0 Område hvor objekter kan droppes
                    6             Antal tekster beskrevet her
     241 101  413 115          0 "Øjne" tekst
     415 123  511 137          1 "Øjenbryn" tekst
     241 179  394 193          2 "Næser" tekst
     395 179  511 193          3 "Ører" tekst
     241 259  445 273          4 "Munde" tekst
     241 307  511 321          5 "Gode ting" tekst
                       43         Antal objekter beskrevet her
     242   0  283  32      70   0  111  32      1 Øje #1
     242  34  283  66      70  34  111  66      1 Øje #2
     242  68  283 100      70  68  111 100      1 Øje #3
      :
      :

Udlægning af overskriftlinie.

Denne linie beskriver området af spillebrættet hvor objekterne er placerede (kartoffelområdet). De første fire tal er koordinaterne for området til venstre, top, højre og bund. Det femte tal er indekstallet for den associerede lyd. Lydene er definerede i kildefilen `categories.h`.

Mængde gruppeetiketter

Denne anden linie, er antallet af gruppetekst etiketter definerede i næste sektion af denne fil.

Etiketpositioner

Disse linier beskriver positionen af tekstetiketterne for grupper eller kategorier af objekter. Teksten på etiketten kan kun ændres i kildekoden (`categories.h`). Kun positionen af etiketterne kan ændres her.

Mængde af objekter

Denne linie er antallet af objekter beskrevet i næste sektion af filen. Justér dette tal hvis du tilføjer eller fjerner objekter.

Individuelle objekter

I denne sektion er hver af de individuelle objekter beskrevet. Positionen af objekterne i `gameboard.xpm` og positionerne af maskerne i `masks.xpm`. De første fire tal er koordinater til objektrektanglet på spillebrættet, venstre, top, højre, bund. Det femte til ottende er koordinaterne for objektets maske, samme rækkefølge. Det niende tal er indekset for den associerede lyd. Adskillige objekter kan associeres med den samme lyd.

### Oversættelse

Foruden den sædvanlige `.po`-fil mekanisme for oversættelse af program etiketter og spørgsmål, kan lydene også lokaliseres.

Hvis de forskellige oversættere optager deres stemmer til en `.wav` fil, kan de gemme denne fil i den sprogspecifikke undermappe af lydmappen. Navnet på lydfilen oversættes så i `.po` filen. For eksempel, hvis sproget er italiensk, kan oversætteren optage sin stemme i `.wav` filer placeret i `$KDE/share/apps/ktuberling/sounds/it`. Så kan man oversætte filnavne såsom `en/hat.wav` til navne såsom `it/capello.wav`.

Information om hvordan man arbejder med oversættelsesmekanismen i &kde; er tilgængelig i KDE Oversættelse HOWTO.

### For programmører

&ktuberling; er ikke særlig svær at udvide for programmører.

#### C++ klasser

`TopNiveau`

  Top-niveau vindue og basal program håndtering

`ToDraw`

  Beskrivelse af et af de grafiske objekter der skal tegnes

#### `.tuberling` filer struktur

En `.tuberling` fil holder alle de nødvendige data to for at tegne en tuberling. Den kan redigeres med en normal tekstredigering.

Der er et grafisk objekt pr linie, i den rækkefølge der er brugt til at tegne dem. Hver linie indeholder 5 tal: identifikatoren for objektet, og rektanget hvor den skal tegnes (venstre, top, højre, bund). Tallene er adskilte af mellemrum.

## Medvirkende og licens

&ktuberling;

- John Calhoun - Oprindelig ide, billeder og engelske lyde

- Eric Bischoff ebisch@cybercable.tm.fr - &kde; Programmering

- François-xavier Duranceau duranceau@free.fr - Tester, råd og hjælp

- Peter Silva peter.silva@videotron.ca - Korrekturlæsning af dokumentationen

- Paul Ahlquist pea@ahlquist.org - Reformatterede og tilføjede skærmaftryk for &kde; 2.1. Udvidede grafik sektionen af den tekniske reference.

Dette spil er dedikeret til min lille datter Sunniva Bischoff

Tak til Apple Computer og til &LinuxPPC; projektet for at have overført &Linux; til &Mac;. &ktuberling; ville ikke have eksisteret uden det!

Dansk oversættelse ved Erik Kjær Pedersen erik@binghamton.edu

&underFDL; &underGPL;

## Installation

### Hvordan får man fat på ktuberling

&ktuberling; er et spil for &kde; projektet http://www.kde.org. &ktuberling; kan findes på ftp://ftp.kde.org/pub/kde/, hoved &FTP;-stedet for &kde; projektet.

### Krav

For at kompilere &ktuberling;, har du brug for de nyeste versioner af `libkdecore`, `libkdeui`, `libkfile`, `libkfm`, og `libmediatooli`. Alle nødvendige biblioteker så vel som &ktuberling; selv findes på ftp://ftp.kde.org/pub/kde/.

### Kompilering og installation

For at kompilere og installere &ktuberling; på dit system, skal du skrive følgende i basismappen for &ktuberling; distributionen:

    % ./configure
    % make
    % make install