Python Pillow - ImageDraw.chord() 函数



ImageDraw.chord() 方法用于绘制弦(圆的一部分),该弦位于由两点定义的边界框内(从起始角度绘制到结束角度)。它与 arc() 方法相同,但两端点之间连接一条直线。圆的弦是连接圆周上两点的直线段。

语法

以下是函数的语法:

ImageDraw.chord(xy, start, end, fill=None, outline=None, width=1)

参数

以下是此函数参数的详细信息:

  • xy - 定义弦的边界框的两点。可以将其指定为两个元组的序列 [(x0, y0), (x1, y1)],也可以指定为扁平列表 [x0, y0, x1, y1]。无论哪种情况,都必须满足条件 x1 >= x0 且 y1 >= y0。

  • start - 弦的起始角度,以度为单位。角度从 3 点钟方向开始测量,顺时针方向递增。

  • end - 弦的结束角度,也以度为单位。

  • fill - 用于填充弦的颜色。

  • outline - 用于弦轮廓的颜色。

  • width - 弦轮廓的线宽,以像素为单位。默认值为 1。

示例

示例 1

此示例在指定的边界框内绘制弦,使用默认填充颜色、轮廓和宽度。

from PIL import Image, ImageDraw

# Create a blank image
image = Image.new("RGB", (700, 300), "black")
draw = ImageDraw.Draw(image)

# Draw a chord inside a bounding box [(100, 10), (350, 250)]
draw.chord([(100, 10), (350, 250)], start=45, end=180)

# Display the image
image.show()
print('Chord is drawn successfully...')

输出

Chord is drawn successfully...

输出图像

bounding box

示例 2

此示例在指定的边界框内绘制弦,填充颜色为蓝色,轮廓为黑色,轮廓线宽为 2 像素。

from PIL import Image, ImageDraw

# Create a new image with a white background
image = Image.new("RGB", (700, 300), "white")
draw = ImageDraw.Draw(image)

# Draw a chord inside the bounding box
draw.chord([(100, 10), (350, 250)], start=30, end=300, fill="blue", outline="black", width=2)

# Display the images
image.show()
print('The Chord is drawn successfully...')

输出

The Chord is drawn successfully...

输出图像

blue chord

示例 3

以下示例演示如何在现有图像上使用不同的参数绘制弦。

from PIL import Image, ImageDraw

# Open an Image
image = Image.open('Images/ColorDots.png')

# Create the draw object
draw = ImageDraw.Draw(image)

# Draw a red chord inside a bounding box 
draw.chord([(250, 130), (440, 260)], start=30, end=270, fill="red", width=10)

# Display the image
image.show()
print('The chord is drawn successfully...')

输出

The chord is drawn successfully...

输出图像

red chord
python_pillow_function_reference.htm
广告