3jNSSKJr SSKrSSKrSSKJrJr SSKJr SSKJ r SSK J r J r SSK Jr SSKJr SS KJr \ (aSS KJrJr SS KJrJrJr SS K Jr SS KJr \ "5r Sr!"SS5r"Sr#"SS\5r$SSjr%"SS5r&\&r'g!\a SS KJr NH!\a \ rNSf=ff=f!\a SSKJr \R>rNnf=f)) annotationsN)ABCabstractmethod)datetime)Lock) TYPE_CHECKINGAny)ScreenShotError) ScreenShot)to_png)CallableIterator)MonitorMonitorsSize)Self)UTC)timezonec(\rSrSrSSjrSSjrSrg)_PlatformSpecific8c$[U5UlgN)str sphinx_repr)selfrs B/home/wildlama/miniconda3/lib/python3.13/site-packages/mss/base.py__init___PlatformSpecific.__init__9s{+cUR$rrrs r__repr___PlatformSpecific.__repr__<sr!r#N)rr returnNone)r'r)__name__ __module__ __qualname____firstlineno__rr%__static_attributes__r!rrr8s , r!rr.c\rSrSr%SrSrS\S'SS.SSjjr\SS j5r \SS j5r \SS j5r SS jr \ SSSjj5rSrg )MSSImplementationEzBase class for internal platform/backend implementations. Only one of these methods will be called at a time; the containing MSS object will hold a lock during these calls. )performance_status with_cursorboolr3F)r3cXl/Ulgr)r3r2)rr3s rrMSSImplementation.__init__Ps'.0r!cg)z0Retrieve all cursor data. Pixels have to be RGB.Nr.r$s rcursorMSSImplementation.cursor]r!cg)zRetrieve all pixels from a monitor. Pixels have to be RGB. If the monitor size is not in pixel units, include a Size in pixels (see issue #23). Nr.)rmonitors rgrabMSSImplementation.grabar:r!cg)zReturn positions of monitors.Nr.r$s rmonitorsMSSImplementation.monitorsir:r!cg)zClean up. This will be called at most once. It's not necessary for subclasses to implement this if they have nothing to clean up. Nr.r$s rcloseMSSImplementation.closemr:r!NcN[X5nX%lX5lU(aXElggzDFactory to create a ctypes function and automatically manage errors.NgetattrargtypesrestypeerrcheckattrfuncrIrJrKmeths r _cfactoryMSSImplementation._cfactoryv%t"  $M r!)r3r4r'r()r'zScreenShot | None)r<rr'z"bytearray | tuple[bytearray, Size]r'rr'r(r rKzCallable | NonerMr rNrrIz list[Any]rJr r'r()r)r*r+r,__doc__ __slots____annotations__rrr8r=r@rC staticmethodrPr-r.r!rr0r0Es 6I16 0??  ,, %) % " % % % % %  % %r!r0c [R"5R5nUS:XaSSKJn U"S 0UD6$US:XaSSKJn U"S 0UD6$US:XaSSKJn U"S 0UD6$SU<S3n[U5e) a#Return the backend implementation for the current platform. Detects the platform we are running on and instantiates the appropriate internal implementation class. .. seealso:: - :class:`mss.MSS` - :class:`mss.darwin.MSS` - :class:`mss.linux.MSS` - :class:`mss.windows.MSS` darwinr) MSSImplDarwinlinux) choose_implwindowszSystem z not (yet?) implemented.r.) platformsystemlower mss.darwinr\ mss.linuxr^ mss.windowsr )kwargsos_r\choose_impl_linuxchoose_impl_windowsmsgs r _choose_implrks //  ! ! #C h,&v&& g~>!*6** iB#,V,, C72 3C # r!cv\rSrSrSr\"S5r\"S5r\"S5rSS\\\S.SS jjr SS jr SS jr SS jr SS jr \S Sj5r\S!Sj5rSSSS.S"SjjrS#Sjr\S$Sj5r\S%S&Sjj5r\S'Sj5r\S(Sj5r\S)Sj5rSrg)*MSSaMultiple ScreenShots class :param backend: Backend selector, for platforms with multiple backends. :param compression_level: PNG compression level. :param with_cursor: Include the mouse cursor in screenshots (GNU/Linux only) :type display: bool, optional (default False) :param display: X11 display name (GNU/Linux only). :type display: bytes | str, optional (default :envvar:`$DISPLAY`) :param max_displays: Maximum number of displays to enumerate (macOS only). :type max_displays: int, optional (default 32) .. versionadded:: 8.0.0 ``compression_level``, ``display``, ``max_displays``, and ``with_cursor`` keyword arguments. .. versionadded:: 10.2.0 ``backend`` keyword argument. FN default)backendcompression_levelr3display max_displaysc0n[R"5nSUS/4SUS/4SUS/44HWupn [U [5(aMXz;a1[R "USSR U 5S3[S S 9 MSXU'MY [S S U0UD6Ul [Ul X l [5UlSUlS Ulg)Nr3LinuxrtruDarwinz is only available on z, z&. This will be an error in the future.) stacklevelrrFr.)r`ra isinstancerwarningswarnjoinDeprecationWarningrk_implr cls_imagersr_lock _monitors_closed) rrrrsr3rtru impl_kwargsranamevaluesupported_platformss rr MSS.__init__s " K' 3 ' + \H: 61 ,D, %!2330 f2499=P3Q2RS;;& %*D!#1 &)5) ) )  ,6 "3 V *. r!cU$)'For the cool call `with MSS() as mss:`.r.r$s r __enter__ MSS.__enter__s r!c$UR5 g)rN)rC)r_s r__exit__ MSS.__exit__s  r!cUR UR(a SSS5 gURR5 SUlSSS5 g!,(df  g=f)aMClean up. This releases resources that MSS may be using. Once the MSS object is closed, it may not be used again. It is safe to call this multiple times; multiple calls have no effect. Rather than use :py:meth:`close` explicitly, we recommend you use the MSS object as a context manager:: with mss.MSS() as sct: ... NT)rrrrCr$s rrC MSS.close s?ZZ||Z JJ   DL ZZsA!A A!c^[U[5(aUSUSUSUS- USUS- S.nUSS::d USS::aSU<3n[U5eUR URR U5n[U[5(aUupEUR XAUS 9nOUnUR XA5nURR(a;URR5=n(aURXg5sS S S 5 $UsS S S 5 $!,(df  g =f) aTRetrieve screen pixels for a given monitor. Note: ``monitor`` can be a tuple like the one :py:meth:`PIL.ImageGrab.grab` accepts: ``(left, top, right, bottom)`` :param monitor: The coordinates and size of the box to capture. See :meth:`monitors ` for object details. :returns: Screenshot of the requested region. rry)lefttopwidthheightrrz"Region has zero or negative size: )sizeN) r{tupler rrr=rr3r8_merge)rr<rjimg_data_and_maybe_sizeimg_datar screenshotr8s rr=MSS.grab s gu % % qz gaj0!!*wqz1 G 7 q GH$5$:6wkBC!#& & ZZ&*jjoog&> #1599!8!^^HD^I 2!^^H> zz%%TZZ5F5F5H+H6+H{{:6ZZZs$B%DD D,cUR URc.URR5UlURceURsSSS5 $!,(df  g=f)a Get positions of all monitors. If the monitor has rotation, you have to deal with it inside this method. This method has to fill ``self._monitors`` with all information and use it as a cache: - ``self._monitors[0]`` is a dict of all monitors together - ``self._monitors[N]`` is a dict of the monitor N (with N > 0) Each monitor is a dict with: - ``left``: the x-coordinate of the upper-left corner - ``top``: the y-coordinate of the upper-left corner - ``width``: the width - ``height``: the height - ``is_primary``: (optional) true if this is the primary monitor - ``name``: (optional) human-readable device name - ``unique_id``: (optional) platform-specific stable identifier for the monitor - ``output``: (optional, Linux only) monitor output name, compatible with xrandr N)rrrr@r$s rr@ MSS.monitorsCsJ.ZZ~~%!%!4!4!6~~111>> ZZs AA A,cURn[U5S::a Sn[U5e[SUSS5US5$)aGet the primary monitor. Returns the monitor marked as primary. If no monitor is marked as primary (or the platform doesn't support primary monitor detection), returns the first monitor (at index 1). :raises ScreenShotError: If no monitors are available. .. versionadded:: 10.2.0 rNo monitor found.c3X# UH nURSS5(dMUv M" g7f) is_primaryFN)get).0r<s r &MSS.primary_monitor..rs' +G;;|U3+s* *N)r@lenr next)rr@rjs rprimary_monitorMSS.primary_monitor`sR== x=A %C!#& & '|  QK   r!rzmonitor-{mon}.png)monoutputcallbackc#"# URnU(d Sn[U5eUS:Xa[USSS5HupgUR"S USU;a[R "[ 5OSS.UD6n[U5(aU"U5 URU5n [U RU RURUS9 Uv M gUS:XaSOUnXAnUR"S USU;a[R "[ 5OSS.UD6n[U5(aU"U5 URU5n [U RU RURUS9 Uv g![an S U<S 3n[U5U eSn A ff=f7f) aGrab a screenshot and save it to a file. :param int mon: The monitor to screenshot (default=0). ``-1`` grabs all monitors, ``0`` grabs each monitor, and ``N`` grabs monitor ``N``. :param str output: The output filename. Keywords: ``{mon}``, ``{top}``, ``{left}``, ``{width}``, ``{height}``, ``{date}``. :param callable callback: Called before saving the screenshot; receives the ``output`` argument. :return: Created file(s). rrrNz{date)rdate)levelrzMonitor z does not exist.r.)r@r enumerateformatrnowrcallabler=r rgbrrs IndexError) rrrrr@rjidxr<fnamesctexcs rsaveMSS.savezsj$==%C!#& & !8 )(12, :  p#TZIZHLL4E`dphopH%%UOii(sww0F0FuU !;by!cC 4"- ]]msgQWFWc1B]amelmF!! ))G$C 377CHHD,B,B6 RL 4 '78%c*3 4s+CFE*B F* F 4FF  Fc bURSS5US'[UR"S0UD65$)zsHelper to save the screenshot of the 1st monitor, by default. You can pass the same arguments as for :meth:`save`. rrr.)rrr)rrfs rshotMSS.shots/ 5!,u DII''((r!c (URURsup#upEURURsupgupX$-X5-pXh-Xy-pX,:=(a X:=(a X=:=(a X:nU(dU$URnURnX7- S-X- S-pX&- S-X- S-pUS:aU*OSnUS:aU*OSnUS-[U S5- nUS-[U S5- n[ S5n[ UUS5HnUU-U-U-nUU-n[ UUS5HonUU-nUU-nUUS-nU(dMU[ :XaUUUS-UUUS-&M8US- nUH,n[ UUU-U-UUU-SU- --5UUU-'M. Mq M U$)zCreate composite image by blending screenshot and mouse cursor. The cursor image should be in straight (not premultiplied) alpha. rrrr)posrrawmaxrangeOPAQUEint)rr8cxcycwchxywhcx2cy2x2y2overlap screen_raw cursor_raw start_count_y start_count_x stop_count_y stop_count_xrcount_ypos_spos_ccount_xsposcposalphaalpha2is rr MSS._merges $ZZ(2#7BGSB'=cg="'=cg ^^ ZZ 6Q,QC6Q,QC!Av1 !Av1 AvC + AvC + Ah]L!rs##%)%222 v    ?%?%D Hy&y&z _   . D ! ,,C s<BB8B5B%%B1-B50B11B58CC