eye3 1.0.3__py3-none-win_amd64.whl

eye3/__init__.py

@@ -0,0 +1,25 @@
+"""eye3 - screen capture bypassing WDA_MONITOR/WDA_EXCLUDEFROMCAPTURE.
+
+Windows x64 native binary bundled in the wheel.
+"""
+
+from .binding import (
+    ThirdEyeError,
+    ThirdEyeOptions,
+    ThirdEyeSession,
+    ThirdeyeFormat,
+    ThirdeyeResult,
+    get_library_path,
+)
+
+__version__ = "1.0.0"
+
+__all__ = [
+    "ThirdEyeError",
+    "ThirdEyeOptions",
+    "ThirdEyeSession",
+    "ThirdeyeFormat",
+    "ThirdeyeResult",
+    "get_library_path",
+    "__version__",
+]

eye3/binding.py

@@ -0,0 +1,165 @@
+"""ctypes binding to the bundled thirdeye.dll (Windows x64)."""
+
+import ctypes
+import os
+import sys
+from enum import IntEnum
+
+_DLL_NAME = "thirdeye.dll"
+
+
+def get_library_path() -> str:
+    """Absolute path to the bundled thirdeye.dll."""
+    path = os.path.join(os.path.dirname(__file__), _DLL_NAME)
+    if not os.path.exists(path):
+        raise ThirdEyeError(
+            f"thirdeye native library not found at {path}. "
+            "This wheel ships a Windows x64 binary only."
+        )
+    return path
+
+
+class ThirdeyeResult(IntEnum):
+    OK = 0
+    ERROR_NOT_INITIALIZED = -1
+    ERROR_SYSCALL_INIT_FAILED = -2
+    ERROR_GDIPLUS_INIT_FAILED = -3
+    ERROR_ENCODER_NOT_FOUND = -4
+    ERROR_SAVE_FAILED = -5
+    ERROR_ALLOCATION_FAILED = -6
+    ERROR_INVALID_PARAM = -7
+    ERROR_NO_REMOTE_SECTION = -8
+
+
+class ThirdeyeFormat(IntEnum):
+    JPEG = 0
+    PNG = 1
+    BMP = 2
+
+
+class ThirdEyeError(RuntimeError):
+    """Raised when a thirdeye call returns a non-OK result."""
+
+    def __init__(self, result, message: str):
+        self.result = result
+        super().__init__(f"{message} (result={int(result)})")
+
+
+class ThirdEyeOptions(ctypes.Structure):
+    _fields_ = [
+        ("format", ctypes.c_int),
+        ("quality", ctypes.c_int),
+        ("bypassProtection", ctypes.c_int),
+    ]
+
+    def __init__(self, format=ThirdeyeFormat.JPEG, quality=90, bypass_protection=True):
+        super().__init__(int(format), int(quality), 1 if bypass_protection else 0)
+
+
+def _load():
+    if sys.platform != "win32":
+        raise ThirdEyeError(
+            ThirdeyeResult.ERROR_NOT_INITIALIZED,
+            "thirdeye is supported on Windows x64 only",
+        )
+    lib = ctypes.WinDLL(get_library_path())
+
+    lib.Thirdeye_CreateContext.argtypes = [ctypes.POINTER(ctypes.c_void_p)]
+    lib.Thirdeye_CreateContext.restype = ctypes.c_int
+
+    lib.Thirdeye_DestroyContext.argtypes = [ctypes.c_void_p]
+    lib.Thirdeye_DestroyContext.restype = None
+
+    lib.Thirdeye_GetDefaultOptions.argtypes = [ctypes.POINTER(ThirdEyeOptions)]
+    lib.Thirdeye_GetDefaultOptions.restype = None
+
+    lib.Thirdeye_CaptureToFile.argtypes = [
+        ctypes.c_void_p,
+        ctypes.c_wchar_p,
+        ctypes.POINTER(ThirdEyeOptions),
+    ]
+    lib.Thirdeye_CaptureToFile.restype = ctypes.c_int
+
+    lib.Thirdeye_CaptureToBuffer.argtypes = [
+        ctypes.c_void_p,
+        ctypes.POINTER(ctypes.POINTER(ctypes.c_uint8)),
+        ctypes.POINTER(ctypes.c_uint32),
+        ctypes.POINTER(ThirdEyeOptions),
+    ]
+    lib.Thirdeye_CaptureToBuffer.restype = ctypes.c_int
+
+    lib.Thirdeye_FreeBuffer.argtypes = [ctypes.POINTER(ctypes.c_uint8)]
+    lib.Thirdeye_FreeBuffer.restype = None
+
+    lib.Thirdeye_GetLastError.argtypes = [ctypes.c_void_p]
+    lib.Thirdeye_GetLastError.restype = ctypes.c_char_p
+
+    lib.Thirdeye_GetVersion.argtypes = []
+    lib.Thirdeye_GetVersion.restype = ctypes.c_char_p
+
+    return lib
+
+
+class ThirdEyeSession:
+    """Thread-safe-ish capture session. Use as a context manager."""
+
+    def __init__(self):
+        self._lib = _load()
+        self._ctx = ctypes.c_void_p()
+        rc = ThirdeyeResult(self._lib.Thirdeye_CreateContext(ctypes.byref(self._ctx)))
+        if rc != ThirdeyeResult.OK or not self._ctx:
+            raise ThirdEyeError(rc, "Thirdeye_CreateContext failed")
+
+    def default_options(self) -> ThirdEyeOptions:
+        opts = ThirdEyeOptions()
+        self._lib.Thirdeye_GetDefaultOptions(ctypes.byref(opts))
+        return opts
+
+    def capture_to_file(self, file_path: str, options: ThirdEyeOptions = None) -> None:
+        opts = options or self.default_options()
+        rc = ThirdeyeResult(
+            self._lib.Thirdeye_CaptureToFile(self._ctx, file_path, ctypes.byref(opts))
+        )
+        if rc != ThirdeyeResult.OK:
+            raise ThirdEyeError(rc, f"Thirdeye_CaptureToFile failed: {self.last_error()}")
+
+    def capture_to_buffer(self, options: ThirdEyeOptions = None) -> bytes:
+        opts = options or self.default_options()
+        buf = ctypes.POINTER(ctypes.c_uint8)()
+        size = ctypes.c_uint32(0)
+        rc = ThirdeyeResult(
+            self._lib.Thirdeye_CaptureToBuffer(
+                self._ctx, ctypes.byref(buf), ctypes.byref(size), ctypes.byref(opts)
+            )
+        )
+        if rc != ThirdeyeResult.OK or not buf or size.value == 0:
+            raise ThirdEyeError(rc, f"Thirdeye_CaptureToBuffer failed: {self.last_error()}")
+        try:
+            return ctypes.string_at(buf, size.value)
+        finally:
+            self._lib.Thirdeye_FreeBuffer(buf)
+
+    def last_error(self) -> str:
+        err = self._lib.Thirdeye_GetLastError(self._ctx)
+        return err.decode("utf-8", "replace") if err else ""
+
+    def version(self) -> str:
+        v = self._lib.Thirdeye_GetVersion()
+        return v.decode("utf-8", "replace") if v else ""
+
+    def close(self) -> None:
+        if self._ctx:
+            self._lib.Thirdeye_DestroyContext(self._ctx)
+            self._ctx = ctypes.c_void_p()
+
+    def __enter__(self) -> "ThirdEyeSession":
+        return self
+
+    def __exit__(self, *exc) -> None:
+        self.close()
+
+    def __del__(self):
+        try:
+            self.close()
+        except Exception:
+            pass

eye3-1.0.3.dist-info/METADATA

@@ -0,0 +1,39 @@
+Metadata-Version: 2.4
+Name: eye3
+Version: 1.0.3
+Summary: Screen capture library bypassing WDA_MONITOR/WDA_EXCLUDEFROMCAPTURE (Windows x64 native binary)
+Author: Matěj "lofcz" Štágl
+License: MIT
+Project-URL: Homepage, https://github.com/lofcz/thirdeye
+Project-URL: Repository, https://github.com/lofcz/thirdeye
+Keywords: screenshot,screen-capture,windows,display-affinity,native
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# eye3
+
+Screen capture library bypassing `WDA_MONITOR` / `WDA_EXCLUDEFROMCAPTURE` (Windows x64 native binary).
+
+```python
+from eye3 import ThirdEyeSession
+
+with ThirdEyeSession() as session:
+    session.capture_to_file("screenshot.png")
+```
+
+Options:
+
+```python
+from eye3 import ThirdEyeSession, ThirdEyeOptions, ThirdeyeFormat
+
+with ThirdEyeSession() as session:
+    opts = ThirdEyeOptions(format=ThirdeyeFormat.JPEG, quality=90, bypass_protection=True)
+    session.capture_to_file("screenshot.jpeg", opts)
+
+    data: bytes = session.capture_to_buffer()
+```
+
+Windows x64 only. Ships the native `thirdeye.dll` inside the wheel.

eye3-1.0.3.dist-info/RECORD

@@ -0,0 +1,7 @@
+eye3/__init__.py,sha256=hK74N2PEZpfUluBBfGYJr2Gsog0iQxURyx2GYCz4xuM,490
+eye3/binding.py,sha256=oeCgba14y4xIoqEmiEust80744CNzOt_P-Ng41y0ws8,5356
+eye3/thirdeye.dll,sha256=y3Yn-rvM2_7Fp_tEGPpciQYK4WRk-UsbzgX5Wm5X3T0,1071104
+eye3-1.0.3.dist-info/METADATA,sha256=GjgPkt5THKMPR2HbuR6krlYBtVz3qzAySZwrVzdHfr4,1264
+eye3-1.0.3.dist-info/WHEEL,sha256=hVx9elvUDfBjRmbl8JwIcXXikst35RZTZK9nspfI_28,98
+eye3-1.0.3.dist-info/top_level.txt,sha256=49LwWwD5uM6wMwG-L9vs2w9tuJhPp01JvO51MR0jads,5
+eye3-1.0.3.dist-info/RECORD,,

eye3-1.0.3.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: false
+Tag: py3-none-win_amd64
+

eye3-1.0.3.dist-info/top_level.txt

@@ -0,0 +1 @@
+eye3