212 lines
7.4 KiB
Python
212 lines
7.4 KiB
Python
"""This is part of the MSS Python's module.
|
|
Source: https://github.com/BoboTiG/python-mss.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import ctypes
|
|
import ctypes.util
|
|
import sys
|
|
from ctypes import POINTER, Structure, c_double, c_float, c_int32, c_ubyte, c_uint32, c_uint64, c_void_p
|
|
from platform import mac_ver
|
|
from typing import TYPE_CHECKING, Any
|
|
|
|
from mss.base import MSSBase
|
|
from mss.exception import ScreenShotError
|
|
from mss.screenshot import ScreenShot, Size
|
|
|
|
if TYPE_CHECKING: # pragma: nocover
|
|
from mss.models import CFunctions, Monitor
|
|
|
|
__all__ = ("MSS",)
|
|
|
|
MAC_VERSION_CATALINA = 10.16
|
|
|
|
|
|
def cgfloat() -> type[c_double | c_float]:
|
|
"""Get the appropriate value for a float."""
|
|
return c_double if sys.maxsize > 2**32 else c_float
|
|
|
|
|
|
class CGPoint(Structure):
|
|
"""Structure that contains coordinates of a rectangle."""
|
|
|
|
_fields_ = (("x", cgfloat()), ("y", cgfloat()))
|
|
|
|
def __repr__(self) -> str:
|
|
return f"{type(self).__name__}(left={self.x} top={self.y})"
|
|
|
|
|
|
class CGSize(Structure):
|
|
"""Structure that contains dimensions of an rectangle."""
|
|
|
|
_fields_ = (("width", cgfloat()), ("height", cgfloat()))
|
|
|
|
def __repr__(self) -> str:
|
|
return f"{type(self).__name__}(width={self.width} height={self.height})"
|
|
|
|
|
|
class CGRect(Structure):
|
|
"""Structure that contains information about a rectangle."""
|
|
|
|
_fields_ = (("origin", CGPoint), ("size", CGSize))
|
|
|
|
def __repr__(self) -> str:
|
|
return f"{type(self).__name__}<{self.origin} {self.size}>"
|
|
|
|
|
|
# C functions that will be initialised later.
|
|
#
|
|
# Available attr: core.
|
|
#
|
|
# Note: keep it sorted by cfunction.
|
|
CFUNCTIONS: CFunctions = {
|
|
# Syntax: cfunction: (attr, argtypes, restype)
|
|
"CGDataProviderCopyData": ("core", [c_void_p], c_void_p),
|
|
"CGDisplayBounds": ("core", [c_uint32], CGRect),
|
|
"CGDisplayRotation": ("core", [c_uint32], c_float),
|
|
"CFDataGetBytePtr": ("core", [c_void_p], c_void_p),
|
|
"CFDataGetLength": ("core", [c_void_p], c_uint64),
|
|
"CFRelease": ("core", [c_void_p], c_void_p),
|
|
"CGDataProviderRelease": ("core", [c_void_p], c_void_p),
|
|
"CGGetActiveDisplayList": ("core", [c_uint32, POINTER(c_uint32), POINTER(c_uint32)], c_int32),
|
|
"CGImageGetBitsPerPixel": ("core", [c_void_p], int),
|
|
"CGImageGetBytesPerRow": ("core", [c_void_p], int),
|
|
"CGImageGetDataProvider": ("core", [c_void_p], c_void_p),
|
|
"CGImageGetHeight": ("core", [c_void_p], int),
|
|
"CGImageGetWidth": ("core", [c_void_p], int),
|
|
"CGRectStandardize": ("core", [CGRect], CGRect),
|
|
"CGRectUnion": ("core", [CGRect, CGRect], CGRect),
|
|
"CGWindowListCreateImage": ("core", [CGRect, c_uint32, c_uint32, c_uint32], c_void_p),
|
|
}
|
|
|
|
|
|
class MSS(MSSBase):
|
|
"""Multiple ScreenShots implementation for macOS.
|
|
It uses intensively the CoreGraphics library.
|
|
"""
|
|
|
|
__slots__ = {"core", "max_displays"}
|
|
|
|
def __init__(self, /, **kwargs: Any) -> None:
|
|
"""MacOS initialisations."""
|
|
super().__init__(**kwargs)
|
|
|
|
self.max_displays = kwargs.get("max_displays", 32)
|
|
|
|
self._init_library()
|
|
self._set_cfunctions()
|
|
|
|
def _init_library(self) -> None:
|
|
"""Load the CoreGraphics library."""
|
|
version = float(".".join(mac_ver()[0].split(".")[:2]))
|
|
if version < MAC_VERSION_CATALINA:
|
|
coregraphics = ctypes.util.find_library("CoreGraphics")
|
|
else:
|
|
# macOS Big Sur and newer
|
|
coregraphics = "/System/Library/Frameworks/CoreGraphics.framework/Versions/Current/CoreGraphics"
|
|
|
|
if not coregraphics:
|
|
msg = "No CoreGraphics library found."
|
|
raise ScreenShotError(msg)
|
|
self.core = ctypes.cdll.LoadLibrary(coregraphics)
|
|
|
|
def _set_cfunctions(self) -> None:
|
|
"""Set all ctypes functions and attach them to attributes."""
|
|
cfactory = self._cfactory
|
|
attrs = {"core": self.core}
|
|
for func, (attr, argtypes, restype) in CFUNCTIONS.items():
|
|
cfactory(attrs[attr], func, argtypes, restype)
|
|
|
|
def _monitors_impl(self) -> None:
|
|
"""Get positions of monitors. It will populate self._monitors."""
|
|
int_ = int
|
|
core = self.core
|
|
|
|
# All monitors
|
|
# We need to update the value with every single monitor found
|
|
# using CGRectUnion. Else we will end with infinite values.
|
|
all_monitors = CGRect()
|
|
self._monitors.append({})
|
|
|
|
# Each monitor
|
|
display_count = c_uint32(0)
|
|
active_displays = (c_uint32 * self.max_displays)()
|
|
core.CGGetActiveDisplayList(self.max_displays, active_displays, ctypes.byref(display_count))
|
|
for idx in range(display_count.value):
|
|
display = active_displays[idx]
|
|
rect = core.CGDisplayBounds(display)
|
|
rect = core.CGRectStandardize(rect)
|
|
width, height = rect.size.width, rect.size.height
|
|
|
|
# 0.0: normal
|
|
# 90.0: right
|
|
# -90.0: left
|
|
if core.CGDisplayRotation(display) in {90.0, -90.0}:
|
|
width, height = height, width
|
|
|
|
self._monitors.append(
|
|
{
|
|
"left": int_(rect.origin.x),
|
|
"top": int_(rect.origin.y),
|
|
"width": int_(width),
|
|
"height": int_(height),
|
|
},
|
|
)
|
|
|
|
# Update AiO monitor's values
|
|
all_monitors = core.CGRectUnion(all_monitors, rect)
|
|
|
|
# Set the AiO monitor's values
|
|
self._monitors[0] = {
|
|
"left": int_(all_monitors.origin.x),
|
|
"top": int_(all_monitors.origin.y),
|
|
"width": int_(all_monitors.size.width),
|
|
"height": int_(all_monitors.size.height),
|
|
}
|
|
|
|
def _grab_impl(self, monitor: Monitor, /) -> ScreenShot:
|
|
"""Retrieve all pixels from a monitor. Pixels have to be RGB."""
|
|
core = self.core
|
|
rect = CGRect((monitor["left"], monitor["top"]), (monitor["width"], monitor["height"]))
|
|
|
|
image_ref = core.CGWindowListCreateImage(rect, 1, 0, 0)
|
|
if not image_ref:
|
|
msg = "CoreGraphics.CGWindowListCreateImage() failed."
|
|
raise ScreenShotError(msg)
|
|
|
|
width = core.CGImageGetWidth(image_ref)
|
|
height = core.CGImageGetHeight(image_ref)
|
|
prov = copy_data = None
|
|
try:
|
|
prov = core.CGImageGetDataProvider(image_ref)
|
|
copy_data = core.CGDataProviderCopyData(prov)
|
|
data_ref = core.CFDataGetBytePtr(copy_data)
|
|
buf_len = core.CFDataGetLength(copy_data)
|
|
raw = ctypes.cast(data_ref, POINTER(c_ubyte * buf_len))
|
|
data = bytearray(raw.contents)
|
|
|
|
# Remove padding per row
|
|
bytes_per_row = core.CGImageGetBytesPerRow(image_ref)
|
|
bytes_per_pixel = core.CGImageGetBitsPerPixel(image_ref)
|
|
bytes_per_pixel = (bytes_per_pixel + 7) // 8
|
|
|
|
if bytes_per_pixel * width != bytes_per_row:
|
|
cropped = bytearray()
|
|
for row in range(height):
|
|
start = row * bytes_per_row
|
|
end = start + width * bytes_per_pixel
|
|
cropped.extend(data[start:end])
|
|
data = cropped
|
|
finally:
|
|
if prov:
|
|
core.CGDataProviderRelease(prov)
|
|
if copy_data:
|
|
core.CFRelease(copy_data)
|
|
|
|
return self.cls_image(data, monitor, size=Size(width, height))
|
|
|
|
def _cursor_impl(self) -> ScreenShot | None:
|
|
"""Retrieve all cursor data. Pixels have to be RGB."""
|
|
return None
|