Launcher

The command line script ezdxf launches various sub-commands:

pp DXF pretty printer, replacement for the previous dxfpp command
audit Audit and repair DXF files
draw Draw and convert DXF files by the Matplotlib backend
view PyQt DXF file viewer
pillow Draw and convert DXF files by the Pillow backend
browse PyQt DXF structure browser for DXF debugging and curious people
browse-acis PyQt ACIS entity content browser for SAT/SAB debugging
strip Strip comments and THUMBNAILIMAGE section from DXF files
config Manage config files
info Show information and optional stats of DXF files as loaded by ezdxf

The help option -h is supported by the main script and all sub-commands:

C:\> ezdxf -h
usage: ezdxf [-h] [-V] [-v] [--config CONFIG] [--log LOG]
             {pp,audit,draw,view,browse,browse-acis,strip,config} ...

Command launcher for the Python package "ezdxf":
https://pypi.org/project/ezdxf/

positional arguments:
  {pp,audit,draw,view,browse,strip}
    pp                  pretty print DXF files as HTML file
    audit               audit and repair DXF files
    draw                draw and convert DXF files by Matplotlib
    view                view DXF files by the PyQt viewer
    pillow              draw and convert DXF files by Pillow
    browse              browse DXF file structure
    browse-acis         browse ACIS structures in DXF files
    strip               strip comments from DXF files
    config              manage config files
    info                show information and optional stats of DXF files loaded by ezdxf,
                        this may not represent the original content of the file, use the
                        browse command to see the original content

optional arguments:
  -h, --help            show this help message and exit
  -V, --version         show version and exit
  -v, --verbose         give more output
  --config CONFIG       path to a config file
  --log LOG             path to a verbose appending log

Note

The ezdxf script is the only executable script installed on the user system.

Pretty Printer

Pretty print the DXF text content as HTML file and open the file in the default web browser:

C:\> ezdxf pp -o gear.dxf
_images/gear-pp.png

Print help:

C:\> ezdxf pp -h
usage: ezdxf pp [-h] [-o] [-r] [-x] [-l] [-s SECTIONS] FILE [FILE ...]

positional arguments:
  FILE                  DXF files pretty print

optional arguments:
  -h, --help            show this help message and exit
  -o, --open            open generated HTML file by the default web browser
  -r, --raw             raw mode, no DXF structure interpretation
  -x, --nocompile       don't compile points coordinates into single tags (only in raw mode)
  -l, --legacy          legacy mode, reorder DXF point coordinates
  -s SECTIONS, --sections SECTIONS
                        choose sections to include and their order, h=HEADER, c=CLASSES,
                        t=TABLES, b=BLOCKS, e=ENTITIES, o=OBJECTS

Audit

Audit and recover the DXF file “gear.dxf” and save the recovered version as “gear.rec.dxf”:

C:\> ezdxf audit -s gear.dxf

auditing file: gear.dxf
No errors found.
Saved recovered file as: gear.rec.dxf

Print help:

C:\> ezdxf audit -h
usage: ezdxf audit [-h] [-s] FILE [FILE ...]

positional arguments:
  FILE        audit DXF files

optional arguments:
  -h, --help  show this help message and exit
  -s, --save  save recovered files with extension ".rec.dxf"

Draw

Convert the DXF file “gear.dxf” into a SVG file by the Matplotlib backend:

C:\> ezdxf draw -o gear.svg gear.dxf

The “gear.svg” created by the Matplotlib backend:

_images/gear.svg

Show all output formats supported by the Matplotlib backend on your system. This output may vary:

C:\> ezdxf draw --formats
eps: Encapsulated Postscript
jpg: Joint Photographic Experts Group
jpeg: Joint Photographic Experts Group
pdf: Portable Document Format
pgf: PGF code for LaTeX
png: Portable Network Graphics
ps: Postscript
raw: Raw RGBA bitmap
rgba: Raw RGBA bitmap
svg: Scalable Vector Graphics
svgz: Scalable Vector Graphics
tif: Tagged Image File Format
tiff: Tagged Image File Format

Print help:

C:\> ezdxf draw -h
usage: ezdxf draw [-h] [--formats] [-l LAYOUT] [--all-layers-visible]
                  [--all-entities-visible] [-o OUT] [--dpi DPI] [-v]
                  [FILE]

positional arguments:
  FILE                  DXF file to view or convert

optional arguments:
  -h, --help            show this help message and exit
  --formats             show all supported export formats and exit
  -l LAYOUT, --layout LAYOUT
                        select the layout to draw, default is "Model"
  --all-layers-visible  draw all layers including the ones marked as invisible
  --all-entities-visible
                        draw all entities including the ones marked as
                        invisible (some entities are individually marked as
                        invisible even if the layer is visible)
  -o OUT, --out OUT     output filename for export
  --dpi DPI             target render resolution, default is 300
  -v, --verbose         give more output

View

View the DXF file “gear.dxf” by the PyQt backend:

C:\> ezdxf view gear.dxf
_images/gear-qt-backend.png

Print help:

C:\> ezdxf view -h
usage: ezdxf view [-h] [-l LAYOUT] [--lwscale LWSCALE] [FILE]

positional arguments:
  FILE                  DXF file to view

optional arguments:
  -h, --help            show this help message and exit
  -l LAYOUT, --layout LAYOUT
                        select the layout to draw, default is "Model"
  --lwscale LWSCALE     set custom line weight scaling, default is 0 to
                        disable line weights at all

Pillow

Convert the DXF file “gear.dxf” into a PNG file by the Pillow backend:

C:\> ezdxf pillow -o gear.png gear.dxf

Advantage over the Draw command is the speed and much less memory usage, disadvantage is the lower text rendering quality. The speed advantages is lost for the text modes OUTLINE and FILLED, because the text-path rendering is done by Matplotlib, but the advantage of the lower memory consumption remains.

Print help:

C:\> ezdxf pillow -h
usage: ezdxf pillow [-h] [-o OUT] [-l LAYOUT] [-i IMAGE_SIZE] [-b BACKGROUND]
                    [-r OVERSAMPLING] [-m MARGIN] [-t {0,1,2,3}] [--dpi DPI] [-v]
                    [FILE]

positional arguments:
  FILE                  DXF file to draw

options:
  -h, --help            show this help message and exit
  -o OUT, --out OUT     output filename, the filename extension defines the image format
                        (.png, .jpg, .tif, .bmp, ...)
  -l LAYOUT, --layout LAYOUT
                        name of the layout to draw, default is "Model"
  -i IMAGE_SIZE, --image_size IMAGE_SIZE
                        image size in pixels as "width,height", default is "1920,1080",
                        supports also "x" as delimiter like "1920x1080". A single
                        integer is used for both directions e.g. "2000" defines an image
                        size of 2000x2000. The image is centered for the smaller DXF
                        drawing extent.
  -b BACKGROUND, --background BACKGROUND
                        override background color in hex format "RRGGBB" or "RRGGBBAA",
                        e.g. use "FFFFFF00" to get a white transparent background and a
                        black foreground color (ACI=7), because a light background gets
                        a black foreground color or vice versa "00000000" for a black
                        transparent background and a white foreground color.
  -r OVERSAMPLING, --oversampling OVERSAMPLING
                        oversampling factor, default is 2, use 0 or 1 to disable
                        oversampling
  -m MARGIN, --margin MARGIN
                        minimal margin around the image in pixels, default is 10
  -t {0,1,2,3}, --text-mode {0,1,2,3}
                        text mode: 0=ignore, 1=placeholder, 2=outline, 3=filled, default
                        is 2
  --dpi DPI             output resolution in pixels/inch which is significant for the
                        linewidth, default is 300
  -v, --verbose         give more output

Browse

Browse the internal structure of a DXF file like a file system:

C:\> ezdxf browse gear.dxf
_images/gear-browse.png
C:\> ezdxf browse -h
usage: ezdxf browse [-h] [-l LINE] [-g HANDLE] [FILE]

positional arguments:
  FILE                  DXF file to browse

optional arguments:
  -h, --help            show this help message and exit
  -l LINE, --line LINE  go to line number
  -g HANDLE, --handle HANDLE
                        go to entity by HANDLE, HANDLE has to be a hex value without
                        any prefix like 'fefe'

The browse command stores options in the config file, e.g. for the Notepad++ on Windows:

[browse-command]

text_editor = "C:\Program Files\Notepad++\notepad++.exe" "{filename}" -n{num}
icon_size = 32

text_editor is a simple format string: text_editor.format(filename="test.dxf", num=100)

Quote commands including spaces and always quote the filename argument!

For xed on Linux Mint use (note: absolute path to executable):

[browse-command]

text_editor = /usr/bin/xed "{filename}" +{num}
icon_size = 32

For gedit on Linux use (untested):

[browse-command]

text_editor = /usr/bin/gedit +{num} "{filename}"
icon_size = 32

The browse command opens a DXF structure browser to investigate the internals of a DXF file without interpreting the content. The functionality of the DXF browser is similar to the DXF Pretty Printer (pp command), but without the disadvantage of creating giant HTML files. The intended usage is debugging invalid DXF files, which can not be loaded by the ezdxf.readfile() or the ezdxf.recover.readfile() functions.

Line Numbers

The low level tag loader ignores DXF comments (group code 999). If there are comments in the DXF file the line numbers displayed in the DXF browser are not synchronized, use the strip command beforehand to remove all comments from the DXF file in order to keep the line numbers synchronized.

GUI Features

The tree view on the left shows the outline of the DXF file. The number in round brackets on the right side of each item shows the count of structure entities within the structure layer, the value in angle brackets on the left side is the entity handle.

The right list view shows the entity content as DXF tags. Structure tags (data type <ctrl>) are shown in blue, a double click on a reference handle (datatype <ref>) jumps to the referenced entity, reference handles of non-existent targets are shown in red.

Clicking on the first structure tag in the list opens the DXF reference provided by Autodesk in the standard web browser.

Auto Reload

The browser automatically displays a dialog for reloading DXF files if they have been modified by an external application.

Browse-ACIS

Show and export the SAT or SAB content of ACIS entities:

C:\> ezdxf browse-acis 3dsolid.dxf
_images/browse-acis-3dsolid.png

The DXF format stores modern solid geometry as SAT data for DXF R2000 - R2010 and as SAB data for DXF R2013 and later. This command shows the content of this entities and also let you export the raw data for further processing.

Entity View

The entity view is a read-only text editor, it’s possible to select and copy parts of the text into the clipboard. To improve the readability all ACIS entities get automatically an id because AutoCAD and BricsCAD use relative references for ACIS data export and do not assign entity ids. The id is shown as decimal number in parenthesis after the entity name. The ~ character is a shortcut for a null-pointer.

C:\>ezdxf browse-acis -h
usage: ezdxf browse-acis [-h] [-g HANDLE] [FILE]

positional arguments:
  FILE                  DXF file to browse

options:
  -h, --help            show this help message and exit
  -g HANDLE, --handle HANDLE
                        go to entity by HANDLE, HANDLE has to be a hex value
                        without any prefix like 'fefe'

Menus and Shortcuts

  • File Menu
    • Open DXF file… Ctrl+O
    • Reload DXF file Ctrl+R
    • Export Current Entity View… Ctrl+E, Export the parsed content of the entity view as text file
    • Export Raw SAT/SAB Data… Ctrl+W, export the raw SAT data as text file and the raw SAB data as a binary file for further processing
    • Quit Ctrl+Q

Strip

Strip comment tags (group code 999) from ASCII DXF files and can remove the THUMBNAILIMAGE section. Binary DXF files are not supported.

C:\> ezdxf strip -h
usage: ezdxf strip [-h] [-b] [-v] FILE [FILE ...]

positional arguments:
  FILE           DXF file to process, wildcards "*" and "?" are supported

optional arguments:
  -h, --help       show this help message and exit
  -b, --backup     make a backup copy with extension ".bak" from the DXF file,
                   overwrites existing backup files
  -t, --thumbnail  strip THUMBNAILIMAGE section
  -v, --verbose    give more output

Config

Manage config files.

C:\> ezdxf config -h
usage: ezdxf config [-h] [-p] [-w FILE] [--home] [--reset]

optional arguments:
  -h, --help   show this help message and exit
  -p, --print  print configuration
  -w FILE, --write FILE
               write configuration
  --home       create config file 'ezdxf.ini' in the user home directory
               '~/.config/ezdxf', $XDG_CONFIG_HOME is supported if set

  --reset      factory reset, delete default config files 'ezdxf.ini'

Info

Show information and optional stats of DXF files as loaded by ezdxf, this may not represent the original content of the file, use the browse command to see the original content. The upgrade is necessary for very old DXF versions prior to R12 and for the “special” versions R13 and R14. The -s option shows some statistics about the DXF content like entity count or table count. Use the -v option show more of everything.

C:\> ezdxf info -h
usage: ezdxf info [-h] [-v] [-s] FILE [FILE ...]

positional arguments:
  FILE           DXF file to process, wildcards "*" and "?" are supported

options:
  -h, --help     show this help message and exit
  -v, --verbose  give more output
  -s, --stats    show content stats

This is the verbose output for an old DXF R10 file and shows that the loading process created some required structures which do not exist in DXF R10 files, like the BLOCK_RECORD table or the OBJECTS section:

C:\> ezdxf info -v -s test_R10.dxf

Filename: "test_R10.dxf"
Loaded content was upgraded from DXF Version AC1006 (R10)
Release: R12
DXF Version: AC1009
Maintenance Version: <undefined>
Codepage: ANSI_1252
Encoding: cp1252
Unit system: Imperial
Modelspace units: Unitless
$LASTSAVEDBY: <undefined>
$HANDSEED: 0
$FINGERPRINTGUID: {9EADDC7C-5982-4C68-B770-8A62378C2B90}
$VERSIONGUID: {49336E63-D99B-45EC-803C-4D2BD03A7DE0}
$USERI1=0
$USERI2=0
$USERI3=0
$USERI4=0
$USERI5=0
$USERR1=0.0
$USERR2=0.0
$USERR3=0.0
$USERR4=0.0
$USERR5=0.0
File was not created by ezdxf >= 0.16.4
File was not written by ezdxf >= 0.16.4
Content stats:
LAYER table entries: 18
  0
  Defpoints
  LYR_00
  LYR_01
  LYR_02
  LYR_03
  LYR_04
  LYR_05
  LYR_06
  LYR_07
  LYR_08
  LYR_09
  LYR_10
  LYR_11
  LYR_12
  LYR_13
  LYR_14
  LYR_15
LTYPE table entries: 13
  BORDER
  ByBlock
  ByLayer
  CENTER
  CONTINUOUS
  CUTTING
  DASHDOT
  DASHED
  DIVIDE
  DOT
  HIDDEN
  PHANTOM
  STITCH
STYLE table entries: 1
  STANDARD
DIMSTYLE table entries: 1
  Standard
APPID table entries: 1
  ACAD
UCS table entries: 0
VIEW table entries: 0
VPORT table entries: 1
  *Active
BLOCK_RECORD table entries: 2
  *Model_Space
  *Paper_Space
Entities in modelspace: 78
  ARC (2)
  CIRCLE (2)
  LINE (74)
Entities in OBJECTS section: 20
  ACDBDICTIONARYWDFLT (1)
  ACDBPLACEHOLDER (1)
  DICTIONARY (11)
  LAYOUT (2)
  MATERIAL (3)
  MLEADERSTYLE (1)
  MLINESTYLE (1)

Show Version & Configuration

Show the ezdxf version and configuration:

C:\> ezdxf -Vv

ezdxf v0.16.5b0 @ d:\source\ezdxf.git\src\ezdxf
Python version: 3.9.6 (tags/v3.9.6:db3ff76, Jun 28 2021, 15:26:21) [MSC v.1929 64 bit (AMD64)]
using C-extensions: yes
using Matplotlib: yes

Configuration:
[core]
default_dimension_text_style = OpenSansCondensed-Light
test_files = D:\Source\dxftest
font_cache_directory =
load_proxy_graphics = true
store_proxy_graphics = true
log_unprocessed_tags = false
filter_invalid_xdata_group_codes = true
write_fixed_meta_data_for_testing = false
disable_c_ext = false

[browse-command]
text_editor = "C:\Program Files\Notepad++\notepad++.exe" "{filename}" -n{num}


Environment Variables:
EZDXF_DISABLE_C_EXT=
EZDXF_TEST_FILES=D:\Source\dxftest
EZDXF_CONFIG_FILE=

Existing Configuration Files:
C:\Users\manfred\.config\ezdxf\ezdxf.ini

See also

Documentation of the ezdxf.options module and the Environment Variables.