release 2.12

Author: skramm

README.md

@@ -42,9 +42,10 @@ int main()
 
 ### News ###
 
+- 2025-01-26: fresh 2.12 release, see https://github.com/skramm/homog2d/releases
 - 2024-04-21: switch to C++17, enable runtime polymorphism using `std::variant`, [see here](docs/homog2d_manual.md#section_rtp)
 - 2024-03-23: added SVG "path" element import
-- 2023-12-26: fresh 2.11 release, see https://github.com/skramm/homog2d/releases
+- 2023-12-26: 2.11 release
 - 2023-11-17: added [doc index](docs/index.md)
 - 2023-07-11: added online Doxygen-generated reference, through the great https://codedocs.xyz/ [see here](https://codedocs.xyz/skramm/homog2d)
 - 2023-02-19: 2.10 release, see https://github.com/skramm/homog2d/releases
@@ -67,7 +68,6 @@ This will copy that file in `/usr/local/include`.
 When installed, run `$ make test` (or `$ make testall` for testing with all 3 numerical types).
 
 - **Contributing**: at present, the best you can do is testing and bug/issue reporting.
-Don't hesitate, this is still beta but stable release expected soon.
 
 - Rationale:
   - Usage simplicity, max flexibility

docs/homog2d_history.md

@@ -17,6 +17,9 @@ See [Release page](https://github.com/skramm/homog2d/releases).
   - polygon minimization
 
 - current master branch
+  - (nil)
+
+- [v2.12](https://github.com/skramm/homog2d/releases/tag/v2.12), released on 2025-01-26
   - **heavy architectural change**: runtime polymorphism is now achieved in a more modern way, using `std::variant`, [see here](homog2d_manual.md#section_rtp).
 This was possible by moving to C++17, which is now a requirement.
   - removed requirement to pointer-based runtime polymorphism to import SVG file, by using `std::variant`.
@@ -31,6 +34,7 @@ This was possible by moving to C++17, which is now a requirement.
   - removed unneeded `HOMOG2D_SVG_CHECK_INIT` macro
   - improved behavior of `findNearestPoint()`, added checking, and wont return query point if it is inside the container
   - `draw()` free function can now draw container holding variant type
+  - added some tests
 
 ## Previous releases
 

homog2d.hpp

@@ -227,7 +227,7 @@ See https://github.com/skramm/homog2d
 	#define HOMOG2D_MAXITER_PIP 5
 #endif
 
-#define HOMOG2D_VERSION "2.11.2"
+#define HOMOG2D_VERSION "2.12.0"
 
 // some MS environments seem to lack Pi definition, even if _USE_MATH_DEFINES is defined
 #ifndef M_PI
@@ -10879,12 +10879,9 @@ impl_drawIndexes( img::Image<IMG>&, size_t, const img::DrawParams&, const DUMMY&
 
 /// Free function, draws a set of primitives
 /**
-Type \c T can be \c std::array<type> or \c std::vector<type>, with \c type being anything drawable
-
-\note: At present, does not handle containers holding std::variant type
-(see https://github.com/skramm/homog2d/blob/master/docs/homog2d_manual.md#section_rtp
-
-\todo 20241024: Enable the use variant-base polymorphism here
+- Type \c T can be \c std::array<type> or \c std::vector<type>, with \c type being anything drawable.
+- The types inside the container can be either plain \c h2d types (\c FRect, \c Segment, ...) of variant types,
+using the \c CommonType class (requires HOMOG2D_ENABLE_VRTP symbol).
 */
 template<
 	typename U,
@@ -10918,6 +10915,9 @@ draw( img::Image<U>& img, const T& cont, const img::DrawParams& dp=img::DrawPara
 
 /// This version holds a \c std::function as 3th parameter. It can be used to pass a function
 /// that will return a different img::DrawParams for a given index of the container.
+/**
+At present, cannot be used with container holding variants...
+*/
 template<
 	typename U,
 	typename T,

misc/homog2d.cbp

@@ -93,6 +93,7 @@
 		<Unit filename="figures_src/src/get_bb_cont_v.cpp" />
 		<Unit filename="figures_src/src/get_pts_inside.cpp" />
 		<Unit filename="figures_src/src/getbb1.cpp" />
+		<Unit filename="figures_src/src/homog_from_pts.cpp" />
 		<Unit filename="figures_src/src/polyline1.cpp" />
 		<Unit filename="figures_src/src/polyline2.cpp" />
 		<Unit filename="figures_src/src/polyline_rcp_1.cpp" />