\magnification=\magstep1

\input german.sty
\input nice

\hsize = 5in
\vsize = 7.7in
\voffset = 0.4in

\book

\contentslevel=3
\contfill={\dotfill}
\contskip=4pt

\let\scstyle=\bf
\font\subsubsectiontitlefont=cmr10 scaled \magstep1

\titlepage
\vskip 1in
\title{DVIPrintSetUp, die Druckhilfe}
\removelastskip
\smallskip
\title{f"ur den AMIGA}
\bigskip
\release{Version 3.86}
\smallskip
\release{vom}
\release{\today}
\bigskip
\author{von}
\author{Stefan Scherer}
\vfill
\abstract{
  DVIPrintSetUp soll den Umgang mit dem Pas\TeX-Druckertreiber DVIprint
  erleichtern. Es ist in Verbindung mit dem Previewer ShowDVI gedacht
  und soll das ARexx-Skript StartDVIprint.sd ersetzen. Die graphische
  Oberfläche stellt die wichtigsten Druckoptionen zur Verfügung und
  kann (fast) vollständig per Tastatur bedient werden. Das Programm
  läuft nur ab Kickstart~V37 oder höher. DVIPrintSetup ist Freeware.}

\vskip 0.7in
\endtitlepage

\medskip
\plainsection{Inhaltsverzeichnis:}
\medskip
\makecontents
\newpage

\section{Copyright}

Das Programm DVIPrintSetup ist Freeware.  Das heißt, jeder darf es sich
kopieren und verwenden, das Copyright bleibt aber vollständig bei mir
(Stefan Scherer).  Das Programm darf auch nur unverändert weitergegeben
werden.

Der Quellcode wird mit veröffentlich, jedoch darf er nur für Lernzwecke
verwendet werden. Der Quellcode darf nur vollständig und unverändert
weitergegeben werden.

\section{Allgemeines über DVIPrintSetUp}

Mit dem Programm DVIPrintSetUp kann man von ShowDVI aus sehr einfach
und komfortabel drucken. Bisher war ein recht dürftiges ARexx-Skript
vorhanden, mit dem man Anfangs- und Endseiten einstellen konnte. Da die
Auswahl mit "`OK"' und "`Cancel"' leicht irreführend ist und auch
sonst fast keine Einstellmöglichkeiten bestanden, habe ich als
Schnittstelle dieses Programm geschrieben. Nun lassen sich zum Beispiel
der Drucker, die Offsets für den Ausdruck und viele andere Optionen
einstellen und falls gewünscht als dauerhafte Grundeinstellung speichern.

\section{Die Installation von DVIPrintSetUp}

Die Installation muß per Hand vollzogen werden. Trotzdem sollte sie in
wenigen, leichten Schritten machbar sein.

\numbered 1
\next Kopieren Sie "`DVIPrintSetup"' in das Verzeichnis "`{\tt TeX:bin/}"'. Das
ARexx-Skript sucht das Programm in diesem Pfad.

\next Kopieren Sie das ARexx-Skript "`StartDVIPrintSetup.sd"' in das Verzeichnis
"`{\tt TeX:Rexx/}"' oder, falls nicht vorhanden, nach "`{\tt Rexx:}"'. 

\next Nun muß die Konfiguration von ShowDVI geändert werden.  Nehmen Sie
dazu einen Texteditor und laden Sie die Datei "`{\tt
TeX:config/ShowDVI.config}"' ein.  Entweder überschreibt man die
Funktionstaste, die bisher für das Drucken zuständig war, oder man führt
eine neue Funktionstaste ein.  Jedenfalls muß für die gewünschte Taste das
ARexx-Skript "`{\tt TeX:rexx/StartDVIPrintSetup}"' eingetragen werden.
Speichern Sie die Änderung ab.

\next Falls Sie bisher die Environmentvariable "`DVIPRINT"' verwendet
haben, sollten Sie dort alles entfernen, was man mit DVIPrintSetup auch
einstellen kann.  Da\-runter fallen die Offsets, der Drucker, sowie einige
weitere Werte.  In "`DVIPRINT"' sollten dann nur noch statische Werte, wie
die Größe des Fontpuffers und solche Dinge drin stehen.  \endnumbered

Damit wäre die Installation abgeschlossen.  Laden Sie nun ShowDVI sowie ein
DVI-File und drücken Sie die Funktionstaste zum Drucken.  Es erscheint nun
das Fenster von DVIPrintSetup.  Dort können Sie noch alle weiteren
Grundeinstellungen vornehmen.  Danach sollten Sie Ihre persönlichen
Einstellungen in DVIPrintSetup speichern und einen Probedruck starten.

\newpage
\section{Der Aufruf von DVIPrintSetUp}

DVIPrintSetUp wird normalerweise nur innerhalb des ARexx-Skriptes
"`StartDVIPrintSetUp.sd"' aufgerufen, das über eine beliebige
Funktionstaste aktiviert wird, die in ShowDVI.config definiert werden kann.
Das Programm verlangt zwei Parameter:  den Dateinamen des DVI-Files sowie
die Seitennummer, mit der die Gadgets "`From"' und "`To"' vorbelegt werden.
Diese Parameter werden automatisch vom ARexx-Skript geliefert.

Nach dem Aufruf erscheint ein Fenster auf dem Screen von ShowDVI, oder
falls dieser nicht existiert auf dem WorkBench Screen, und das Gadget
"`From"' ist aktiviert.  In den Feldern für die Seitennummern steht jedes
mal die aktuelle Seitennummer.  Im Normalfall sind bereits alle
Einstellungen richtig und man möchte daher zum Drucken nur die
Seitennummern ändern (zum Beispiel, wenn man über mehrere Seiten drucken
möchte).

Andererseits können zahlreiche Optionen für DVIprint geändert werden, etwa
der horizontale und der vertikale Druckoffset mit ihren getrennten
Einheiten, die Einstellung, ob alle Seiten eines Bereiches hintereinander,
nur die geraden oder nur die ungeraden Seiten gedruckt werden sollen, die
Ausgabedatei (auch "`NIL:"' gehört dazu) sowie die weiteren Schalter, die
ausführlich in der Dokumentation von DVIprint beschrieben sind.

\section{Die Hilfefunktion von DVIPrintSetUp}

Ist DVIPrintSetUp aktiv, kann mit der "`Help"'-Taste eine kontextsensitive
Hilfe aufgerufen werden.  Durch Anklicken der einzelnen Gadgets oder durch
Auslösen der Textgadgets wird der zugehörige Hilfetext angezeigt.  Keine
Angst mit "`Save"'oder "`Print"':  Die Funktionen und Schalter von
DVIPrintSetUp sind dabei ausgeschaltet und nach Verlassen der Hilfefunktion
werden auch alle Gadgets auf ihren ursprünglichen Zustand zurückgesetzt.

\section{Technisches}

Das Programm DVIPrintSetup verwendet für eine dauerhafte Speicherung der
Einstellungen eine Konfigurationsdatei, die in "`{\tt
TeX:config/DVIPrintSetup.config}"' abgelegt wird.  Zusätzlich merkt sich
das Programm nach einem Druckvorgang die letzten Werte (außer den
Seitennummern) für den nächsten Druckauftrag in einer Environmentvariablen
"`DVIPRINTSETUP"'.

Diese Variable geht nach einem Reset wieder verloren.  Dies hat jedoch den
Vorteil, daß nicht ständig die Grundeinstellungen überschrieben werden
müssen, auch wenn einige Einstellungen vorübergehend gemerkt bleiben
sollen.

\newpage
\section{Autor}

Bei Problemen, Fehlern, Anregungen etc.{} bitte beim Autor melden. Meine
Adresse lautet

\itemlist{\quad\quad}
\next Stefan Scherer
\next Abt-Wolf-Straße 17
\next 96215 Lichtenfels
\next Tel: $(0\,95\,71) 20\,13$
\enditemlist
\bye
