----------------------------------------------------------------------
-                                                                    -
-              LevelCopy  -  der Pushem Level-Kopierer               -
-                                                                    -
-                von Peter Groth und Markus Uhlendahl                -
-                                                                    -
----------------------------------------------------------------------



Einleitung
----------

Mit dem Leveleditor von Pushem lassen sich komfortabel neue Level
erstellen, mit denen Sie andere Spieler vor schwierige Knobelaufgaben
stellen können. Um diese Level anderen zugänglich zu machen, müssen
sie kopiert werden. Diese Aufgabe nimmt LevelCopy wahr. Mit LevelCopy
lassen sich Level sortieren, kopieren oder löschen. Auf einfache Weise
können an den bisherigen Bestand neue Level angefügt werden.

Wer Fragen zu einem unser Programme hat, wird gebeten uns einen an sich
adressierten und freigemachten Briefumschlag zu schicken. Wir bemühen
uns so schnell wie möglich zu antworten und Ihr Problem zu lösen.
Adresse können Sie dem Text 'Copyright.dok' entnehmen.


Dateiorganisation
-----------------

LevelCopy kann Level aus jedem Verzeichnis in jedes Verzeichnis
kopieren. Pushem jedoch erwartet eine ganz bestimmte Verzeichnis-
struktur, die unbedingt eingehalten werden muß. Da LevelCopy selbst
keine Verzeichnisse erstellt, sollte man dafür sorgen, daß eine
entsprechende Struktur im Zielverzeichnis vorhanden ist bevor man
LevelCopy startet.
In dem Verzeichnis, in dem auch Pushem steht, muß ein Verzeichnis mit
dem Namen 'Levels' existieren, in dem sich die Unterverzeichnisse
'OnePlayer' und 'TwoPlayer' befinden.
Wichtig ist außerdem, daß beim Start von Pushem mindestens ein Level
für einen Spieler und einer für zwei Spieler im entsprechenden Ver-
zeichnis ist.



Bedienung
---------

Nach dem Start von LevelCopy öffnet sich auf der Workbench ein Fenster
mit verschiedenen Schaltern und Feldern.
In den beiden Feldern unten im Fenster werden die gerade angewählten
Level dargestellt. Ist kein Level angewählt, sind sie schwarz.
Direkt darüber stehen die Nummern der gewählten Level.
Links im Fenster befindet sich ein großes Feld, in dem alle Level des
gerade aktiven Verzeichnisses angezeigt werden. Ist dieses Feld leer,
wurde entweder ein nicht existierendes oder ein leeres Verzeichnis
angewählt.
Mit dem Rollbalken direkt daneben läßt sich der angezeigte Ausschnitt
verschieben. Durch einen Mausklick auf eine Levelnummer läßt sich der
entsprechende Level anwählen. Er wird dann im linken unteren Feld
dargestellt.
Auf der rechten Seite des Fensters befindet sich ein ähnliches Feld,
in dem alle Level des internen Speichers von LevelCopy angezeigt
werden. In diesem internen Speicher können Level zusammengestellt
werden, die dann zusammen auf Diskette/Festplatte geschrieben werden.
Auch hier läßt sich der angezeigte Ausschnitt mit dem Rollbalken ver-
schieben und ein Level per Mausklick anwählen.
Das aktuelle Verzeichnis läßt sich mit dem String-Gadget oben links
wählen. Hier muß der komplette Pfad eines Levelverzeichnisses ange-
geben werden. Jede Eingabe muß mit <RETURN> abgeschlossen werden.
Nach der Auswahl eines Verzeichnisses (z.B. 'DF0:Levels/OnePlayer')
werden alle Level im linken Feld angezeigt.

In der Mitte des Fensters befinden sich die Schalter für die ver-
schiedenen Funktionen von LevelCopy:

Add     - fügt den gewählten Level des linken Auswahlfeldes an das Ende
          des internen Speichers an

Insert  - fügt den aktiven Level des linken Feldes an der gewählten
          Position in den internen Speicher ein

Delete  - löscht den gewählten Level aus dem internen Speicher

Add all - fügt alle Level des aktiven Verzeichnisses an das Ende des
          internen Speichers an

Del all - löscht alle Level aus dem internen Speicher

Write   - schreibt alle Level des internen Speichers in das aktuelle
          Verzeichnis, alle dort bereits vorhandenen Level werden
          vorher gelöscht (!!!)

Append  - hängt alle Level des internen Speichers an die Level des
          aktuellen Verzeichnisses an, Level 000 des internen
          Speichers bekommt also eine um 1 höhere Nummer als der
          letzte Level des Verzeichnisses usw.


Um die Sortierung der Level zu erleichtern, werden im linken Auswahl-
feld alle bereits kopierten Level mit einem Sternchen gekennzeichnet.
Außerdem wird bei den Leveln des internen Speichers vermerkt, von
welcher Nummer des aktuellen Verzeichnisses sie kopiert wurden.
Wird das aktuelle Verzeichnis gewechselt, erscheint statt der alten
Levelnummer jeweils ein Sternchen.



Beispiel
--------

Sie haben von einem Freund eine Diskette mit neuen Pushem Leveln
bekommen und wollen diese auf Ihre Diskette kopieren. Die neue
Diskette mit dem Namen 'PushemLevels' enthält folgende Dateien:

OnePlayer (dir)
   Level000
   Level001
   Level002
   Level003
   MaxLevel   (Die MaxLevel-Datei muß in jedem Levelverzeichnis
               vorhanden sein. Sie wird automatisch von LevelCopy
               erzeugt)
TwoPlayer (dir)
   Level000
   Level001
   Level002
   MaxLevel

Ihre Pushem Diskette heißt 'Pushem' und enthält folgende Dateien:

Pushem       (Dies ist das Spiel Pushem)
Pushem.info
Levels (dir)
   OnePlayer (dir)
      Level000
      Level001
      Level002
      Level003
      Level004
      MaxLevel
   TwoPlayer (dir)
      Level000
      Level001
      MaxLevel

Um Ihre Levelsammlung zu ergänzen, gibt es zwei Möglichkeiten:

1. Sie geben als aktuelles Verzeichnis 'Pushem:Levels/OnePlayer' an
   und kopieren mit <Add all> alle alten Level in den internen
   Speicher (Sie können sie natürlich auch umsortieren, indem Sie die
   Level einzeln hinzu- oder einfügen).
   Danach wechseln Sie das aktuelle Verzeichnis nach
   'PushemLevels:OnePlayer' und fügen die neuen Level mit <Add all>
   (oder mit <Add> und <Insert>) an die Level im internen Speicher an.
   Jetzt wechseln Sie wieder ins Verzeichnis 'Pushem:Levels/OnePlayer'
   und schreiben den internen Speicher komplett mit <Write> auf Ihre
   Diskette.
   Das gleiche Verfahren wenden Sie dann für die Zwei-Spieler-Level
   (im Verzeichnis 'Pushem:Levels/TwoPlayer') an.

2. Sie geben als aktuelles Verzeichnis 'PushemLevels:OnePlayer' an und
   kopieren die neuen Level mit <Add all> in den internen Speicher.
   Dann wechseln Sie in das Verzeichnis 'Pushem:Levels/OnePlayer' und
   fügen die neuen Level mit <Append> an Ihre alten Level an.
   Das gleiche gilt wieder für die Zwei-Spieler-Level.

Die zweite Methode hat den Vorteil, daß das Kopieren schneller geht,
bei der ersten kann man dafür die Reihenfolge der Level beliebig
ändern.



...abschliessend noch ein paar wichtige


Bemerkungen
-----------

- ändern Sie niemals das aktuelle Verzeichnis während LevelCopy
  irgendeine Funktion ausführt!!!

- denken Sie daran, jede Änderung des Verzeichnisnamens mit <RETURN>
  abzuschliessen!!!

- erstellen Sie immer die notwendigen Verzeichnisse bevor Sie
  LevelCopy starten



