3.2.0

This release improves CMake building, fixes a couple of issues related to standards conformance, and fixes a handful of other issues.

If you use this library in commercial software, please see my note in the README.

Added

• {cmake} Added E57_INSTALL_CMAKEDIR option to override where the cmake files are installed. (#305)

  This defaults to lib/cmake/E57Format and the path is relative to CMAKE_INSTALL_PREFIX.

Changed

• {cmake} If building as a shared library, set VERSION & SOVERSION. (#304)
• {cmake} Don't force warnings as errors when building self. (#299)
• {cmake} Use git tag in library version for more precision. (#298)
• {license} Re-license all my (asmaloney) MIT files to BSL-1.0. It is just easier to have it all under one license. (#296)
• {format} Update to clang-format 18 & reformat code. (#286)
• Add "E57_" to macros in E57Exception.h. (#285)
• "De-deprecate" methods in E57SimpleWriter. These methods can be useful when writing batches. (#284)

Fixed

• Update CRCpp to fix MSVC and MinGW warnings. (#302)
• Fix warnings about redefinition of _LARGEFILE64_SOURCE and __LARGE64_FILES (#301) (Thanks Niklas!)
• Fix building with emscripten. (Note that the project doesn't officially support emscripten.) (#288) (Thanks maz-1!)
• {standard conformance} CompressedVectors always write an index packet. This is required by the standard (9.3.5). (#295)
• {standard conformance} E57SimpleReader accepts files containing zero scans. (#283)
• {cmake} Replace deprecated "exec_program" with "execute_process". (#282)
• Fix potential invalid range exceptions when reading integer nodes. (#278)

New Contributors

• @maz-1 made their first contribution in #288
• @nh2 made their first contribution in #301

Full Changelog: v3.1.1...v3.2.0

3.1.1

Fixed

• Fix library version in CMakeLists.txt. (Thanks Olli!)

Full Changelog: v3.1.0...v3.1.1

3.1.0

This release includes fixes to standards conformance related to compressed vectors with zero points and a few compilation-related fixes.

Added

• {cmake} New option E57_RELEASE_LTO controls whether link-time optimization is on for release builds. It defaults to ON. (#254)

  CMake forces "thin" LTO (see this issue) which is a problem if compiling statically for distribution (e.g. in a package manager). Generally you will only want to turn this off for distributing static release builds.

Changed

• Trying to read a Data3D with zero records which has an ill-formed header will now throw an ErrorData3DReadInvalidZeroRecords exception instead of ErrorInternal. (#264)

  Note that previous versions of this library (and E57RefImpl itself) could write these headers incorrectly. This was also fixed in this release (see below).

• {cmake} Remove E57_VISIBILITY_HIDDEN option. (#259)

  I cannot get extern templates to work across all of gcc, clang, apple clang, and MSVC when using "hidden" visibility with shared libraries.

Fixed

• Fix #include to avoid MSVC compilation error with Visual Studio 2017 (#268) (Thanks Thomas!)
• {standard conformance} A compressed vector with 0 records must still write a data packet. (#266)
• {standard conformance} Fix reading a compressed vector with 0 points which has an empty data packet. (#267)
• {standard conformance} Compressed vectors with an invalid section ID now throw an ErrorBadCVPacket exception if E57_VALIDATION_LEVEL > 0. (#265)
• Fix clang warnings about implicit conversions in SourceDestBufferImpl.cpp. Apple's clang doesn't warn about these, but it looks like the official clang releases do. (#257) (Thanks Martin!)

New Contributors

• @thbeu made their first contribution in #268

Full Changelog: v3.0.2...v3.1.0

3.0.2

This release fixes several build issues, reading of index packets, and one issue related to standards conformance.

Please consider one-time or recurring support - especially if you use this library in a product you sell.

Fixed

• Fix E57_VERBOSE build. (#251) (Thanks Jia!)
• {standard conformance} Fix invalid range exception in FloatNode implementation. (#250)
• Fix reading of index packets. (#249)
• Fix several places where we should be checking for MSVC, not WIN32. (#248)
• Fix "unnecessary semicolons" warnings which prevented building with GCC <= 10. (#241) (Thanks Andre!)

New Contributors

• @andre-schulz made their first contribution in #241
• @jiapei100 made their first contribution in #251

Full Changelog: v3.0.1...v3.0.2

3.0.1

This release fixes MSVC 32-bit builds, adds an MSVC 32-build to the CI, and fixes a couple of CMake options to allow overriding them with CMake variables.

Please consider one-time or recurring support - especially if you use this library in a product you sell.

Added

• {ci} Added an MSVC 32-bit build. (#235)

Fixed

• {cmake} Turn off inter-procedural optimization in debug builds. Link-time optimization can make debugging more difficult. (#240)
• {cmake} Don't force a debug postfix if CMAKE_DEBUG_POSTFIX is defined.(#239)
• {cmake} Don't force install locations. This prevents overriding them using CMAKE_INSTALL_BINDIR & CMAKE_INSTALL_LIBDIR.(#237)
• Fix warnings which prevented building on 32-bit systems. (#233, #234)

3.0.0

This major release required changes to the API in some places, so I took this opportunity to clean up and deprecate several things for readability & clarity.

There have been many changes around the Simple API in this release to fix some problems, avoid potential errors, and simplify the use of the API. Where possible these changes are marked as deprecated to be removed later. The compiler will produce warnings for these indicating what needs to change. Other changes could not be marked deprecated but will break the API, requiring code changes. The notable ones are marked with 🚧 below.

Please consider one-time or recurring support - especially if you use this library in a product you sell.

Added

• Add address (ASan) and undefined behaviour (UBSan) sanitizers. These are controlled by E57FORMAT_SANITIZE_ALL, E57FORMAT_SANITIZE_ADDRESS and E57FORMAT_SANITIZE_ADDRESS. They are not included when building with MSVC.

• Add new E57Version.h header for more convenient access to version information. (#197).

• Add ImageFile::extensionsLookupPrefix() overload for more concise user code. (#161)

• Added a constructor & destructor for E57SimpleData's Data3DPointsData_t. This will create all the required buffers based on an e57::Data3D struct and handle their cleanup. See the SimpleWriter tests for examples. (#149)

  Note: I strongly recommend these new constructors be used to simplify your code and help prevent errors.

• A new E57SimpleReader constructor takes a ReaderOptions struct which allows setting the checksum policy.

  Reader( const ustring &filePath, const ReaderOptions &options );

• {test} Added testing using GoogleTest. For details, please see test/README.md (#121)

• Added E57Exception::errorStr() to get the error string directly. (#128)

• {cmake} Use ccache if available. (#129)

• {ci} Added a CI check for proper clang-formatted code. (#125)

Changed

• Now requires a C++14 compatible compiler.
• Now requires CMake >= 3.15. (#205)
• 🚧 DEBUG and VERBOSE macros were changed to simplify and clarify:
  • New E57_ENABLE_DIAGNOSTIC_OUTPUT controls the inclusion of the code for the dump() functions on nodes. I don't see any real reason to turn this off, but I left the capability in for compatibility.
  • New E57_VALIDATION_LEVEL=N replaces E57_DEBUG (N=1) and E57_MAX_DEBUG (N=2).
  • E57_MAX_VERBOSE was consolidated with E57_VERBOSE since they were essentially the same.
• When building itself, warnings are now treated as errors. (#205, #211)
• Clean up global const and enum names to use the e57 namespace and avoid repetition. (#176)
  • i.e. instead of e57::E57_STRUCTURE, we now use e57::TypeStructure
• {format} Update clang-format rules for clang-format 15. (#168, #179)
• Change default checksum policies to an enum. (#166)

  Old	New
  CHECKSUM_POLICY_NONE	ChecksumPolicy::None
  CHECKSUM_POLICY_SPARSE	ChecksumPolicy::Sparse
  CHECKSUM_POLICY_HALF	ChecksumPolicy::Half
  CHECKSUM_POLICY_ALL	ChecksumPolicy::All

• Avoid implicit conversion in constructors. (#135)
• Update CRCpp to 1.2. (#130)
• E57Exception changes (#118):
  • mark methods as noexcept
  • use private instead of protected
• Rename E57Simple's Data3DPointsData and Data3DPointsData_d structs to Data3DPointsFloat and Data3DPointsDouble respectively. (#180)
• 🚧 E57Simple: Specifying the node type for cartesian & spherical points, time stamp, and intensity is now explicit using new fields (pointRangeNodeType, angleNodeType, timeNodeType, and intensityNodeType) and a new enum (NumericalNodeType). (#178)
  • For examples, please see test/src/testSimpleWriter.cpp.
• Simplify the E57SimpleWriter API with WriteImage2DData() for images and WriteData3DData() for 3D data. This reduces code, hides complexity, and avoids potential errors. (#171)
  • As part of this simplification, WriteData3DData() will now fill in any missing min/max values for cartesian & spherical points, intensity, and time stamps by looking at the data.(#175)
• 🚧 E57Simple: Intensity now uses double instead of float. (#178)
• 🚧 E57Simple: Colours now use uint16_t instead of uint8_t. (#167)
• 🚧 Change E57SimpleData's Data3D field name from pointsSize to pointCount. (#164)
• 🚧 Min/max fields in E57SimpleData's Data3D's point fields were a mix of floats and doubles. Since the fields are doubles, set them all to doubles and use the new Data3DPointsData_t constructor to set them properly for floats. (#153)

  Note: If you were previously relying on these to be floats and are not using the new Data3DPointsData_t constructor, you will need to set these.

• 🚧 Renamed the E57_EXT_surface_normals extension's fields in E57SimpleData's PointStandardizedFieldsAvailable to be in line with existing code. (#149)
  • normalX renamed to normalXField
  • normalY renamed to normalYField
  • normalZ renamed to normalZField

Deprecated

• e57::Utilities::getVersions(). (#197)
• e57::Data3DPointsData and e57::Data3DPointsData_d types. (#180)
• Many global const and enum names. The compiler will produce warnings including the replacement symbols (note that enumerators will not produce warnings on C++14, but they will on C++17). (#176)
• e57::Writer::NewImage2Dand e57::Writer::SetUpData3DPointsData. (#171)
• Old default checksum policies (CHECKSUM_POLICY_NONE, CHECKSUM_POLICY_SPARSE, CHECKSUM_POLICY_HALF, and CHECKSUM_POLICY_ALL). (#166)
• The old e57::Reader constructor taking only filePath. (#139)
• The old e57::Writer constructor taking only filePath. (#117)

Fixed

• Fix several potential divide-by-zero cases. (#224)
• {ci} Now builds shared library versions as well. (#219)
• {win} Fixes shared library build warnings. (#215, #216, #217)
• Fix the code which shortens floating point numbers when converted to strings. The impact of it being incorrect was negligible since it's just the floating point representation in the XML portion of the file. (#214)
• Turned on a lot of compiler warnings and fixed them. (#201, #202, #203, #204, #205, #207, #209)
• Fix writing floating point numbers when std::locale::global is set. (#174)
• E57XmlParser: Parse doubles in a locale-independent way. (#173) (Thanks Hugal31!)
• E57SimpleReader: Ensure scaled integer fields are set as best we can when reading. (#158)
• Fix the E57_EXT_surface_normals extension's URI in E57SimpleWriter. (#143)
• {win} Fix conversion warning when compiling with debug on. (#124)
• Add errno detail to E57_ERROR_OPEN_FAILED exception. (#119, #120)

New Contributors

• @Hugal31 made their fir...

2.3.0

Added

• {cmake} Added E57_VISIBILITY_HIDDEN option to control CXX_VISIBILITY_PRESET. Defaults to ON. (#104) (Thanks Nigel!)
• Added BSD support. (#99) (Thanks Christophe!)

Changed

• Updated & reorganized the online API docs and changed to a cleaner theme.
• Change file creation to use 0666 permissions on POSIX systems. (#105) (Thanks Nigel!)
• {cmake} CXX_VISIBILITY_PRESET is now set and ON by default. (#104) (Thanks Nigel!)
• A new E57SimpleWriter constructor takes a WriterOptions struct which allows setting the file's GUID.

  Writer( const ustring &filePath, const WriterOptions &options );

  The old constructor taking only coordinateMetadata is deprecated and will be removed in the future. (#96) (Thanks Nigel!)
• Change E57_DEBUG, E57_MAX_DEBUG, E57_VERBOSE, E57_MAX_VERBOSE, E57_WRITE_CRAZY_PACKET_MODE from #defines to cmake options. (#80) (Thanks Nigel!)

Fixed

• Fix E57SimpleWriter's writing of invalid quaternions. It now defaults to the identity quaternion. (#108) (Thanks Nigel!)
• Fix E57SimpleReader to handle missing images2D and isAtomicClockReferenced nodes. (#90) (Thanks Olli!)
• Fix BitpackIntegerDecoder sometimes reading past end of input buffer. (#87) (Thanks Nigel!)
• Fix compilation when some debug options are set. (#81, #82, #84) (Thanks Nigel!)
• Fix compilation with musl libc (#70) (Thanks Dimitri!)
• Add missing include for GCC 11 (#68) (Thanks bartoszek!)

Note: The next release will be 3.0 and will require a C++14 compiler.

New Contributors

• @bartoszek made their first contribution in #68
• @dimitri-tdg made their first contribution in #70
• @nigels-com made their first contribution in #81
• @ollira made their first contribution in #90
• @moench-tegeder made their first contribution in #99
• @striezel made their first contribution in #102

Full Changelog: v2.2.0...v2.3.0

2.2.0

Added

• Added and updated the E57Simple API from the old reference library. (#41, #63) (Thanks Jiri & Grégoire!)
• Enabled building E57Format as a shared library. (#40) (Thanks Amodio!)
• Added a clang-format file, a cmake target for it ("format"), and reformatted the code.
• {doc} Added info about using SPDX License Identifiers.
• {ci} Added GitHub Actions to build macOS, Linux, and Windows. (#35)

Changed

• E57_V1_0_URI was changed from a #define to a constexpr, so if you use it, it will need to be updated with a namespace: e57::E57_V1_0_URI.
• {doc} Moved some documentation to new repo (libE57Format-docs) and generate the docs.
• {cmake} Reviewed and updated cmake files. CMake minimum version was changed to 3.10.

Fixed

• Fixed building with E57_MAX_VERBOSE defined. (#44)
• {win} Fixed MSVC warnings. (#34, #36)

Other

• Removed all internal usage of dynamic_cast<>. (#39) (Thanks Jiri!)
• Split classes out from E57FormatImpl.[h,cpp] intot their own files.

2.1

• handle UTF8 file names on Windows (based on #26)
• now supports char* input (#22)
• internal code cleanups
• {cmake} remove unused ICU requirement for Linux
• {cmake} mark xerces-c as required
• {cmake} added fallback configuration for RelWithDebInfo and MinSizeRel #29
• {cmake} added proper install configuration #28
• {cmake} various cleanups

2.0.1

• writing files was broken and would produce the following error:
  Error: bad API function argument provided by user (E57_ERROR_BAD_API_ARGUMENT) (ImageFileImpl.cpp line 109)