Screenshots¶
This service takes screenshots and returns them in 8-bit ARGB format. The resulting images are lists of bytearrays, but can easily be converted to PNGs using pypng:
import png
image = Screenshot(pebble).grab_image()
png.from_array(image).save('screenshot.png')
-
class
libpebble2.services.screenshot.
Screenshot
(pebble)¶ Takes a screenshot from the watch.
Parameters: pebble (PebbleConnection) – The pebble of which to take a screenshot. -
grab_image
()¶ Takes a screenshot. Blocks until completion, or raises a
ScreenshotError
on failure.While this method is executing, “progress” events will periodically be emitted with the following signature:
(downloaded_so_far, total_size)
Returns: A list of bytearrays in RGB8 format, where each bytearray is one row of the image.
-
register_handler
(event, handler)¶ Registers a handler to be triggered by an event
Parameters: - event – The event to handle
- handler – The handler callable.
Returns: A handle that can be used to unregister the handler.
-
unregister_handler
(handle)¶ Unregisters an event handler.
Parameters: handle – The handle returned from register_handler()
-
wait_for_event
(event, timeout=10)¶ Block waiting for the given event. Returns the event params.
Parameters: - event – The event to handle.
- timeout – The maximum time to wait before raising
TimeoutError
.
Returns: The event params.
-