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

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

概述

在创建数组时,建议以下参数类型:

  1. Integer
  2. Float
  3. String
  4. Object
  5. 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\. 下。

你可能感兴趣的:(脚本)