Mercurial > hg > ascension / changeset

--- a/src/ascension/2d.h	Tue Aug 05 16:48:04 2025 +0200
+++ b/src/ascension/2d.h	Tue Aug 05 16:53:25 2025 +0200
@@ -43,11 +43,35 @@
 } AscRectangle;
 
 struct asc_rectangle_create_args {
+    /**
+     * X-coordinate of the rectangle's origin.
+     * When no alternate point of origin is specified, the (x,y) belongs to the top-left corner.
+     */
     int x;
+    /**
+     * Y-coordinate of the rectangle's origin.
+     * When no alternate point of origin is specified, the (x,y) belongs to the top-left corner.
+     */
     int y;
+    /**
+     * X-offset for the point of origin in rectangle coordinates.
+     * Zero means the left edge and the rectangle's width means the right edge.
+     * The origin may lie outside the rectangle's bounds.
+     */
     int origin_x;
+    /**
+     * Y-offset for the point of origin in rectangle coordinates.
+     * Zero means the top edge and the rectangle's height means the bottom edge.
+    * The origin may lie outside the rectangle's bounds.
+     */
     int origin_y;
+    /**
+     * The horizontal length of the rectangle.
+     */
     unsigned int width;
+    /**
+     * The vertical length of the rectangle.
+     */
     unsigned int height;
     /**
      * Corner radius.