2.7　Processing参考文档

前面我示范的函数（ellipse()、line()、stroke()等）都是Processing库中的内容。“ellipse”不能拼写为“elipse”，rect()需要使用4个实参（x坐标值、y坐标值、宽度值、高度值）等这些细节内容是非常直观的，也容易理解，这也证明Processing确实非常适合初学者作为学习计算机编程的首选语言。然而，学习这些知识最严谨的方法是阅读Processing提供的在线参考文档。虽然本书会涉及参考文档中的部分内容，但这并不能完全替代参考文档的作用。学习Processing，本书和参考文档都是必需的。

Processing的参考文档可以在Processing官网（processing.org）的“reference”链接中找到。在那里可以按照不同种类或者字母排序来浏览所有的函数。比如，如果你在查看ellipse()函数的页面，会看到相关解释内容，如图2-6所示。

图　2-6

如上图所示，参考文档页面提供了关于ellipse()函数的所有文档内容，包括：

名称（Name）：函数名称。

示例（Examples）：示例代码（适当情况下会有代码的视觉输出结果）。

描述（Description）：关于函数具体内容的描述。

句法（Syntax）：关于如何使用该函数的具体句法描述。

形参（Parameters）：函数圆括号里面的内容。它告诉你应该输入什么类型的数据（数字、字符等），以及这些内容代表了什么（后面的章节会对此进行更详细的讲解）。有时也写作实参。

返回类型（Returns）：在调用函数的时候，有些函数会反馈一些信息给你（例如，你可以调用函数让其返回两个数值给你，而不是让它执行一个诸如画圆的命令）。这些内容我在后面会更加详细的讲解。

相关信息（Related）：一系列和该函数相关的其他函数。

Processing还有一个非常好用的功能选项：“在文档中查询”。使用方法如下：双击代码中的任何关键词完成选中，然后在菜单栏中选择“帮助” →“在文档中查询”（或者在选中关键词后，在Mac电脑使用Shift+Command+F快捷键；在Windows电脑使用Ctrl+Shift +F快捷键）。

练习2-7：打开Processing的参考文档，尝试使用两个还没有讲过的函数编写一个简单程序。建议使用参考文档中的“Shape”和“Color（setting）”这两种函数。

练习2-8：使用参考文档，找到一个可以改变线条宽度的函数。这个函数具有哪些实参要求？画一条1个像素宽的线条，然后是5个像素宽，最后是10个像素宽。