Debian Codegraph @

ogr/ogrsf_frmts/dgn/web/index.html

raw
1 <html>
2 <head>
3 <title>DGNLib: Microstation DGN (ISFF) Reader</title>
4 <link href="http://www.maptools.org/maptools.css" rel="stylesheet" type="text/css">
5 </head>
6 <body bgcolor="#ffffff">
7
8 <h1>DGNLib: a Microstation DGN (ISFF) Reader</h1>
9
10 I (<a href="http://pobox.com/~warmerdam">Frank Warmerdam</a>)
11 have implemented a Microstation DGN reading library on contract to
12 <a href="http://www.avenza.com/">Avenza Systems Inc.</a>, makers of
13 MAPublisher. The library will be OpenSource (under my usual MIT license),
14 portable and callable from C/C++. While it has been incorporated into my
15 <a href="http://gdal.maptools.org/ogr">OGR Simple Features</a> library, it is
16 also be usable standalone with minimal overhead. The dgnlib library, and this
17 page of DGN related information are primarily hosted at
18 <a href="http://dgnlib.maptools.org/">http://dgnlib.maptools.org</a>.<p>
19
20 <h2>DGNLib</h2>
21
22 DGNLib is a small C/C++ library for reading and writing DGN files.
23
24 <ul>
25
26 <li> <b>Where can I get the source code?</b><p>
27
28 <a href="dl/dgnlib-1.11.zip">dgnlib-1.11.zip</a>: Current standalone source
29 with <i>dgndump</i> example mainline.<p>
30
31 <li> <b>Does DGNLib support all DGN elements?</b><p>
32
33 No, but it does support most 2D and 3D elements. Some of the more esoteric
34 elements are read in "raw data mode", but not interpreted. It does support
35 lines, line strings, curves, bsplines, ellipses,
36 arcs, and text elements, as well as extracting color tables, and master
37 coordinate information.<p>
38
39 <li> <b>Does DGNLib support Microstation V8 DGN Files?</b><p>
40
41 No, they are a substantially different format, and are not recognised at
42 all. The DGNdirect library from the <a href="http://www.opendwg.org">OpenDWG
43 Alliance</a> does support DGN v8.<p>
44
45 <li> <b>Is it portable?</b><p>
46
47 Yes, fairly, though as distributed it may be necessary to tweak the
48 cpl_port.h and cpl_config.h files for different platforms. It was developed
49 on Linux for a client deploying on MacOS, and Windows.<p>
50
51 <li> <b>Does it require a lot of memory?</b><p>
52
53 Generally speaking no. Only one element at a time is kept in memory. If
54 the file is "indexed" an additional 12 bytes per element is kept in memory
55 after a pre-scan, but this isn't required.<P>
56
57 <li> <b>Does DGNLib include code to draw DGN elements?</b><p>
58
59 No, but there is a <a href="representation.html">document</a> that tries to
60 indicate how to properly draw DGN elements given the structures returned by
61 DGNLib. The OGR layer re-interprets the drawing information into
62 <a href="http://www.gdal.org/ogr_feature_style.html">OGR Feature Style</a>
63 format which is understood by some applications such as
64 <a href="http://mapserver.gis.umn.edu/">UMN MapServer</a>.
65 <p>
66
67 <li> <b>What is the license?</b><p>
68
69 DGNLib is under my usual MIT style open source license. Thus is can be
70 easily used in commercial, and free products with no concern about licensing
71 issues. See the header of any source file for the full license text. <p>
72
73 <li> <b>Is there support for writing DGN files?</b><p>
74
75 Yes, there is preliminary support for writing 2D and 3D DGN files in
76 recent releases.<p>
77
78 <li> <b>Is there documentation?</b><p>
79
80 There is a detailed <a href="libhtml/dgnlib_8h.html">DGN Library API Reference
81 </a> available. There is currently no tutorial style information on how to
82 use the library, but the dgndump.c utility can serve as a limited example.<p>
83
84 <li> <b>Is further work going on to improve the library?</b><p>
85
86 The initial project is complete, but I am interested in fixing
87 bugs and adding minor features. Improvements are welcome.<p>
88
89 </ul>
90
91 <h2>DGN Related Information</h2>
92
93 <ul>
94
95 <li> <a href="dgn.html">ISFF/DGN File Format</a>: I have taken the venerable
96 <a href="isff.txt">isff.txt</a> description, and am reformatting it in
97 HTML and filling in missing information.<P>
98
99 <li> <a href="dl/ref18.pdf">Microstation 95/ISFF Description (pdf)</a>:
100 Information on the ISFF/DGN file format as distributed with Microstation 95.
101 <P>
102
103 <li> The most recently
104 <a href="http://www.gdal.org/srctree/ogr/ogrsf_frmts/dgn/">committed code</a>
105 is available in <a href="http://www.gdal.org/">GDAL</a> CVS tree.<p>
106
107
108 <li> <a href="libhtml/dgnlib_8h.html">DGN Library API Documentation</a>
109 <p>
110
111 <li> <a href="representation.html">DGN Feature Representation</a>: info on
112 drawing DGN elements properly.<p>
113
114 <li> <a href="http://www.intergraph.com/gis/support/technotes/db_link.asp">
115 Intergraph Notes on Database Linkages</a>
116 (also <a href="dl/db_link.doc">db_link.doc</a> in MS Word format)<p>
117
118 <li> The <a href="mailto:[email protected]">[email protected]</a> mailing list is for discussion of general DGN issues as well as dgnlib in
119 particular. The group includes an <a href="http://groups.yahoo.com/group/dgnlib/">email archive</a> and can be subscribed from the following subscribe box.
120 Please confirm your interest with <a href="mailto:[email protected]">me</a>
121 by email if you are using a relatively anonymous email service so I can
122 verify you aren't a spammer.<p>
123
124 <form method=GET action="http://groups.yahoo.com/subscribe/dgnlib">
125 <table cellspacing=0 cellpadding=2 border=0 bgcolor=#FFFFCC>
126 <tr>
127 <td colspan=2 align=center>
128 <b>Subscribe to dgnlib</b>
129 </td>
130 </tr>
131 <tr>
132 <td>
133 <input type=text name="user" value="enter email address" size=20>
134 </td>
135 <td>
136 <input type=image border=0 alt="Click here to join dgnlib"
137 name="Click here to join dgnlib" src="http://groups.yahoo.com/img/ui/join.gif">
138 </td>
139 </tr>
140 </table>
141 </form>
142
143 </ul>
144
145 <h2>Other DGN Viewers/Libraries</h2>
146
147 <ul>
148
149 <li> DGNdirect is a library from the <a href="http://www.opendwg.org/">
150 Open Design Alliance</a> that supports reading (and to some extent) writing DGN
151 v8 files. It also supports reading DGN v7 files. The Open Design Alliance
152 offers it under quite reasonable (but not Open Source) licensing terms.<p>
153
154 <li> Bentley itself offers DGN libraries, and tools as part of their
155 <a href="http://www.bentley.com/opendgn/">OpenDGN</a> program.<p>
156
157 <li> <A href="http://www.graphstore.com">GraphStore</a> has a product called
158 eCADLite that can be used in demo mode as a DGN viewer.<p>
159
160 <li> <A href="http://columbus.arup.com">Columbus</a> is a free
161 document viewer which includes DGN support.<p>
162
163 <li> <A href="http://www.cimmetry.com/">AutoVue</a> from Cimmetry.<p>
164
165 <li> <a href="http://www.safe.com/">Safe Software's</a> FME product has
166 excellent DGN read and write support, and can be used as a standalone product,
167 or FMEObjects acts as a library.<p>
168
169 <li> My own <A href="http://openev.sf.net/">OpenEV</a> uses dgnlib for DGN
170 support.<p>
171
172 </ul>
173
174 <h2>Sample Datasets</h2>
175
176 <ul>
177 <li> <a href="dl/dgnsamp.zip">dgnsamp.zip</a>: DGN Samples from Cybertal<p>
178 <li> <a href="http://www.dot.state.oh.us/techservsite/downlds/downloads.htm">
179 Ohio DOT Downloads Page</a><p>
180 <li> <a href="http://www.odot.state.or.us/tdmappingpublic/microhelp.htm">
181 Oregon DOT</a><p>
182 </ul>
183
184 <h2>Credits</h2>
185
186 I would like to thank:<p>
187
188 <ul>
189 <li> Dennis Christopher (and <a href="http://www.avenza.com/">Avenza Systems
190 Inc</a>) for funding this development, and allowing me to release it as
191 open source.<p>
192
193 <li> Rodney Jenson who gave me some hints, and moral support.<p>
194
195 <li> Patrick van Dijk, for information and code related to Quaternion
196 handling.<p>
197
198 <li> Cybertal Components, whose's OpenDGN based dumping program was helpful to
199 me in testing. Unfortunately, Cybertal does not appear to still be in
200 business.<p>
201
202 <li> Ason Kang who provided a sample multi-byte text file and code to
203 handle it properly.<p>
204
205 <li> The various US DOTs and other government organizations who are progressive
206 enough to provide mapping information directly in DGN format on the web. It's
207 a great store of sample data. <p>
208
209 <li> Mike Cane for held with Radix50 names, and support for cell headers.<p>
210
211 <li> Jeff Smith (Geographic Software Specialists) who funded DGN write
212 support.<p>
213
214 <li> Jamie Cecchetto (<a href="http://www.centurysystems.net">Century
215 Systems</a>) for funding 3D write support. <p>
216
217 <li> <a href="http://www.dmsolutions.ca/">DM Solutions Group</a> for
218 providing the <a href="http://maptools.org">maptools.org</a> site to
219 host this on, and for funding (also thanks to Tyler Mitchell of
220 <a href="http://www.lignum.com">Lignum</a>) integration into
221 OGR.<p>
222
223 <li> Marius Kintel (<a href="http://www.sim.no">Systems In Motion</a>) for
224 adding support for reading 3D cone (23), 3D surface (18) and 3D solid (19)
225 elements.<p>
226
227 <li> Paulo Pires for adding 3D transformation support in DGNCreateCellHeaderElem().<p>
228
229 </ul>
230
231 </BODY>
232 </html>