通过实例学习Virtools脚本语言VSL - 检索和修改数组的数据

 该实例中，我们会用VSL来检索和修改数组中的数据。

概述

在创建数组时，建议以下参数类型：

Integer

Float

String

Object

Parameter

前面四种类型 - "Integer", "Float", "String" 及 "Object"
-占用的系统内存比"Parameter"类型将近小十倍。仅仅在必需时使用"Parameter"
类型的数组，比如当在Schematic视图和数组单元格间快捷方式时(自动更新数组而不需使用BB)使用。注意：这些这种快捷方式仅仅在从
Schematic视图到数组时会发生，其它方式都不行；你必须从Schematic中复制数据并将快捷方式复制到数组单元格。

可用的VSL方法

检索单元格的值

下面是用于从数组中检索数据的方法，及附带的所需参数：





GetElement

这个方法返回作品中该元素的索引值。然后你需要通过bc的"Get Object"方法从索引值来识别该元素。

 





GetElementObject

这是从由CKObject类实体(二维实体 - 2D entities，三维实体 - 3D entities， 动画 -
animations，等等)组成的数组中检索元素的最简单的方法，它基于行与列索引的详细指定。既然检索值是"object"类型，我们就经常要通
过"Cast"方法来转换类型了。








GetElementStringValue

利用这个方法从一个包含字符串类型元素的数组检索字符值。通过使用一个null参数，我们检索所读取字符串的总大小。注意：该大小包含了最后的字符
串"0" -
表示字符串的结束。然后我们通过指定的参数重设字符串的大小。然而在指定大小的时候，"Resize"方法不需要考虑最后的字符串"0"，所以我们减掉了
1.





 

警告：要避免下面的脚本，"str"类型的使用尽管编译时没有问题，但会产生错误。





 




GetElementValue

这里，我们用"p_Value"变量存储从数组检索的值。这个方法尤其适用于那些包含了非衍生自CKObject类类型(integer, float, matrix, vector等)值的数组。





 

修改单元格的值

如下，我们把用于修改数组中值的VSL方法集合在一起，提示框上可以看到所必要的参数：





 

注意： "SetElementValueFromParameter" 方法还没在这里出现，将会放在以后的文档中。

SetElementObject

这是向由CKObject类实体(二维实体 - 2D entities、三维实体 - 3D entities、 动画 - animations、等等)组成的数组中放置元素的最简单的方法，它基于行与列索引的详细指定。





 

SetElementStringValue

这个方法用于包含字符串的数组，且是基于详细指定行与列索引来用的。





SetElementValue

这个方法用来存储那些包含非衍生自CKObject类的类型(如integer、float、matrix、vector等)的数组的值。





现在去看看Virtools Minisite
中提供的其它更多VSL技术样例吧，在Dev文档目录 /CMOS/TechnicalSamples/VSL/Samples/.
下。