Fix: Add angle display to AnnotatedSegment and fix angle for AnnotatedObliqueRectangle and AnnotatedEllipse

Author: PierreRaybaut

doc/release_notes/release_2.08.md

@@ -2,12 +2,21 @@
 
 ## PlotPy Version 2.8.3 ##
 
+💥 New features:
+
+* `AnnotatedSegment` new angle display:
+  * Added angle display in annotation label, showing the segment's angle relative to the horizontal direction (0° to 180°)
+  * This implements the equivalent feature submitted in [Pull Request #51](https://github.com/PlotPyStack/PlotPy/pull/51) by user @deuterium33
+
 🛠️ Bug fixes:
 
 * Fixed circle/ellipse shape drawing with non-uniform aspect ratios:
   * Axes were not perpendicular and did not connect to the ellipse edge when plot aspect ratio differed from 1.0
   * Now uses parametric ellipse drawing that correctly handles non-perpendicular axes in pixel space
   * The ellipse properly passes through all four handle points regardless of aspect ratio or rotation
+* Fixed angle display range for `AnnotatedObliqueRectangle` and `AnnotatedEllipse`:
+  * Angle is now displayed in the 0° to 180° range instead of -90° to 90° (the original implementation was also displaying 0° at vertical orientation -additionally to horizontal orientation- which was counter-intuitive)
+  * This provides a more intuitive and consistent angle representation
 
 ## PlotPy Version 2.8.2 (2025-11-10) ##
 

plotpy/items/annotation.py

@@ -599,6 +599,14 @@ def get_tr_center(self):
         """Return segment position (middle) after applying transform matrix"""
         return compute_center(*self.get_transformed_coords(0, 1))
 
+    def get_tr_angle(self):
+        """Return segment angle with horizontal direction (0° to 180°),
+        after applying transform matrix"""
+        xcoords = self.get_transformed_coords(0, 1)
+        _x, yr1 = self.apply_transform_matrix(1.0, 1.0)
+        _x, yr2 = self.apply_transform_matrix(1.0, 2.0)
+        return (compute_angle(*xcoords, reverse=yr1 > yr2) + 180) % 180
+
     # ----AnnotatedShape API-----------------------------------------------------
     def set_label_position(self):
         """Set label position, for instance based on shape position"""
@@ -616,6 +624,7 @@ def get_info(self) -> str:
             [
                 _("Center:") + " " + self.get_tr_center_str(),
                 _("Distance:") + " " + self.x_to_str(self.get_tr_length()),
+                _("Angle:") + f" {self.get_tr_angle():.1f}°",
             ]
         )
 
@@ -1108,12 +1117,12 @@ def __init__(
 
     # ----Public API-------------------------------------------------------------
     def get_tr_angle(self):
-        """Return X-diameter angle with horizontal direction,
+        """Return X-diameter angle with horizontal direction (0° to 180°),
         after applying transform matrix"""
         xcoords = self.get_transformed_coords(0, 1)
         _x, yr1 = self.apply_transform_matrix(1.0, 1.0)
         _x, yr2 = self.apply_transform_matrix(1.0, 2.0)
-        return (compute_angle(*xcoords, reverse=yr1 > yr2) + 90) % 180 - 90
+        return (compute_angle(*xcoords, reverse=yr1 > yr2) + 180) % 180
 
     def get_bounding_rect_coords(self) -> tuple[float, float, float, float]:
         """Return bounding rectangle coordinates (in plot coordinates)
@@ -1260,12 +1269,12 @@ def set_rect(self, x0, y0, x1, y1):
         raise NotImplementedError
 
     def get_tr_angle(self):
-        """Return X-diameter angle with horizontal direction,
+        """Return X-diameter angle with horizontal direction (0° to 180°),
         after applying transform matrix"""
         xcoords = self.get_transformed_coords(0, 1)
         _x, yr1 = self.apply_transform_matrix(1.0, 1.0)
         _x, yr2 = self.apply_transform_matrix(1.0, 2.0)
-        return (compute_angle(*xcoords, reverse=yr1 > yr2) + 90) % 180 - 90
+        return (compute_angle(*xcoords, reverse=yr1 > yr2) + 180) % 180
 
     # ----AnnotatedShape API-----------------------------------------------------
     def set_label_position(self):