@database amigaguide.guide
@rem $Date: 28/04/94 14:41:52 $ $Revision: 2.1 $

@index indi

@node MAIN
@title " - LOGO -  Kurzanleitung 1994"

@{B}


                                                                    |
                                                                   -*-
                                                                    |
    ######  ##       ###    ##### ##   ## ######   #####  ##    ##
    ##   ## ##      ## ##  ##     ##  ##  ##   ## ##   ## ##    ##
    ##   ## ##     ##   ## ##     ## ##   ##   ## ##   ## ##    ##
    ##   ## ##     ##   ## ##     ####    ##   ## ##   ##  ##  ##
    ## ###  ##     ##   ## ##     ###     ## ###  ##   ##   ####
    ##   ## ##     ####### ##     ####    ##   ## ##   ##  ##  ## 
    ##   ## ##     ##   ## ##     ## ##   ##   ## ##   ## ##    ##
    ##   ## ##     ##   ## ##     ##  ##  ##   ## ##   ## ##    ##
    ######  ###### ##   ##  ##### ##   ## ######   #####  ##    ##
@{UB}

   




	Kurzanleitung : 


			@{"   Deutsch   " link GERMAN}

			@{"   Englisch  " link ENGLISCH}
@endnode

@node ENGLISCH "Instructions"


 Still under construction.. Patience is a virtue..

 
@{B}    ** BlackBox **
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯@{UB}


@{B} Legal matters :
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯ @{UB}

COPYRIGHT

	Copyright (c) 1994, Stephan Ilaender, All Rights Reserved.

	This program is @{B}FREEWARE@{UB}. You may freely use and distribute this
	program under the following conditions:

	1) No modifications are made into the program or this documentation
	   and all the files are spread together. However, you are allowed
	   to compress all the files into an archive for distribution.

	2) No money (other than nominal copying fees) is charged for its
	   distribution.

DISCLAIMER

	THIS PROGRAM IS PROVIDED "AS IS" @{B}WITHOUT WARRANTY@{UB} OF @{B}ANY@{UB} KIND,
	EITHER EXPRESSED OR IMPLIED. THE AUTHOR WILL NOT BE LIABLE FOR
	ANY DAMAGES, DIRECT, INDIRECT, INCIDENTAL OR CONSEQUENTIAL,
	RESULTING FROM THE USE OF THE PROGRAM. @{B}THE ENTIRE RISK AS TO THE
	USE OF THIS PROGRAM IS ASSUMED BY THE USER.@{UB}


@{B}1. Rules :
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯ @{UB}
The black box is an 8x8 grid in which several atoms are hidden.
Your job is to find the atoms. You have at your disposal a ray
projector. You can use this to send rays into the box.

A ray may meet with one of three fates. It may hit an atom and
be absorbed, it may be diverted and come out somewhere else or
it may be reflected and come out where it went in.

Rules governing the fate of rays:

@{B}1.@{UB} A ray that hits an atom head on is absorbed and
   never comes back out.
@{B}2.@{UB} A ray that hits an atom to one side is diverted
   90° to that side
@{B}3.@{UB} A ray that passes between two atoms one  square
   apart is reflected, its direction  is  reversed 
   and it retraces its path.
@{B}4.@{UB} A ray that enters alongside an atom is reflected
@{B}5.@{UB} At all other times a ray follows a straight path
@{B}6.@{UB} A ray may bounce off more than one atom

@{B}2. Gameplay :
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯ @{UB}
To send in a ray use the mouse to select the entry point  for
the ray. It will start out travelling vertically or  horizon-
tally depending on which side it enters.

You will be told wether the ray is absorbed by an atom (Entry
point will be marked with a capital A), is  reflected ( Entry
point will be marked with a capital B) or comes out.
If it comes out, you will be told where ( Entrance  and  Exit
will be marked with the same letter).

Put 4 atoms on the grid by selecting grid positions with  the 
mouse. Selecting 'Solve' will compare the actual position  of
the atoms with the user-suggested positions.If the user fails
to locate all atoms penalty-points will be added to his score.

Select the time-limit option to increase the level  of  diff-
iculty. 

@{B}3. Preferences :
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯ @{UB}
(..)

@{B}4. Harddiskinstallation :
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯ @{UB}
Simply drag the BlackBox drawer into a drawer on  your  Hard-
disk. No further assigns needed !

@{B}5. Requirements :
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯ @{UB}
 - AMIGA

 - OS 2.x, 3.x or better..

@{B}6. The Author :
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯ @{UB}
Send suggestions & bug-reports (Bugs ? Me ?) to the following
e-mail adress :

   @{B}corona@uni-paderborn.de@{UB}


@endnode


@node GERMAN "Deutsche Kurzanleitung"




@{"  BlackBox  " link LOGO}   



@{B}0.  Anmerkung :
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯ @{UB}
Diese Anleitung enthält auch  IFF-Grafiken. Diese müsen aber nach
dem  Ansehen  geschlossen  werden  um  weiterlesen  zu können !!!
Um  die  Bilder  anzuzeigen  muß  sich Multiview® im  Verzeichnis 
SYS:Utilities  befinden. Falls  sich die Grafiken aus irgendeinem
Grund  nicht  innerhalb  des Dokuments ansehen lassen, können sie 
mit   jedem  gängigen   Malprogramm / Bildanzeiger   geladen  und 
betrachtet werden. 


@{B}1.  Ziel des Spiels
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯ @{UB}
Ziel  des  Spiels  ist  es,  4 Murmeln zu finden, die auf dem 8x8
Spielfeld versteckt wurden.


@{B}2.  Wie wird gespielt ?
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯  @{UB}
Außerhalb  des  Spielfelds  sind  Knöpfe angebracht, die entweder
horizontal  oder  vertikal einen Strahl in das 8x8 Feld schießen.
Jede  Murmel  ist  von einer  @{"Korona" system "sys:utilities/Multiview iff/Korona.iff"}  (1  Feld in jede Richtung)
umgeben,  welche  den  Strahl  ablenkt,  wenn sie getroffen wird.
Trifft  z.B.   ein  Strahl  der  von  links hineingeschossen wird
oberhalb  einer  Murmel auf deren Korona, so wird der Strahl nach
oben @{"abgelenkt" system "sys:utilities/Multiview iff/Ablenkung.iff"}.   Trifft  ein  Strahl  also  links  oder  rechts
(oberhalb  /  unterhalb)  von einer Murmel auf so wird er von der
Korona im 90 Grad Winkel abgelenkt.  Trifft der Strahl direkt auf
die  Murmel  selbst, wird  er  @{"absorbiert" system "sys:utilities/Multiview iff/Absorbtion.iff"}.   Liegen  die Murmeln
parallel mit einem leeren Feld zwischen ihnen, so wird der Strahl
@{"reflektiert" system "sys:utilities/Multiview iff/Reflektion.iff"} (d.h.   Er  tritt dort wieder aus, wo er in das Feld
hineingeschossen  wurde. )  Wird  bei einer  Kugel  die direkt am
@{"Rand" system "sys:utilities/Multiview iff/RandRef.iff"} liegt in ihre Korona geschossen, so liefert dies immer eine
Reflektion.

  @{"  Ein Beispiel aus der Praxis..        " system "sys:utilities/Multiview iff/Beispiel.iff"}

  @{"  Beispiel für eine korrekte Lösung..  " system "sys:utilities/Multiview iff/Korrekt.iff"}


@{B}3. Ablauf
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯ @{UB}
Nach  Spielbeginn  kann mittels der Knöpfe ein Strahl in das Feld
geschossen werden. Wird der Strahl so @{"abgelenkt" system "sys:utilities/Multiview iff/Ablenkung.iff"}, daß er an einem
anderen  Feld  als  dem Eintrittsfeld austritt, werden Eintritts-
und  Austrittsfeld  durch  den  selben Buchstaben gekennzeichnet.
Trifft  der  Strahl im Laufe seines Weges direkt auf eine Murmel,
wird   das   Eintrittsfeld  mit  einem  großen  A  (=Absorbtion)
gekennzeichnet.   Gleiches gilt für eine Reflektion, welche durch
ein  großes  R  gekennzeichnet  wird.   Für  jeden Schuß werden 2
Punkte  addiert.   Auf dem Feld können 4 Murmeln abgelegt werden,
welche  beliebig  gesetzt  und  gelöscht werden können.  Wenn man
'LÖSEN' anwählt, sollten die selbst gelegten Kugeln jedoch an den
Stellen  liegen,  an  denen man die versteckten Murmeln vermutet.
Der   Computer   überprüft   dann  die  vorgeschlagene  und  die
tatsächliche  Lösung  und  verteilt  entsprechende Punkte.  Durch
anwählen von 'WEITER' kann dann eine neue Runde begonnen werden.


@{B}4. Auswertung
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯@{UB}
Die  zur  Lösung  benötigten  Punkte  werden  addiert, wobei eine
falsch gesetzte Kugel 5 Strafpunkte bedeutet.  Aus der Anzahl der
gespielten Spiele und der erreichten Punkte wird dann der Schnitt
berechnet.   Der  Schnitt  und  die  Anzahl der bisher gespielten
Spiel liegen der Hiscore-Liste zugrunde.



@{B}4.1 Die Voreinstellungen
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯@{UB}
Um  in  der  Hiscore-liste namentlich vermerkt zu werden, muß der
Name   in   den  Voreinstellungen  eingegeben  werden.   Er  kann
nachträglich    jederzeit    durch    erneutes    aufrufen    der
Voreinstellungen  ( durch  Menüeintrag)  verändert  werden.   Der
Vorname erscheint im Spielfenster.

Desweiteren  läßt  sich festlegen, ob die momentane Hiscore-liste
beim beenden von BlackBox gespeichert werden  soll.  Als Optionen
stehen immer, nach Abfrage und nie zur Auswahl.

Außerdem  läßt  sich  festlegen wie oft Warnungen (bzw.  Hinweise
oder Meldungen) erscheinen sollen.  'so oft wie möglich' bewirkt,
daß  fast  jede  Aktion  von  einem  Hinweis  oder  einer Warnung
verbunden ist (besonders geeignet für Anfänger).  Bei 'so oft wie
nötig' wird nur bei unbedingt nötigen bzw.  gefährlichen Aktionen
gewarnt.

Hiscore-Pfad  legt fest, in welchem Verzeichnis die Hiscore-liste
gespeichert   werden   soll.   Voreingestellt  ist  das  logische
Verzeichnis  'S:'.   Sollte  ein  Verzeichnis  gewählt werden, in
welchem  sich  noch keine Hiscore-datei befindet so erscheint die
Warnung,  daß  keine  Hiscore-datei gefunden wurde.  Dies ist für
den  weiteren  Ablauf aber irrelevant und behindert das Speichern
einer Hiscore-datei in keiner Weise.



@{B}4.2 Die Menüleiste
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯@{UB}
@{B}Projekt..@{UB}

 @{I}Neu@{UI}          -  Startet das Spiel neu. Alle Daten gehen verloren.

 @{I}Spiel laden..@{UI}-  Lädt ein gespeichertes Spiel.

 @{I}Spiel speichern..@{UI}- Speichert einen Spielstand.

 @{I}Spielregeln..@{UI}-  Zeigt diese Anleitung an. (Oder die eingebaute 
                 Hilfefunktion falls die Datei BlackBox.guide nicht
                 vorhanden ist.)

 @{I}Information..@{UI}-  Zeigt Namen und Versionsnummer.

 @{I}Ende..@{UI}       -  Beendet das Programm.

@{B}Extras..@{UB}
 
 @{I}Ikonifizieren..@{UI}- Das Hauptfenster wird geschlossen und das Spiel
                  wechselt  in  einen Wartezustand. Auf der Work-
                  bench  erscheint  ein  kleines  Fenster mit dem 
                  Namen BlackBox. Alle Daten  bleiben erhalten. Durch 
                  schliessen  des kleinen  Fensters  gelangt  man 
                  zurück ins Hauptfenster.

 @{I}HS-Liste ansehen..@{UI}- Zeigt  die aktuelle Hiscore-Liste an. Der
                     Name des aktuellen Spielers wird (wenn er 
                     denn  vertreten ist..) in  einer  anderen 
                     Farbe dargestellt.

 @{I}Voreinstellungen..@{UI}- Ruft das Voreinstellungsfenster auf.
                     (jederzeit möglich !).

@{B}Spielmodus..@{UB}

 @{I}Kein Zeitspiel@{UI}   - Das Spiel läuft ohne Zeitlimit. Man kann be-
                    liebig lange nachdenken.

 @{I}Zeitspiel langsam@{UI}- Alle 4 Sekunden wird ein Strafpunkt addiert.
                    (Mehr als 78 Punkte sind nicht vorgesehen)

 @{I}Zeitspiel mittel@{UI} - Alle 3 Sekunden wird ein Strafpunkt addiert.

 @{I}Zeitspiel schnell@{UI}- Alle 2 Sekunden wird ein Strafpunkt addiert.

Anmerkungen :

 - Der Spielmodus kann jederzeit geändert werden.

 - In der Hiscore-liste wird der Spielmodus nicht berücksichtigt.



@{B}5. Status
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯@{UB}
Diese   Programm   ist @{B}++ F R E E W A R E ++@{UB} !!.  Es  darf  frei
kopiert werden sofern diese Anleitung ebenfalls kopiert wird.

Es  ist  jedoch  @{B}nicht@{UB} (!!)  erlaubt  es  komerziell zu nutzen.


6.  @{" Voreinstellung über ToolTypes " link VORE}

7.  @{" Hard-/Softwareanforderungen   " link FORD}

8.  @{" HD-Installation               " link HDIN}

9.  @{" Bekannte Fehler               " link BFEL}

10. @{" Ausblick                      " link AUSB}

11. @{" Updates                       " link REGI}






@endnode

@node HDIN " Harddiskinstallation "


Harddiskinstallation :

Zur Harddiskinstallation reicht es den Ordner von BlackBox auf der Work-
bench in ein beliebiges Verzeichnis der  Festplatte  zu  ziehen. Es
werden keine zusätzlichen assign's oder Zuweisungen  benötigt. Alle  
Dateien die zu BlackBox gehören sollten sich im gleichen Verzeichnis be-
finden. Für die Hiscore-liste benutzt BlackBox  die  Garnet-schrift,
welche  zum  Lieferumfang  der  Workbench  gehört.  Sollte es diese
Schrift nicht finden benutzt BlackBox die Topaz-schrift.

@endnode

@node VORE " Dauerhafte Voreinstellungen "

Die   Voreinstellungen   von  BlackBox werden dauerhaft   in   ToolTypes
gespeichert. Einstellungen im Voreinstellungsfenster haben  jedoch  eine
höhere Priorität. Sie werden beim verlassen des Spiels allerdings  nicht
in den ToolTypes gesichert.

Folgende ToolTypes können gesetzt werden :

Schlüsselwort:                   Werte:           Bedeutung:

HSPATHNAME                       Zeichenkette     Enthält  den Pfadnamen
                                                  für   das  Verzeichnis
                                                  in  das   der  Hiscore 
                                                  gespeichert wird.

SAVESCORE                        ALWAYS           Speichere den HS immer

                                 NEVER            Speichere den HS nie !

                                 INTERACTIVE      Speichere nach Abfrage

NOWARNINGS                       TRUE             Warnung nur wenn nötig

                                 FALSE            Warnungen wenn möglich

TOP                              Zahl (0-16384)   Y-Koordiante des Spiel-
                                                  fensters

LEFT                             Zahl (0-16384)   X-Koordinate des Spiel-
                                                  fensters

FORCEENGLISH                     TRUE             Erzwingt englische  Be-
                                                  nutzeroberfläche   (Für
                                                  User ohne lokalisierbare
                                                  Workbench)

                                 FALSE            Lokalisierung durch WB
                                                  (locale.library)

CLOCK                            TRUE             Schaltet Uhr   in  der
                                                  Titelzeile an

                                 FALSE            Schaltet Uhr aus. (Für
                                                  User ohne Echtzeituhr)

ICONTOP                          Zahl (0-16384)   Y-Koordinate des ikoni-
                                                  fizierten Fensters

ICONLEFT                         Zahl (0-16384)   X-Koordinate des ikoni-
                                                  fizierten Fensters

POPUPPREFS                       TRUE             Zeige  Voreinstellungs-
                                                  fenster bei Spielbeginn.

                                 FALSE            Beginne Spiel direkt.

4COLS                            TRUE             Wenn kein MAGIC-WB.

4COLS                            FALSE            Wenn MAGIC-WB intalliert
                                                  ist.
@endnode

@node BFEL " Bekannte Fehler und Schwächen.. "

 
 - Die Hiscore-Datei wird nicht codiert.

 - Die gewählte Hiscore-Datei wird nicht auf Korrektheit getestet.
 
 - Unterstützt zur Zeit noch keinen eigenen Screen.

 - Unterstützt zur Zeit noch keine Tonausgabe.

 - Auf einer 640x256 Workbench wird das Hiscorefenster 	abgeschnitten. 
   Es kann aber mit dem '@{B}CLOSEGADGET@{UB}' geschlossen werden.
 
 - BlackBox wurde bis jetzt erst auf einer einzigen Hardware-
   Konfiguration getestet :
             @{I} A1200, MC68020, AGA, 2MB Chip-, 4MB FastRam,85MB HD
                  (KS/WB 3.0/3.0 39.106/39.29)
                  Compiler: MaxonC++ V1.1
@{UI}

 ->> Bug-Reports, Anregungen etc.
     an E-Mail : 
@{B}                 corona@uni-paderborn.de@{UB}



@endnode

@node AUSB " In Arbeit.. "

 - Eigener Screen für BlackBox

 - Echtes AppIcon für Ikonifizierung

 - Variable Spielfeldgröße / Variable Anzahl von Murmeln

 - @{I}hier könnte Deine Anregung stehen..@{UI} ;-)

 - ???

@endnode

@node REGI " Updates.. "

 in Arbeit..

@endnode


@node LOGO " Programminformationen... "




Name    : @{I}BlackBox@{UI}
Version : @{I}V2.1@{UI}
Erstellt: @{I}14.04.94@{UI}
Umfang  : @{I}
          - BlackBox (Hauptprogramm)
          - BlackBox.asc (ASCII)
          - BlackBox.guide (AmigaGuide®)
          - 7 IFF-Grafiken@{UI}

Autor   : @{I}Stephan Ilaender (corona@uni-paderborn.de)@{UI}
GUI     : @{I}GadToolsBox@{UI}



@endnode

@node FORD " Technische Spezifikation "


Betriebssystem : AmigaOS >= 2.x, 3.x

Bibliotheken   : AmigaGuide®, GadTools, ASL, Utility, Locale

Screenmode     : Mindestens: 640x256 (PAL/Hires) 4 Farben
                 Optimal   : >= 640x400                 
                 (DBLNTSC/Hires/Flimmerfrei) 8 Farben
                      
RAM-Ausbau     : >= 0.5MB

Zeichensatz    : topaz.8, nicht veränderbar!

Bemerkung      :- »@{B}BlackBox.guide@{UB}« sollte sich im
                  Verzeichnis von BlackBox befinden.

                - BlackBox unterstützt englische Workbench 
                   (benötigt Locale.library)

@endnode

@node indi "Index :"


  INDEX :
 

@{"  BlackBox  " link LOGO}  

@{"   Deutsch   " link GERMAN}
@{"   Englisch  " link ENGLISCH}

@{"Korona" system "sys:utilities/Multiview iff/Korona.iff"}
@{"abgelenkt" system "sys:utilities/Multiview iff/Ablenkung.iff"}
@{"absorbiert" system "sys:utilities/Multiview iff/Absorbtion.iff"}
@{"reflektiert" system "sys:utilities/Multiview iff/Reflektion.iff"}
@{"Rand" system "sys:utilities/Multiview iff/RandRef.iff"}
@{"  Ein Beispiel aus der Praxis..        " system "sys:utilities/Multiview iff/Beispiel.iff"}
@{"  Beispiel für eine korrekte Lösung..  " system "sys:utilities/Multiview iff/Korrekt.iff"}

@{" Voreinstellung über ToolTypes " link VORE}
@{" Hard-/Softwareanforderungen   " link FORD}
@{" HD-Installation               " link HDIN}
@{" Bekannte Fehler               " link BFEL}
@{" Ausblick                      " link AUSB}
@{" Updates                       " link REGI}


@endnode
