🐛 fix(canvas): align rotated-box docs and optimize keyboard rotation repaint (#1333)

Author: CVHub520

anylabeling/views/labeling/widgets/canvas.py

@@ -1,7 +1,6 @@
 """This module defines Canvas widget - the core component for drawing image labels"""
 
 import math
-from copy import deepcopy
 from PyQt6 import QtCore, QtGui, QtWidgets
 from PyQt6.QtCore import Qt, QTimer
 from PyQt6.QtGui import QWheelEvent
@@ -2039,33 +2038,29 @@ def rotate_point(self, p, center, theta):
 
     def bounded_rotate_shapes(self, i, shape, theta):
         """Rotate shapes. Adjust position to be bounded by pixmap border"""
-        new_shape = deepcopy(shape)
         if len(shape.points) == 2:
-            new_shape.points[0] = shape.points[0]
-            new_shape.points[1] = QtCore.QPointF(
-                (shape.points[0].x() + shape.points[1].x()) / 2,
-                shape.points[0].y(),
-            )
-            new_shape.points.append(shape.points[1])
-            new_shape.points.append(
+            p0 = shape.points[0]
+            p1 = shape.points[1]
+            shape.points = [
+                p0,
                 QtCore.QPointF(
-                    shape.points[1].x(),
-                    (shape.points[0].y() + shape.points[1].y()) / 2,
-                )
-            )
+                    (p0.x() + p1.x()) / 2,
+                    p0.y(),
+                ),
+                p1,
+                QtCore.QPointF(p1.x(), (p0.y() + p1.y()) / 2),
+            ]
         center = QtCore.QPointF(
-            (new_shape.points[0].x() + new_shape.points[2].x()) / 2,
-            (new_shape.points[0].y() + new_shape.points[2].y()) / 2,
+            (shape.points[0].x() + shape.points[2].x()) / 2,
+            (shape.points[0].y() + shape.points[2].y()) / 2,
         )
-        for j, p in enumerate(new_shape.points):
+        for j, p in enumerate(shape.points):
             pos = self.rotate_point(p, center, theta)
             # TODO: Reserved for now
             # if self.out_off_pixmap(pos):
             #     return False  # No need to rotate
-            new_shape.points[j] = pos
-        new_shape.direction = (new_shape.direction - theta) % (2 * math.pi)
-        self.selected_shapes[i].points = new_shape.points
-        self.selected_shapes[i].direction = new_shape.direction
+            shape.points[j] = pos
+        shape.direction = (shape.direction - theta) % (2 * math.pi)
         return True
 
     def deselect_shape(self):
@@ -3369,11 +3364,14 @@ def move_by_keyboard(self, offset):
     def rotate_by_keyboard(self, theta):
         """Rotate selected shapes by an theta (using keyboard)"""
         if self.selected_shapes:
+            rotating_shape = False
             for i, shape in enumerate(self.selected_shapes):
                 if shape._shape_type == "rotation":
                     self.bounded_rotate_shapes(i, shape, theta)
-                    self.repaint()
-                    self.rotating_shape = True
+                    rotating_shape = True
+            if rotating_shape:
+                self.repaint()
+                self.rotating_shape = True
 
     # QT Overload
     def keyPressEvent(self, ev):

docs/en/user_guide.md

@@ -192,7 +192,7 @@ For detailed field definitions, see [`shape.py`](../../anylabeling/views/labelin
 X-AnyLabeling supports creating the following types of shapes:
 
 - **Rectangle** (`R`): Click and drag to define opposite corners, or click once for the first corner and again for the second.
-- **Rotated Rectangle** (`O`): Click to set the first point, click again for the second point defining one side, then move the cursor to set the height and click a third time.
+- **Rotated Rectangle** (`O`): Click once to set the first corner, move the cursor, and click again to create an axis-aligned box first. To rotate it, select the shape in Editing Mode and press `Z`, `X`, `C`, or `V`.
 - **Polygon** (`P`): Click along the object's boundary to place vertices. Click the starting point or double-click the last point to close the polygon. Requires at least 3 points. A brush mode (`Ctrl+N`) is also available: once activated, click to place the first point, then move the mouse to automatically trace polygon vertices along the cursor path. Move near the starting point to auto-close. The point distance can be adjusted via `Settings > Canvas > brush.point_distance`.
 - **Quadrilateral** (`T`): Click to place the first corner, then click the remaining three corners in order to complete the quadrilateral.
 - **Point**: Click to place a point.

docs/zh_cn/user_guide.md

@@ -200,7 +200,7 @@ X-AnyLabeling 默认开启自动保存功能，用户在初次启动界面时，
 当前，X-AnyLabeling 支持创建以下对象：
 
 - **rectangle**（R）：通过左键单击开始绘制，移动光标，左键再次单击结束矩形框绘制；
-- **rotation**（O）：通过左键单击开始绘制，移动光标，左键再次单击结束旋转框绘制；
+- **rotation**（O）：通过左键单击开始绘制，移动光标，左键再次单击先生成一个水平/竖直方向的旋转框；如需调整角度，可在编辑模式下选中该对象后按 `Z`、`X`、`C`、`V` 旋转；
 - **polygon**（P）：通过左键单击开始绘制，沿着物体边缘点击添加分割点，光标移动到起始顶点处单击即可结束绘制。当前最少需绘制 3 个顶点。另外支持画笔模式（Ctrl+N），激活后单击放置起始点，移动鼠标即可自动沿轨迹添加多边形顶点，光标移至起始点附近自动闭合。画笔点间距可通过 `Settings > Canvas > brush.point_distance` 调整。
 - **quadrilateral**（T）：通过左键单击开始绘制，依次点击四个顶点，最后一次单击即可结束四边形绘制；
 - **point**：通过左键单击即可直接创建关键点；