ezdxf - Man Page

ezdxf – command launcher for the Python package “ezdxf”

Synopsis

ezdxf [-h] [-V] [-f] [-v] [--config CONFIG] [--log LOG] {pp,audit,draw,view,browse,browse-acis,strip,config,info,hpgl} ...

Options

Positional Arguments

Each of these has a corresponding man page: for example,: ezdxf-pp(1) for “ezdxf pp”.
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
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(1). This may not represent the original content of the file; use ezdxf-browse(1) to see the original content.
hpgl: View and/or convert HPGL/2 plot files to various formats

Optional Arguments

-h, --help: show a help message and exit
-V, --version: show version and exit
-f, --fonts: rebuild the system font cache and print all fonts found
-v, --verbose: give more output
--config CONFIG: path to a config file
--log LOG: path to a verbose appending log, stderr logs to the standard error stream

Environment

EZDXF_DISABLE_C_EXT: Set environment variable EZDXF_DISABLE_C_EXT to 1 or True to disable the usage of the C-extensions.
EZDXF_TEST_FILES: Path to the ezdxf test files required by some tests, for instance the CADKit sample files should be located in the EZDXF_TEST_FILES/CADKitSamples folder. See also option ezdxf.options.test_files.
EZDXF_CONFIG_FILE: Specifies a user config file which will be loaded automatically after the default config files at the first import of ezdxf. See the Files section.
XDG_CONFIG_HOME: When searching for a default config file in the user home directory, ezdxf(1) follows the XDG Base Directory specification if the environment variable XDG_CONFIG_HOME is set. See the Files section.

The default config files are loaded from the user home directory as ~/.config/ezdxf/ezdxf.ini, and the current working directory as ./ezdxf.ini. A custom config file can be specified by the environment variable EZDXF_CONFIG_FILE. ezdxf(1) follows the XDG Base Directory specification if the environment variable XDG_CONFIG_HOME is set.

The config file loading order:

user home directory: ~/.config/ezdxf/ezdxf.ini
current working directory: ./ezdxf.ini
config file specified by EZDXF_CONFIG_FILE

A configuration file that is loaded later does not replace the previously loaded ones, only the existing options in the newly loaded file are added to the configuration and can overwrite existing options.

Examples

Show the ezdxf(1) version and configuration:

$ 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

Referenced By

ezdxf-audit(1), ezdxf-browse(1), ezdxf-browse-acis(1), ezdxf-config(1), ezdxf-draw(1), ezdxf-hpgl(1), ezdxf-info(1), ezdxf-pp(1), ezdxf-strip(1), ezdxf-view(1).

July 2023