gizeh 0.1.11

表面

表面是一个固定尺寸（以像素为单位）的矩形，您可以在其上绘制元素，并将其保存或导出为图像。

import gizeh

# initialize surface
surface = gizeh.Surface(width=320, height=260) # in pixels

# Now make a shape and draw it on the surface
circle = gizeh.circle(r=30, xy= [40,40], fill=(1,1,1))
circle.draw(surface)

# Now export the surface
surface.get_npimage() # returns a (width x height x 3) numpy array
surface.write_to_png("circle.png")

元素

基本元素包括圆形、矩形、线条、文本等，您可以使用 my_element.draw(surface) 在表面上绘制。您可以在创建时指定这些元素的属性和坐标。

• xy：对象中心的坐标。在渲染时间（在 surface.write_to_png 函数中），您可以设置参数 y_origin 为 top（默认）或 bottom。如果将其设置为 top，则（0,0）对应于最终图片的左上角，而右下角的坐标为（width, height）。如果您选择 y_origin=bottom，则（0,0）将在图片的左下角（类似于标准绘图），而（width, height）将在右上角。

• angle：元素围绕其中心 xy 的旋转角度（以弧度为单位）。

• fill：填充元素的内容（默认不填充）。可以是颜色（R,G,B）、颜色渐变、图像等。请参见下面的章节。

• stroke：填充元素轮廓的内容。与 fill 的规则相同。

• stroke_width：元素轮廓的宽度（以像素为单位）。默认为 0（无轮廓）。

元素的示例

Pi = 3.14
circ = gizeh.circle(r=30, xy=(50,50), fill=(1,1,1))
rect = gizeh.rectangle(lx=60.3, ly=45, xy=(60,70), fill=(0,1,0), angle=Pi/8)
sqr = gizeh.square(l=20, stroke=(1,1,1), stroke_width= 1.5)
arc = gizeh.arc(r=20, a1=Pi/4, a2=3*Pi/4, fill=(1,1,1))
text = gizeh.text("Hello world", fontfamily="Impact",  fontsize=40,
                  fill=(1,1,1), xy=(100,100), angle=Pi/12)
polygon = gizeh.regular_polygon(r=40, n=5, angle=np.pi/4, xy=[40,50], fill=(1,0,1))
line = gizeh.polyline(points=[(0,0), (20,30), (40,40), (0,10)], stroke_width=3,
                     stroke=(1,0,0), fill=(0,1,0))

变换

任何元素都可以进行变换（平移、旋转或缩放）。所有变换都是 原地：它们不会修改原始元素，而是创建其修改后的版本。

示例

square_1 = gizeh.square(l=20, xy = [30,35], fill=(1,0,0))
square_2 = square_1.rotate(Pi/8) # rotation around [0,0] by default
square_3 = square_2.rotate(Pi/4, center=[10,15]) # rotation around a center
square_4 = square_1.scale(2) # two times bigger
square_5 = square1.scale(sx=2, sy=3) # width times 2, height times 3
square_6 = square_1.scale(2, center=[30,30]) # zoom: scales around a center
square_7 = square_1.translate(xy=[5,15]) # translation

组

组是一组将一起变换和绘制的元素。这些元素可以是基本元素（正方形、圆形等），甚至可以是组。

示例

square = gizeh.square(l=20, fill=(1,0,0), xy=(40,40))
circle = gizeh.circle(r=20, fill=(1,2,0), xy=(50,30))
group_1 = gizeh.Group([square, circle])
group_2 = group.translate(xy=[30,30]).rotate(Pi/4)
group_3 = gizeh.Group([circle, group_1])

surface = gizeh.Surface(width=300,height=200)
group.draw(surface)
group_1.draw(surface)
group_2.draw(surface)
group_3.draw(surface)
surface.write_to_png("my_masterwork.png")

以上就是所有内容！

这就是所有需要了解的内容。若要进一步了解，请参阅 examples 文件夹中的示例或直接在代码中的文档。