3.8 KiB
3.8 KiB
Changelog
v0.5.0 -> v0.5.1
- Fixes a bug, where the conversion of larger to smaller types results in a false buffer interpretation.
v0.5.0-rc.3 -> v0.5.0
PointConvertibletrait is nowunsafesince the offset is used for raw memory access, where safety can not be guaranteed by the compiler.- Fixes clippy on nightly.
- Fixes a bug when attempting to write larger types than available in the message. This now results in a
ExhaustedSourceerror. - Adds
repr(C)to docs where custom conversions are explained to encourage best practices for raw type descriptions.
v0.5.0-rc.2 -> v0.5.0-rc.3
- Bump r2r to 0.9.
- Fixed building in
no_stdenvironments. - Removed
expectcalls.
v0.5.0-rc.1 -> v0.5.0-rc.2
PointConvertiblenow includes the information forTypeLayoutandFields, which reduces boilerplate code for custom points. The respective derive macro is updated to work with the updated trait._vecfunctions now work without thederivefeature and thus are always available.- The
derivefeature now is disabled by default but it is still strongly recommended for custom points to avoid layout errors. This also makes procmacro dependencies optional for the functionality, since every conversion can be called without them. - The alignment of all predefined points is increased for SSE optimization and optimized copies between C++ PCL and Rust.
v0.4.0 -> v0.5.0-rc.1
Most of the library is rewritten to be simpler and more expandable while adding mostly performance focused features to motivate the breaking changes.
Why?
The previous concept of the Convert struct for both directions of conversion leads to use cases, where the behavior is unexpected for the user.
What changed?
Nearly every public function is changed to be easier to work with and faster at runtime and adaptable for different scenarios.
It is easier to update to the new version by looking at it as a new crate and starting with the documentation.
Breaking
- Switched from FallibleIterator to Iterator, since all possible errors are checked before returning the type.
- Renamed
pcl_utilsmodule topointsto make the module more a general toolkit and less a PCL compatibility layer. - Renamed
ros_typesmodule torossince types are inferred. - Removed
Convertstruct. ThePointCloud2Msgnow directly offerstry_from_iterandtry_into_iterfunctions. - Dimensions and PointMeta in
PointConvertibleare merged to types, that are mostly deducted to minimize the needed code (see the docs for a custom point example). - Conversions can not fail per point in
PointConvertible, so TryFrom -> From. - RGB is now stored as a union to allow direct copy with
_vecfunctions without packing it manually per point. There are setters and getters for safety and usability. - ros_types::TimeMsg (now ros::TimeMsg) uses
nanosecinstead ofnsecnaming to conform with ROS2. This also removes the type alias forrosrust. Instead, there is aimpl From<rosrust::Time> for TimeMsgnow.
Added features
[from|into]_vecenabled by derive for memory heavy applications (enabled by default).[from|into]_par_iterenabled by rayon for processing heavy applications.derivemacros for minimizing code for custom point conversions (enabled by default).xyz()getter enabled by nalgebra for all predefined points.prelude::*re-export module for quickly importing common types in point cloud processing projects.- Lightweight:
no_stdcompatibility foriterconversions and dependency-free builds when only needingiterconversions. - Overall speed up thanks to more vectorizable iterator conversions and the new
vecandpar_iterfunctions. See the comparison with PCL for more info. - More type deduction in public facing functions, leading to less code for the user of the library.
- More documentation.