萬盛學電腦網

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

Linux 下 Python 截圖實現:基於 GTK/GDK 跨平台桌面截圖工具完整代碼

在 Linux 桌面環境 (GNOME、KDE、XFCE 等) 中,使用 Python 調用 GTK/GDK 實現螢幕截圖功能,需處理視窗系統交互、座標捕捉、像素緩衝區讀取等底層細節。本文提供一個功能完整的互動式截圖類,支援滑鼠框選區域、全螢幕截圖、PNG 儲存與取消/退出邏輯。

完整實現代碼


#!/usr/bin/env python
# -*- coding: utf-8 -*-
"""Linux 桌面截圖工具 - 基於 GTK+2/GDK"""
import gtk
import gtk.gdk
import glib

class Point:
    def __init__(self, x=0, y=0):
        self.x, self.y = int(x), int(y)

class Rect:
    def __init__(self, x=0, y=0, w=0, h=0):
        self.x, self.y, self.w, self.h = int(x), int(y), int(w), int(h)
    
    @classmethod
    def from_points(cls, p1, p2):
        return cls(min(p1.x, p2.x), min(p1.y, p2.y),
                   abs(p2.x - p1.x), abs(p2.y - p1.y))

class ScreenshotTool:
    def __init__(self):
        # 建立隱形視窗捕捉滑鼠事件
        self.window = gtk.Window()
        self.window.set_default_size(1, 1)
        self.window.connect("button-press-event", self.on_button_press)
        self.window.show()
        
        self.start_point = None
        self.grabbed = False
    
    def on_button_press(self, widget, event):
        if event.type != gtk.gdk.BUTTON_PRESS:
            return
        
        if event.button == 1:  # 左鍵:框選區域
            pt = Point(event.x_root, event.y_root)
            if not self.start_point:
                self.start_point = pt
                self.grab_pointer()
            else:
                rect = Rect.from_points(self.start_point, pt)
                self.capture_rect(rect)
                self.start_point = None
                self.ungrab_pointer()
        
        elif event.button == 3:  # 右鍵:取消/退出
            if self.start_point:
                print("已取消框選")
                self.start_point = None
                self.ungrab_pointer()
            else:
                print("退出程式")
                gtk.main_quit()
    
    def grab_pointer(self):
        """獨佔滑鼠指標,顯示十字光標"""
        cursor = gtk.gdk.Cursor(gtk.gdk.CROSSHAIR)
        display = gtk.gdk.display_get_default()
        ret = gtk.gdk.pointer_grab(self.window.window, True,
                                   gtk.gdk.BUTTON_PRESS_MASK,
                                   None, cursor, gtk.gdk.CURRENT_TIME)
        if ret == gtk.gdk.GRAB_SUCCESS:
            self.grabbed = True
            print("左鍵框選區域,右鍵取消/退出")
        else:
            print(f"指標捕捉失敗: {ret}")
    
    def ungrab_pointer(self):
        if self.grabbed:
            gtk.gdk.pointer_ungrab(gtk.gdk.CURRENT_TIME)
            self.grabbed = False
    
    def capture_rect(self, rect, filename="screenshot.png"):
        """截取指定矩形區域並存為 PNG"""
        # 取得根視窗 (全螢幕)
        display = gtk.gdk.display_get_default()
        root_win = display.get_default_screen().get_root_window()
        
        print(f"截圖區域: x={rect.x}, y={rect.y}, w={rect.w}, h={rect.h}")
        
        # 建立像素緩衝區
        pixbuf = gtk.gdk.Pixbuf(gtk.gdk.COLORSPACE_RGB, False, 8, rect.w, rect.h)
        pixbuf = pixbuf.get_from_drawable(root_win, root_win.get_colormap(),
                                          rect.x, rect.y, 0, 0, rect.w, rect.h)
        
        if pixbuf:
            pixbuf.save(filename, "png")
            print(f"截圖已儲存: {filename}")
        else:
            print("截圖失敗:無法讀取像素資料")

def main():
    tool = ScreenshotTool()
    # 1 秒後自動開始捕捉 (給視窗映射時間)
    glib.timeout_add_seconds(1, lambda: (tool.grab_pointer(), False)[1])
    gtk.main()

if __name__ == '__main__':
    main()

關鍵技術點解析

組件角色
gtk.gdk.pointer_grab獨佔滑鼠輸入,防止其他視窗干擾框選
gtk.gdk.CROSSHAIR十字光標提示截圖模式
get_default_screen().get_root_window()取得根視窗覆蓋所有螢幕
Pixbuf.get_from_drawable從可繪製區讀取像素到記憶體
Pixbuf.save(..., "png")編碼為 PNG 格式寫入磁碟

依賴安裝


# Ubuntu/Debian
sudo apt-get install python-gtk2 python-gobject-2

# CentOS/RHEL
sudo yum install pygtk2

# Arch
sudo pacman -S pygtk

現代化替代方案 (Python 3 / GTK 3)


# 使用 GI 綁定 (PyGObject)
import gi
gi.require_version('Gtk', '3.0')
gi.require_version('Gdk', '3.0')
from gi.repository import Gtk, Gdk, GLib

# 核心 API 變更:
# Gdk.Display.get_default()
# Gdk.Screen.get_default()
# Gdk.pixbuf_get_from_window()  (GDK 3.22+)
# GLib.timeout_add_seconds()

無頭環境/伺服器端替代方案

  • Xvfb + Selenium/Playwright: 虛擬顯示器渲染網頁截圖
  • scrot / import (ImageMagick): 命令列工具,subprocess.run(['scrot', '-s', 'out.png'])
  • mss (Python 庫): 純 Python 跨平台截圖 pip install mss

此 GTK 方案雖屬經典技術棧,但完整展示了桌面應用與視窗系統交互的核心流程:事件捕捉 → 座標計算 → 像素讀取 → 圖像編碼,對理解 GUI 底層機制極具教學價值。

copyright © 萬盛學電腦網 all rights reserved