@database AGM.guide
@master AGM.guide
@$VER: 2.5
@author ":"
@(c) "1996-97 by Felix Schwarz"

@node "Main" "AGM - Ihr persönlicher Gebühren - Manager"
 @{fg shine}A@{fg text}MIGA-@{fg shine}G@{fg text}ebühren-@{fg shine}M@{fg text}anager V2.5
 (c) 1996-97 by Felix Schwarz


 @{"Der Autor" link "Der Autor" 0}                    - wer hat das verbrochen ?
 @{"Registration" link "Registration" 0}                 - Wie man für neue Versionen sorgt..
 @{"Bedienungsoberfläche" link "Die Oberfläche" 0}         - wie man AGM bedient
 @{"Hinzufügen/Ändern von Zonen" link "Hinzu" 0}  - so fügt man eigene Zonen hinzu/paßt sie an..
 @{"Der ARexx-Port" link "Heavy Magic" 0}               - Heavy Magic!
 @{"History" link "History" 0}                      - wie sich dieses Programm entwickelte
 @{"Andere Programme des Autors" link "Andere Programme des Autors" 0}  - andere Genialitäten
 @{"Copyright" link "Copyright" 0}                    - Rechtliches
@endnode

@node "Der Autor" "Der Autor"
@{fg shine}@{bg fill} Der Autor@{fg text}@{bg back}
 Angefangen habe ich mit einem ZX Spectrum, habe dann auf einem
 Sinclair QL programmiert. Dann einen Amiga 2000 und nun einen
 Amiga 1200 mit Turboboard, Videomaster, Scanner, CD-ROM-Laufwerk,...
 Mein größtes Hobby ist Raytracing und Grafik sowie vor allem Pro-
 grammierung auf dem Amiga (deswegen gibt es auch Ultraconv und
 Ultracat, weil ich keine Lust habe, mir ein Programm für mehrere
 hundert Mark zu kaufen!).

 Und so bin ich zu erreichen:
 
 @{fg shine}Telefon@{fg text}: 09132/3400

 @{fg shine}Email@{fg text}: bs168@fen.baynet.de

 @{fg shine}Adresse@{fg text}: Felix Schwarz
          Am Gründla 3
          D-91074 Herzogenaurach
          GERMANY

 @{fg shine}Homepage@{fg text}: http://home.t-online.de/home/UConv/

    - Felix
@endnode

@node "Die Oberfläche" "Die Benutzer-Oberfläche"
@{fg shine}@{bg fill} Die Benutzeroberfläche@{fg text}@{bg back}

 Im unteren rechten Eck befindet sich eine @{fg shine}Prozentanzeige@{fg text},
 die anzeigt, wie weit die aktuelle Einheit abgelaufen ist.
 Darüber befindet sich eine Leiste mit folgenden Funktionen.

 @{fg shine}Start@{fg text}
  Klicken Sie auf dieses Gadget, wenn Sie das Telefongespräch
  anfangen. Ab jetzt können Sie ablesen, wieviel Geld Sie
  schon vertelefoniert haben, wie lange eine Einheit ist, und
  wie lange Sie schon telefonieren, bzw. online sind.

 @{fg shine}Stop!@{fg text}
  Stoppt die Zeit. Nun können Sie mit "@{fg shine}Speichern@{fg text}" alle Daten
  inklusive Datum, Anfangsuhrzeit, Enduhrzeit, Kosten und
  Tarifzone abspeichern. Die erzeugte Liste können Sie
  nun mit "@{fg shine}LB zeigen@{fg text}" abrufen. Wenn Sie diese Liste ausdrucken
  möchten, so wählen Sie Print im Pulldown-Menü aus.

 @{fg shine}Speichern@{fg text}
  Speichert die aktuellen Verbindungskosten in das Logbuch ab.

 @{fg shine}City/R 50/R 200/Fern/...@{fg text}
  Mit diesem Gadget müssen Sie anwählen, innerhalb welcher
  Tarifzone Sie telefonieren. Zu weiteren Informationen
  schauen Sie am Besten in Ihrem Infoprospekt der Telekom
  nach.

 @{fg shine}Feiertag / Werktag@{fg text}
  Normalerweise stellt AGM hier den richtigen Wert ein.
  Da es aber auch unter der Woche Feiertage geben kann,
  können Sie dies hier manuell beeinflussen. In der registrierten
  Version kennt AGM alle diese Ausnahmen, bis auf die, die die Telekom
  kurzfristig bekannt gibt (man denke da z.B. an die 1996`er Weihnachts-
  aktion, bei der man vom 24.12-31.12 zum Feiertagstarif telefonieren
  konnte).

 @{fg shine}Kosten@{fg text}
  Wenn Sie auf dieses Gadget klicken, so errechnet Ihnen AGM
  automatisch, wie viel Geld Sie schon seit Anfang des
  aktuellen Logbuchs verbraucht haben.

 @{fg shine}Jump!@{fg text}
  "Springt" auf den vordersten Bildschirm, d.h., wenn
  Sie z.B. AGM auf der Workbench haben, aber sich lieber auf dem
  Term-Bildschirm Übersicht verschaffen wollen, so klicken Sie
  auf dieses Gadget und bringen dann innerhalb von 2 Sekunden
  den Term-Bildschirm in den Vordergrund, wo sich dann das Fenster
  von AGM öffnet.

 @{fg shine}Über@{fg text}
  Zeigt Informationen zum Programm.
  
 @{fg shine}Lade LB@{fg text}
  Hiermit laden Sie ein Logbuch, das dann das aktuelle
  Logbuch ist. Wenn noch kein Logbuch mit diesem Namen
  existiert, so erstellt AGM es mit dem ersten Klick auf
  Speichern automatisch.

 @{fg shine}Iconify@{fg text}
  Hiermit verkleinern Sie die Anzeige auf folgendes:

  +-------------------------------------------+
  | I E: 0 K: 000,00 DM Start Stop |****      |
  +-------------------------------------------+
    ^ ^    ^            ^     ^       ^
    | |    |            |     |       Prozentanzeige, die anzeigt, wie weit die
    | |    |            |     |       aktuelle Einheit schon verbraucht ist
    | |    |            |     Siehe Stop
    | |    |            Siehe Start
    | |    enstandene Kosten
    | Anzahl der Einheiten, die Sie schon verbraucht haben
    Zurückkehren zum großen Fenster

 @{fg shine}Akustische Signale:@{fg text}
  Ertönt ein Sound nur mit geringer Lautstärke, so ist
  die Einheit schon zu 75 % verbraucht. Ertönt er hingegen mit
  voller Lautstärke, so wird gerade eine neue Einheit angefangen.
  Sie können selbst weitere Sounds hinzufügen, indem Sie in die
  Schublade "Sounds" z.B. "Sound3.8svx" "Sound4.8svx" ...
  hinzufügen. Die Sounds dürfen nicht größer als 128 Kilobyte sein,
  und werden automatisch beim Start geladen. JEDER Sound braucht
  Speicher! AGM arbeitet auch, wenn sich keine Sounds im "Sounds"-
  Verzeichnis befinden.

 @{fg shine}Ein kleines Praxis-Beispiel:@{fg text}
  Sie wählen Ihren Provider an, der innerhalb der R 50-
  Zone liegt. Sie klicken also auf R 50, und sobald das
  Modem der Gegenstelle abgehoben hat, klicken Sie auf
  Start. Nach einer halben Stunde beenden Sie die Verbindung
  wieder. Sie klicken also auf Stop!. Da Sie immer Übersicht
  darüber haben wollen, was Sie so vertelefonieren, klicken Sie
  auf "Speichern", um automatisch eine Liste anfertigen
  zu lassen. Als Ihnen nun die Telefonrechnung der Telekom
  ins Haus flattert, können Sie genau nachschauen, wann Sie
  wohin und wie lang telefoniert haben, und könnten so eventuell
  auch einen Abrechnungsfehler bemerken.

@endnode

@node "Andere Programme des Autors" "Andere Programme des Autors"
@{fg shine}@{bg fill} Andere Programme des Autors@{fg text}@{bg back}

 Die wenigsten Programmierer schreiben nur ein Programm.
 Daher hier einige Programme, die vielleicht dem einen
 oder anderen schon bekannt vorkommen könnten.

 @{fg shine}Ultraconv und Ultracat@{fg text}
  Hierbei handelt es sich um zwei Programme, die zur
  Grafikbearbeitung und zum Katalogisieren von Bildern
  dienen. Hierbei muß bemerkt werden, daß UCat nicht nur
  Bilder in den Formaten PCX, ILBM, GIF, BMP, PPM, JPEG,
  TIFF, PNG sowie Datatypes in Kataloge aufnimmt, sondern
  auch MPEG, FLI und Anim7S, Anim7L, Anim5 sowie AnimJ und
  Animbrush anstandslos verarbeitet. Als erste "Bilder"daten-
  bank der Welt zeigt UCat die Animationen nicht durch deren
  erstes Frame an, sondern animiert sie in Echtzeit. Durch
  den Workbench und AGA-Modus läuft UCat auf jedem Rechner
  ab OS 2.0.
  Doch selbst diese beeindruckenden Eckdaten kommen nicht an
  die Funktionalität von UConv heran. Schluckt doch dieses
  Programm ILBM, PCX, PPM, JPEG, TIFF, PNG, MPEG, FLI, Anim..
  und Datatypes und diese sowohl als einzelne Dateien, wie auch
  Serien von Dateien. Zudem spuckt es HAM8/HAM6/IFF24/ILBM, PCX
  JPEG, OS/2-BMP, Win-BMP, Anim5, Anim7L, Anim7S, PNG, TIFF und
  PPM und ein frei konfigurierbares Format aus (z.B. Targa, GIF,
  ASCII, MAP, ..). Zwischen Ein- und Ausgabe lassen sich zudem
  noch ca. 50 Filter schalten, wie z.B. das mischen, überblenden,
  transperieren, 3D-Brillen aufbereiten von bis zu vier Animationen
  (d.h. vier Animationen gleichzeitig auf einem Schirm, oder zwischen
  zweien oben genannte Effekte). Man kann wachsendes, konstantes, ab-
  fallendes und zufällige Störungen einbauen, und auch ganze Animationen
  skalieren, drehen, aufhellen, abdunkeln, embossen, edge-detecten, ..
  Sie sehen also, daß UConv mehr als nur ein Konverter ist, sondern
  vielmehr ein Bild- und Animationsverarbeitungsprogramm mit allen
  Extras, die man sich nur wünschen kann.
  
  Ultraconv 1.6 und Ultracat 1.1 sind im Aminet unter
  gfx/conv/uconv16r.lha zu finden.

 @{fg shine}ANIM>GIFANIM@{fg text}
  Ein Konverter, der IFF-ANIMationen ins GIF-ANIM-Format konvertiert,
  das z.B. von IBrowse unterstützt wird. Es ist Freeware und auf meiner
  Homepage erhältlich.

@endnode

@node "Copyright" "Copyright"
@{fg shine}@{bg fill} Copyright@{fg text}@{bg back}
  Dieses Programm darf solange verbreitet werden, so
  lange keine Änderungen an den Dateien und dem Liefer-
  umfang gemacht werden. Ich freue mich natürlich über
  jede Zuschrift, die mir mitteilt, wo das Programm
  überall drauf ist. Die registrierte Version darf
  nicht mehr kopiert werden.

  Sollten irgendwelche Schäden durch den Gebrauch dieses
  Programmes entstehen, so kann der Autor nicht dafür haftbar
  gemacht werden. Der Autor haftet ebenfalls nicht für eventuelle
  Ungenauigkeiten bei Abrechnungen(nicht daß es bei mir welche ge-
  geben hätte :-) ...).
@endnode

@node "Hinzu" "Hinzufügen/Ändern von Zonen"
@{fg shine}@{bg fill} Hinzufügen/Anpassen/Ändern von Zonen@{fg text}@{bg back}
 Seit V2.0 verfügt AGM über ein neues, modulares Konzept,
 daß es jedem erlaubt, die Zonen auf versch. Länder,
 Neuheiten, etc. anzupassen, bzw. neue hinzuzufügen.
 Ein ".agm"-File enthält alle Daten, die AGM benötigt,
 um die Gebühren korrekt für Feiertage und Werktage zu
 berechnen. Die ".agm"-Files liegen im Verzeichnis
 Config/Gebs/ im AGM-Hauptverzeichnis.
 Der Aufbau sieht dabei folgendermaßen aus(ohne SNIP, bzw. SNAP):
 
--- SNIP ---
IRGENDETWAS - nur zur Übersicht, um Werktag und Feiertag zu trennen
Anzahl der Sekunden für eine Einheit um 0 Uhr/Werktag
Anzahl der Sekunden für eine Einheit um 1 Uhr/Werktag
Anzahl der Sekunden für eine Einheit um 2 Uhr/Werktag
Anzahl der Sekunden für eine Einheit um 3 Uhr/Werktag
Anzahl der Sekunden für eine Einheit um 4 Uhr/Werktag
Anzahl der Sekunden für eine Einheit um 5 Uhr/Werktag
Anzahl der Sekunden für eine Einheit um 6 Uhr/Werktag
Anzahl der Sekunden für eine Einheit um 7 Uhr/Werktag
Anzahl der Sekunden für eine Einheit um 8 Uhr/Werktag
Anzahl der Sekunden für eine Einheit um 9 Uhr/Werktag
Anzahl der Sekunden für eine Einheit um 10 Uhr/Werktag
Anzahl der Sekunden für eine Einheit um 11 Uhr/Werktag
Anzahl der Sekunden für eine Einheit um 12 Uhr/Werktag
Anzahl der Sekunden für eine Einheit um 13 Uhr/Werktag
Anzahl der Sekunden für eine Einheit um 14 Uhr/Werktag
Anzahl der Sekunden für eine Einheit um 15 Uhr/Werktag
Anzahl der Sekunden für eine Einheit um 16 Uhr/Werktag
Anzahl der Sekunden für eine Einheit um 17 Uhr/Werktag
Anzahl der Sekunden für eine Einheit um 18 Uhr/Werktag
Anzahl der Sekunden für eine Einheit um 19 Uhr/Werktag
Anzahl der Sekunden für eine Einheit um 20 Uhr/Werktag
Anzahl der Sekunden für eine Einheit um 21 Uhr/Werktag
Anzahl der Sekunden für eine Einheit um 22 Uhr/Werktag
Anzahl der Sekunden für eine Einheit um 23 Uhr/Werktag
IRGENDETWAS - nur zur Übersicht, um Werktag und Feiertag zu trennen
Anzahl der Sekunden für eine Einheit um 0 Uhr/Feiertag
Anzahl der Sekunden für eine Einheit um 1 Uhr/Feiertag
Anzahl der Sekunden für eine Einheit um 2 Uhr/Feiertag
Anzahl der Sekunden für eine Einheit um 3 Uhr/Feiertag
Anzahl der Sekunden für eine Einheit um 4 Uhr/Feiertag
Anzahl der Sekunden für eine Einheit um 5 Uhr/Feiertag
Anzahl der Sekunden für eine Einheit um 6 Uhr/Feiertag
Anzahl der Sekunden für eine Einheit um 7 Uhr/Feiertag
Anzahl der Sekunden für eine Einheit um 8 Uhr/Feiertag
Anzahl der Sekunden für eine Einheit um 9 Uhr/Feiertag
Anzahl der Sekunden für eine Einheit um 10 Uhr/Feiertag
Anzahl der Sekunden für eine Einheit um 11 Uhr/Feiertag
Anzahl der Sekunden für eine Einheit um 12 Uhr/Feiertag
Anzahl der Sekunden für eine Einheit um 13 Uhr/Feiertag
Anzahl der Sekunden für eine Einheit um 14 Uhr/Feiertag
Anzahl der Sekunden für eine Einheit um 15 Uhr/Feiertag
Anzahl der Sekunden für eine Einheit um 16 Uhr/Feiertag
Anzahl der Sekunden für eine Einheit um 17 Uhr/Feiertag
Anzahl der Sekunden für eine Einheit um 18 Uhr/Feiertag
Anzahl der Sekunden für eine Einheit um 19 Uhr/Feiertag
Anzahl der Sekunden für eine Einheit um 20 Uhr/Feiertag
Anzahl der Sekunden für eine Einheit um 21 Uhr/Feiertag
Anzahl der Sekunden für eine Einheit um 22 Uhr/Feiertag
Anzahl der Sekunden für eine Einheit um 23 Uhr/Feiertag
--- SNAP ---

Um eine solche ".agm"-Datei in AGM zu integrieren,
müssen Sie noch einen Eintrag in Config/Zonen im
AGM-Hauptverzeichnis machen. Trägt Ihre ".agm"-Datei
z.B.den Namen "Euro200.agm" und liegt im Verzeichnis "Config/Gebs/",
so fügen Sie folgende Zeilen, der "Config/Zonen"-Datei an(ohne <RETURN>,
sowie SNIP und SNAP):
--- SNIP ---
Euro200 <RETURN>
Config/Gebs/Euro2000.agm
--- SNAP ---
Bitte beachten Sie, daß Sie kein RETURN nach der zweiten Zeile drücken,
da AGM sonst ein leeres Button zuviel erzeugt.

@endnode

@node "Heavy Magic" "Heavy Magic - Der Arexx-Port"
@{fg shine}@{bg fill} Heavy Magic - der ARexx-Port@{fg text}@{bg back}
 AGM verfügt über folgende ARexx-Befehle:

 @{fg shine}AGMLOG "Logbücher/MYLOG"@{fg text}
  AGM schaltet auf das Logbuch MYLOG um. Voreingestellt ist Logbücher/Logbuch.
  Existiert dieses Logbuch noch nicht, so wird es mit dem nächsten AGMSAVE-
  Befehl erstellt.
 
 @{fg shine}AGMSTART@{fg text}
  AGM beginnt mit der Zählung der Einheiten. Identisch mit einem Klick auf Start.
  
 @{fg shine}AGMSTOP@{fg text}
  AGM stoppt das Zählen der Einheiten. Identisch mit einem Klick auf Stop.
  
 @{fg shine}AGMSAVE@{fg text}
  AGM speichert die aktuell verbrauchten Einheiten in das mit AGMLOG bestimmte
  Logbuch. Identisch mit einem Klick auf "Speichern".
  
 @{fg shine}AGMJUMP@{fg text}
  AGM "springt" auf einen anderen Screen, z.B. dem eines Terminal-Programms
  wie Term. Identisch mit einem Klick auf "Jump".
 
 @{fg shine}AGMZONE "Config/Gebs/City.agm"@{fg text}
  AGM wechselt in die Gebührenzone City. Wenn Sie für "City" "R200" einsetzen,
  so wechselt AGM in die Gebührenzone R200.
  
 @{fg shine}AGMICONIFY@{fg text}
  AGM "ikonfiziert" sich, d.h. es verwandelt sich in eine kompakte Variante in
  der linken oberen Ecke. Identisch mit einem Klick auf "Iconify".

 @{fg shine}AGMDEICONIFY@{fg text}
  AGM öffnet wieder seine normale Benutzeroberfläche. Identisch mit einem Klick
  auf "I".

 @{fg shine}AGMDAY@{fg text}
  AGM wechselt zwischen Feiertag(AGMDAY 2) oder Werktag(AGMDAY 1).
 
 @{fg shine}AGMPLUSSEC, AGMPLUSMIN, AGMPLUSHOUR@{fg text}
  AGM fügt zu der telefonierten Zeit eine Sekunde, Minute oder Stunde
  hinzu.

 @{fg shine}AGMQUIT@{fg text}
  AGM beendet sich.

 Noch ein Tip zum Schluß: Ihnen wird sicherlich auffallen, daß AGM immer
 den Über-Requester öffnet, wenn Sie es starten. Zur Automatisierung von
 Gebührenabrechnung kann das aber sehr störend sein. Starten Sie also
 AGM mit dem Argument NOABOUT:
@{fg shine}  run >NIL: AGM NOABOUT@{fg text}

 Viel Spaß!

@endnode

@node "Registration" "Registration"
@{fg shine}@{bg fill} Registration@{fg text}@{bg back}
 Die Registration erfolgt via Post, Verrechnungsscheck oder
 Nachnahme. Sie erlaubt Ihnen die Nutzung des vollen Funktions-
 umfangs. U.a. fehlen in der unregistrierten Version:
  · Alle Logbuch-Funktionen
  · Ausdruck von Gebührentabellen
  · ARexx-Port
  · Ausnahmen-Behandlung für Feiertage
  · Euro 1, Euro2, Euro City, Welt 1, Welt 2, Welt 3, Welt 4
  · GebEd-Speicherfunktion

 Sie sichern durch eine Registration die Weiterentwicklung dieses
 Programms.
 
 Füllen Sie das Registrierformular aus und schicken Sie
 es an:
   Felix Schwarz
   Am Gründla 3
   91074 Herzogenaurach
 
 Ich danke Ihnen für Ihre Unterstützung.
 
 @{"Registrierformular drucken" system "copy Registrierformular prt:"}

@endnode

@node "History" "History"
@{fg shine}@{bg fill} History@{fg text}@{bg back}

 AGM entstand aus der Idee heraus, ein Programm zu
 erstellen, das online die Gebühren berechnet und
 verwaltet. Ich habe auf der Amiga Plus Diskette
 einmal ein solches Programm gesehen ... aber es
 war mehr als kümmerlich! Das Programm hat zwar ange-
 geben, wie lange man telefonieren kann, das wars dann
 aber auch schon. Ich denke, daß, angesichts der Fähig-
 keiten von AGM ein Preis von 15.- DM angemessen ist!
 Aber nun zu der History:

 @{fg shine}V1.0@{fg text}
 - erste Version
 - Upload ins FEN
 - Standardsound
 - City/R50/R200/Fern - Zonenunterstützung
 - Jump!
 - Über
 - Start
 - Stop
 - Speichern in ein Logbuch
 - Zeigen eines Logbuches

 @{fg shine}V1.1@{fg text}
 - verbessertes Logbuch
   - Druckfunktion
   - Suchfunktion
 - Ausrechnen des gesamten vertelefonierten Betrages
 - Kleine Ansicht
 - Anzeigen der Onlinezeit in Minuten
 - Unterstützung von mehreren Logbüchern

 @{fg shine}V2.0@{fg text}
 - Änderungen zum 1.6.1996
 - bis zu 100 Tarifzonen
 - modularer Aufbau, um AGM auch auf besondere Tarifzonen
   abzustimmen.
 - Unterstützung und Erkennung des Wechsels zwischen Tarifzonen

 @{fg shine}V2.5@{fg text}
 - Nun Shareware(15 DM)
 - ARexx-Port
 - GadTools-GUI
 - Tabellendruck
 - Ausnahmenberücksichtigung
 - Gebühreneditor

@endnode
