rpaframework-screenshot 0.2.0

Examples

grab and show the whole screen:

#-- include('examples/showgrabfullscreen.py') --#
import pyscreenshot as ImageGrab

if __name__ == '__main__':

    # grab fullscreen
    im = ImageGrab.grab()

    # save image file
    im.save('screenshot.png')

    # show image in a window
    im.show()
#-#

to start the example:

python3 -m pyscreenshot.examples.showgrabfullscreen

grab and show the part of the screen:

#-- include('examples/showgrabbox.py')--#
import pyscreenshot as ImageGrab

if __name__ == '__main__':
    # part of the screen
    im = ImageGrab.grab(bbox=(10, 10, 510, 510))  # X1,Y1,X2,Y2
    im.show()
#-#

to start the example:

python3 -m pyscreenshot.examples.showgrabbox

Installation

• install Pillow (Ubuntu: sudo apt-get install python3-pil)

• install at least one back-end

• install the program:

  pip3 install pyscreenshot

Command line interface

Back-end performance:

The performance can be checked with pyscreenshot.check.speedtest.

Example:

#-- sh('python3 -m pyscreenshot.check.speedtest --virtual-display 2>/dev/null') --#

n=10
------------------------------------------------------
scrot                 6.1  sec        (  608 ms per call)
imagemagick           9.7  sec        (  969 ms per call)
wx                    4.1  sec        (  408 ms per call)
pygdk3                3.3  sec        (  328 ms per call)
qtpy                  6.9  sec        (  687 ms per call)
pyqt5                 6.9  sec        (  687 ms per call)
pyqt                  6.4  sec        (  644 ms per call)
pyside2               6.7  sec        (  671 ms per call)
pyside                6.5  sec        (  652 ms per call)
gnome-screenshot      12   sec        ( 1209 ms per call)
#-#

Print versions:

#-- sh('python3 -m pyscreenshot.check.versions 2> /dev/null ')--#
python               3.7.3
pyscreenshot         0.7
scrot                1.1.1
imagemagick          6.9.10
wx                   4.0.4
pygdk3               3.32.0
qtpy                 1.3.1
pyqt5                5.12.1
pyqt                 4.12.1
pyside2              5.11.2
pyside               1.2.2
pygtk                missing
gnome-screenshot     3.30.0
#-#

Wayland

On Wayland only the gnome-screenshot back-end works:

im = ImageGrab.grab(backend='gnome-screenshot')