ezdxf-browse(1)

1EZDXF-BROWSE(1)                  User Commands                 EZDXF-BROWSE(1)
2
3
4

ezdxf browse – PyQt DXF structure browser for DXF debugging and curious people

SYNOPSIS

8       ezdxf browse [-h] [-l LINE] [-g HANDLE] [FILE]
9

DESCRIPTION

11       The browse command opens a DXF structure browser to investigate the in‐
12       ternals of a DXF file without interpreting the content.  The  function‐
13       ality  of  the  DXF  browser  is  similar  to  the  DXF  Pretty Printer
14       (ezdxf-pp(1) command), but without the disadvantage of  creating  giant
15       HTML  files.   The intended usage is debugging invalid DXF files, which
16       cannot be loaded by the  ezdxf.readfile()  or  the  ezdxf.recover.read‐
17       file() functions.
18
19   LINE NUMBERS
20       The  low  level  tag  loader ignores DXF comments (group code 999).  If
21       there are comments in the DXF file the line numbers  displayed  in  the
22       DXF  browser  are  not synchronized, use the ezdxf-strip(1) command be‐
23       forehand to remove all comments from the DXF file in order to keep  the
24       line numbers synchronized.
25
26   GUI FEATURES
27       The  tree view on the left shows the outline of the DXF file.  The num‐
28       ber in round brackets on the right side of each item shows the count of
29       structure  entities  within  the  structure  layer,  the value in angle
30       brackets on the left side is the entity handle.
31
32       The right list view shows the entity content as  DXF  tags.   Structure
33       tags  (data  type <ctrl>) are shown in blue, a double click on a refer‐
34       ence handle (datatype <ref>) jumps to the referenced entity,  reference
35       handles of non-existent targets are shown in red.
36
37       Clicking on the first structure tag in the list opens the DXF reference
38       provided by Autodesk in the standard web browser.
39
40   AUTO RELOAD
41       The browser automatically displays a dialog for reloading DXF files  if
42       they have been modified by an external application.
43
44   MENUS AND SHORTCUTS
45       File Menu
46
47              • Open DXF file...  Ctrl+O
48
49              • Reload DXF file Ctrl+R
50
51              • Open  in  Text Editor Ctrl+T, open the DXF file in the associ‐
52                ated text editor at the current location
53
54              • Export DXF Entity...  Ctrl+E, export the  current  DXF  entity
55                shown in the list view as text file
56
57              • Copy  selected  DXF Tags to Clipboard Ctrl+C, copy the current
58                selected DXF tags into the clipboard
59
60              • Copy DXF Entity to Clipboard Ctrl+Shift+C, copy all  DXF  tags
61                of  the  current  DXF  entity  shown in the list view into the
62                clipboard
63
64              • Quit Ctrl+Q
65
66       Navigate Menu
67
68              • Go to Handle...  Ctrl+G
69
70              • Go to Line...  Ctrl+L
71
72              • Find Text...  Ctrl+F, opens the find text dialog
73
74              • Next Entity Ctrl+Right, go to  the  next  entity  in  the  DXF
75                structure
76
77              • Previous  Entity  Ctrl+Right, go to the previous entity in the
78                DXF structure
79
80              • Show Entity in TreeView Ctrl+Down, expand the left  tree  view
81                to the currently displayed entity in the list view – this does
82                not happen automatically for performance reasons
83
84              • Entity History Back Alt+Left
85
86              • Entity History Forward Alt+Right
87
88              • Go to HEADERS Section Shift+H
89
90              • Go to BLOCKS Section Shift+B
91
92              • Go to ENTITIES Section Shift+E
93
94              • Go to OBJECTS Section Shift+O
95
96       Bookmarks Menu
97
98              • Store Bookmark...  Ctrl+Shift+B,  store  current  location  as
99                named bookmark
100
101              • Go to Bookmark...  Ctrl+B, go to stored location
102

OPTIONS

104   POSITIONAL ARGUMENTS
105       FILE   DXF file to browse
106
107   OPTIONAL ARGUMENTS
108       -h, --help
109              show a help message and exit
110
111       -l LINE, --line LINE
112              go to line number
113
114       -g HANDLE, --handle HANDLE
115              go to entity by HANDLE, HANDLE has to be a hex value without any
116              prefix like ‘fefe’
117

ENVIRONMENT

119       See ezdxf(1).
120

FILES

122       See ezdxf(1).
123
124       The browse command stores options in the  config  file,  e.g.  for  the
125       Notepad++ on Windows:
126
127              [browse-command]
128
129              text_editor = "C:\Program Files\Notepad++\notepad++.exe" "{filename}" -n{num}
130              icon_size = 32
131
132       text_editor   is   a  simple  format  string:  text_editor.format(file‐
133       name="test.dxf", num=100)
134
135       Quote commands including spaces and always quote the filename argument!
136
137       For xed(1) on Linux Mint use (note: absolute path to executable):
138
139              [browse-command]
140
141              text_editor = /usr/bin/xed "{filename}" +{num}
142              icon_size = 32
143
144       For gedit(1) use (untested):
145
146              [browse-command]
147
148              text_editor = /usr/bin/gedit +{num} "{filename}"
149              icon_size = 32
150

EXAMPLES

152       Browse the internal structure of a DXF file like a file system:
153
154              $ ezdxf browse gear.dxf
155