//////////////////////////////////////////////////
/////  Fukui Renderer                        /////
/////  DAWN (Drawer for Academic WritiNgs)   /////
/////                                        /////
//////////////////////////////////////////////////

            Authors:
              Satoshi   Tanaka    (Ritsumeikan University (Rits), JAPAN)
              Minato    Kawaguti  (Fukui University, JAPAN)
              Hiroshi   Hasui     (Fukui University, JAPAN)
              Yoshitaka Kawabata  (Fukui University, JAPAN)
              Takeshi   Konya     (Fukui University, JAPAN)
              Tetsuji   Nishimura (Fukui University, JAPAN)
              Masahiro  Noguchi   (Fukui University, JAPAN)
              Kensuke   Ohtubo    (Fukui University, JAPAN)
              Yasuhide  Sawada    (Fukui University, JAPAN)
              Masayasu  Kawabata  (Fukui University, JAPAN)                 

            E-mail:
              stanaka@media.ritsumei.ac.jp

* About DAWN

    Fukui  Renderer   DAWN (Drawer for Academic WritiNgs) 
  is a renderer, which reads 3D geometrical data and visualize them.  
  It is a vectorized 3D PostScript processor. 
  It aims at precise technical drawing of complicated objects.  
  It performs geometrical hidden line/surface removal and calculates 
  out all visible parts of the 3D data before drawing.  This drawing 
  algorithm realizes device-independent technical high quality of
  vectorized graphics.
    3D Data files should be generated by a modeler or by hands 
  separately.  If you use DAWN as a visualizer of, 
  say, a simulator of physical experiments, 
  the simulator application itself is recognized as a modeler.
    An important feature of DAWN is that
  it has been developed to visualize 3D data generated by
  a high-energy experimental detector simulator "GEANT4".  
  How to use DAWN as  a visualizer of GEANT 4 is also described below.

* Quick installation guide

      In most of Unix systems (Linux/Cygwin/MacOSX,etc), 
    the default Makefile, i.e., "Makefile.default", 
    should be available:

      % cp Makefile.default Makefile
      % make clean
      % make guiclean
      % make 
      % su
      # make install

    Then DAWN is installed into /usr/local/bin.

     Note 1: In Cygwin the final "strip" command fails. 
             But you can ignore this error. If you do not like 
             the error, edit only one line of "Makefile.default" 
             as follows.
                "EXEC = dawn" ===> "EXEC = dawn.exe"     

     Note 2: If you need only PostScript-processing function 
            i.e. if you do not want to include OpenGL-visualization 
            mode, you can use "Makefile.min" instead of 
            "Makefile.default".
  
    If the above default Makefiles are not available in your system
    unfortunately, you need to execute a proper configure script.
    For details, see  ./DOC/About_DAWN.html.

* BUG
  In recent Linux (RedHat 8/9, FederaCore), 
  the X-Window mode does not work.
   (If you find how to fix this bug, please inform to 
    Satoshi Tanaka (stanaka@media.ritsumei.ac.jp).)
  Use OpenGL the mode instead.
  In Mac OSX, X-Window mode works.


* For more details...

    For more details, see document in the directory ./DOC,
  where some documents are placed:

   ./DOC/About_DAWN.html     : INSTALLATION manual and USAGES of DAWN
   ./DOC/CUSTOMIZE           : How to customize behavior of DAWN with
                               environmental variables
   ./DOC/DAWN_HISTORY.html   : Development history
   ./DOC/G4PRIM_FORMAT_24.tex: Detaild description on DAWN data format


 In directory ./TOOLS, some simple but useful tools for DAWN are placed.
 For details, see ./TOOLS/README.

 Enjoy DAWN, please!!