111 lines
3.2 KiB
Markdown
111 lines
3.2 KiB
Markdown
# ToyDesigner形状（Shape）
|
||
> 源码：[shape.py](https://gitea.winkinshly.site/songsenand/ToyDesigner/blob/main/toydesigner/shape.py)
|
||
|
||
## 点（Point）
|
||
|
||
点是 ToyDesigner 中最基本的形状，它代表着坐标系中的一个点。声明方式为`point = Point(x, y)`，参数`x`和`y`分别代表着该点的横坐标和纵坐标。
|
||
|
||
> 注意：ToyDesigner 中的坐标系为直角坐标系。
|
||
|
||
```python
|
||
# 示例
|
||
from toydesigner.shape import Point
|
||
|
||
# 声明一个点
|
||
point = Point(1, 2)
|
||
|
||
# 打印点的坐标
|
||
print(point.x, point.y) # 1 2
|
||
|
||
# 弹出GUI展示点的位置
|
||
point.show()
|
||
```
|
||
|
||
## 直线（Line）
|
||
|
||
直线是由两个点组成的线段。
|
||
声明方式为`line = Line(point1, point2)`，参数`point1`和`point2`分别是该线段的两个端点。也可使用`line = Line((x1, y1), (x2, y2))`，参数`x1`、`y1`、`x2`、`y2`分别是该直线的两个端点的横、纵坐标。
|
||
|
||
> 注意：直线的两个端点必须是不同的点。否则将会抛出ValuError异常。
|
||
|
||
```python
|
||
# 示例
|
||
from toydesigner.shape import Point, Line
|
||
|
||
# 声明两个点
|
||
point1 = Point(1, 2)
|
||
point2 = Point(3, 4)
|
||
|
||
# 声明一个直线
|
||
line = Line(point1, point2)
|
||
|
||
# 另一种写法
|
||
line = Line((1, 2), (3, 4))
|
||
```
|
||
|
||
## 矩形（Rectangle）
|
||
|
||
矩形是由两个点组成的矩形，它可以用来绘制矩形、圆角矩形等图形。
|
||
声明方式为`rectangle = Rectangle(point1, point2)`，参数`point1`和`point2`分别是该矩形左上角和右下角两个端点，也可使用`rectangle = Rectangle((x1, y1), (x2, y2))`，参数`x1`、`y1`、`x2`、`y2`分别是该矩形左上角和右下角两个端点的横、纵坐标。
|
||
|
||
> 注意：矩形的两个端点必须是不同的点。否则将会抛出ValuError异常。
|
||
|
||
```python
|
||
# 示例
|
||
from toydesigner.shape import Point, Rectangle
|
||
|
||
|
||
# 声明两个点
|
||
point1 = Point(1, 2)
|
||
point2 = Point(3, 4)
|
||
|
||
# 声明一个矩形
|
||
rectangle = Rectangle(point1, point2)
|
||
|
||
# 另一种写法
|
||
rectangle = Rectangle((1, 2), (3, 4))
|
||
```
|
||
|
||
## 圆（Circle）
|
||
|
||
圆是由中心点和半径组成的图形。
|
||
声明方式为`circle = Circle(center, radius)`，参数`center`是该圆的中心点，参数`radius`是该圆的半径，也可使用`circle = Circle((x, y), r)`，参数`x`、`y`是该圆的中心点的横、纵坐标，参数`r`是该圆的半径。
|
||
|
||
> 注意：radius必须大于0。否则将会抛出ValueError异常。
|
||
|
||
```python
|
||
# 示例
|
||
from toydesigner.shape import Point, Circle
|
||
|
||
# 声明一个中心点和半径
|
||
center = Point(1, 2)
|
||
radius = 3
|
||
|
||
# 声明一个圆
|
||
circle = Circle(center, radius)
|
||
|
||
# 另一种写法
|
||
circle = Circle((1, 2), 3)
|
||
```
|
||
|
||
## 多边形（Polygon）
|
||
|
||
|
||
多边形是由多个点组成的图形。
|
||
声明方式为`polygon = Polygon(points)`，参数`points`是该多边形的点列表，列表中的每个元素都是一个点。也可使用`tuple(x, y)`代替`Point(x, y)`，声明方式为`polygon = Polygon([(x1, y1), (x2, y2), (x3, y3), ...])`，参数`x1`、`y1`、`x2`、`y2`、`x3`、`y3`分别是该多边形的点的横、纵坐标。
|
||
|
||
```python
|
||
# 示例
|
||
from toydesigner.shape import Point, Polygon
|
||
|
||
# 声明点列表
|
||
points = [Point(1, 2), Point(3, 4), Point(5, 6)]
|
||
|
||
# 声明一个多边形
|
||
polygon = Polygon(points)
|
||
|
||
# 另一种写法
|
||
polygon = Polygon([(1, 2), (3, 4), (5, 6)])
|
||
```
|
||
|