README
1
2 DGNLIB Source Distribution
3 ==========================
4
5Current information on DGNLIB, including detailed API documentation
6can be found at:
7
8 http://dgnlib.maptools.org/
9
10
11Building
12--------
13
14This is a preliminary source distribution, and I have not gone to any
15pains to make it easy to configure and build. To build please do the
16following:
17
18== Unix:
19
201. Update cpl_config.h to represent your platform accurately. Generally all
21that matters is to #define WORDS_BIGENDIAN on big endian platforms. The
22rest can likely be ignored.<p>
23
242. Build the programs.
25
26 % make
27
28== Windows:
29
301. Ensure you have Microsoft Visual C++ 6.x or later installed.
31
322. Ensure the commandline VC++ environment is setup properly. You may need
33 to run the VCVARS32.BAT script from within the VC++ tree.
34
353. Compile the code, and build statically linked executables for the sample
36 programs and DLL using the following command.
37
38 nmake /f makefile.vc
39
40
41
42Release Notes
43=============
44
45Release 1.11
46------------
47
48 o B-Spline support:
49 - The DGNT_BSPLINE define was bogus, replaced with DGNT_BSPLINE_POLE.
50 - Added support for the following B-Spline related elements:
51 o DGNElemBSplineSurfaceHeader (24)
52 o DGNElemBSplineCurveHeader (27)
53 o DGNElemBSplineSurfaceBoundary (25)
54 o DGNElemKnotWeight (26/28)
55
56 o Added initial support for Shared Cell Definition elements
57
58 o 3D solid/surface fixes:
59 - Fixed incorrect reading and writing of surftype field.
60 - Added boundelms field to DGNElemComplexHeader
61 - Added DGNCreateSolidHeaderElem() and DGNCreateSolidHeaderElemFromGroup()
62 - Changed DGNCreateComplexHeaderElem() and
63 DGNCreateComplexHeaderElemFromGroup() to only support complex chains/shapes
64 - Fixed bug creating solids/surfaces: totlength was 1 word too short.
65 - Renamed bogus define DGNSUT_SOLID to DGNSUT_SURFACE_OF_PROJECTION
66
67 o Added support for cloning Cone elements
68
69 o Fixes for uor handling in DGNCreate().
70
71 o Treat the most recently read color table as the global color table,
72 instead of just the first one encountered.
73
74 o Added Text Node implementation from Ilya Beylin.
75
76
77Release 1.10
78------------
79
80 o Added DGNElemTypeHasDispHdr(), and use it in DGNParseCore() to avoid trying
81 to read disp hdr, or attributes from inappropriate elements.
82
83 o Check if a negative amount of attribute information is being read in
84 DGNParseCore(), and if so just issue a warning, and skip attempt.
85
86 o Fixed DGNCreateCellHeaderFromGroup() to not pre-transform the bounds.
87
88 o Fixed missing handling of min/max Z in DGNCreateMultiPointElem(). (Marius)
89
90 o Added surface type to DGNCreateComplexHeaderElem(). (Marius)
91
92 o DGNRad50ToAscii() reimplemented to correct a few problems. New version
93 provided by Armin Berg (iez.com).
94
95 o Fixes to complex header and cell header creation to set the total group
96 size properly, and to set up complex header pad attributes properly. Now
97 passed EDG validation.
98
99
100Release 1.9
101-----------
102
103 o Added DGNLoadTCB(), and fixed problem when writing new elements to an
104 existing file without having already read the TCB.
105
106 o Fixed serious bug in setting the index "offset" location. Critical for
107 writing applications.
108
109
110Release 1.8
111-----------
112
113 o Added support for reading 3D cone (23), 3D surface (18) and 3D solid (19)
114 elements based on contributions from Marius Kintel.
115
116 o Main site moved to http://dgnlib.maptools.org/
117
118
119Release 1.7
120-----------
121
122 o Improved calculation of bounding box in DGLCreateTextElem() based on code
123 from Matt Kelder.
124
125 o Added preliminary 3D write support.
126
127 o Modified DGNCreateTextElem() arguments, and deprecated DGNCreateArcElem2D()
128 in favour of DGNCreateArcElem().
129
130 o Report transformation matrix for ViewInfo when dumping.
131
132
133Release 1.6
134-----------
135
136 o Bug fix in DGNGetLinkage() for DMRS recognition from Henk Jan Priester.
137
138 o Added DGNCreateCellHeaderFromGroup() and DGNCreateCellHeaderElem()
139 functions in the write API.
140
141 o Added a Microsoft VC++ makefile (Makefile.vc).
142
143
144Release 1.5
145-----------
146
147 o Added 2D write support!
148
149 o Fixed collection of background color in color table (color 255) as per
150 bug report by Henk Jan Priester (Justcroft Technical Systems).
151
152 o Added support for association ids (DGNLT_ASSOC_ID, DGNGetAssocID()).
153
154 o Fixed problem with updating the DGNInfo.color_table field when a color
155 table is read.
156
157 o Fixed problem with spatial queries either including all of a complex
158 element (and its members) or none.
159
160 o Added support for reading the eight view descriptions in the TCB element.
161
162 o Added a Makefile in the source distribution.
163
164 o Fixed error with tags in DGNFreeElement() as reported by Henk Jan Priester.
165
166
167
168Release 1.4
169-----------
170
171 o Added "fast" spatial searching via the DGNSetSpatialFilter() function.
172 This basically just reads the extents information at beginning of
173 geometric features to see if they should be returned.
174
175 o Actually extract the global origin from the TCB, and use it when
176 transforming points. Only a few files (i.e. Brazos County roads.rds) use
177 a non-zero origin.
178
179 o Added experimental multi byte text support from Ason Kang
180 (hiska@netian.com).
181
182 o Add experimental support for 3D files. Some 3D elements not supported.
183 3D quaternion for ellipse and arc elements not utilized.
184
185 o Added preliminary support for reading cell header structures based
186 on input from Mike Cane.
187
188 o Moved a bunch of stuff into dgnread.cpp.
189
190 o Build default colortable into dgnhelp.cpp for use of DGNLookupColor().
191
192 o Added DGNGetShapeFillInfo().
193
194 o DGNGetShapeFillInfo() now tries to handle multi-part attribute linkages.
195
196
197Release 1.3
198-----------
199
200 o Added raw_data/raw_bytes members of DGNElemCore, and DGNSetOptions()
201 to allow control of when raw element image is retained.
202
203 o Added -r flag to dgndump to dump raw contents of desired elements.
204
205 o Add CPL_CVSID() to simplify tracking of versions.
206
207 o Fixed bug with freeing element index in DGNClose().
208
209
210