Python Cairo库的使用教程及代码案例

 更新时间:2025年04月09日 09:12:28   作者:老胖闲聊  
Cairo库是一个开源的2D图形库,支持矢量图形的绘制,它广泛应用于X Window System,用于制作高质量的图形输出,本文给大家介绍了Python Cairo库的使用教程及代码案例,需要的朋友可以参考下

一、Cairo 简介

Cairo 是一个2D矢量图形库,支持多种输出设备(如PNG、PDF、SVG、窗口系统)。PyCairo 是 Cairo 的 Python 绑定,允许通过 Python 代码实现高质量的图形绘制。

二、安装 PyCairo

# 通过 pip 安装(注意包名可能是 pycairo 或 cairo)
pip install pycairo

三、基础概念与核心类

  1. Surface(表面)
    表示绘图的目标介质(如内存、文件、窗口)。常见类型:

    • ImageSurface: 位图图像(如PNG)
    • PDFSurface: PDF 文件
    • SVGSurface: SVG 矢量图
  2. Context(上下文)
    控制绘图操作的核心对象,管理路径、颜色、变换等绘图状态。

四、基础绘图方法

示例1:绘制简单图形(PNG)

import cairo

# 1. 创建 Surface 和 Context
width, height = 400, 300
surface = cairo.ImageSurface(cairo.Format.ARGB32, width, height)
ctx = cairo.Context(surface)

# 2. 设置背景色
ctx.set_source_rgb(0.9, 0.9, 0.9)  # RGB 范围 0~1
ctx.paint()  # 填充整个表面

# 3. 绘制红色矩形
ctx.set_source_rgb(1, 0, 0)         # 红色
ctx.rectangle(50, 50, 100, 80)      # (x, y, width, height)
ctx.fill()                          # 填充形状

# 4. 绘制蓝色边框圆形
ctx.arc(250, 150, 40, 0, 2 * 3.14159)  # (x, y, radius, start_angle, end_angle)
ctx.set_source_rgb(0, 0, 1)            # 蓝色
ctx.set_line_width(3)                  # 线宽
ctx.stroke()                           # 描边路径

# 5. 保存为 PNG
surface.write_to_png("basic_shapes.png")

注释说明:

  • set_source_rgb(): 设置绘图颜色(RGB值)。
  • rectangle() 和 arc(): 定义路径形状。
  • fill() 和 stroke(): 分别表示填充路径和绘制路径边框。
  • write_to_png(): 将结果保存为PNG文件。

五、高级特性

1. 坐标变换

# 平移、旋转、缩放示例
ctx.save()                  # 保存当前状态
ctx.translate(200, 150)     # 移动原点至 (200,150)
ctx.rotate(0.25 * 3.14159)  # 旋转45度(弧度制)
ctx.scale(2, 2)             # 缩放2倍
ctx.rectangle(-20, -20, 40, 40)  # 绘制正方形
ctx.set_source_rgb(0, 1, 0)
ctx.fill()
ctx.restore()               # 恢复之前保存的状态

2. 渐变填充

# 线性渐变
linear = cairo.LinearGradient(0, 0, 300, 300)
linear.add_color_stop_rgba(0, 1, 0, 0, 1)    # 起点红色
linear.add_color_stop_rgba(1, 0, 0, 1, 0.5)  # 终点半透明蓝色
ctx.set_source(linear)
ctx.rectangle(50, 50, 200, 200)
ctx.fill()

3. 路径操作与曲线

# 绘制贝塞尔曲线
ctx.move_to(50, 200)                # 起点
ctx.curve_to(100, 50, 200, 350, 350, 200)  # 控制点1, 控制点2, 终点
ctx.set_source_rgb(0.5, 0, 0.5)
ctx.set_line_width(4)
ctx.stroke()

4. 文本渲染

# 设置字体并绘制文本
ctx.select_font_face("Arial", cairo.FONT_SLANT_NORMAL, cairo.FONT_WEIGHT_BOLD)
ctx.set_font_size(30)
ctx.move_to(50, 100)
ctx.set_source_rgb(0, 0, 0)
ctx.show_text("Hello Cairo!")  # 绘制文本

六、综合案例:绘制复杂图形

import cairo

# 初始化
surface = cairo.ImageSurface(cairo.Format.ARGB32, 600, 400)
ctx = cairo.Context(surface)
ctx.set_source_rgb(1, 1, 1)
ctx.paint()

# 绘制渐变背景
gradient = cairo.RadialGradient(300, 200, 10, 300, 200, 300)
gradient.add_color_stop_rgba(0, 0.8, 0.8, 1, 1)
gradient.add_color_stop_rgba(1, 0.2, 0.2, 0.5, 1)
ctx.set_source(gradient)
ctx.rectangle(0, 0, 600, 400)
ctx.fill()

# 绘制旋转矩形
ctx.save()
ctx.translate(300, 200)
for i in range(12):
    ctx.rotate(3.14159 / 6)  # 每次旋转30度
    ctx.set_source_rgba(0, 0.5, 0, 0.5)
    ctx.rectangle(-30, -30, 60, 60)
    ctx.fill()
ctx.restore()

# 保存结果
surface.write_to_png("advanced_demo.png")

七、关键注意事项

  1. 坐标系:原点 (0,0) 在左上角,x向右增长,y向下增长。
  2. 路径操作:所有路径需通过 fill() 或 stroke() 才会生效。
  3. 状态堆栈save() 和 restore() 用于管理绘图状态(如颜色、变换)。

通过结合基础方法和高级特性,Cairo 能实现复杂的矢量图形绘制。建议参考 Cairo官方文档 深入探索更多功能。

到此这篇关于Python Cairo库的使用教程及代码案例的文章就介绍到这了,更多相关Python Cairo库使用内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • numpy.random.seed()的使用实例解析

    numpy.random.seed()的使用实例解析

    这篇文章主要介绍了numpy.random.seed()的使用实例解析,分享了相关代码示例,小编觉得还是挺不错的,具有一定借鉴价值,需要的朋友可以参考下
    2018-02-02
  • 快速解决jupyter notebook启动需要密码的问题

    快速解决jupyter notebook启动需要密码的问题

    这篇文章主要介绍了快速解决jupyter notebook启动需要密码的问题,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-04-04
  • python snap7读写PLC的操作方法

    python snap7读写PLC的操作方法

    这篇文章主要介绍了python snap7读写PLC的操作方法,本文结合实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2023-02-02
  • python paramiko远程服务器终端操作过程解析

    python paramiko远程服务器终端操作过程解析

    这篇文章主要介绍了python paramiko远程服务器终端操作过程解析,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2019-12-12
  • Python截图的五个方法实例总结

    Python截图的五个方法实例总结

    学习一门语言最好的方法便是实践,想要拿Python写一个截图工具,下面这篇文章主要给大家介绍了关于Python截图的五个方法,文中通过图文介绍的非常详细,需要的朋友可以参考下
    2022-12-12
  • Python实现基本Socket服务端与客户端通信的完整代码

    Python实现基本Socket服务端与客户端通信的完整代码

    这篇文章主要介绍了Python实现基本Socket服务端与客户端通信,分步详解与完整代码都有,按需所求即可,对Python Socket服务端与客户端通信相关知识感兴趣的朋友一起看看吧
    2023-06-06
  • python matplotlib绘画十一种常见数据分析图

    python matplotlib绘画十一种常见数据分析图

    这篇文章主要介绍了python matplotlib绘画十一种常见数据分析图,文章主要绘制折线图、散点图、直方图、饼图等需要的小伙伴可以参考一下文章具体内容
    2022-06-06
  • python字典多键值及重复键值的使用方法(详解)

    python字典多键值及重复键值的使用方法(详解)

    下面小编就为大家带来一篇python字典多键值及重复键值的使用方法(详解)。小编觉得挺不错的,现在就分享给大家,也给大家做个才参考。一起跟随小编过来看看吧
    2016-10-10
  • python模拟重载初始化函数的方法详解

    python模拟重载初始化函数的方法详解

    重载初始化函数,是指同一个类中定义了多个构造函数,可以通过多种不同的方法进行构造,下面我们就来看看在python中如何实现类似的功能吧
    2024-11-11
  • Python的互斥锁与信号量详解

    Python的互斥锁与信号量详解

    这篇文章主要介绍了Python的互斥锁与信号量详解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2019-09-09

最新评论