forked from LibreDWG/libredwg
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
213 lines (155 loc) · 8.36 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
LibreDWG - free implementation of the DWG file format
LibreDWG is a free C library to read and write DWG files. This program is
part of the GNU project, released under the aegis of GNU. It is licensed
under the terms of the GNU General Public License version 3 (or at you option
any later version).
DWG is a file format created in the 70's for the emerging CAD applications.
Currently it is the native file format of AutoCAD, a proprietary CAD program
developed by AutoDesk.
LibreDWG is a fork from LibDWG due to its usage of Esperanto, which we
think is not the best strategy for a free software project which aims
to get lots of contributors. LibreDWG is written in English. At the
moment our decoder (i.e. reader) is done, just some very advanced
R2010+ and pre-R13 entities fail to read and are skipped over. The
writer is good enough for R2000. Among the example applications we
wrote using LibreDWG is a reader, a writer, a rewriter (i.e. saveas),
an initial SVG and Postscript conversion, dxf and json converters,
dwggrep to search for text, and dwglayer to print the list of layers.
More are in the pipeline.
Please contact us if you want to help.
The strings API is utf-8 (wtf8 really, Windows UCS-2 has no surrogate
pairs), and encodes to the internal 8-bit or UCS-2 strings, depending
on the DWG version.
Sometimes we hang on our IRC channel which is #libredwg at irc.freenode.net
If you don't find us there, please email the package maintainers:
Reini Urban <rurban AT cpan.org>
The now inactive founders and previous maintainers were:
Felipe Corrêa da Silva Sanches <juca AT members.fsf.org>
Rodrigo Rodrigues da Silva <pitanga AT members.fsf.org>
Hardeep Singh Rai <hardeep.rai AT gmail DOT com>
If you are looking for general information about the project, check our website:
http://www.gnu.org/software/libredwg
== Building and installing the library ==
You need the following dependencies:
- Basic development tools (a C99 compiler like gcc/clang, make, autoconf, automake
and libtool)
Optionally:
- gperf to update static hashes for several API's
Only needed when you added objects or changed the dwg.spec significantly
- TeXinfo for building the docs
- pslib for dwg2ps: http://pslib.sourceforge.net/doc/pslib.html
- pcre2 with 8bit and 16bit libraries for dwggrep regexp support
- SWIG 1.7+
- Python 2.7 or 3.x development headers (debian: python-dev; yum: python-devel)
and the libxml2 python bindings.
- Perl 5 for the perl bindings
- doxygen to generate the reference manual
- jq to check json validity
- shellcheck to check shell scripts
- rpmlint to check the spec validity
- jinq with some svg11 relaxng to check SVG validity.
LaTeXML used to have a broken svg11-basic.rng. If so
the zip from http://yupotan.sppd.ne.jp/relax-ng/svg11/ is correct.
Needs to be installed into /usr/local/share/relaxng/svg11/
sudo unzip ~/Downloads/svg11-relaxng-20060604.zip -d /usr/local/share/relaxng/
On Ubuntu I needed:
apt install jing libjaxp1.3-java libbatik-java libavalon-framework-java
- mapbox/geojsonhint as geojson linter
npm install -g @mapbox/geojsonhint
- geojson-validation as 2nd geojson fallback linter
npm install -g geojson-validation
- valgrind to find leaks and memory bugs
- timeout to help tests with large or hanging DWG's
- GNU parallel to speed up special tests (not the moreutils parallel!)
- picat to find unknown fields, a better prolog. http://picat-lang.org/
See INSTALL for generic instructions. Basically, you do:
$ sh ./autogen.sh (if you checked out the source code from git)
$ ./configure [--enable-trace] [--disable-write] [--disable-shared]
$ make
$ make check
$ sudo make install
This builds and installs various files in the "installation dirs":
$libdir ($exec_prefix/lib) -- library files (libredwg.*)
$includedir ($prefix/include) -- dwg.h dwg_api.h
$libdir/pkgconfig -- libredwg.pc
$infodir ($datarootdir/info) -- LibreDWG.info
Use "./configure --help" to see a full list of options you can use to
customize the installation dirs. Other options recognized by configure are:
--enable-release
Recommended for packagers and fuzzers. Disables all features
which will not be enabled in official tarball releases. Like support
for pre-R13 DWGs, skipping unstable DWG features, unknown DWG versions
and objects.
--enable-trace
Enable runtime tracing (default: no). When enabled, the environment
variable LIBREDWG_TRACE is consulted on the first decode/encode attempt.
Its value is an integer: 0 (no output) through 9 (full verbosity).
Most tools do support a --verbosity|-v flag instead.
--disable-write
Disable DWG write support (default: no). When enabled, you activate the write
support for the DWG format.
This is an experimental feature. Rewriting most DWG's to the r2000 format
usually works fine, DWG versions since r2004 are not yet supported, and the
API usage is very rough so far.
--disable-bindings
Disable SWIG bindings for python and perl5.
--disable-dxf
Disables all in and out modules: DXF, DXFB, JSON, GeoJSON.
--disable-json
Disables the json in and out modules: JSON, GeoJSON.
--disable-python
Disable python bindings and tests.
Related: --enable-python=python3.6
Enforce a specific version.
--enable-debug
Activates support for unstable classes. For testing only.
--enable-gcov
Activates support for GNU gcov, test coverage reporting.
--with-perl-install=vendor
Where to install the perl bindings: vendor,arch,yes,no,site.
Default is perl-install=site
== Windows ==
See the following scripts how we build on Windows:
* build-aux/smoke.sh: cross-compilation recipes
* build-aux/msys2.bat: msys2 deps
* .appveyor.yml: windows smoker
We only support C99 compilers and POSIX environments, i.e. cygwin or msys or cross.
stdint.h and inttypes.h must be available.
Pre-compiled Windows binaries are here: https://github.com/LibreDWG/libredwg/releases
== Example usage of the library ==
The programs and examples directories contains some application code that uses our lib:
* dwgread -- A DWG reader supporting various output formats, such as
JSON, DXF, DXFB, GeoJSON. Later also YAML, XML/OGR, GPX, SVG, PS.
* dwgwrite -- A DWG writer supporting various input formats, such as DXF, DXFB, JSON.
GeoJSON, YAML, XML/OGR, GPX are under construction.
* dwgrewrite -- Reads a DWG, writes it back under a different name and optionally
under a different version (default r2000), and re-reads it back for confirmation.
* dwg2dxf -- Converts a DWG to a DXF (ascii or binary, minimal or full), optionally
under a different version. About 90% coverage.
* dxf2dwg -- Converts a ascii or binary DXF to a DWG (r2000 only so far).
About 80% coverage.
* dwglayers -- Prints the list of layers in a DWG. Optionally with --extnames
* dwggrep -- Searches DWG files for a text string, via regular expressions.
* dwg2ps -- Opens a DWG file and outputs an PostScript file. This code
depends on the PSlib library. On Debian-based systems this is usually
available as a package named pslib-dev. This is very limited so far.
* dwg2SVG -- Opens a DWG file and outputs an SVG (Scalable Vector Graphics)
file. SVG is a W3C standard for 2d vector graphics. You can open these
files on several free software tools. We recommend Inkscape, a free software
vector graphics editor. The dwg2SVG program will not handle 3d content
from DWG since SVG only supports 2-dimensional images. Handles only some
entities.
* dwgbmp -- Extracts the bmp thumbnail of a dwg file when it is available.
* load_dwg -- This is a skeleton code, reading the DWG and adding an entity.
Look there if you want to have a quickly glance on how to use the library.
* dwg2svg2 -- Another example how to use the DWG API, bypassing direct access to
the DWG struct.
* xmlsuite -- an extensive example library to use XML to compare against prepared
features is in the test/xmlsuite directory. It also features code to output entities
in XML, but does not use the python bindings.
Copyright (C) 2009, 2010, 2015, 2018-2020 Free Software Foundation, Inc.
This library is free software, licensed under the terms of the GNU
General Public License as published by the Free Software Foundation,
either version 3 of the License, or (at your option) any later version.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.