COCKTAIL

========



Eine Cocktailrezeptverwaltung von





        Harald Hrtl                 Konto: 9129198

        Bergbahnstr. 2a              BLZ  : 660 501 01

        W-7500 Karlsruhe 41          Sparkasse Karlsruhe

        Tel.: 0721/407536





Das das Programm GEM-konform programmiert ist, sollte es auf jedem 
Rechner (auch mit nur 520 kB) in jeder Auflsung arbeiten.



Bisher getestet:

ST, ST + Overscan, ST + Bigscreen (nur monochrom) [TOS 1.4, KAOS]

STE 







1. Installation



Die Dateien COCKTAIL.PRG und COCKTAIL.RSC mssen im selben Verzeich- 
nis stehen. 







2. Programmbedienung



2.1 Dialogboxen



Wenn GEM noch Fenster zu vergeben hat, werden alle Dialoge in Fenster 
gelegt, ansonsten als fliegende Dialoge dargestellt.

Fensterdialoge knnen wie ein normales Fenster verschoben werden, die 
fliegenden Dialoge durch Gedrckthalten der Maustaste auf dem Esels- 
ohr oben rechts.

Wenn ein Feld im Dialog einen unterstrichenen Buchstaben aufweist, 
kann durch Eingabe von <Alternate>-Buchstabe das betreffende Feld 
ausgelst werden.

Dialogboxen mit editierbaren Feldern weisen eine Besonderheit auf: 
Durch Bettigen von <Return> wird der Dialog nicht wie gewohnt ver- 
lassen; vielmehr wird ein Editfeld weitergeschaltet. Um den Dialog 
mit der Tastatur zu verlassen, mu <Shift>-<Return> bettigt werden.

Schattiert dargestellte Objekte in Dialogboxen ziehen nach ihrer Be- 
ttigung weitere Eingabeaufforderungen nach sich.



Eingabe von Sonderzeichen:

Nicht direkt mit der Tastatur erreichbare Zeichen (Akzentzeichen, 
etc.) knnen entweder mit Kombitasten oder durch Eingabe ihres 
ASCII-Codes dargestellt werden. Dem ASCII-Code (dezimal) ist dazu ein 
#-Zeichen voranzustellen (z.B. #146 -> ).



Kombitasten:

   ,c ->   ,C -> 

   `a ->   `e ->   `i ->   `o ->   `u -> 

   'a ->   'e ->   'i ->   'o ->   'u ->   'E -> 

   ^a ->   ^e ->   ^i ->   ^o ->   ^u -> 

   ~n ->   ~N -> 

   :a ->   :o ->   :u ->   :A ->   :O ->   :U ->  

   :i ->   :y ->   :e -> 

   .a ->   .A -> 



Die Umwandlung in das entsprechende Sonderzeichen geschieht erst nach 
Verlassen des jeweiligen Editfeldes!



Die Tastaturkrzel der Menuleisten funktionieren nicht, wenn ein Fen- 
sterdialog mit Editfeldern dargestellt wird, da dann alle Tastatur- 
eingaben auf ein Editfeld bezogen werden.





2.2 Fenstermenus



Die Fenstermenuzeile wird durch Anklicken eines Menutitels aktiviert. 
Sollte der gewnschte Menutitel nicht sichtbar sein, kann er durch 
Anklicken der Symbole <- bzw -> ins Fenster gebracht werden.







3. Die Menuzeile



3.1 COCKTAIL



  3.1.1 Programminfo

  Zustzlich zum blichen Blabla Anzeige des freien Speichers.



  3.1.2 Deskaccessories

  Accessories sind ohne Einschrnkungen verwendbar.





3.2 Datei



  3.2.1 neu

  Anlegen eines neuen Barfachs mit Platz fr max. 65535 Zutaten und 
  ebensoviel Getrnken (max. 10 Barfcher).

  Es wird ein Fenster geffnet, in dem durch Anklicken oder Eingabe 
  von ^G bzw. ^Z das zugehrige Getrnke- bzw. Zutatenfenster ge- 
  ffnet werden kann (Siehe dazu Punkte 4 und 5).

  Anzeige der momentan eingetragenen Getrnke (G:) und Zutaten (Z:).

  Verschiedene Barfcher knnen beispielsweise dazu benutzt werden, 
  erprobte Getrnke von noch zu testenden zu Trennen oder alle Before 
  Dinner Getrnke zu sammeln, oder...



  3.2.2 ffnen

  Laden eines Barfaches, ffnen des Barfensters wie in 3.2.1.



  3.2.3 schlieen

  Das aktuelle Barfenster wird geschlossen. Nur anwhlbar, wenn ein 
  Barfenster das aktive Fenster ist. Wiedererffnen des Barfensters 
  ber den entsprechenden Menupunkt in "Barfach".



  3.2.4 sichern

  Speichern der Zutaten und Getrnke des aktuellen Barfensters unter 
  dessen Dateinamen. (Wenn noch keiner vergeben wurde, wird automa- 
  tisch "sichern als" aufgerufen.)



  3.2.5 sichern als

  Wie "sichern", nur da ein Dateiname gewhlt werden kann.



  3.2.6 Ende

  Beendet das Programm. Sollten noch vernderte und nicht gesicherte 
  Barfcher vorhanden sein (markiert durch "*" vor dem Namen), wird 
  ein Speichern dieser Barfcher angeboten.





3.3 Barfach



  3.3.1 Barfcher

  Jedes durch Laden oder neu Anlegen geffnete Barfach erhlt einen 
  Menueintrag unter diesem Menutitel. Somit knnen geschlossene Bar- 
  fcher wieder geffnet bzw. unter anderen Fenstern versteckte Bar- 
  fenster nach oben gebracht werden.



  3.3.2 lschen

  Das in einem Popup-Menu auszuwhlende Barfach wird aus dem Speicher 
  entfernt.





3.4 Parameter



  3.4.1 einstellen

  Dialogboxen: Alle Dialoge (auch die in Fenstern) werden an der an- 
   gegebenen Stelle angezeigt.

  Getrnkepreise: Bei der Anzeige der Preise wird entsprechend ge- 
   rundet.

  Drucker: Zum Ausdruck werden verschiedene Steuerzeichen des Druk- 
   kers bentigt. Diese werden mittels "Einstellen" gesetzt. Der 
   Druckertreiber, der im Programm verwendet werden soll, ist mittels 
   "Treiber" einstellbar.

  automatisch laden: Ein Barfach kann bei Programmstart automatisch 
   geladen werden. Dabei ist zustzlich zum Dateinamen auch die 
   Option "ein" zu selektieren.

  Getrnke drucken: Durch Selektion von "mit Zutaten" werden beim 
   Ausdruck neben dem Namen auch Zutaten, Zubereitung und Glas aus- 
   gedruckt; sonst nur Namen und Preis.



  3.4.2 laden

  Laden einer Parameterdatei.



  3.4.3 speichern

  Speichern der aktuellen Parameterdatei. Wird als Dateiname 
  COCKTAIL.PAR gewhlt und befindet sich diese Datei im selben Ver- 
  zeichnis wie COCKTAIL.PRG, so wird diese Parameterdatei automatisch 
  bei Programmstart geladen.







4. Zutatenfenster



Ein Einfachklick auf eine Zutat selektiert diese; ist zustzlich eine 
Shifttaste gedrckt, werden bisher selektierte Zutaten nicht deselek- 
tiert.

Ein Doppelklick ffnet eine Zutat zum Ansehen oder ndern (siehe 
4.1.2).





4.1 Zutat



  4.1.1 neu

  In einem Dialog knnen Name, Inhalt, Preis und Verfgbarkeit einer 
  neuen Zutat eingegeben werden.



  4.1.2 ffnen

  Die bei Neueingabe eingegebenen Daten einer Zutat werden angezeigt 
  und knnen bei Bedarf gendert werden. nderungen werden dabei 
  automatisch auch in die Getrnkerezepte bernommen.



  4.1.3 lschen

  Alle selektierten Zutaten werden entfernt, wenn sie nicht fr ein 
  Getrnk bentigt werden.



  4.1.4 drucken

  Von allen selektierten Zutaten werden Name, Inhalt und Preis sowie 
  die Preise verschiedener kleiner Mengen dieser Zutat auf einem 
  Drucker ausgegeben. Als "nicht vorhanden" markierte Zutaten werden 
  dabei hervorgehoben gedruckt (Parameter-Drucker einstellen-Hervor- 
  heben).





4.2 Arbeiten



  4.2.1 ausschneiden

  Alle selektierten Zutaten werden in ein internes Klemmbrett ber- 
  nommen und, falls mglich (siehe 4.1.3), aus dem aktuellen Fenster 
  gelscht.



  4.2.2 kopieren

  Wie 4.2.1, nur da die Zutaten nicht gelscht werden.



  4.2.3 einfgen

  Mittels 4.2.1 oder 4.2.2 ins Klemmbrett gebrachte Zutaten werden in 
  das aktuelle Fenster eingefgt. Bei Namensgleichheit folgt eine 
  weitere Abfrage.



  4.2.4 alle selektieren

  Alle Zutaten des aktuellen Fensters werden selektiert.



  4.2.5 Selektion invertieren

  Selektierte Zutaten werden zu nicht selektierten und umgekehrt. Um 
  ein "deselektiere alle" durchzufhren, kann man demnach zunchst 
  "alle selektieren" und dann die "Selektion invertieren" (Oder auf 
  ein freies Feld im Fenster klicken).



  4.2.6 suchen

  Der einzugebende Suchtext wird in dem mit "suchen nach" definierten 
  Bereich gesucht. Dabei werden nur Zutaten bercksichtigt, deren 
  Status dem in "Auswahl aus" entspricht.

  Der Suchtext darf bei Suche nach Text (Namen) die Wildcards "*" und 
  "?" enthalten, bei Suche nach Zahlen (Inhalt/Preis) die Operatoren 
  ">" und "<" (grer als und kleiner als), diese jedoch nur an er- 
  ster Stelle im Suchtext.

  Beispiel: Suche aller nicht vorhandenen Zutaten, die mit Y begin- 
  nen: Suchtext: Y*, suchen nach: Name, Auswahl aus: nicht vorhande- 
  nen, <Shift><Return> (wg. Editierfeld funktioniert <Return> allei- 
  ne nicht -> 2.1).







5. Getrnkefenster



Ein Einfachklick auf ein Getrnk selektiert dieses; ist zustzlich 
eine Shifttaste gedrckt, werden bisher selektierte Getrnke nicht 
deselektiert.

Ein Doppelklick ffnet ein Getrnk (siehe 5.1.2) zum Ansehen oder 
ndern.







5.1 Getrnk



  5.1.1 neu

  Es erscheint ein Dialog, in dem die verschiedenen Parameter eines 
  Getrnks eingegeben werden knnen.

  Name: Name des Getrnks

  Typ: Durch Klicken auf den Popup-Knopf (schattiert) erscheint eine 
   Auswahl an Getrnketypen.

  Glas: Siehe Typ

  Zutaten: Durch Klick in ein Feld des linken Blocks erscheint eine 
   Mengenauswahl. Klickt man hier auf "anders...", so gelangt man zu 
   einem weiteren Dialog, der die exakte Mengenangabe ermglicht.

   Ein Klick in den rechten Block ffnet das Zutatenfenster. Durch 
   Klick auf eine Zutat wird diese in den Getrnkedialog bernommen. 
   Sollte die gewnschte Zutat noch nicht eingegeben sein, so kann 
   dies ber den Menupunkt "Zutat-neu" nachgeholt werden.

  Zubereitung: Drei Zeilen zur freien Verfgung. Man beachte, da, 
   wie in allen brigen Editfeldern, Kombitasten und Zeicheneingabe 
   ber den ASCII-Code (vgl. 2.1) erst nach Verlassen der Editzeile 
   aufgelst werden.

  Status: Durch Klick auf "Status testen" werden der Gesamtinhalt 
   und der Preis des aktuellen Getrnks berechnet, sowie die Verfg- 
   barkeit desselben getestet (verfgbar, wenn alle Zutaten den Vor- 
   handenstatus besitzen).



  5.1.2 ffnen

  Die bei Neueingabe eingegebenen Daten eines Getrnks werden ange- 
  zeigt und knnen bei Bedarf gendert werden.



  5.1.3 lschen

  Alle selektierten Getrnke werden entfernt.



  5.1.4 drucken

  Von allen selektierten Getrnken werden die in 3.4.1 eingestellten 
  Daten gedruckt. Nicht verfgbare Getrnke werden hervorgehoben aus- 
  gegeben.





5.2 Arbeiten



  5.2.1 ausschneiden

  Alle selektierten Getrnke werden mit den dafr bentigten Zutaten 
  in ein internes Klemmbrett bernommen und aus dem aktuellen Fenster 
  gelscht.



  5.2.2 kopieren

  Wie 5.2.1, nur da die Getrnke nicht gelscht werden.



  5.2.3 einfgen

  Mittels 5.2.1 oder 5.2.2 ins Klemmbrett gebrachte Getrnke werden 
  in das aktuelle Fenster eingefgt. Bei Namensgleichheit folgt eine 
  weitere Abfrage, im Zielfenster nicht vorhandene Zutaten werden 
  automatisch mitkopiert.



  5.2.4 alle selektieren

  Alle Getrnke des aktuellen Fensters werden selektiert.



  5.2.5 Selektion invertieren

  Selektierte Getrnke werden zu nicht selektierten und umgekehrt. Um 
  ein "deselektiere alle" durchzufhren, kann man demnach zunchst 
  "alle selektieren" und dann die "Selektion invertieren" (Oder auf 
  ein freies Feld im Fenster klicken).



  5.2.6 suchen

  Der einzugebende Suchtext wird in dem mit "suchen nach" definierten 
  Bereich gesucht. Dabei werden nur Getrnke bercksichtigt, deren 
  Status dem in "Auswahl aus" entspricht.

  Der Suchtext darf die Wildcards "*" und "?" enthalten.







6. nderung der Resourcedatei



Das bertragen des Programms auf andere Sprachen ist durch ndern der 
Resourcedatei vollstndig mglich. Lediglich die Meldungen "Anmelden 
beim AES hat nicht funktioniert" und "Resourcedatei nicht ladbar" 
bleiben aus verstndlichen Grnden immer in deutsch.

Zur Beachtung:

Der Name des Programmautors stellt eine unvernderliche Gre dar. 
 nderungen verunmglichen die Ausfhrbarkeit des Programms.

Der Text des Menupunkts "Barfach-lschen..." mu die Lnge des Ori- 
 ginaleintrags besitzen, da sonst die Namen der Barfcher falsch ein- 
 getragen werden.

Die Free Strings fr die Alertboxen drfen nicht in Alert-Strings 
 umgewandelt werden (da Interface dies tut, ist ein "x" am Anfang, 
 damit Interface dies nicht tut.) Die Struktur der Alertboxen ist 
 etwas gegenber der Norm erweitert: Erlaubt sind max. 16 Zeilen  
 max. 55 Zeichen. %U unterstreicht eine Zeile einmal, %D zweimal, %F 
 schreibt die Zeile in Fettschrift.

 Fr die $-Zeichen setzt das Programm die aktuellen Strings ein. Bei 
 Auftreten mehrerer $-Zeichen sollte bei bersetzungen die logische 
 Reihenfolge beibehalten werden, um Verwirrungen (des Benutzers, dem 
 Programm ist es egal) zu vermeiden.

In den Nichtalertboxfreestrings trennt das $-Zeichen verschiedene 
 Texte. Die Lnge dieser Texte mu dann, wenn sie Leerzeichen am Ende 
 enthalten, beibehalten werden (Sonst mllt die Druckausgabe). -> 
 Ausprobieren.

Neue Getrnktypen und -glser kann man einfach zu den bestehenden 
 hinzufgen. Bei den Glsern sollte man allerdings die gegebene Icon- 
 gre (Breite 48, Hhe 90 Pixel) beibehalten und als Icontext nicht 
 mehr als sieben Zeichen verwenden.

AUF KEINEN FALL DARF DIE OBJEKTREIHENFOLGE VERNDERT WERDEN!!! Das 
 heit: keine Objekte lschen, nicht sortieren!







7. Beispielsitzung



Wie beginne ich am besten, um beiliegende Cocktailrezepte an meinen 
Barschrank anzupassen?



COCKTAIL.BAR laden (Datei-ffnen). 

Zutatenfenster ffnen (Klick auf Symbol "Zutaten" im Barfenster).

Alle Zutaten selektieren (Arbeiten-alle selektieren (Fenstermenu)).

Zutaten anzeigen lassen (Zutat-ffnen (Fenstermenu)).

Den "Zutat vorhanden"-Knopf entsprechend einstellen, <Shift><Return> 
 (oder OK).

Die nchste Zutat wird angezeigt, ...

Barfenster nach oben bringen, Getrnkefenster ffnen

Alle verfgbaren Getrnke suchen (Arbeiten-suchen in der Menuzeile 
 des Getrnkefensters): Suchtext:*, suchen nach: Name, Auswahl aus: 
 selektierten, nicht selektierten, verfgbaren.

Alle selektierten Getrnke ins Klemmbrett (Arbeiten-kopieren).

Neues Barfach anlegen (Datei-neu).

Getrnkefenster des neuen Barfachs ffnen.

Klemmbrett einfgen (Arbeiten-einfgen).

Barfenster des neuen Barfachs nach oben, abspeichern (Datei-sichern 
 als).

Im neuen Barfach stehen nun alle Getrnke, die sofort gemixt werden 
 knnen.







8. Programmstatus



Dieses Programm ist Freeware. Das bedeutet hier:



Die Benutzung erfolgt in jeder Hinsicht auf eigene Gefahr.

Jeder darf dieses Programm unentgeltlich benutzen und kopieren.

Die Weitergabe ist ausschlielich nur dann gestattet, wenn die 
 Dateien COCKTAIL.PRG, COCKTAIL.RSC und COCKTAIL.TXT in unvernderter 
 Form vorliegen (bzw. COCKTAIL.RSC und COCKTAIL.TXT in sinngemer 
 bersetzung).







9. Fr Interessierte



Wer dieses Programm gern benutzt, der mge sich zu einer Spende von 
DM 20.- (oder natrlich mehr) auf obiges Konto hinreien lassen. Im 
Gegenzug spendiere ich dann die neueste Version mit weiteren 
Cocktailrezepten.



Wer sich einmal als derart grozgig erwiesen hat, kann mir jederzeit 
eine rckfrankierte Diskette schicken, auf die ich dann mit neuen Re- 
zepten (zur Zeit ca. 300 neue, geplant ca. 1000) und/oder einer neuen 
Version antworten werde.



Irgendwelche Spenden entfallen, wenn ich 50 mir bis dato unbekannte 
Rezepte als *.BAR erhalte. 







10. Zu den Rezepten



Alle Getrnke sollten, wenn nicht anders angegeben, in einem Shaker 
mit Eis geschttelt werden. (Ich war zu faul, dies bei fast jedem 
Rezept hinzuschreiben.)

Die Aussage "rhren" sollte als "im Mixglas mit Eis rhren" verstan- 
den werden.



