Pygame 官方文档 - pygame.Rect

pygame.Rect 是 pygame 库中一个非常重要的模块，用于表示矩形区域。在游戏开发和其他图形应用中，矩形经常被用来表示物体、边界和碰撞检测等。pygame.Rect 提供了一系列属性和方法，使得处理矩形变得非常方便。
基本概念
pygame.Rect 对象由四个参数表示，分别是左下角的坐标 (left, top) 和矩形的宽度和高度 (width, height)。可以通过以下方式创建 pygame.Rect 对象：

rect = pygame.Rect(left, top, width, height)
rect = pygame.Rect((left, top), (width, height))
rect = pygame.Rect(object)

其中，left 和 top 参数表示矩形的左下角坐标，width 和 height 参数表示矩形的宽度和高度。
常用属性

• left：矩形左边缘的 x 坐标。
• top：矩形上边缘的 y 坐标。
• right：矩形右边缘的 x 坐标，等于 left + width。
• bottom：矩形下边缘的 y 坐标，等于 top + height。
• width：矩形的宽度。
• height：矩形的高度。
• topleft：矩形的左上角坐标，是一个元组 (left, top)。
• topright：矩形的右上角坐标，是一个元组 (right, top)。
• bottomleft：矩形的左下角坐标，是一个元组 (left, bottom)。
• bottomright：矩形的右下角坐标，是一个元组 (right, bottom)。
  常用方法

1. copy()：创建一个与原始 Rect 对象完全相同的新 Rect 对象。
2. inflate_ip(dx, dy)：在 Rect 对象的左边和顶部增加 dx 和 dy 距离，以扩大或缩小矩形的大小。这是一个原地操作，不会返回新的 Rect 对象。
3. clamp(rect)：将当前 Rect 对象移动到另一个 Rect 对象内部，返回一个新位置的 Rect 对象。如果当前 Rect 对象超出目标 Rect 对象边界，则将其移动到边界上。
4. union(rect)：返回一个新的 Rect 对象，该对象包含原始 Rect 对象和另一个 Rect 对象的并集区域。
5. clamp_ip(rect)：原地移动 Rect 对象到另一个 Rect 对象的内部，并返回 None。这是一个原地操作，会直接修改原始 Rect 对象的位置和大小。
6. clipline(x, y)：检查点 (x, y) 是否在 Rect 对象的边界上或内部，并返回相应的布尔值。
7. update(left=None, top=None, width=None, height=None)：设置 Rect 对象的 left、top、width 和 height 属性值。可以同时更新多个属性值，也可以只更新单个属性值。这是一个原地操作，会直接修改原始 Rect 对象的位置和大小。
8. clamp_ip(rect)：原地将 Rect 对象移动到另一个 Rect 对象的内部边界上，并返回 None。这是一个原地操作，会直接修改原始 Rect 对象的位置和大小。
9. unionall(rects)：将当前 Rect 对象与一系列 Rect 对象进行合并操作，返回一个新的 Rect 对象，该对象包含所有参与合并操作的 Rect 的并集区域。
10. moveto(x, y)：将 Rect 对象的左下角移动到点 (x, y)，同时修改位置和大小属性值。这是一个原地操作，会直接修改原始 Rect 对象的位置和大小。
11. fit(width, height)：根据给定的宽度和高度调整 Rect 对象的大小，同时保持其宽高比不变。