diagram
=======

Version:         0.01
letzte nderung: 23.02.2018
Autor:           Dietmar Uhlig
Lizenz:          MIT

Zweck
-----

Diagram dient der Anzeige von Linien im 2D-Diagramm. Die
Linienwerte mssen in einer oder mehreren CSV-Dateien
vorliegen, Format siehe unten. Das Programm startet im
VGA-Textmodus, arbeitet hauptschlich im G0-Grafikmodus und
kehrt bei Fehlern oder nach Beendigung in den VGA-Modus zurck.

Aufruf
------

diagram [CSV-Datei]

CSV-Datei kann mit absolutem oder relativem (also auch ohne)
Pfad angegeben werden. Theoretisch knnen mehrere CSV-Dateien
in die Kommandozeile geschrieben werden. In Version 0.01 wird
aber nur die erste Datei geladen (bekannter Fehler).

diagram -h

...gibt eine kurze Hilfe und den Verweis auf diese Datei aus.

Struktur
--------

Im ersten Schritt wird die Struktur der CSV-Datei geprft. Die
Beschriftungen werden an Bellatrix bergeben. Dazu muss vorher
der G0-Treiber geladen werden. Beim ersten Fehler in der
Struktur wird erst wieder in den VGA-Modus umgeschaltet, dann
der Fehler angezeigt und das Programm beendet.

Konnte die CSV-Datei geladen werden, erscheint der Dialog zur
Linienauswahl. Man muss mindestens eine Linie whlen, bevor man
zur Linienanzeige wechseln kann.

Bedienung
---------

generell:

  ESC   ... Programmende
  Enter ... Wechsel zwischen Linienauswahl-Dialog und
            Linienanzeige

im Linienauswahl-Dialog:

  TAB       ... Sprung zur nchsten Linie in der Listen
  Shift+TAB ... funktioniert in Version 0.01 nicht, eigentlich:
                Sprung zur vorherigen Linie in der Liste
  Cur.Links/Rechts ... Auswahl des Radio-Button

in der Linienanzeige:

  TAB       ... Hervorheben der nchsten Linie durch Blinken
  Shift+TAB ... funktioniert in Version 0.01 nicht, eigentlich:
                Hervorheben der vorheren Linie durch Blinken
  Space     ... Hervorheben der aktuellen Linie durch Blinken

Struktur der CSV-Dateien
------------------------

Die Zellen der CSV-Datei mssen mit Komma getrennt werden. Es
kann sowohl der DOS- als auch der UNIX-Zeilenumbruch genommen
werden. Zellen kann man in Anfhrungsstriche (") einschlieen,
um Kommas in der Zelle unterzubringen. Die Anfhrungsstriche
werden dann nicht mit angezeigt. Am Dateiende darf kein
Zeilenumbruch stehen. Der wrde dazu fhren, dass noch eine
Zeile ohne Spalten erkannt und dann ein Fehler wegen falscher
Spaltenanzahl gemeldet wird.

Die erste Zeile enthlt Krzel fr die Achsenbeschriftung im
Diagramm, Vorschlag: 1-5 Zeichen. In der zweiten Zeile stehen
knappe Erklrungen zu jedem Krzel. Krzel und Erklrung werden
im Auswahldialog in einer Zeile dargestellt; dort ist nur fr
30 Zeichen pro Zeile Platz.

Ab der dritten Zeile stehen die Werte in der CSV-Datei. Das
drfen nur ganze Zahlen von -2^31 bis 2^31-1 sein. Ungltige
Eintrge werden unvollstndig oder als 0 interpretiert.

Die erste Spalte enthlt die Daten der X-Achse. In Version 0.01
wird die Erklrung nicht ausgewertet und angenommen, dass genau
8 Zeilen mit den Werten 1-8 folgen (werden nicht ausgewertet).
