Class RectBuffer

source/binding/Python/maa/buffer.py:534–639

矩形缓冲区 / Rectangle buffer 用于在 Python 和 C API 之间传递矩形数据（x, y, width, height）。 Used to pass rectangle data (x, y, width, height) between Python and C API.

class RectBuffer:
    """矩形缓冲区 / Rectangle buffer

    用于在 Python 和 C API 之间传递矩形数据（x, y, width, height）。
    Used to pass rectangle data (x, y, width, height) between Python and C API.
    """

    _handle: MaaRectHandle
    _own: bool

    def __init__(self, c_handle: Optional[MaaRectHandle] = None):
        self._set_api_properties()

        if c_handle:
            self._handle = c_handle
            self._own = False
        else:
            self._handle = Library.framework().MaaRectCreate()
            self._own = True

        if not self._handle:
            raise RuntimeError("Failed to create rect buffer.")

    def __del__(self):
        if self._handle and self._own:
            Library.framework().MaaRectDestroy(self._handle)

    def get(self) -> Rect:
        """获取矩形数据 / Get rectangle data

        Returns:
            Rect: 矩形对象 (x, y, width, height) / Rectangle object (x, y, width, height)
        """
        x = Library.framework().MaaRectGetX(self._handle)
        y = Library.framework().MaaRectGetY(self._handle)
        w = Library.framework().MaaRectGetW(self._handle)
        h = Library.framework().MaaRectGetH(self._handle)

        return Rect(x, y, w, h)

    def set(self, value: RectType) -> bool:
        """设置矩形数据 / Set rectangle data

        Args:
            value: 矩形数据，可以是 Rect、tuple、list 或 numpy.ndarray
            Rectangle data, can be Rect, tuple, list, or numpy.ndarray

        Returns:
            bool: 是否成功 / Whether successful

        Raises:
            ValueError: 如果数据格式不正确
            TypeError: 如果类型不支持
        """
        if isinstance(value, numpy.ndarray):  # pyright: ignore[reportUnnecessaryIsInstance]
            if value.ndim != 1:
                raise ValueError("value must be a 1D array")
            if value.shape[0] != 4: