Gizeh API速查手册：常用函数与参数全解析

Gizeh API速查手册：常用函数与参数全解析

【免费下载链接】gizehSimple Vector Graphics for Python项目地址: https://gitcode.com/gh_mirrors/gi/gizeh

Gizeh是一款面向Python的简单矢量图形库，提供直观的API帮助开发者轻松创建和操作矢量图形。本文将详细解析Gizeh中最常用的核心函数及其参数，帮助新手快速掌握矢量图形绘制技巧。

一、基础图形绘制函数

1.1 矩形绘制：rectangle()

功能：创建矩形图形元素
核心参数：

• lx：矩形宽度
• ly：矩形高度
• **kw：可选样式参数（如fill填充色、stroke边框色、stroke_width边框宽度）

使用示例：

rect = gizeh.rectangle(lx=100, ly=50, fill=(1,0,0)) # 创建100x50的红色矩形

1.2 圆形绘制：circle()

功能：创建圆形图形元素
核心参数：

• r：圆的半径
• **kw：可选样式参数（支持与矩形相同的样式配置）

使用示例：

circle = gizeh.circle(r=30, fill=(0,0,1), stroke=(1,1,1), stroke_width=2) # 蓝色圆形带白色边框

1.3 星形绘制：star()

功能：创建多角星形图形元素
核心参数：

• nbranches：星的角数（默认5）
• radius：外半径（默认1.0）
• ratio：内半径与外半径比例（默认0.5）
• **kwargs：可选样式参数

使用示例：

star = gizeh.star(nbranches=6, radius=50, ratio=0.3, fill=(1,1,0)) # 黄色六角星

二、坐标变换与操作

2.1 旋转操作：rotate()

功能：对图形元素进行旋转
核心参数：

• angle：旋转角度（弧度制）
• center：旋转中心点坐标（默认图形中心）

使用示例：

rotated_rect = rect.rotate(angle=math.pi/4, center=(50,25)) # 矩形旋转45度

2.2 平移操作：translate()

功能：移动图形元素位置
核心参数：

• xy：平移向量（x,y坐标偏移量）

使用示例：

moved_circle = circle.translate(xy=(100, 200)) # 将圆形移动到(100,200)位置

2.3 缩放操作：scale()

功能：调整图形元素大小
核心参数：

• rx：x轴缩放比例
• ry：y轴缩放比例（默认与rx相同）
• center：缩放中心点（默认图形中心）

使用示例：

scaled_star = star.scale(rx=1.5, ry=0.8) # x轴放大1.5倍，y轴缩小至0.8倍

三、画布与渲染

3.1 创建画布：Surface()

功能：创建绘图表面（画布）
核心参数：

• width：画布宽度
• height：画布高度
• bg_color：背景颜色（默认透明）

使用示例：

surface = gizeh.Surface(width=400, height=400, bg_color=(1,1,1)) # 创建400x400白色画布

3.2 保存图像：write_to_png()

功能：将画布内容保存为PNG图片
核心参数：

• filename：保存路径
• y_origin：坐标原点位置（"top"或"bottom"，默认"top"）

使用示例：

surface.write_to_png("my_drawing.png") # 保存画布内容到PNG文件

四、实战应用示例

以下是一个综合使用Gizeh API创建简单图形的示例：

import gizeh import math # 创建画布 surface = gizeh.Surface(200, 200, bg_color=(1, 1, 1)) # 绘制蓝色圆形 circle = gizeh.circle(r=80, fill=(0, 0.5, 1)) circle.draw(surface) # 绘制黄色星形并旋转 star = gizeh.star(nbranches=5, radius=40, ratio=0.4, fill=(1, 1, 0)) star.rotate(angle=math.pi/2).translate(xy=(100, 100)).draw(surface) # 保存图像 surface.write_to_png("star_on_circle.png")

通过组合使用这些基础函数，你可以创建复杂的矢量图形。Gizeh的API设计简洁直观，非常适合Python开发者快速上手矢量图形绘制。更多高级功能和参数细节，可以查阅项目源码中的gizeh/gizeh.py文件。

【免费下载链接】gizehSimple Vector Graphics for Python项目地址: https://gitcode.com/gh_mirrors/gi/gizeh