
 YAPT - Yet an other Planets Tool                (c) 1993 Nils Pipenbrinck 
                  

  Yapt ist Shareware.


  Das heit, Du hast das Recht dieses Programm fr 30 Tage kostenlos zu
  benutzen und zu testen. Wenn Du das Programm gut findest, und es auch
  nach dieses 30 Tagen benutzt, dann mut Du eine registrierte Version
  bei mir bestellen. Ich bernehme brigens keine Verantwortung jeglicher
  Schden, die dieses Programm anstellt. Ich hab's zwar sehr sauber pro-
  grammiet, aber leider gibt's derart viele PC's, das es sein kann, das
  es nicht auf jedem Rechner problemlos luft. (Deshalb auch Shareware).

  Achja: Last but not least: Der Preis dieses Programms: 10,- (Inflation!)
  ------------------------------------------------------------------------

  Ich habe mich entschlossen, dieses Programm ohne jeglicher Einschrnkungen
  oder Zeitbegrenzungen zu verffentlichen. Das sollte fr Dir die Ent-
  scheidung erleichtern, mir ebenso entgegenzukommen, und Dich bei mir
  registrieren zu lassen.

  Teile des Programms sind Copyright by Borland. (die Laufzeitbibliothek,
  Fonts und vieles andere Mehr) Borland hat jedoch sonst KEINE Rechte oder
  Verpflichtungen zum Support auf diesem Programm
  Ingo Hamann hat eine Unit Namens XMS geschrieben. Der XMS und der HMA-
  Mechanismus wurden von Ihm geschrieben. Glcklicherweise war Ingo so nett,
  die Unit als Public Domain herrauszugeben.

  Der Quelltext (in seiner jetzigen Form) ist fr DM 50,- bei mir zu bekommen.
  Melde Dich bei Interesse. Achtung: Du darfst den Quelltext nicht benutzen,
  um damit kommerzielle (also auch Shareware) Programme zu schreiben. Er
  dient lediglich als Information und Lernbeispiel. Bei dem Quelltext sind
  natrlich nicht dabei: Die Passwort dekodierung. Tim Wisseman hat mir den
  Quellcode fr die Passwortabfrage nur unter der Vorraussetzung gegeben, das
  ich sie NICHT weitergebe, und ich halte mich auch daran.

 Contact:  Nils Pipenbrinck           CIS:              100121.2450
           August-Macke-Weg 47        Fido:             2:242/316.8
           22115 Hamburg              VGA Planets Netz: 70:76/3'
           Germany

	    Fr die Bestellung setze Dich einfach mit mir in Verbindung.

 Bank:     Hamburger Sparkasse; BLZ: 20050550; Kontonr: 1332409844

  

 Dieses Tool soll das planen der Zge im VGA-Planets 3.0 Spiel erleichtern.
 Es stellt folgende Dinge dar:

    -   Minefields (aber nur wenn sie 'gescannt' werden. Ships also auf
        Minesweep stellen. Achtung die Minenmeldungen sind von Host zu
        Host unterschiedlich. Auf jeden fall kontrollieren, ob die Felder
        falsch eingezeichnet werden. Die Felder knnen in der Datei YAPT.DAT
        bearbeitet werden. Die erste Zahl ist die Anzahl der Mienenfelder,
        danach kommen jeweilst X-Koordinate, Y-Koordinate, Radius)
    -   Planeten mit deren Namen und ID's (liest auch erstellte Sternen-
        karten ein)
    -   Suchen von Planeten und Schiffen
    -   Messen von Entfernungen
    -   Ships (die Eingenen und die Gescannten. Achtung: Das Programm
        versucht alle Spielerdaten zu lesen. D.H. wenn Du die Zge
        zweier Spieler hast, hast Du auch alle Schiffe sichtbar!)
    -   Geschwindigkeit und Heading der Schiffe (als Vektor dargestellt)
    -   Starbases
    -   Wahlweise Darstellung mit Gitter. Der Abstand zweier Linien ist
        immer 100 Lichtjahre.
    -   Erstellen einer druckbaren Postscript Datei
    -   Erstellen einer Monocrome-BMP-Datei. (Windows Bitmap)
    -   Hypersprung: Schiffe im Hypersprung haben jetzt einen ent-
        sprechend langen Hypersprung-Vektor. Achtung: Das Programm
        kann NICHT erkennen, ob gegnerisch Schiffe einen Hypersprung
        machen oder nicht. Also bitte NICHT wundern, wenn das Programm
        gelegentlich merkwdige Headings anzeigt.
    -   NEU: schneller Zoommode fr Mausbesitzer

                Siehe auch Info ganz am Ende des Textes.
      
 Systemausrstung: 
  

  80286 oder hher.
  Microsoft kompatible Maus
  VGA-Karte (256kB langt)
  Festplatte
  Koprozessor (nicht umbedingt ntig, aber ohne kann das Scrollen in der 
  Sternenkarte ganz schn nervig werden ) Ich habe einen 386+Copro, und bei
  mir ist das Zoomen kein Problem. Ich habe gesehen, wie das Programm auf
  einem 386'er ohne CoPro luft. (von 286 gar nicht zu reden) Ich kann nur
  empfehlen, sich einen CoPro zuzulegen, er kostet z.Z. ca. 100,- und 
  (gerade) das HOST von VGA-Planets profitiert davon.


 Benutzung: 
  
  
  Generelle Hilfe kann man mit yapt /? erhalten. Ansonsten sollten alle
  YAPT-Files in das gleiche Verzeichnis wie VGA-Planets kopiert werden.
  Beim Aufruf von YAPT wird zuerst der Name des Game-Verzeichnises angegeben,
  und dann optionale andere Parameter.  (Versuche auch /?)


 Drucken:
  

 Drucken wird nicht direkt untersttzt. Dies liegt daran, das ich keine Lust
 habe mich mit blden Druckertreibern rumzuschlagen. 

 Um dennoch das Ausdrucken zu ermglichen ist es mglich, eine Sternenkarte
 im .BMP-Format zu erzeugen. Die .BMP-Grafik kann mit fast jedem Mal- bzw.
 Bildbearbeitungsprogramm ausgedruckt werden. Die Bildgenerierung kann u.U.
 Sehr lange dauern. Am lngsten dauert Text und das Rastern der Minenfelder.
 Achtung: Es gibt einen bekannten Bug in der BMP-Save Routine. Dieser tritt
 nicht auf, wenn das Bild in einem der Standard-Modi generiert wurde. Sollte
 bei einem speziellen Mode das BMP-Bild nicht lesbar sein, einfach bei der
 Auflsung 8 Pixel mehr oder weniger nehmen. Sorry for this. Ich habe 
 brigens nicht ausprobiert, wo die maximale Auflsung liegt. Bis 4000
 Pixel luft alles ohne Probleme. Darber geht alles auf eigene Gefahr.
 
 Sollte das Programm whrend des Druckens abstrzen (aus welchen Grnden
 auch immer) wird empfohlen hinterher chkdsk aufzurufen und den Rechner
 neu zu Booten. Es kann sein, das noch Speicher belegt ist, obwohl das
 Programm lngst beendet wurde.
 
 Die Postscript-Ausgabe aus den vorherigen Versionen wird nach wie vor als
 Alternative angeboten. Sie wird aber vorraussichtlich in den nchsten
 Versionen nicht mehr untersttzt werden.

 Bedienung: (Quick Referenz) 
  
   
  Ŀ
    Icon        linke Maustaste               rechte Maustaste          
  Ĵ
    +           zoom in                                                 
    -           zoom out                                                
    hoch        move up                                                 
    runter      move down                                               
    links       move left                                               
    rechts      move right                                              
    l           load default                                            
    s           write default                                           
    r           reset                                                   
                                                                        
    print       Erstellt Screenshoot.                                   
    info        Info ber das Program                                   
    Dist.       Entfernungen Messen (Mouse)                             
    Find        Planeten suchen (nach ID)     Schiffe suchen (nach ID)  
    name        planetennamen anzeigen        raumschiffnamen anzeigen  
    id          planetenid anzeigen           raumschiffid anzeigen     
    grid        gitter einblenden                                       
    mine        Minenfelder einblenden                                  
    ships       Schiffe anzeigen                                        
    bases       Starbases anzeigen                                      
    Head.       Ziele der Schiffe anzeigen.                             
  

   Linke Maustaste in der Starchart bringt den angeklickten Punkt in
   die Mitte des Ausschnittes.

 Zoom: 
  
   
   Rechte Maustaste in der Starchart startet den Zoommode: Es erscheint
   eine kleine Box, die den zu zoomenden Ausschnitt darstellt. Die Box kann
   mit der Maus an jede Position bewegt werden. 
   Vergrern und Verkleinern geht mit drcken der rechten Maustaste.
   Der Zoommode wird mit Druck auf die linke Maustaste beendet. Der im Kasten
   liegende Ausschnitt wird dann zum aktuellen Ausschnitt (sollte eigentlich
   klar sein, wenn nicht... ausprobieren). Wenn eine beliebige Taste
   gedrckt wird, dann wird der Zoomvorgang abgebrochen.
   
   Herrauszoomen ist z.Z. nicht mglich.

   
 Tasten: 
  

    10'er Block:    Wie Steuerblock im Bild oben rechts Num auf on stellen!

    Ansonsten die Anfangsbuchstaben probieren (evtl auch mit Shift. Manche
    Tasten sind doppelt belegt.


 Bugfixes:
  

 * 10.11.1993 Release V1.0

 * 16.11.1993 Release V1.1
   Das Programm stellt nun auch Rebel-Schiffe problemlos dar.
   Das Programm zeigt nun die Richtung der eigenen Schiffe ohne Probleme
   dar (Vorher wurde der Winkel falsch berechnet)

 * 19.11.1993 Release V1.2
    Das Programm zeigt jetzt _wirklich_ die Richtung der eigenen Schiffe
    ohne Probleme an. Ich habe jedoch das Gefhl, das da noch etwas buggy
    ist, also bitte mit Vorsicht genieen.
    Neu: direkter Zoom aus der Sternenkarte
    Neu: Jetzt auch Version fr Rechner ohne Co-Prozessor

 * 23.11.1993 Release V1.3
   Interne Optimierungen und einige Bugfixes.

 * 26.11.1993 Release V1.4
   Bugfix: Jetzt werden die Pfeile TATSCHLICH Richtig gezeichnet.
   Bugfix: Auch Minenfelder mit irre viel Minen werden ohne Probleme
           dargestellt.
   Bugfix: Jetzt luft es auch wirklich ohne Co-Prozessor.
   Neu: Mit dem Print-Button kann jetzt entweder wie gehabt eine Postscript
        Ausgabe erreicht werden, oder aber auch eine Zeichnung im .BMP-
        Format errechnet werden. (bis zu 8" in 360x360 dpi)
   Neu: Jetzt knnen auch eigene Grafinparamete eingegeben werden (Achtung:
        Ich hab nicht ausprobiert, wo die Grenzen liegen.....)
   Neu: Das Programm hat jetzt ENDLICH eine Passwortfunktion. Glcklicher-
        weise war Tim Wisseman so nett und hat mir den Code gegeben.
   Neu: Jezt mehr Sicherheit, wenn mehrere Spieler auf einem Rechner
        die Zge machen (jedem sein Config-File ect.)
   Neu: Die eigenen und die feindlichen Minenfelder werden jetzt unter-
        schiedlich dargestellt und ausgedruckt.
   Neu: Mit dem Dist. Button kann jetzt die Entfernung zweier Punkte be-
        rechnet werden.
   Neu: Mit dem Find-Button knnen jetzt Planeten und Schiffe gesucht werden.

   nderung: Mit den Funtionstasten kann nicht mehr der Player umgeschaltet
             werden.
   nderung: Die Command-Line Switsches haben sich leicht gendert. 1-9,a,q
             wird nicht mehr ausgewertet.
   nderung: Mit dem Command-Line Switch 'b' kann jetzt das scannen der
             Basedaten unterbunden werden

 * 26.11.1993 Release V1.5
   Irgendjemand hat sich die Freiheit genommen das Archiv 1.4 in 1.5 umzu-
   benennen. Da mir das im Prinzip egal ist kommt jetzt:

 * 7.12.1993 Release V1.6
   Bugfix: Funktioniert jetzt auch mit 'dummen' Maustreibern. Achtung:
   sollte die 1.4 oder 1.5 bei Dir nicht funktioniert haben solltest Du
   Dir einen neueren Maustreiber besorgen. Ich bin warscheinlich der Einzige
   Programmierer, der fuer diese Maustreiber eine Extrawurst braet.

                           	to be continued
