PyCairo支持多种不同的后端。后端是PyCairo产生的图形可以显示的地方。我们将使用PyCairo来创建一幅PNG图像,一个PDF文件,一个SVG文件,并将在一个GTK窗口中绘制。
PNG 图像
在第一个例子中,我们将创建一幅 PNG 图像。
#!/usr/bin/python
'''
ZetCode PyCairo tutorial
This program uses PyCairo to
produce a PNG image.
author: Jan Bodnar
website: zetcode.com
last edited: August 2012
'''
import cairo
def main():
ims = cairo.ImageSurface(cairo.FORMAT_ARGB32, 390, 60)
cr = cairo.Context(ims)
cr.set_source_rgb(0, 0, 0)
cr.select_font_face("Sans", cairo.FONT_SLANT_NORMAL, cairo.FONT_WEIGHT_NORMAL)
cr.set_font_size(40)
cr.move_to(10, 50)
cr.show_text("Diszip ist Macht.")
ims.write_to_png("image.png")
if __name__ == "__main__":
main()
这是一个小小的终端命令行应用程序,它会创建一幅 PNG 图像。
import cairo
我们导入PyCairo模块。
ims = cairo.ImageSurface(cairo.FORMAT_ARGB32, 390, 60)
cr = cairo.Context(ims)
我们创建一个surface,并由这个surface创建一个cairo上下文。这个Surface是一幅390×60px的图像。
cr.set_source_rgb(0, 0, 0)
我们将用黑色墨水来画我们的文字。
cr.select_font_face("Sans", cairo.FONT_SLANT_NORMAL, cairo.FONT_WEIGHT_NORMAL)
cr.set_font_size(40)
我们选择一种字体类型并设置它的大小。
cr.move_to(10, 50)
cr.show_text("Diszip ist Macht.")
我们移动到图像的x=10.0,y=50.0位置,并绘制文字。
ims.write_to_png("image.png")
这个方法调用创建PNG图像。
Figure: PNG image in Image Viewer
PDF 文件
在第二个例子中,我们创建一个简单的PDF文件。
#!/usr/bin/python
'''
ZetCode PyCairo tutorial
This program uses PyCairo to
produce a PDF image.
author: Jan Bodnar
website: zetcode.com
last edited: August 2012
'''
import cairo
def main():
ps = cairo.PDFSurface("pdffile.pdf", 504, 648);
cr = cairo.Context(ps)
cr.set_source_rgb(0, 0, 0)
cr.select_font_face("Sans", cairo.FONT_SLANT_NORMAL, cairo.FONT_WEIGHT_NORMAL)
cr.set_font_size(40)
cr.move_to(10, 50)
cr.show_text("Diszip ist Macht.")
cr.show_page()
if __name__ == "__main__":
main()
我们必须在一个pdf viewer中打开一个pdf文件。Linux用户可以使用KPDF或者Evince viewers。
ps = cairo.PDFSurface("pdffile.pdf", 504, 648);
为了渲染一个pdf文件,我们必须使用cairo.PDFSurface对象来创建一个pdf surface。pdf文件的大小以点为单位来指定,这也是排字的一个标准。
cr.show_page()
show_page()结束对于pdf文件的渲染。
Figure: PDF file in Document Viewer
SVG 文件
在下一个例子中创建一个简单的SVG(Scalable Vector Graphics)文件。SVG文件是一个基于XML的文件格式。
#!/usr/bin/python
'''
ZetCode PyCairo tutorial
This program uses PyCairo to
produce a SVG image.
author: Jan Bodnar
website: zetcode.com
last edited: August 2012
'''
import cairo
def main():
ps = cairo.SVGSurface("svgfile.svg", 390, 60);
cr = cairo.Context(ps)
cr.set_source_rgb(0, 0, 0)
cr.select_font_face("Sans", cairo.FONT_SLANT_NORMAL, cairo.FONT_WEIGHT_NORMAL)
cr.set_font_size(40)
cr.move_to(10, 50)
cr.show_text("Diszip ist Macht.")
cr.show_page()
if __name__ == "__main__":
main()
我们可以使用一个web浏览器,比如Google Chrome或者一个向量绘图程序,比如Inkscape来打开一个SVG文件。
ps = cairo.SVGSurface("svgfile.svg", 390, 60);
在PyCairo中创建一个SVG文件,我们必须使用cairo.SVGSurface对象创建一个svg surface。
Figure:SVG file in Chrome
GTK窗口
在最后一个例子中,我们将在一个GTK窗口中进行绘制。这个后端也将被用于被指南后面的所有的例子中。
#!/usr/bin/python
'''
ZetCode PyCairo tutorial
This program uses PyCairo to
draw on a window in GTK.
author: wolf-cs
website: http://my.oschina.net/wolfcs/blog
last edited: May 2013
'''
import gtk
import cairo
class Example(gtk.Window):
def __init__(self):
super(Example, self).__init__()
self.init_ui()
print "Example: " + str(self)
def init_ui(self):
darea = gtk.DrawingArea()
darea.connect("expose_event", self.expose)
self.add(darea)
self.set_title("GTK window")
self.resize(420, 120)
self.set_position(gtk.WIN_POS_CENTER)
self.connect("delete-event", gtk.main_quit)
self.show_all()
def expose(self, widget, event):
self.context = widget.window.cairo_create()
self.on_draw(420, self.context)
print "expose: " + str(widget)
def on_draw(self, wid, cr):
cr.set_source_rgb(0, 0, 0)
cr.select_font_face("Sans", cairo.FONT_SLANT_NORMAL, cairo.FONT_WEIGHT_NORMAL)
cr.set_font_size(40)
cr.move_to(10, 50)
cr.show_text("Diszip ist Macht.")
def main():
window = Example()
gtk.main()
if __name__ == "__main__":
main()
这个例子弹出一个位于屏幕中央的GTK窗口,该窗口中绘制有内容为”Disziplin ist Macht”的文字。
import gtk
import cairo
我们导入需要的PyCairo和GTK模块。
darea = gtk.DrawingArea()
我们将会在一个gtk.DrawingArea widget上进行绘制。
darea.connect("expose_event", self.expose)
当一个窗口被重绘的时候,会产生一个expose_event信号。我们将那个信号连接到expose()回调。
def expose(self, widget, event):
self.context = widget.window.cairo_create()
self.on_draw(420, self.context)
在expose()回调中,我们创建cairo context。然后,绘制的动作在on_draw()方法的内部完成。第三个参数是cairo上下文,由expose()创建。Cairo库是GTK系统内建的。
Figure: GTK window
本章中,我们已经覆盖了PyCairo所支持的所有的后端了。
Done.