# Das Handbuch zu &palapeli;

## Einleitung

&palapeli; ist ein Bilderpuzzle-Spiel für einen Spieler.

Das Fenster von &palapeli; ist in die beiden Bereiche Sammlung und Puzzletisch unterteilt. Dieses Handbuch beschreibt diese beiden Bereiche.

## Sammlung durchsuchen

Beim erstmaligen Start von &palapeli; ist die Sammlung mit ein paar standardmäßig mit &palapeli; ausgelieferten Puzzle gefüllt. Sobald auf eines dieser Puzzle geklickt wird startet das Spiel unverzüglich. Das Spiel findet auf dem Puzzletisch statt. Weitere Informationen zur Bedienung des Puzzletisches werden im übernächsten Abschnitt gegeben.

Zusätzlich zur Auswahl des Puzzles kann die Sammlung für folgende weitere Aktionen verwendet werden:

- Erstellen neuer Puzzle aus auf der Festplatte befindlichen Bilder

- Importieren von anderen erstellten Puzzle

- Exportieren von Puzzle zur Weitergabe an andere

- Entfernen von nicht weiter benötigten Puzzle

Der folgende Abschnitt zeigt, wie diese Aufgaben mit den Knöpfen der Werkzeugleiste bewerkstelligt werden.

### Werkzeugleiste

Die Puzzle können mittels Drücken der Strg-Taste und Klick mit der linken Maustaste ausgewählt werden. Das Klicken mit der linken oder rechten Maustaste ohne Drücken der Strg-Taste öffnet das jeweils angeklickte Puzzle auf dem Puzzletisch.

Neues Puzzle erstellen

- Öffnet einen Dialog zum Erstellen eines neuen Puzzles aus einem Bild auf der lokalen Festplatte. Weitere Informationen finden Sie im nächsten Abschnitt

Entfernen

- Die ausgewählten Puzzles werden endgültig aus der Sammlung gelöscht.

  Diese Aktion kann nicht rückgängig gemacht werden.

Aus Datei importieren

- &palapeli;-Puzzle (meist `*.puzzle`-Dateien) können hierdurch in die lokale Sammlung aufgenommen werden. Die Puzzledateien werden aber auch mittels entsprechendem Klick im Dateimanager geöffnet werden. Jedoch erscheinen sie nur nach dem Importieren in der Sammlung und die ursprüngliche Puzzledatei kann danach ohne weitere Auswirkungen auf &palapeli; gelöscht werden.

In Datei exportieren

- Exportiert die ausgewählten Puzzles in Dateien, damit sie an Freunde weitergegeben, im Internet veröffentlicht oder als Sicherungskopie der Sammlung gespeichert werden können.

## Neue Puzzle erstellen

Wie im vorherigen Abschnitt beschrieben, können Sie durch Klicken auf den Knopf Neues Puzzle ersteĺlen in der Puzzle-Sammlung neue Puzzles erstellen.

Damit öffnen Sie einen Dialog, der aus drei Seiten besteht:

1. Auf der ersten Seite wählen Sie ein Bild aus, das in Puzzleteile zerschnitten werden soll. Achten Sie darauf, die richtigen Metadaten für das Bild einzutragen: den Autor des Bildes (⪚ der Maler oder Fotograf). Bitte respektieren Sie das Copyright des Bildautors.

2. Auf der zweiten Seite können Sie die Art der Teile auswählen, in die das Bild zerschnitten werden soll. &palapeli; enthält bereits einige Schnittprogramme, aber Programme von anderen sind möglicherweise auch vorhanden.

3. Auf der letzten Seite des Dialogs richten Sie das ausgewählte Schnittprogramm ein. Dazu wählen Sie ⪚ eine andere Anzahl von Teilen oder verändern die Parameter der Objekte. Die vorhandenen Einstellungen werden durch das verwendete Schnittprogramm vorgegeben.

In diesem Handbuch werden im folgenden die mit &palapeli; gelieferten Schnittprogramme erläutert. Haben Sie andere Schnittmodule für &palapeli; installiert, lesen Sie bei Problemen mit der Installation oder Benutzung die Dokumentation zu diesen Modulen.

### &psc;

Das &psc; erzeugt realistische Puzzleteile aus unterschiedlichen Grundmustern:

Rechteckige Grundform

- Erzeugt die bekannten rechteckigen Puzzleteile.

Fünfeckige Grundform

- Die fünfeckigen Teile mit ungleichen Kantenwinkeln ergeben ein schwer zu spielendes Puzzle, weil die Teile auf ungewohnte Art zusammenpassen.

Sechseckige Grundform

- Erzeugt sechseckige Teile, angeordnet wie Honigwaben.

Rhombentrihexagonale Grundform

- Durch eine besondere Kombination von dreieckigen, sechseckigen und rechteckigen Teilen bilden sie ein Muster, das viele sich überschneidende Kreise erinnert.

Zufällige Grundform

- Dieses Muster steht nur zur Verfügung, wenn Sie das Programm qvoronoi aus dem Paket qhull installiert haben. qvoronoi wird benutzt, um die irreguläre Formen der Puzzleteile aus zufällig gesetzten Punkten zu berechnen.

Für &psc; gibt es mehrere Parameter, die die Form der Teilekanten, insbesondere der Verbindungen beeinflussen. Für alle Parameter gibt es bereits sinnvolle Standardeinstellungen. Außerdem können Sie „Vordefinierte Einstellung“ verwenden, damit ist die Anzahl der Parameter auf ein Minimum reduziert. Folgende Parameter sind normalerweise vorhanden:

Ungefähre Anzahl der Teile

Prozentsatz umgedrehter Kanten

- Die Wahrscheinlichkeit für das Umdrehen jedes Verbindung. Eine Verbindung ist umgedreht, wenn sie in die entgegengesetzte Richtung als in einem regelmäßigen Gitter zeigt. Bei rechteckigen Mustern führt dies zu Teilen mit 3 oder 4 Verbindungen nach innen beziehungsweise außen. Mit dem Schieberegler ganz links erhalten Sie normale regelmäßige Gitter. In der Mitte ist die Richtung der Verbinder zufällig. Ganz rechts ergibt wieder ein regelmäßige Gitter, aber mit einer „veränderlichen“ Regel. Das führt nicht zur Umkehrung aller Verbinder. Im „veränderlichen“ regelmäßigen Gitter hat jedes Teil zum Beispiel vier nach innen oder vier nach außen zeigende Verbinder. Bei irregulären Gitter hat diese Einstellung keine Wirkung.

Kantenabrundung

- Legt fest, wie kurvig die Kanten sind, &ie; wie stark die Ränder ein- und ausgebeult werden. Steht der Schieberegler ganz links, dann erhalten Sie mit Ausnahme der Verbindungen gerade Kanten.

Größe der Verbindungen

- Bestimmt die Größe der Verbindungsteils jeder Kante. Die Voreinstellung (Schieberegler mittig) erzeugt Formen wie im echten Puzzle. Mit dem Schieberegler können Sie die Größe von 50 % bis 150 % ändern. Mit 150 % erhalten Sie ungewöhnlich große Verbindungsteile. Das Programm versucht mit mehreren schritten Kollisionen zu vermeiden. Zuerst wird die Form mehrfach verändert und in kleinen Schritten geschrumpft. Trotzdem gibt es besonders bei großen Verbindungsteilen Fälle, in denen dies Problem nicht gelöst werden kann.

Abrundungen

- Legt fest, wie stark die Abrundung zwischen den Kanten variiert. Ist der Schieberegler ganz links, so sind Dellen und Ausbeulungen alle gleich. Schieben Sie den Regler ganz nach recht, werden sowohl sehr gerade als auch sehr stark gewölbte Ränder erzeugt.

Verbindungsstellen

- Gibt an, wie stark die Position der Verbinder auf der Kante variiert. Steht der Schieberegler ganz links, werden die Verbindungen mittig auf der Kante angeordnet.

Verbindungen

- Gibt an, wie unterschiedlich die Form der Verbindungen ist. Steht der Regler ganz links, sehen die Verbinder alle gleich aus. Ganz rechts ist jeder Verbinder ein Einzelstück.

Stückgröße

- Nur für irreguläre Gitter: Bestimmt den Größenunterschied der Puzzleteile. Mit einem kleinen Wert sind die Größen fast gleich, es entstehen Strukturen wie Kristalle. Höhere Werte erzeugen sowohl sehr kleine wie auch sehr große Puzzleteile.

Schneidemuster anlegen

- Speichert ein Bild des Schnittmusters mit schwarzen Schnittkanten auf weißem Hintergrund unter `~/goldberg-slicer-dump.png`. Ist bereits eine Datei mit diesem Namen vorhanden, wird Sie überschrieben.

### Veraltete Schnittprogramme

Aus historischen Gründen sind in &palapeli; auch die Schnittmuster für „klassische Puzzleteile“ und für „Rechteckige Teile“ enthalten. Diese Schnittprogramme erzeugen einfache rechteckige Teile mit oder ohne Verbindungen. Bei beiden Muster können Sie die Anzahl der Teile und das Seitenverhältnis einstellen. Ziehen Sie den Schieberegler nach links, dann entstehen schmale Teile, ganz rechts dann breite Teile. In der Standardeinstellung entstehen etwa quadratische Teile.

## Spielen auf dem Puzzletisch

Aufbau des Puzzletisches

Das Ziel besteht darin, die vorhandenen Stücke zu einem Bild zusammenzusetzen.

Die Puzzleteile können nach dem Anklicken mit gedrückter linker Maustaste auf dem Puzzletisch frei bewegt werden. Mit gedrückter Strg-Taste oder linker Maustaste können mehrere Puzzleteile mittels Fangband gleichzeitig ausgewählt werden.

Werden zusammengehörige Puzzleteile nebeneinander gelegt, so werden sie automatisch miteinander verbunden (1). Verbundene Puzzleteile können nicht wieder getrennt werden. Anders als beim realen Puzzle können hier keine Puzzleteile miteinander verbunden werden, die nicht tatsächlich zusammengehören.

Die Fortschrittsanzeige unterhalb des Puzzletisches (2) zeigt den aktuellen Fortschritt an. &palapeli; speichert den Fortschritt automatisch nach jedem Spielzug, sodass sich darum nicht mehr gekümmert werden muss.

Mit dem Mausrad oder dem Schieberegler rechts unten (3) kann die Ansicht des Puzzletisches vergrößert oder verkleinert werden. Mit gedrückter rechter Maustaste kann der Puzzletisch verschoben werden.

Die Puzzleteile können nur innerhalb des Puzzlebereiches auf dem Puzzletisch bewegt werden. Dieser wird durch ein leicht erhelltes Rechteck dargestellt. Werden die Puzzlestücke an den Rand (4) bewegt, so vergrößert sich der Puzzletisch, um mehr Platz zu schaffen. In der Nähe des schattierten Rahmens verwandelt sich der Mauszeiger in einen Doppelpfeil und die Größe des Puzzlebereiches kann sodann mit gedrückter Maustaste angepasst werden.

Die Größe des Puzzlebereiches kann mittels dem kleinen Knopf rechts neben der Fortschrittsanzeige (5) festgestellt werden. Die Schattierung um den Puzzlebereich (4) wird dunkler, der Puzzlebereich vergrößert sich nicht mehr automatisch und die Puzzleteile nur noch innerhalb des erhellten Bereiches bewegt werden. Die manuelle Anpassung der Größe des Puzzlebereiches ist weiterhin möglich.

### Maus-Funktionen

Wie im letzten Abschnitt beschrieben kann &palapeli;s Puzzletisch durch Verwenden der Maus auf verschiedene Arten bedient werden. Welche Maustaste welche Aktion auslösen soll kann frei festgelegt werden (siehe Spieleinstellungen). Die nachstehende Zusammenstellung zeigt alle möglichen Mausaktionen:

Größe des Puzzlebereiches durch Ziehen der Kanten ändern

- Standardmäßig ist diese Aktion der linken Maustaste zugeordnet.

Teile durch Ziehen bewegen

- Nachdem ein Puzzleteil ausgewählt wurde kann dieses durch ständiges Drücken der entsprechenden Taste bewegt werden. Sofern mehrere Puzzleteile ausgewählt sind und eines davon bewegt wird, bewegen sich alle ausgewählten Teile. Standardmäßig ist diese Aktion der linken Maustaste zugeordnet.

Ansicht durch Ziehen verschieben

- Standardmäßig ist diese Aktion der rechten Maustaste zugeordnet.

Mehrere Puzzleteile gleichzeitig auswählen

- Sofern in den freien Bereich des Puzzletisches geklickt wird, kann ein Fangband gezogen werden. Beim Lösen der Maustaste werden dann alle Puzzleteile innerhalb des Fangbandes ausgewählt. Alle anderen Stücke sind nicht ausgewählt. Standardmäßig ist diese Aktion der linken Maustaste zugeordnet.

Teile durch Anklicken auswählen

- Sofern auf ein einzelnes Puzzleteil geklickt wird, ist nur dieses ausgewählt. War es bereits ausgewählt, wird die Auswahl aufgehoben. Standardmäßig ist diese Aktion der linken Maustaste (bei gedrückter Strg-Taste) zugeordnet.

Sperre für Größe des Puzzlebereiches umschalten

- Diese Aktion ist mit dem Drücken des Knopfes (5) in der Statusleiste vergleichbar. Standardmäßig ist diese Aktion nicht zugeordnet und kann im Einrichtungsdialog entsprechend zugeordnet werden.

Ansicht waagerecht verschieben und Ansicht senkrecht verschieben

- Standardmäßig ist diese Aktion nicht dem Mausrad zugeordnet. Über den Einrichtungsdialog ist eine entsprechende Zuordnung möglich.

Ansicht vergrößern

- Diese Aktion ist identisch mit dem Bewegen des Schiebereglers (3) in der Statusleiste. Standardmäßig ist dieser Aktion das Mausrad zugeordnet.

### Werkzeugleiste

Puzzle neu starten

- Der bisher gespeicherte Fortschritt wird verworfen und das Puzzle von neuem begonnen.

## Benutzeroberfläche

Die beiden Bereiche von &palapeli; (Sammlung und Puzzletisch) sind durch Karteikarten in das Menü eingebunden. Die beiden anderen Standard-Menüs werden nachstehend beschrieben.

### Das Menü Einstellungen

Einstellungen Statusleiste anzeigen

- Zeigt die Fortschrittsanzeige und Knöpfe im unteren Bereich des Puzzletisches an bzw. blendet sie aus. In der Sammlung hat diese Einstellung keine Auswirkungen.

Einstellungen Kurzbefehle festlegen ...

- Öffnet einen Dialog zum Einstellen der Tastenkürzel für &palapeli;.

Einstellungen&palapeli; einrichten ...

- Öffnet einen Dialog für die Spieleinstellungen. Eine nähere Beschreibung hierzu ist im Abschnitt Spieleinstellungen enthalten.

### Das Menü Hilfe

&help.menu.documentation;

## Spieleinstellungen

Der Einrichtungsdialog wird über das Menü Einstellungen&palapeli; einrichten ... aufgerufen.

### Allgemeine Einstellungen

Hintergrund

- Ein anderer Hintergrund für den Puzzletisch kann gewählt werden. Bei Auswahl von Einfarbig kann die Farbe rechts neben dem Auswahlfeld festgelegt werden.

Erscheinungsbild der Puzzleteile

- Wenn &palapeli; sehr langsam läuft oder lange zum Öffnen von Puzzles braucht, können Sie die grafischen Effekte hier abschalten und dadurch das Spielverhalten beschleunigen.

Einrastgenauigkeit

- Legt fest, wie nahe die zusammenpassenden Teile beieinander sein müssen, damit sie miteinander verbunden werden (einrasten). Wird der Schieberegler weiter nach rechts bewegt, so werden sie schon bei größerer Entfernung miteinander verbunden. Dadurch wird die Bedienung ein bisschen einfacher.

### Maus-Funktionen

Diese Seite des Einrichtungsdialoges ermöglicht die Zuordnung der Maustasten zu den Maus-Funktionen, welche im Abschnitt Puzzletisch beschrieben werden. Die Funktionen sind unterteilt in solche, die den Maustasten (z. B. Ansicht durch Ziehen verschieben) und jenen, die dem Mausrad (z. B. Ansicht waagerecht verschieben) zugeordnet werden können.

#### Karteikarte Maustasten

Neben dem Namen der jeweiligen Aktion befindet sich ein Knopf mit einem Bild einer Computermaus, welche die aktuell zugeordnete Aktionzeigt. Das Festlegen der Aktionen geschieht durch Klicken zunächst mit der linken Maustaste auf diesen Knopf und nachfolgend der gewünschten Maustaste, welcher die Aktion zugeordnet werden soll. Sofern beim zweiten Klicken eine oder mehrere Modifizierungstasten (Strg, Alt, Umschalt oder Windows) gedrückt werden, können die Aktionen auf dem Puzzletisch nur ausgeführt werden, wenn auch die entsprechend festgelegten Modifizierungstasten gedrückt werden.

Keine Maustaste kann dieser Aktion auch durch Drücken der Leertaste zugeordnet werden (sofern Modifizierungstasten dabei gedrückt werden). Bei Keine Maustaste übernehmen die Modifizierungstasten die Aufgabe der Maustaste: Die Aktion beginnt sobald eine Modifizierungstaste gedrückt wird und endet beim Lösen der Modifizierungstaste.

#### Karteikarte Mausrad

Diese Karteikarte ist mit der vorherigen vergleichbar. Wenn der Knopf auf der rechten Seite eine Eingabe erfordert muss hier das Mausrad betätigt werden. Auch hier können die Modifizierungstasten verwendet werden.

Sofern eine Maus mit Mausrad für zwei Richtungen verfügbar ist (meist beim Touchpad von Laptops), kann von dieser Möglichkeit Gebrauch gemacht werden: &palapeli; unterscheidet zwischen waagerechter und senkrechter Bewegung des Mausrades.

## Danksagungen und Lizenz

&palapeli; soll den unaufgeregten Spaß und die Herausforderungen eines Bilderpuzzles auf die Arbeitsfläche von &kde; bringen.

Ursprünglich wurde die Idee von Bernhard Schiffner mit dem derzeitigen Hauptentwickler von &palapeli; Stefan Majewsky entwickelt. Das &psc; wurde von Johannes Löhnert beigesteuert.

Dokumentation © 2009, 2010 Johannes Löhnert, Stefan Majewsky.

Übersetzung: Johannes Obermayr johannesobermayr@gmx.de

&underFDL; &underGPL;

## Installieren

&install.intro.documentation;

### Kompilieren und Installieren

&install.compile.documentation;
&documentation.index;