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个像素宽。