萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

使用 Matplotlib 在座標系中互動式繪製矩形

前言

Matplotlib 不僅能繪製靜態圖表,透過事件處理機制,還能實現滑鼠互動繪圖。本文示範如何利用 Rectangle 補丁與滑鼠事件,在座標系中以拖曳方式繪製矩形,適用於資料標註、ROI 選取等場景。

核心原理

  1. 建立 Rectangle 物件並加入 Axes。
  2. 連接 button_press_event(按下)與 button_release_event(釋放)事件。
  3. 按下時記錄起始座標 (x0, y0);釋放時記錄結束座標 (x1, y1)。
  4. 根據兩點計算寬高,更新矩形幾何屬性並重繪畫布。

完整互動式範例

import matplotlib.pyplot as plt
from matplotlib.patches import Rectangle

class RectangleDrawer:
    """互動式矩形繪製器"""
    def __init__(self, ax=None):
        self.ax = ax or plt.gca()
        self.rect = Rectangle((0, 0), 1, 1,
                              edgecolor='red', facecolor='none', linewidth=2)
        self.ax.add_patch(self.rect)
        self.x0 = self.y0 = self.x1 = self.y1 = None
        self._connect_events()

    def _connect_events(self):
        canvas = self.ax.figure.canvas
        canvas.mpl_connect('button_press_event', self.on_press)
        canvas.mpl_connect('button_release_event', self.on_release)
        canvas.mpl_connect('motion_notify_event', self.on_motion)  # 即時預覽

    def on_press(self, event):
        if event.inaxes != self.ax:
            return
        self.x0, self.y0 = event.xdata, event.ydata
        self.rect.set_xy((self.x0, self.y0))
        self.rect.set_width(0)
        self.rect.set_height(0)
        self.ax.figure.canvas.draw_idle()

    def on_motion(self, event):
        if self.x0 is None or event.inaxes != self.ax:
            return
        self.x1, self.y1 = event.xdata, event.ydata
        self.rect.set_width(self.x1 - self.x0)
        self.rect.set_height(self.y1 - self.y0)
        self.ax.figure.canvas.draw_idle()

    def on_release(self, event):
        if self.x0 is None:
            return
        self.x1, self.y1 = event.xdata, event.ydata
        # 確保寬高為正
        self.rect.set_width(abs(self.x1 - self.x0))
        self.rect.set_height(abs(self.y1 - self.y0))
        self.rect.set_xy((min(self.x0, self.x1), min(self.y0, self.y1)))
        self.x0 = self.y0 = None
        self.ax.figure.canvas.draw_idle()
        print(f'矩形座標: {self.rect.get_xy()}, 寬高: {self.rect.get_width():.2f} x {self.rect.get_height():.2f}')

if __name__ == '__main__':
    fig, ax = plt.subplots()
    ax.set_xlim(0, 10)
    ax.set_ylim(0, 10)
    ax.set_title('拖曳滑鼠繪製矩形,釋放後固定')
    drawer = RectangleDrawer(ax)
    plt.show()

關鍵細節解析

  • 事件座標系:event.xdata/ydata 為資料座標;若需螢幕像素座標請用 event.x/y。
  • 即時預覽:監聽 motion_notify_event 可在拖曳過程中即時更新矩形,體驗更流暢。
  • draw_idle vs draw:draw_idle() 僅在畫布「髒」時重繪,效能優於 draw()。
  • 矩形正規化:釋放時取絕對值並調整左上角,確保無論拖曳方向矩形皆正確顯示。

延伸應用:多矩形管理與資料匯出

class MultiRectManager:
    def __init__(self, ax):
        self.ax = ax
        self.rects = []
        self.current = None
        self.cid_press = ax.figure.canvas.mpl_connect('button_press_event', self.on_press)
        self.cid_release = ax.figure.canvas.mpl_connect('button_release_event', self.on_release)

    def on_press(self, event):
        if event.inaxes != self.ax or event.button != 1:  # 僅左鍵
            return
        self.current = Rectangle((event.xdata, event.ydata), 0, 0,
                                 edgecolor='blue', facecolor='blue', alpha=0.2)
        self.ax.add_patch(self.current)
        self.ax.figure.canvas.draw_idle()

    def on_release(self, event):
        if self.current is None:
            return
        # 固定最終幾何
        x0, y0 = self.current.get_xy()
        w, h = self.current.get_width(), self.current.get_height()
        self.current.set_width(abs(w))
        self.current.set_height(abs(h))
        self.current.set_xy((min(x0, x0+w), min(y0, y0+h)))
        self.rects.append(self.current)
        self.current = None
        self.ax.figure.canvas.draw_idle()

    def get_rectangles_data(self):
        """匯出所有矩形的 (x, y, w, h)"""
        return [(r.get_x(), r.get_y(), r.get_width(), r.get_height()) for r in self.rects]

常見坑點

  • 未檢查 event.inaxes 導致在座標軸外點擊也觸發邏輯。
  • 忘記在釋放事件中清除 self.x0,造成下一次點擊時殘留舊座標。
  • 在 Jupyter Notebook 中使用 %matplotlib widget 或 %matplotlib qt 才能正常互動;內建 inline 後端不支援事件。
copyright © 萬盛學電腦網 all rights reserved