wgc-python 2.0.1__py3-none-any.whl → 2.1.0__py3-none-any.whl

wgc_python/__init__.py

@@ -157,4 +157,65 @@ class WindowCapture:
     def handle(self) -> int: return self._h
 
 
-__all__ = ['WindowCapture', 'enumerate_windows', 'get_last_error', 'get_active_capture_count']
+class WindowCaptureMonitor:
+    """显示器捕获类 - 捕获目标窗口所在显示器的全部内容
+
+    捕获会话绑定显示器而非窗口：目标窗口全屏/窗口切换不会使会话失效
+    （窗口捕获模式会在此时冻结于最后一帧）。仅捕获屏幕内容，无客户区裁剪。
+
+    Args:
+        title: 目标窗口标题（用于定位其所在显示器）
+        class_name: 目标窗口类名
+    """
+
+    def __init__(self, title: str, class_name: str):
+        self._h = _dll.StartCaptureMonitorOfWindow(title.encode(), class_name.encode())
+        if not self._h:
+            raise RuntimeError(get_last_error())
+    
+    def __del__(self): self.close()
+    def __enter__(self): return self
+    def __exit__(self, *_): self.close()
+    
+    def get_frame(self) -> Optional[Tuple[int, int, int, int]]:
+        """返回 (data_ptr, w, h, row_pitch) — 零拷贝 GPU 映射内存。
+
+        用完必须调用 release_frame()，期间不要再次调用。"""
+        if not self._h: return None
+        data = ctypes.POINTER(ctypes.c_ubyte)()
+        w, h, rp = ctypes.c_int(), ctypes.c_int(), ctypes.c_int()
+        if _dll.GetFrameMapped(self._h, ctypes.byref(data), ctypes.byref(w), ctypes.byref(h), ctypes.byref(rp)) == 0:
+            return None
+        return (ctypes.cast(data, ctypes.c_void_p).value, w.value, h.value, rp.value)
+
+    def release_frame(self):
+        if self._h: _dll.ReleaseMappedFrame(self._h)
+    
+    def stop(self):
+        if self._h: _dll.StopCapture(self._h)
+    
+    def pause(self):
+        if self._h: _dll.PauseCapture(self._h)
+    
+    def resume(self):
+        if self._h: _dll.ResumeCapture(self._h)
+    
+    def is_capturing(self) -> bool:
+        return bool(self._h and _dll.IsCapturing(self._h))
+    
+    def is_paused(self) -> bool:
+        return bool(self._h and _dll.IsPaused(self._h))
+    
+    def get_frame_count(self) -> int:
+        return _dll.GetFrameCount(self._h) if self._h else 0
+    
+    def close(self):
+        if self._h:
+            _dll.DestroyCapture(self._h)
+            self._h = 0
+    
+    @property
+    def handle(self) -> int: return self._h
+
+
+__all__ = ['WindowCapture', 'WindowCaptureMonitor', 'enumerate_windows', 'get_last_error', 'get_active_capture_count']

{wgc_python-2.0.1.dist-info → wgc_python-2.1.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: wgc_python
-Version: 2.0.1
+Version: 2.1.0
 Summary: Windows Graphics Capture 窗口捕获库 — BGRA numpy 帧、按需捕获、零拷贝 GPU 路径
 Author: XuanChenxuan
 License: MIT
@@ -26,6 +26,7 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: numpy
 Requires-Dist: opencv-python
+Dynamic: license-file
 
 # wgc_python
 
@@ -174,6 +175,21 @@ while True:
 cap.close()
 ```
 
+### 显示器捕获（推荐全屏游戏场景使用）
+
+捕获目标窗口**所在的显示器**而非窗口本身：捕获会话绑定显示器，**目标窗口在全屏/窗口之间切换不会使捕获会话失效**（窗口捕获模式下此场景会冻结于最后一帧）。
+
+```python
+from wgc_python import WindowCaptureMonitor
+
+# 定位目标窗口所在的显示器并捕获其全部内容（无客户区裁剪）
+cap = WindowCaptureMonitor("游戏窗口", "UnityWndClass")
+frame = cap.capture_one()   # 整屏 BGRA 帧
+cap.close()
+```
+
+适用场景：全屏游戏的长期自动化采集、目标窗口显示模式频繁变化的场景。需要裁剪客户区或排除其他窗口内容时，仍请使用 `WindowCapture`。
+
 ### 零拷贝高级用法
 
 ```python

wgc_python-2.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+wgc_python/__init__.py,sha256=rpzrOz1oaluBuK7Qg3g3E2kE45_80Ff03xjahRe1b8E,8429
+wgc_python/wgc_python.dll,sha256=0T1liFK7PJShi5pT1Ym06gURBNIXgNxWnQOKMIiSao8,348160
+wgc_python-2.1.0.dist-info/licenses/LICENSE,sha256=B5ek2R7a_iool-DvWfPuU-DlXlL-Meo1HBpDXfnqi2Y,1090
+wgc_python-2.1.0.dist-info/METADATA,sha256=OKHyScy-Pf3i9pTyECNRA04nH6Yf2BNCNFegmpDonkE,27656
+wgc_python-2.1.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+wgc_python-2.1.0.dist-info/top_level.txt,sha256=xqnLXhvRXiyjxTPKMDQSQSwa3NfcRhOAnLXj3YCpNp0,11
+wgc_python-2.1.0.dist-info/RECORD,,

{wgc_python-2.0.1.dist-info → wgc_python-2.1.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (72.1.0)
+Generator: setuptools (84.2.1)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

wgc_python-2.0.1.dist-info/RECORD

@@ -1,7 +0,0 @@
-wgc_python/__init__.py,sha256=TyGhYB64Hvs1cK666ScerI1Vtv8erZDUg5C6I_aruHI,6248
-wgc_python/wgc_python.dll,sha256=Y-pJOFlmAN8NysLQGO8aLBAIEp1Ty_s311wffZiJaMM,340992
-wgc_python-2.0.1.dist-info/LICENSE,sha256=B5ek2R7a_iool-DvWfPuU-DlXlL-Meo1HBpDXfnqi2Y,1090
-wgc_python-2.0.1.dist-info/METADATA,sha256=TXtdivxqwqD-QO8uwcKbSIGbVxpMhhl0WTfRp797pek,26880
-wgc_python-2.0.1.dist-info/WHEEL,sha256=R0nc6qTxuoLk7ShA2_Y-UWkN8ZdfDBG2B6Eqpz2WXbs,91
-wgc_python-2.0.1.dist-info/top_level.txt,sha256=xqnLXhvRXiyjxTPKMDQSQSwa3NfcRhOAnLXj3YCpNp0,11
-wgc_python-2.0.1.dist-info/RECORD,,