November 2002                                                    (Version 1.22)
                              ============
                              HILFE & INFO
                              ============
                              

 


                               0. Inhalt
                               =========

         1.  Was ist DXF?
         2.  Wie mensch den Betrachter benutzt
         3.  Untersttzte Eigenschaften von DXF / Ausblick
         4.  Danksagungen
         5.  Lizenz
         6.  Fehler





                              1. Was ist DXF
                              ==============

   DXF ist ein Datenaustauschformat fr CAD-Daten. Es wurde ursprnglich
von der Firma Autodesk, Inc. fr ihr bekanntes Produkt AutoCAD(tm) vor
etwa 15 Jahren entwickelt und ist seitdem mit jeder AutoCAD-Version fort-
entwickelt worden.

   Trotzdem es eigentlich proprietr ist, gibt es heutzutage tausende von
Programmen, die von sich behaupten, DXF lesen oder schreiben zu knnen. 
Unter ihnen befindet sich nahezu jedes CAD-Programm (wenig erstaunlich),
viele DTP- und Malprogramme und manches andere. Dieser Betrachter ist eins
davon.



                   2. Wie mensch den Betrachter benutzt
                   ====================================

                            2.1 So geht's los
                            -----------------

   Zunchst bentigt mensch mindestens eine zum JDK/JRE 1.1.x (oder neuer) 
kompatible Java-Version.

   Fr Java-Version 1.2 und neuer: zum Betrachten einer DXF-Datei einfach
folgenden Befehl aufrufen:
        java -jar dxfviewer.jar dxffilename     

   Fr Java-Version 1.1.x: das den Betrachter beinhaltende JAR-Archiv muss an 
den CLASSPATH angehngt werden. Dann kann eine DXF-Datei betrachtet werden 
durch Eingabe von:
        java de.escape.quincunx.dxf.DxfViewer dxffilename

   Um eine andere Sprache einzustellen, kann die Property dxfview.language
gesetzt werden. Z.B.
        java -Ddxfview.language=de_DE -jar dxfviewer.jar

bzw. fr Java 1.1.x:
	java -Ddxfview.language=de_DE de.escape.quincunx.dxf.DxfViewer 

startet den Betrachter mit deutscher Oberflche, ohne eine Datei zu laden. 
Standardsprache ist Englisch.

   Zur Frderung der guten alten Bequemlichkeit empfiehlt es sich sehr, dies
in eine Skript- oder Batchdatei zu packen. Mit dem JAR-Archiv sollte eigent-
lich auch eine DOS-Batchdatei (namens DV.BAT) und ein Unixskript (namens dv)
mitgekommen sein. Diese lassen sich leicht anpassen, damit der Betrachter
dann so gestartet werden kann:
        dv dxffilename

   Der Betrachter kann einfache DXF-Dateien und mit gzip oder (pk)zip 
gepackte Dateien laden. Die Dateien brauchen keine spezielle Dateiendung wie
z. B. .dxf. 

   Eine andere Mglichkeit, eine DXF-Datei zu betrachten, ist wie blich ber
das Dateimen. Der Fortgang des Ladens und Konvertierens der Datei lt sich
mit dem wachsenden Balken unten rechts abschtzen.

Es gibt noch zwei Eigenschaften, die ber den Kommandozeilenschalter -D gesetzt
werden knnen:

dxfview.reducelines -- eine Ganzzahl, die die Anzahl der Linien, die in der
                       reduzierten Darstellung anzeigt werden, angibt.

preview.reducelines -- eine Ganzzahl, die die Anzahl der Linien in der
                       Druckvorschau angibt. 0 lsst alle Linien darstellen!


                              2.2 Bedienung
                              -------------

                                 Bewegen
                                 
Der Inhalt der DXF-Datei wird als Drahtgittermodell dargestellt. Dieses kann
gedreht, verschoben und sklaiert werden, indem die Maus mit gedrckter Taste
ber das Betrachterfenster geschoben wird. Die verschiedenen Maustasten bzw.
zustzliches Drcken von Strg (Ctrl) und Umschalt (Shift) whlen die ver-
schiedenen Bewegungsmglichkeiten aus.

LINKE      Maustaste (und keine Umschalttaste) zum Drehen des Modells.
           Beim Rotieren erscheint ein Kreis. Am besten stell man sich
           einen Ball vor, der in diesem Kreis liegt. Bewegt man die
           Maus innerhalb des Kreises ist es so, als wenn man diesen
           Ball mit der Maus festhlt und dreht. Das Modell bewegt
           sich entsprechend. Bewegt man die Maus auerhalb des Kreises,
           wird das Modell entsprechend der Bewegung um die Blickachse 
           gedreht. Nach kurzer Eingewhnungszeit kann man die Sicht auf
           diese Weise perfekt kontrollieren.
MITTLERE   Maustaste (oder LINKE und UMSCHALT) zum Verschieben.
RECHTE     Maustaste (oder LINKE und STRG) zum Skalieren bzw. ndern der
           Entfernung.

Damit's bei umfangreicheren Modellen etwas schneller geht, lt sich die Kom-
plexitt der Darstellung mittels der Auswahl in der oberen rechten Ecke
ndern:

[Komplett bewegen]   bewegt das komplette Modell (langsam)
[Maximalbox bewegen] bewegt nur einen Kasten (schnell)
[reduziert bewegen]  zeigt beim Bewegen nur einen Teil der Linien (Default)


Durch vorherige Ansichten kann mittels der zwei Knpfe [Vorherige]/[Nchste]
geblttert werden. 
Rcksetzen auf [X-Y] setzt die Ansicht auf eine Blickrichtung parallel
                     zur z-Achse zurck,
               [Y-Z] entsprechend senkrecht zur x-Achse und
               [X-Z] senkrecht zur y-Achse.


                                 Layer
                                 
Die Daten in der DXF-Datei ist auf sogenannten Layern organisiert. Diese
knnen mittels der kleinen Listen unten rechts an- oder abgeschaltet werden.
Der Knopf [Invertieren] kehrt die Auswahl um, der Knopf [Alle selektieren]
schaltet alle Layer ein. Layer, die in der Datei als 'versteckt' markiert
sind, sind auch zunchst unselektiert.


                                Drucken
                                
Es ist prinzipiell mglich, die angezeigte Ansicht zu drucken, indem der
entsprechende Punkt im Dateimen ausgewhlt wird. Drucken ist allerdings
in den bisherigen Java-Version nur sehr rudimentr untersttzt, also
bitte lieber nicht zuviel erwarten.

Fr alle Nutzer mit Zugang zu PostScript-Druckern gibt es seit neuerem auch
die Mglichkeit, PostScript-Dateien direkt zu erzeugen. Diese ergeben einen
erheblcih besseren Ausdruck als die Java1.1-internen Druckroutinen.


                       Sprache [Optionen>Sprache]
                       
Die Sprache lt sich zwischen Englisch und Deutsch ndern. Englisch ist 
Standard, aber in Abschnitt 2.1 steht, wie der Betrachter in Deutsch 
startet. Die Sprache von manchen Systemdialogen wird allerdings nicht
gendert.

            Koordinatensystem [Optionen>KS zeigen/KS-Position]
            
In die Ansicht lt sich zur Orientierung ein kleines Hilfskoordinatensystem
einblenden. Es kann ausgewhlt werden, in welcher Ecke es dargestellt wird
(Hierbei steht SW fr Sd-West etc.).

      Schwarz & Wei austauschen [Optionen>Schwarz & Wei austauschen
      
DXF hat normalerweise einen schwarzen Hintergrund. Wer es lieber anders
mag, kann dies durch entsprechendes Auswhlen im Optionenmen erreichen.

                     Meldungen [Info>Meldungen]
                     
Hier werden die Meldungen und Warnungen vom Dateieinlesen angezeigt.

                      Modell Info [Info>Modell]
                      
Hier werden rudimentre Informationen ber das momentane Modell angezeigt.

                        JVM [Info>Java-Info]
                        
Hier werden einige Informationen ber die Java Virtual Machine angezeigt.
Dies kann fr Fehlerberichte sehr sinnvoll sein.

                               Beenden
                               
Sollten Sie das Programm tatschlich jemals wieder verlassen wollen, so 
geht dies wie blich ber das Dateimen->Beenden.



                              2.3 Applet
                              ----------

   Der Viewer ist eigentlich in der vorliegenden Form auch schon als Applet
benutzbar, die diversen Bugs der verschiedenen Internetbrowser erfordern aber
ein etwas komplizierteres Vorgehen, wobei gewisse Teile des jar-Archivs auf
dem Server entpackt bereitgestellt werden mssen. Das genauere Vorgehen und
ein entsprechend vorbereitetes Paket sind auf der Internetseite
        http://www.escape.de/users/quincunx/dxfviewer/
zu finden.


                   3. Untersttze Eigenschaften von DXF
                   ====================================

   Das DXF-Format ndert sich mit jeder neuen Version von AutoCAD(tm).
Dieser Betrachter versteht DXF, wie es von AutoCAD R12 geschrieben
wurde. Dies ist auch die meistgenutzte Version von DXF.

   AutoDesk hat das DXF-Format beginnend mit AutoCAD R13 von Grund auf
gendert. Der Viewer wird neuere DXF-Dateien daher nur bedingt richtig
darstellen.   


			    DXF-Entities
                            
                             
Hier nun eine Tabelle aller DXF-Entities (Elemente) und wie sie der 
Betrachter untersttzt oder auch nicht.	

            ENTITY                |           Status
----------------------------------+-------------------------------------
            POINT                 |           untersttzt (nur Punkte)
                                  |
            LINE/3DLINE           |           untersttzt
                                  | 
            CIRCLE                |           untersttzt
                                  |
            ARC                   |           untersttzt
                                  |
            TRACE                 |           untersttzt
                                  |
            SOLID                 |           untersttzt
                                  |
            TEXT                  |           untersttzt (in der Version
                                  |           mit Zeichenstzen)
                                  |
            SHAPE                 |           NICHT untersttzt
                                  |
            POLYLINE/VERTEX       |           untersttzt
                                  |
            3DFACE                |           untersttzt
                                  |
            VIEWPORT/VPORT/VIEW   |           noch nicht untersttzt
                                  |
            DIMENSION             |           untersttzt
                                  |
            BLOCK/INSERT          |           untersttzt
                                  |
            ATTRIB/ATTDEF         |           untersttzt
----------------------------------+-------------------------------------



                          Entity-Eigenschaften
                          

   DXF-Entities knnen verschiedene Eigenschaften haben. In der folgenden
Tabelle steht, ob (und mglicherweise, wie) sie angezeigt werden.

            EIGENSCHAFT           |           Status
----------------------------------+-------------------------------------
            Farbe                 |           untersttzt
                                  |
            Layer                 |           untersttzt
                                  |
            Strichlierung         |           untersttzt
                                  |
            Linienbreite          |           noch nicht untersttzt
                                  |
            Hochzug               |           untersttzt
                                  |
            Schriftart            |           untersttzt wenn bekannt 
                                  |           (in der Schriftartversion)
----------------------------------+-------------------------------------
                                  


                             Ausblick
                             --------

*  Alles, was 'noch nicht untersttzt' gebrandmarkt ist, wartet darauf,
   endlich implementiert zu werden.

*  Wenn es eine verbreitete 3D-Schnittstelle gibt, wren schattierte 
   Modelle ein nettes Feature.

*  Drucken mu wirklich besser werden.




                        4. Danksagungen
                        ===============

*  Vielen Dank an die Leute bei Sun, die das JDK umsonst zur Verfgung
   stellen.

*  Dieses Programm entstand unter Linux. Also tausend Dank an die Linux-
   Gemeinde und alle anderen, die daran mitgeholfen haben, fr die
   Zillionen Jahren unbezahlter Arbeit, die dies mglich gemacht haben.

*  Speziellen Dank an Frank Gerberding fr das Raytracen des Logos auf
   seinem berchtigten PPC-angetriebenen Amiga.

*  Dank an Tim Niels van der Leeuw, der mir die Idee eingab, da Java-
   Ein- und Ausgabe nicht langsam sein mu.

*  Vielen Dank an HP Knoll aus Paris fr eine binre DXF-Datei. Nunmehr
   beherrscht der Betrachter auch dieses eher seltene Format. 

*  Dank an Dietmar Rudolph/Thomas Strznickel/Leo Weissenberger fr das
   Schreiben des Buches "Der DXF-Standard" (ISBN 3-87686-246-9). Es war
   unverzichtbar (und vielleicht werde ich eines Tages alle Fehler gefunden
   haben  ;-)



                            5. Lizenz
                            =========

   Nehmen Sie dies Programm, benutzen Sie es, verteil es. Es ist umsonst.
Wenn Sie es schaffen, damit Schaden zu verursachen, werde ich staunen, aber 
nicht dafr aufkommen. Sie benutzen es auf Ihr eigenes Risiko. 

   Es ist mglich, die Quellen zu bekommen. Dazu mssen Sie mir eine Email
schreiben und ich werde sie Ihnen vermutlich zur Verfgung stellen. Ich bin
einfach neugierig, wer sich dafr interessiert und mchte auch verhindern,
da jemand das ganze mit ein paar nderungen als eigenes Produkt (oder als
Teil eines Programms) verkauft. Hier ist meine Adresse:

                      rammi@quincunx.escape.de

                      Rammi (alias Andreas M. Rammelt)
                      Gliesmaroder Str. 95
                      38106 Braunschweig
                      Germany
                      Tel. +49-531-343054
                      


                               6. Fehler 
                               =========

                             Fehler mitteilen
                             

   Wenn Sie einen Fehler finden sollten, schaue bitte erst, ob er weiter unten bereits 
erwhnt wird. Falls nicht, so wre es nett, wenn Sie einen kurzen Bericht an obige
Adresse schicken wrden. Bitte fgen Sie das JVM-Info, da Sie unter dem Menpunkt
[Info>Java-Info] erhalten, bei. Falls mglich und nicht zu gro (<1MByte), schicken
Sie bitte die DXF-Datei, die den Fehler verursacht, mit. Vielen Dank!

   Ich suche noch immer nach AutoCAD-R14 -DXF-Dateien. Falls Sie Zugriff zu AutoCAD 
haben, knnten Sie diesen Betrachter verbessern helfen, indem Sie von dort eine
normale und eine binre DXF-Datei exportieren und an die oben angegebene Adresse
senden.


                             Bekannte Fehler
                             

Die mittlere Maustaste funktioniert nicht mit JDK1.2 unter Windows
------------------------------------------------------------------
Das ist ein JDK1.2-Fehler. 
Bis er behoben ist, verschieben Sie das Modell bitte durch zustzliches Drcken
der Umschalt (Shift) Taste.

Das Koordinatensystem erscheint abgeschnitten mit JDK1.2 unter Windows
----------------------------------------------------------------------
Das ist ein JDK1.2-Fehler.
Abhilfe ist keine bekannt.

Das Betrachterfenster reagiert nicht auf Grenvernderungen auf SGI
--------------------------------------------------------------------
Dieser Fehler wurde fr SGI-Maschinen mit JDK 1.1.5 (3.1) auf Irix 6.2 berichtet.
Abhilfe ist keine bekannt.

Das Drucken ist nicht zufriedenstellend
---------------------------------------
Das ist ein bekanntes Java 1.1-Problem. Es sollte besser werden, wenn der Betrachter
nach Java 1.2 portiert ist.




Stand: 15. November 2002