标题：绘图 API 使用基础知识

转自：docs.bilibili.tv

使用绘图 API 简介

绘图 API 是 Script 中的一项内置功能的名称，您可以使用该功能来创建矢量图形（直线、曲线、形状、填充和渐变），并在屏幕上显示它们。Display.createGraphic.graphics 类提供了这一功能。

如果刚刚开始学习使用代码进行绘制，可以使用 Graphics 类中包含的几种方法来简化绘制常见形状（如圆、椭圆、矩形以及带圆角的矩形）的过程。您可以将它们作为空线条或填充形状进行绘制。当您需要更高级的功能时，还可以使用 Graphics 类中包含的用于绘制直线和二次贝塞尔曲线的方法，您可以将这些方法与 Math 类中的三角函数配合使用来创建所需的任何形状。

常见绘图 API 任务

以下是您可能需要在 Script 中使用绘图 API 完成的任务，本章对这些任务进行了介绍：

• 定义线条样式和填充样式以绘制形状

• 绘制直线和曲线

• 使用方法来绘制形状（如圆、椭圆和矩形）

• 使用渐变线条和填充进行绘制

• 定义矩阵以创建渐变

• 将三角函数与绘图 API 配合使用

• 将绘图 API 与动画相结合

重要概念和术语

以下参考列表包含将会在本章中遇到的重要术语：

• 锚点 (Anchor point)：二次贝塞尔曲线的两个端点之一。

• 控制点 (Control point)：该点定义了二次贝塞尔曲线的弯曲方向和弯曲量。弯曲的线绝不会到达控制点；但是，曲线就好像朝着控制点方向进行绘制的。

• 坐标空间 (Coordinate space)：显示对象中包含的坐标（其子元素所在的位置）的图形。

• 填充 (Fill)：形状内的实心部分，它包含一条用颜色填充的线条，或者整个形状都没有轮廓。

• 渐变 (Gradient)：此颜色是指从一种颜色逐渐过渡到一种或多种其它颜色（相对于纯色而言）。

• 点 (Point)：坐标空间中的一个位置。在 Script 使用的二维坐标系中，点是按其 x 轴和 y 轴位置（点坐标）来定义的。

• 二次贝塞尔曲线 (Quadratic Bézier curve)：一种由特定数学公式定义的曲线类型。在这种类型的曲线中，曲线形状是根据锚点（曲线端点）和控制点（定义曲线的弯曲方向和弯曲量）的位置计算的。

• 缩放 (Scale)：相对于原始大小的对象大小。用作动词时，对象缩放是指伸展或缩小对象以更改其大小。

• 笔触 (Stroke)：形状的轮廓部分，它包含一条用颜色填充的线条，或未填充的形状的多个线条。

• 平移 (Translate)：将点的坐标从一个坐标空间更改为另一个坐标空间。

• X 轴 (X axis)：Script 使用的二维坐标系中的水平轴。

• Y 轴 (Y axis)：Script 使用的二维坐标系中的垂直轴。