New example: how to capture only a part of the screen

Mickaël Schoentgen · Mickaël Schoentgen · commit bcdbb560a53c · 2017-04-20T20:33:36.000+02:00
diff --git a/docs/source/examples.rst b/docs/source/examples.rst
@@ -130,3 +130,20 @@ This is an example using `frombytes() <http://pillow.readthedocs.io/en/latest/re
 
             # And save it!
             img.save('monitor-{0}.jpg'.format(num))
+
+
+Part of the screen
+==================
+
+You can capture only a part of the screen::
+
+    from mss import mss
+
+
+    with mss() as sct:
+        # The screen part to capture
+        mon = {'top': 160, 'left': 160, 'width': 222, 'height': 42}
+
+        # Create the screen part
+        output = 'sct-{top}x{left}_{width}x{height}.png'.format(**mon)
+        sct.to_png(sct.get_pixels(mon), output)
diff --git a/examples/part-of-screen.py b/examples/part-of-screen.py
@@ -0,0 +1,33 @@
+#!/usr/bin/env python
+# coding: utf-8
+''' This is part of the MSS Python's module.
+    Source: https://github.com/BoboTiG/python-mss
+'''
+
+from mss.exception import ScreenshotError
+from mss import mss
+
+
+def main():
+    # type: () -> int
+    ''' Example to capture part of the screen. '''
+
+    try:
+        with mss() as sct:
+            # The screen part to capture
+            mon = {'top': 160, 'left': 160, 'width': 160, 'height': 135}
+
+            # Create the picture
+            output = 'sct-{top}x{left}_{width}x{height}.png'.format(**mon)
+            sct.to_png(sct.get_pixels(mon), output)
+            print(output)
+
+            return 0
+    except ScreenshotError as ex:
+        print(ex)
+
+    return 1
+
+
+if __name__ == '__main__':
+    exit(main())
