在 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
# 使用 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()
subprocess.run(['scrot', '-s', 'out.png'])pip install mss此 GTK 方案雖屬經典技術棧,但完整展示了桌面應用與視窗系統交互的核心流程:事件捕捉 → 座標計算 → 像素讀取 → 圖像編碼,對理解 GUI 底層機制極具教學價值。