\documentclass[a4paper,12pt] {article} \usepackage{german} \usepackage[latin1] {inputenc} \usepackage{verbatim} \pagestyle{headings} \begin{document} \title{\textsf{MicroChart} 1.0.0} \author{Frank Reibold} \maketitle \thispagestyle{empty} \vfill \begin{abstract} Dieses Programm erlaubt die einfache Erstellung von Datendiagrammen. Die zugrundeliegenden Daten können entweder manuell eingegeben oder von dem Datenbankverwaltungssystem \textsf{MicroBase} erzeugt werden. \textsf{MicroChart} erzeugt Kreis-, Linien und Balkendiagramme. Die Diagramme können als Grafiken gesichert werden, um sie mit einem Malprogramm nachzubearbeiten. Ein Screengrabber und ein IFF-Viewer werden mitgeliefert. \end{abstract} \newpage \pagenumbering{roman} \tableofcontents \newpage \pagenumbering{arabic} \section{Konventionen} \subsection*{Allgemeines} Diese Dokumentation beschreibt das Diagrammwerkzeug \textsf{MicroChart}. Grundkenntnisse über die Bedienung des Amiga werden vorausgesetzt -- Sie sollten in der Lage sein, ein Programm aufzurufen sowie Befehle aus einem Pulldown-Menü auswählen können. Die mögliche Übernahme von Daten aus dem Datenbankverwaltungssystem \textsf{MicroBase} wird hier nicht erläutert. Nähere Informationen finden Sie in der Dokumentaion zu \textsf{MicroBase}. \subsection*{Verwendete Schriftarten} In dieser Dokumentation werden neben Roman die folgenden Schriftarten verwendet: \begin{itemize} \item Programmnamen sind in \textsf{Sans Serif} gesetzt. \item Menübefehle sind \textit{kursiv} geschrieben. \item Wichtige Begriffe werden \textsl{schräg} dargestellt. \item Tabellenüberschriften werden in \textsc{Kapitälchen} gesetzt. \item Tastatureingaben und Bildschirmausgaben erscheinen in einer Schriftart mit \texttt{fester Zeichenbreite}. \end{itemize} \newpage \section{\textsf{MicroChart} installieren} \textsf{MicroChart} benötigt 512 KB RAM und mindestens Kickstart 2.0. Um \textsf{MicroChart} zu installieren, rufen Sie einfach das mitgelieferte Installerskript auf. Folgende Dateien werden installiert: \bigskip \begin{tabular}{|l|l|} \hline \textsc{Datei} & \textsc{Verzeichnis} \\ \hline \hline Programmdateien & Programmverzeichnis \\ \hline grabscreen & Programmverzeichnis \\ \hline iffview & Programmverzeichnis \\ \hline \end{tabular} \bigskip Nach der Installation des Programms können Sie: \begin{itemize} \item die Projektdatei \texttt{Demo.MCD} öffnen, um einen Überblick über die Fähigkeiten des Programms zu bekommen oder \item das \textsl{Tutorial} lesen, um die Bedienung des Programms an Hand eines Beispielprojektes zu erlernen. \end{itemize} \newpage \section{Was bietet \textsf{MicroChart}?} \textsf{MicroChart} bietet Ihnen folgende Möglichkeiten: \begin{itemize} \item Balkendiagramme \item Liniendiagramme \item Tortendiagramme \item auf AGA-Rechnern bis zu 256 Farben möglich \item Sichern der Diagramme als IFF-Datei \item Ausdruck der Diagramme \item Linienstil definierbar \item Screengrabber \item IFF-Viewer \item Zeichensatz wählbar \end{itemize} Folgendes ist zur Zeit noch nicht möglich: \begin{itemize} \item Änderung des Bildschirmformats nach der Erstellung eines Diagramms \item Unterstützung von ECS- und AGA-Bildschirmmodi \item interne Speicherfunktion für Grafiken \item Einbinden von Grafiken \end{itemize} \newpage \section{Die Menüs von \textsf{MicroChart}} \subsection{Das \textit{Projekt}-Menü} \begin{description} \item [Neu \dots{}] Mit diesem Befehl wird ein neues Projekt erstellt. Die Optionen werden auf ihre Vorgabewerte zurückgesetzt; alle Daten werden gelöscht. Sie werden aufgefordert, die Anzahl der zu erfassenden Daten einzugeben. Rufen Sie den Befehl \textit{Dateneingabe \dots{}} im Menü \textit{Edieren} auf, um die Daten zu erfassen. \item [öffnen \dots{}] Sie können über einen ASL-Requester die Projektdatei aus\-wäh\-len, die Sie laden möchten. Es erscheint eine Fehlermeldung, falls die Datei keine gültige Projektdatei ist. Die Anzahl der Bildschirmfarben wird ggf. automatisch begrenzt. Wenn zuvor schon ein Diagramm erstellt wurde, wird das in der Datei gespeicherte Bildschirmformat ignoriert.% \footnote{Das Bildschirmformat kann nach der Erstellung eines Diagramms leider nicht mehr geändert werden.} \item [sichern] Das aktuelle Projekt wird gesichert. Wurde noch kein Dateiname ge\-wählt, erscheint ein ASL-Requester. \item [sichern als \dots{}] Das Projekt kann unter einem anderen Namen gesichert werden. \item [Über] Die Copyrightmeldung und die Versionsnummer von \textsf{MicroChart} werden angezeigt. \item [Ende] Das Programm wird ohne eine Sicherheitsabfrage beendet. \end{description} \subsection{Das \textit{Edieren}-Menü} \begin{description} \item [Dateneingabe \dots{}] Hier werden die Daten eingegeben. Folgende Angaben sind jeweils erforderlich: \begin{itemize} \item Bezeichnung (bis zu 25 Zeichen) \item Wert (bis zu 20 Zeichen) \item Farbe \end{itemize} Achten Sie bei der Eingabe der Werte bitte darauf, dass Sie statt des Dezimalkommas einen Punkt (\texttt{.}) eingeben müssen. Um einen Eintrag zu löschen, drücken Sie einfach auf die Taste \texttt{Esc}. Ein Standardwert für die Farbe wird vom Programm vorgegeben, kann jedoch von Ihnen geändert werden. \item [Titel \dots{}] Sie können einen Titel für das Diagramm eingeben. Dieser wird über dem eigentlichen Diagramm dargestellt. \item [Autofarben] Die Farben werden auf Standardwerte gesetzt. Wenn Sie in den Optionen die Sperrung der Schriftfarbe aktiviert haben, so wird diese nicht als Datenfarbe verwendet und übersprungen. \end{description} \subsection{Das \textit{Diagramm}-Menü} \begin{description} \item [Balkendiagramm] Der Diagrammtyp \textsl{Balkendiagramm} wird aktiviert.% \footnote{Bei negativen Werten erscheint die Beschriftung teilweise im Balken statt darunter.} \item [Liniendiagramm] Der Diagrammtyp \textsl{Liniendiagramm} wird aktiviert. \item [Tortendiagramm] Der Diagrammtyp \textsl{Tortendiagramm} wird aktiviert.% \footnote{Negative Werte können nicht als Tortendiagramm dargestellt werden. Sie werden in Absolutwerte umgewandelt, also mit $-1$ multipliziert.} \item [Diagramm anzeigen] Das Diagramm wird mit den aktuellen Daten und Einstellungen angezeigt. Die Proportionen des Diagrammes werden automatisch an den gewählten Zeichensatz und das Bildschirmformat angepasst. Der Diagrammbildschirm enthält ein Menü \textit{Grafik}, dessen Befehl \textit{schließen} den Grafikbildschirm entfernt und die normalen Menüs wieder herstellt. \end{description} \subsection{Das \textit{Optionen}-Menü} \begin{description} \item [Bildschirmformat \dots{}] Sie können Breite, Höhe und Tiefe des Grafik\-bild\-schir\-mes definieren. ECS- und AGA-Bildschirmmodi wie \textit{Productivity} werden nicht unterstützt. Es werden jedoch bis zu 256 Farben (Tiefe 8) akzeptiert, wenn das AGA-Chipset festgestellt werden konnte. Wenn Sie nur die Originalchips haben, wird die Bildschirmtiefe auf 5 bzw. 4 begrenzt. Wenn zuvor schon ein Diagramm erstellt wurde, kann das Bildschirmformat nicht mehr verändert werden. \item [Beschriftungen \dots{}] Folgende Einstellungen können vorgenommen werden: \begin{description} \item [Zahlenformat:] Sie müssen einen Formatstring eingeben, der das Zahlenformat festlegt. Die Zeichen innerhalb des Formatstrings haben folgende Bedeutung: \bigskip \begin{tabular}{|l|p{7cm}|} \hline \textsc{Zeichen} & \textsc{Bedeutung} \\ \hline \hline \verb|#| & steht für eine Ziffer \\ \hline . & Dezimalpunkt \\ \hline - & bei negativen Zahlen Minuszeichen ausgeben (Das Zeichen muss am Ende des Formatstrings stehen.) \\ \hline + & Vorzeichen ausgeben (Das Zeichen muss am Anfang oder am Ende des Formatstrings stehen.) \\ \hline ** & Sternchen statt Leerzeichen benutzen \\ \hline \verb|$$| & ein Dollarzeichen ausgeben \\ \hline ** \verb|$| & Kombination von \verb|$$| und ** \\ \hline \verb|^^^^| & Exponentialformat benutzen \\ \hline \end{tabular} \bigskip Alle anderen Zeichen werden unverändert übernommen.% \footnote{Es wird ein Prozentzeichen vor der Zahl ausgegeben, wenn im Formatstring kein ausreichender Platz für die Ziffern angegeben wurde.} \paragraph{Beispiel:} 'DM \verb|######.##|' gibt vor der Zahl das Währungssymbol \textsl{DM} aus; die Zahl wird auf genau zwei Nachkommastellen gerundet. \item [Schriftfarbe:] Sie können eine Farbe auswählen, mit der die Datenbeschriftung erfolgen soll. Dazu müssen Sie die Nummer des gewünschten Farbregisters angeben. Zusätzlich können Sie angeben, ob die Grafik überhaupt beschriftet werden soll. Wenn Sie die Schriftfarbe sperren, wird sie nicht zur Darstellung der Daten benutzt. Diese Einstellungen gelten nur für die Daten (Werte) selbst. Die Bezeichnungen werden in jedem Fall ausgegeben. \end{description} \item [Zeichensatz \dots{}] Über diesen Menüpunkt können Sie den zu verwendenden Zeichensatz und dessen Größe festlegen. Die Zeichensatzauswahl geschieht über einen ASL-Requester. \item [Balkendiagramme \dots{}] Sie können die maximale Breite der Balken sowie den Abstand zwischen den Balken festlegen. Zusätzlich ist die Angabe des Abstandes zwischen den Balken und der Beschriftung möglich. \item [Liniendiagramme \dots{}] Sie können angeben, ob die Linien in einer einzigen oder in der jeweiligen Datenfarbe gezeichnet werden sollen. Außerdem können Sie das zu verwendende Linienmuster ändern. Folgende Zeichen sind innerhalb des Musterstrings erlaubt: \bigskip \begin{tabular}{|l|l|} \hline \textsc{Zeichen} & \textsc{Bedeutung} \\ \hline \hline 1 & Punkt wird gezeichnet \\ \hline 0 & Punkt wird nicht gezeichnet \\ \hline \end{tabular} \bigskip Standardmäßig wird eine durchgezogene Linie gezeichnet. \paragraph{Anmerkung:} Es gelten auch die Einstellungen für Balkendiagramme. \item [Tortendiagramme \dots{}] Sie können wählen, ob die Werte oder nur Prozentwerte angegeben werden sollen. \end{description} \subsection{Das \textit{Extras}-Menü} \begin{description} \item [Beispieldaten] Es werden zufällige Daten und Farben verwendet. \paragraph{Anmerkung:} Die Daten und Einstellungen des aktuellen Projekts werden ohne Sicherheitsabfrage überschrieben! \item [Hilfe] Die On\-line-Do\-ku\-men\-ta\-tion wird über \texttt{SYS:Utilities/Multiview} angezeigt. \end{description} \subsection{Das \textit{Grafik}-Menü} Dieses Menü ist nur im Grafikbildschirm verfügbar. \begin{description} \item [sichern als \dots{}] Sie können über einen ASL-Requester die Datei auswählen, in die der Bildschirminhalt geschrieben werden soll. Es wird eine Stan\-dard-IFF-ILBM-Datei erzeugt.% \footnote{Zum Schreiben der Grafikdatei wird das mitgelieferte Utility \textsf{grabscreen} benutzt, dessen Beschreibung Sie weiter unten finden.} Wenn die Datei geschrieben wurde, blinkt der Bild\-schirm kurz auf. \item [drucken] Die Grafik wird auf dem voreingestellten Drucker ausgegeben. Danach blinkt der Bildschirm kurz auf. \item [schließen] Der Grafikbildschirm wird geschlossen und die gesperrten Menüs wieder angezeigt. \end{description} \newpage \section{Copyright} Copyright (C) 1997 by FR-SoftWorks. \textbf{Für eventuelle Schäden, die durch das Programm entstehen, wird nicht gehaftet.} \textsf{MicroChart} ist Public Domain und darf -- jedoch nur als vollständiges Archiv -- weitergegeben werden. Verbesserungsvorschläge, Fragen und Fehlerberichte senden Sie bitte an: \begin{verbatim} Frank Reibold Ottberger Weg 13 31737 Rinteln \end{verbatim} Bei Fehlerberichten notieren Sie bitte die genaue Fehlermeldung und schildern auch die Situation, die den Fehler verusachte. Geben Sie auch Ihre Hard\-ware\-kon\-figura\-tion (benutzter Computer, Betriebssystemversion usw. ) an. \newpage \section{History} \begin{tabular}{ll} 1.0.0 & Erste Version des Programms. \\ \end{tabular} \newpage \section{Fehlermeldungen} \textsf{MicroChart} generiert die folgenden Fehlermeldungen: \bigskip \begin{tabular}{p{4.5cm}p{4.5cm}} Datei nicht gefunden. & Sie wollten eine Datei öffnen, die nicht existiert. \textbf{Lösung:} Öffnen Sie eine andere Datei.\\ \end{tabular} \bigskip \begin{tabular}{p{4.5cm}p{4.5cm}} »Dateiname« - Unbekanntes Dateiformat. & Sie wollten eine Datei öffnen, die nicht im \textsf{MicroChart}-Format gespeichert wurde. \textbf{Lösung:} Öffnen Sie eine \textsf{Mi\-cro\-Chart}-Pro\-jekt\-da\-tei. Diese haben normalerweise die Dateinamenserweiterung \texttt{.MCD}. \\ \end{tabular} \bigskip \begin{tabular}{p{4.5cm}p{4.5cm}} AGA Chip\-set nicht erkannt. Screen-Tiefe wurde zu\-rück\-ge\-setzt. & Das eingestellte Bild\-schirm\-for\-mat wird von Ih\-rem Ami\-ga nicht un\-ter\-stützt. \textbf{Lösung:} \textsf{MicroChart} hat die An\-zahl der Fa\-rben au\-to\-ma\-tisch re\-du\-ziert und erstellt das Dia\-gramm. Wenn Ihnen die Far\-ben nicht gefallen, sollten Sie den Befehl \textit{Autofarben} im Menü \textit{Edieren} aufrufen. \\ \end{tabular} \bigskip \begin{tabular}{p{4.5cm}p{4.5cm}} Bild\-schirm\-for\-mat kann nach der Dia\-grammer\-stel\-lung nicht mehr ge\-än\-dert werden. & Sie haben während der laufenden Sitzung schon ein Dia\-gramm erstellt und möchten jetzt eine Pro\-jekt\-da\-tei öffnen bzw. das Bild\-schirm\-for\-mat wechseln. \textbf{Lösung:} Wenn Sie ein anderes Bild\-schirm\-for\-mat ein\-stel\-len möchten, müssen Sie folgende Schritte ausführen: \begin{enumerate} \item Speichern Sie ggfs. das aktuelle Pro\-jekt. \item Verlassen Sie Mi\-cro\-Chart. \item Starten Sie Mi\-cro\-Chart neu. \item Laden Sie Ihre Pro\-jekt\-da\-tei. \item Ändern Sie das Bild\-schirm\-for\-mat. \item Nun können Sie das Dia\-gramm mit dem gewünschten Bild\-schirm\-for\-mat anzeigen. \end{enumerate}\\ \end{tabular} \bigskip \begin{tabular}{p{4.5cm}p{4.5cm}} Es wurde noch kein Pro\-jekt de\-fi\-niert. & Sie wollten Daten eingeben oder ein Dia\-gramm anzeigen, ohne ein Pro\-jekt de\-fi\-niert zu haben. \textbf{Lösung:} Fol\-gen\-de Mög\-lich\-kei\-ten stehen zur Verfügung: \begin{itemize} \item Öffnen Sie ein vorhandenes Pro\-jekt \item Erstellen Sie mit dem Befehl \textit{Bei\-spiel\-da\-ten} im Menü \textit{Extras} ein Pro\-jekt mit Zu\-falls\-da\-ten. \item Rufen Sie den Befehl \textit{Neu} im \textit{Pro\-jekt}-Menü auf, um ein neues Pro\-jekt zu beginnen. \end{itemize}\\ \end{tabular} \newpage \section{Die mitgelieferten Utilities} \subsection{Das Utility \textsf{grabscreen}} \textsf{MicroChart} benutzt dieses Programm, um den Grafikbildschirm in einer IFF\-Datei zu speichern. Sie können es jedoch auch selbst aus dem CLI aufrufen. \bigskip \verb|grabscreen filename [screenname]| \bigskip \begin{tabular}{|l|l|} \hline \textsc{Option} & \textsc{Bedeutung} \\ \hline \hline filename & der Name der zu erzeugenden Datei \\ \hline screenname & der Name des zu sichernden Bildschirms \\ \hline \end{tabular} \bigskip Wenn Sie den Namen des Screens nicht angeben, wird der aktuelle Bildschirm gesichert. Wenn Sie \textsf{grabscreen} nur mit dem Argument '?' aufrufen, wird ein Hilfetext angezeigt. \subsection{Das Utility \textsf{iffview}} Das Programm kann über Workbench oder CLI gestartet werden und dient dem Anzeigen von Grafiken im IFF-Format. Es wird von \textsf{MicroChart} für die Bildanzeige in der Online-Dokumentation verwendet. \bigskip \verb|iffview [filename]| \bigskip Falls beim Aufruf keine Datei angegeben wird, öffnet das Programm einen ASL-Requester. Das Programm wird durch einen Mausklick beendet. \newpage \section{Tutorial} \subsection*{Willkommen beim Tutorial!} Wir wollen Ihnen in unserem Tutorial zeigen, wie man z. B. eine Umsatzstatistik mit \textsf{MicroChart} ganz einfach erstellen kann. \subsection*{Vorbereitungen} Rufen Sie bitte den Befehl \textit{Projekt/Neu \dots{}} auf, um mit der Umsatzstatistik zu beginnen. Geben Sie als Datenanzahl eine \texttt{4} (vier) ein. Stellen Sie jetzt bitte mittels des Menübefehles \textit{Op\-ti\-onen/Be\-schrif\-tung} die Einstellung \textit{Schrift\-far\-be sperren} auf \texttt{J}. Die Schriftfarbe wird nun nicht mehr für die Datendarstellung verwendet. \subsection*{Daten eingeben} Geben Sie bitte folgende Daten ein: \bigskip \begin{tabular}{|l|r|} \hline \textsc{Bezeichnung} & \textsc{Wert} \\ \hline \hline I. Quartal & 230000 \\ \hline II. Quartal & 320000 \\ \hline III. Quartal& 280000 \\ \hline IV. Quartal & 170000 \\ \hline \end{tabular} \bigskip Die Farbwerte übernehmen Sie bitte so, wie sie vorgegeben sind. Rufen Sie anschließend bitte den Befehl \textit{Autofarben} auf, der die Daten unter Berücksichtigung der Sperrung der Schriftfarbe einfärbt. \subsection*{Daten anzeigen} Stellen Sie bitte mit dem Befehl \textit{Optionen/Bildschirmformat} einen Bildschirm mit folgenden Werten ein: \bigskip \begin{tabular}{|l|r|} \hline \textsc{Option} & \textsc{Wert} \\ \hline \hline Breite & 640 \\ \hline Höhe & 512 \\ \hline Tiefe & 4 \\ \hline \end{tabular} \bigskip Dies erzeugt einen Hires-Laced-Screen mit 16 Farben. Nun stellen Sie bitte noch mittels \dq Optionen/Beschriftungen\dq das Zahlenformat 'DM \verb|########|' ein. Geben Sie außerdem über \textit{Edieren/Titel} den Diagrammtitel \texttt{Um\-satz\-sta\-ti\-stik} ein. Nun können Sie sich für einen Diagrammtyp entscheiden und die Grafik über den entsprechenden Befehl im Diagramm-Menü anzeigen lassen. \subsection*{Sichern der Grafik} Wenn Sie die Grafik im IFF-Format speichern möchten, um sie mit einem Malprogramm überarbeiten zu können, können Sie das jetzt mit dem Befehl \textit{sichern als \dots{}} im neuen Menü \textit{Grafik} tun. In diesem Menü finden Sie auch einen Befehl zum Drucken der Grafik. Schließen Sie jetzt bitte den Grafikbildschirm über den entsprechenden Befehl. \subsection*{Das Projekt sichern} Rufen Sie bitte den Befehl \textit{Sichern} im Menü \textit{Projekt} auf, und geben Sie als Namen \texttt{Umsatz} ein. \textsf{MicroChart} sichert das Projekt als \texttt{Umsatz.MCD}. \subsection*{Ausblick} Hiermit ist das Tutorial beendet. Sie sollten einmal einige Optionen verändern, um zu sehen, was sie bewirken. Dies ist die beste Methode, das Programm kennenzulernen. \newpage \section{Beispielprojekte} \subsection*{Demo} Dies ist eine einfache Demonstration. \subsection*{Tutorial} In dieser Datei können Sie überprüfen, ob Sie bei der Durcharbeitung des Tutorials zum korrekten Ergebnis gekommen sind. \subsection*{Basic} Hier sind die Laufzeiten eines Testprogramms (Zählen von 1 bis 1 000 000) für verschiedene Programmiersprachen in Ticks ($ \frac{1}{50} $ Sekunden) angegeben. Bei Verwendung eines Balkendiagramms kann man sehr gut erkennen, welche der untersuchten Programmiersprachen die schnellste ist. \subsection*{Textverarbeitungen} Dies ist das Ergebnis eines Vergleichs von Textverarbeitungsprogrammen für Windows 95. Die komplette Untersuchung finden Sie im separaten \textsf{MicroBase}- Archiv. \end{document}