Root window
In this part of the PyCairo tutorial, we will work with the root window. The root window is the desktop window where we usually have icon shortcuts.It is possible to manipulate with the root window. From the programmer's perspective, it is just a special kind of a window.
Transparent window
Our first example will create a transparent window. We will see, what it beneath of the window object.#!/usr/bin/pythonTo create a transparent window, we get the visual of the screen object and set it for our window. In the on_draw() method, we draw over the screen's visual object. This createas an illusion of partial transparency.
'''
Dukeo PyCairo tutorial
This code example shows how to
create a transparent window.
author: Tanvir redwan
website: http://dukeo.blogspot.com
last edited: March 2013
'''
from gi.repository import Gtk
import cairo
class Example(Gtk.Window):
def __init__(self):
super(Example, self).__init__()
self.tran_setup()
self.init_ui()
def init_ui(self):
self.connect("draw", self.on_draw)
self.set_title("Transparent window")
self.resize(300, 250)
self.set_position(Gtk.WindowPosition.CENTER)
self.connect("delete-event", Gtk.main_quit)
self.show_all()
def tran_setup(self):
self.set_app_paintable(True)
screen = self.get_screen()
visual = screen.get_rgba_visual()
if visual != None and screen.is_composited():
self.set_visual(visual)
def on_draw(self, wid, cr):
cr.set_source_rgba(0.2, 0.2, 0.2, 0.4)
cr.set_operator(cairo.OPERATOR_SOURCE)
cr.paint()
def main():
app = Example()
Gtk.main()
if __name__ == "__main__":
main()
self.set_app_paintable(True)We must set the application to be painted on.
screen = self.get_screen()The
get_screen()
method returns the screen object. visual = screen.get_rgba_visual()From the screen window, we get its visual. The visual contains the low level display information.
if visual != None and screen.is_composited():Not all displays support this operation. Therefore, we check if our screen supports composition and the returned visual is not None. We set the screen's visual to be the visual of our window.
self.set_visual(visual)
def on_draw(self, wid, cr):We use a partially transparent source to draw over the screen window. The
cr.set_source_rgba(0.2, 0.2, 0.2, 0.4)
cr.set_operator(cairo.OPERATOR_SOURCE)
cr.paint()
cairo.OPERATOR_SOURCE
creates a composition operation where we draw over the source. Which is the screen window. To get full transparency, we set the alpha value to 0 or use the cairo.OPERATOR_CLEAR
operator. Figure: Transparent window
Taking a screenshot
The root window is also essential in taking a screenshot.#!/usr/bin/pythonThe example captures a snapshot of the entire screen.
'''
Dukeo PyCairo tutorial
This code example takes a screenshot.
author: Tanvir redwan
website: http://dukeo.blogspot.com
last edited: August 2012
'''
from gi.repository import Gdk
import cairo
def main():
root_win = Gdk.get_default_root_window()
width = root_win.get_width()
height = root_win.get_height()
ims = cairo.ImageSurface(cairo.FORMAT_ARGB32, width, height)
pb = Gdk.pixbuf_get_from_window(root_win, 0, 0, width, height)
cr = cairo.Context(ims)
Gdk.cairo_set_source_pixbuf(cr, pb, 0, 0)
cr.paint()
ims.write_to_png("screenshot.png")
if __name__ == "__main__":
main()
root_win = Gdk.get_default_root_window()We get the root window with the
Gdk.get_default_root_window()
method call. width = root_win.get_width()We determine the width and the height of the root window.
height = root_win.get_height()
ims = cairo.ImageSurface(cairo.FORMAT_ARGB32, width, height)An empty image surface is created. It has the size of the root window.
pb = Gdk.pixbuf_get_from_window(root_win, 0, 0, width, height)We get a pixbuf from the root window using the
Gdk.pixbuf_get_from_window()
method call. A pixbuf is an object that describes an image in memory. It is used by the GTK library. cr = cairo.Context(ims)In the above code lines, we create a Cairo drawing context on the image surface that we have created earlier. We place the pixbuf on the drawing context and paint it on the surface.
Gdk.cairo_set_source_pixbuf(cr, pb, 0, 0)
cr.paint()
ims.write_to_png("screenshot.png")The image surface is written to a PNG image using the
write_to_png()
method. Showing message
In the third example, we will show a message on the desktop window.#!/usr/bin/pythonThe code displays a message label on the root window.
'''
Dukeo PyCairo tutorial
This code example shows a message on the desktop
window.
author: Tanvir redwan
website: http://dukeo.blogspot.com
last edited: August 2012
'''
from gi.repository import Gtk, Gdk, Pango
import cairo
class Example(Gtk.Window):
def __init__(self):
super(Example, self).__init__()
self.setup()
self.init_ui()
def setup(self):
self.set_app_paintable(True)
self.set_type_hint(Gdk.WindowTypeHint.DOCK)
self.set_keep_below(True)
screen = self.get_screen()
visual = screen.get_rgba_visual()
if visual != None and screen.is_composited():
self.set_visual(visual)
def init_ui(self):
self.connect("draw", self.on_draw)
lbl = Gtk.Label()
text = "Dukeo, tutorials for programmers."
lbl.set_text(text)
fd = Pango.FontDescription("Serif 20")
lbl.modify_font(fd)
lbl.modify_fg(Gtk.StateFlags.NORMAL,Gdk.color_parse("white"))
self.add(lbl)
self.resize(300, 250)
self.set_position(Gtk.WindowPosition.CENTER)
self.connect("delete-event", Gtk.main_quit)
self.show_all()
def on_draw(self, wid, cr):
cr.set_operator(cairo.OPERATOR_CLEAR)
cr.paint()
cr.set_operator(cairo.OPERATOR_OVER)
def main():
app = Example()
Gtk.main()
if __name__ == "__main__":
import signal
signal.signal(signal.SIGINT, signal.SIG_DFL)
main()
self.set_app_paintable(True)We will be manipulating the application window, so we make it paintable.
self.set_type_hint(Gdk.WindowTypeHint.DOCK)Implementing this window hint removes window borders and decoration.
self.set_keep_below(True)We keep the application always at the bottom, just over the root window.
screen = self.get_screen()We set the visual of the screen to be the visual of our application.
visual = screen.get_rgba_visual()
if visual != None and screen.is_composited():
self.set_visual(visual)
lbl = Gtk.Label()We put a message label on the application window.
text = "Dukeo, tutorials for programmers."
lbl.set_text(text)
fd = Pango.FontDescription("Serif 20")With the help of the Pango module, we change the appearance of the text.
lbl.modify_font(fd)
lbl.modify_fg(Gtk.StateFlags.NORMAL,Gdk.color_parse("white"))
def on_draw(self, wid, cr):We use the
cr.set_operator(cairo.OPERATOR_CLEAR)
cr.paint()
cr.set_operator(cairo.OPERATOR_OVER)
cairo.OPERATOR_CLEAR
operator to clear the background of the window. Then we set the cairo.OPERATOR_CLEAR
to let the label widget be drawn. if __name__ == "__main__":There is an older bugthat does not allow us to terminate the application launched from the terminal with the Ctrl+C shortcut. Adding the two lines is a workaround for this.
import signal
signal.signal(signal.SIGINT, signal.SIG_DFL)
main()
In this chapter we have worked with the desktop window in PyCairo.
0 comments:
Post a Comment