DWGDUMP is a utility for analyzing AutoCAD drawings              Ver. 1.4


Written By: Rick Llewellyn (Compuserv ID, 73417,1357)
            HDR Engineering, Inc.             
            8404 Indian Hills Dr.            
            Omaha, NE 68114-4049


         --- This software is released into the public domain ---

DWGDUMP was written to address quality control and translation issues within 
our company. The development took place over a few weeks here and there and 
we have not put any further time into development. As a result, the format of
the output data is a bit sloppy, but the data seems to be correct. I would 
appreciate any comments to make the software more useful.



USAGE   : dwgdump [-option ...] filespec

OPTIONS : 
          h = Header data only.
          b = Block list only.
          v = View list only.
          p = Viewport list only.
          u = UCS list only.
          l = Layer list only.
          y = Linetype list only.
          s = Shape list only.
          t = CDF list of time variables.
          r = AutoCAD version number only.
          e = Entity summary


SAMPLE CALLS : 

dwgdump -hvly *.dwg      
(would dump header, view, layer and linetype list forall drawings in the 
current directory)

dwgdump -r c:\acad\*.dwg 
(would dump version number of each drawing in the C:\ACAD directory.)

dwgdump -sb c:\acad
(would FAIL, since the dwg file extension has not been specified)

dwgdump -sb c:\acad\*.dwg >out.lst
(would dump shape and block list to the file named OUT.LST in the current
directory)

dwgdump -t c:\acad\*.dwg >times.cdf
(would generate a file suitable to use to import into a database or 
spreadsheet)

dwgdump -e c:\acad\*.dwg |more
(would pipe the screen output to the MORE filter to show a page of the
entity summaries for all drawings in the C:\ACAD directory)


OPTION DESCRIPTIONS :

[-h] the header that is dumped contains data that is typically in the
     header section of a DXF file. All variable names are output in 
     alphabetical order and the dimension variables are segregated into
     a separate section. The header list is not all inclusive, there are a
     few obscure variables which are not dumped.

[-b] the block list is pulled from the tables and listed in the order in
     which they are found, presumably the order in which they were defined
     or inserted. Nested blocks are not identified.

[-v] the view list is also pulled from the tables and are listed in the in
     which they were created.

[-p] the viewport list shows the viewports and ones that are marked as
     purged, or no longer necessary.

[-u] the UCS list shows the UCSs which are defined and lists their names.

[-l] the layer list shows the layer name, color and linetype.

[-y] the linetype list shows the linetype name and description.

[-s] the shape list shows the names of the shapes which are referenced
     in the drawing.

[-t] lists the drawing name, date created, time created, last date updated, 
     last time updated, time in editor and time in user timer. Times are
     expressed as 0000:00:00.000 (Hrs:Min:Seconds.Milliseconds).

[-r] this option simply prints the version number of the drawing.

[-e] shows the numbers of types of entities in the drawing. Currently
     dumps 3D FACE, 3D LINE, ARC, BLOCK INSERT, CIRCLE, LINE, POINT,
     PLINE, SOLID, TEXT and TRACE entity counts.

SUGGESTIONS FOR USE :

Use the -r option to locate old .DWG files which may need to be updated.
Use the -l option to verify the correctness and visibility of layers.
Use the -b option to locate a block which may not have been WBLOCKed.
Use the -h option to verify menu names.
Use the -t option to build a report to import into xBase.
Use the -l option, redirect to file, import file into .DWG file.
Use the -e option to determine if non-translatable entities have been used.


REVISION HISTORY
--------------------------------------------------------------------------
Version 1.4 (5/7/93)

Added the [-e] option to obtain quick checks & counts of entities.
Also corrected a bug which prevented long menu names from dumping.

--------------------------------------------------------------------------
Version 1.3 (8/2/92) NOT RELEASED ON COMPUSERV

Added some code to print the XREF path of an XREF. It is printed as
part of the block list and only is printed if a drawing has an XREF
that is not purged. There is some anomaly which I do not understand
and there are some non XREF things are ocassionally appearing.
--------------------------------------------------------------------------
Version 1.2 (12/12/91)

Corrected formats of a few of the header variable outputs.

Added [-t] option which reports values of the timer variables.
--------------------------------------------------------------------------
Version 1.1 (11/26/91)

Fixes several bugs and also provides some enhancements
to the output.

There was a bug which prevented more than 33 blocks, layers, etc. to
be displayed. DWGDUMP will now list up to; 200 blocks, 200 layers, 
100 shapes, 100 linetypes, 20 views and 20 UCSs. This type of bug caused
systems to hang.

Some Y & Z values for header values were not being printed. This should
take care of all of those instances. 

Formatting for the values was reviewed, exponential notation is now 
used to display some of the larger values. Each section now has a 
header consisting of the '=' character. Each section ends with a trailer
consisting of a '-' character. 

The layer listing was reformatted so that a layer is specifically ON or 
OFF.

All lists are now in sorted order, rather than the order found.

Eliminated need to use lower case letters on command line.
--------------------------------------------------------------------------