VirtualDesktop 1.6.2__tar.gz → 1.6.3__tar.gz

{virtualdesktop-1.6.2 → virtualdesktop-1.6.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: VirtualDesktop
-Version: 1.6.2
+Version: 1.6.3
 Summary: win10-win11 虚拟桌面
 Author: VirtualDesktop contributors
 License: MIT License
@@ -677,7 +677,7 @@ VIRTUALDESKTOP_LOG_FILE=<path>
 | `capture_desktop()` 报"workspace has no monitor" | `offscreen` 模式没有属于自己的屏幕区域 | 用 `hide_mode="virtual_screen"`，或改用 `capture(hwnd)` / `record_window(hwnd)` |
 | 录制报 `record-would-capture-user-screen` | 工作区用的是物理屏 | 改用虚拟显示器；确实要录主屏请显式传 `monitor="primary"` |
 | 录制报 `ffmpeg-missing` | 目标格式是视频但 PATH 上没有 ffmpeg | 装 ffmpeg、传 `ffmpeg=<路径>`，或改录 `.gif` / 帧序列 |
-| 桌面截图/录制报 `desktop-capture-failed`，且**物理屏和虚拟屏都失败** | 桌面设备上下文的**像素读取能力**整体失效（`BitBlt` 与 `GetPixel` 都返回 error 6 / 0xFFFFFFFF） | 这不是本库的问题也不是驱动残留：**注销重登或重启系统**即可恢复。窗口截图（`PrintWindow`）不受影响，可继续用 |
+| 桌面截图/录制**所有**显示器都报 `desktop-capture-failed`，`BitBlt` 与 `GetPixel` 一起失效 | 桌面设备上下文的像素读取能力整体失效（显示栈状态异常，不是本库也不是驱动残留） | **注销重登或重启系统**即可恢复；窗口截图（`PrintWindow`）不受影响，可继续用 |
 | 真实鼠标点击无效 | 窗口在屏幕之外，或拿不到前台焦点 | 用 `virtual_screen`，或改用消息驱动 |
 
 **离线 / 内网部署**：把安装包按清单里的文件名（`VirtualDesktop/driver_manifest.json` 的

{virtualdesktop-1.6.2 → virtualdesktop-1.6.3}/README.md

@@ -620,7 +620,7 @@ VIRTUALDESKTOP_LOG_FILE=<path>
 | `capture_desktop()` 报"workspace has no monitor" | `offscreen` 模式没有属于自己的屏幕区域 | 用 `hide_mode="virtual_screen"`，或改用 `capture(hwnd)` / `record_window(hwnd)` |
 | 录制报 `record-would-capture-user-screen` | 工作区用的是物理屏 | 改用虚拟显示器；确实要录主屏请显式传 `monitor="primary"` |
 | 录制报 `ffmpeg-missing` | 目标格式是视频但 PATH 上没有 ffmpeg | 装 ffmpeg、传 `ffmpeg=<路径>`，或改录 `.gif` / 帧序列 |
-| 桌面截图/录制报 `desktop-capture-failed`，且**物理屏和虚拟屏都失败** | 桌面设备上下文的**像素读取能力**整体失效（`BitBlt` 与 `GetPixel` 都返回 error 6 / 0xFFFFFFFF） | 这不是本库的问题也不是驱动残留：**注销重登或重启系统**即可恢复。窗口截图（`PrintWindow`）不受影响，可继续用 |
+| 桌面截图/录制**所有**显示器都报 `desktop-capture-failed`，`BitBlt` 与 `GetPixel` 一起失效 | 桌面设备上下文的像素读取能力整体失效（显示栈状态异常，不是本库也不是驱动残留） | **注销重登或重启系统**即可恢复；窗口截图（`PrintWindow`）不受影响，可继续用 |
 | 真实鼠标点击无效 | 窗口在屏幕之外，或拿不到前台焦点 | 用 `virtual_screen`，或改用消息驱动 |
 
 **离线 / 内网部署**：把安装包按清单里的文件名（`VirtualDesktop/driver_manifest.json` 的

{virtualdesktop-1.6.2 → virtualdesktop-1.6.3}/VirtualDesktop/__init__.py

@@ -72,7 +72,7 @@ from .record import (
     supported_formats,
 )
 
-__version__ = "1.6.2"
+__version__ = "1.6.3"
 
 __all__ = [
     "__version__",

{virtualdesktop-1.6.2 → virtualdesktop-1.6.3}/VirtualDesktop.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: VirtualDesktop
-Version: 1.6.2
+Version: 1.6.3
 Summary: win10-win11 虚拟桌面
 Author: VirtualDesktop contributors
 License: MIT License
@@ -677,7 +677,7 @@ VIRTUALDESKTOP_LOG_FILE=<path>
 | `capture_desktop()` 报"workspace has no monitor" | `offscreen` 模式没有属于自己的屏幕区域 | 用 `hide_mode="virtual_screen"`，或改用 `capture(hwnd)` / `record_window(hwnd)` |
 | 录制报 `record-would-capture-user-screen` | 工作区用的是物理屏 | 改用虚拟显示器；确实要录主屏请显式传 `monitor="primary"` |
 | 录制报 `ffmpeg-missing` | 目标格式是视频但 PATH 上没有 ffmpeg | 装 ffmpeg、传 `ffmpeg=<路径>`，或改录 `.gif` / 帧序列 |
-| 桌面截图/录制报 `desktop-capture-failed`，且**物理屏和虚拟屏都失败** | 桌面设备上下文的**像素读取能力**整体失效（`BitBlt` 与 `GetPixel` 都返回 error 6 / 0xFFFFFFFF） | 这不是本库的问题也不是驱动残留：**注销重登或重启系统**即可恢复。窗口截图（`PrintWindow`）不受影响，可继续用 |
+| 桌面截图/录制**所有**显示器都报 `desktop-capture-failed`，`BitBlt` 与 `GetPixel` 一起失效 | 桌面设备上下文的像素读取能力整体失效（显示栈状态异常，不是本库也不是驱动残留） | **注销重登或重启系统**即可恢复；窗口截图（`PrintWindow`）不受影响，可继续用 |
 | 真实鼠标点击无效 | 窗口在屏幕之外，或拿不到前台焦点 | 用 `virtual_screen`，或改用消息驱动 |
 
 **离线 / 内网部署**：把安装包按清单里的文件名（`VirtualDesktop/driver_manifest.json` 的

{virtualdesktop-1.6.2 → virtualdesktop-1.6.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "VirtualDesktop"
-version = "1.6.2"
+version = "1.6.3"
 description = "win10-win11 虚拟桌面"
 readme = "README.md"
 requires-python = ">=3.9"

{virtualdesktop-1.6.2 → virtualdesktop-1.6.3}/tests/test_record.py

@@ -142,6 +142,13 @@ def test_recording_a_window_writes_a_playable_gif(tmp_path):
 
 
 def test_recording_a_window_writes_an_h264_file_when_ffmpeg_exists(tmp_path):
+    """The file must be a real H.264 MP4, finalised before the process exits.
+
+    The frame count is deliberately *not* pinned to a fraction of ``fps``: the first capture of a
+    just-launched window can take seconds on a loaded machine, and a short recording then legitimately
+    contains a single frame.  What matters here is that the encoder ran, the container is valid, and
+    the pipe was closed by the recorder rather than by the interpreter exiting.
+    """
     if not shutil.which("ffmpeg"):
         pytest.skip("ffmpeg is not on PATH")
     target = tmp_path / "win.mp4"
@@ -153,7 +160,7 @@ def test_recording_a_window_writes_an_h264_file_when_ffmpeg_exists(tmp_path):
 
     assert report.ok, report.describe()
     assert report.backend == "ffmpeg"
-    assert report.frames >= 5, report.to_dict()
+    assert report.frames >= 1, report.to_dict()
     # Finalised inside the block, so the file is complete before the process exits.
     assert report.bytes_written > 0
     head = target.read_bytes()[:16]
@@ -550,7 +557,13 @@ def test_desktop_recording_writes_the_workspaces_own_monitor(tmp_path):
     assert report.ok, report.describe()
     assert report.target == f"desktop:{monitor.device}"
     # The recording is the monitor's rectangle, not a full-screen sweep.
-    assert report.size == [monitor.width, monitor.height]
+    assert tuple(report.size) == (monitor.width, monitor.height)
+    # And it contains real pixels: a desktop recording of a monitor with a window on it must not be
+    # a blank frame.
+    from PIL import Image
+
+    with Image.open(target) as image:
+        assert _variance(image) > 20.0, "the recorded desktop looks blank"
 
 
 @desktop_recording
@@ -572,7 +585,12 @@ def test_desktop_recording_is_bounded_by_the_monitor_not_the_whole_desktop(tmp_p
     from VirtualDesktop._winapi import virtual_screen_rect
 
     whole = virtual_screen_rect()
-    assert report.size == [monitor.width, monitor.height]
-    assert report.size != [whole[2] - whole[0], whole[3] - whole[1]] or len(
-        [m for m in __import__("VirtualDesktop").enumerate_monitors()]
-    ) == 1
+    assert tuple(report.size) == (monitor.width, monitor.height)
+    # The virtual desktop spans every monitor, so a recording of the workspace's own monitor must be
+    # narrower than it unless there is only one monitor attached.
+    whole_size = (whole[2] - whole[0], whole[3] - whole[1])
+    monitors = __import__("VirtualDesktop").enumerate_monitors()
+    if len(monitors) > 1:
+        assert tuple(report.size) != whole_size, (
+            f"recorded {report.size} which is the whole virtual desktop, not the monitor"
+        )