vrgetpref函数读取Simulink三维动画模块的参数选项值。其语法格式为
x=vrgetpref
x=vrgetpref('preference_name')
x=vrgetpref('preference_name','factory')
x=vrgetpref('factory')其中，preference_name表示要读取的参数选项值。下面解释各语法格式的意义：
x=vrgetpref 将Simulink三维动画模块中所有参数选项值返回到一个结构数组中。
x=vrgetpref('preference_name') 返回指定参数选项值。如果preference_name是一个参数选项名称的单元数组，则返回对应参数选项值的单元数组。
x=vrgetpref('preference_name', 'factory') 返回指定参数选项的默认值。
x=vrgetpref('factory') 返回所有参数选项的默认值。
定义了表6-2中所示的参数选项。
表6-2 vrgetpref函数的参数选项
| 参 数 选 项 | 说 明 |
|---|---|
| DefaultFigurePosition | 设置Simulink三维动画模块查看器窗口的位置和大小 |
| DefaultPanelMode | 确定查看器中控制面板的外观。合法的值为opaque|translucent|off|halfbar|bar|factory, 默认值为halfbar |
| DefaultViewer | 指定哪个查看器用于查看虚拟场景。当参数选项设置为internal时，使用Simulink三维动画模块查看器；参数选项设置为web时，使用Web浏览器。默认时设置为internal |
| Editor | VRML编辑器的路径。如果路径为空，则使用MATLAB编辑器 |
| httpPort | 用于在Web上通过HTTP获取虚拟现实服务器的IP端口号。如果改变此参数选项，则必须重新启动MATLAB才有效 |
| TransportBuffer | 在虚拟现实服务器与客户之间进行通信时传送缓冲器的长度 |
| VrPort | 用于在虚拟现实服务器和它的客户之间进行通信的IP端口。如果改变这个参数选项，则必须重启动MATLAB才有效 |
注意，httpPort, VrPort和TransportBuffer参数选项影响虚拟世界基于Web的视图效果。DefaultFigurePosition和DefaultPanelMode参数影响Simulink三维动画模块查看器。
DefaultPanelMode参数选项控制Simulink三维动画模块查看器中控制面板的外观。例如，将该值设置为“translucent”会使控制面板看起来是透明的。
DefaultViewer参数确定虚拟场景是显示在Simulink三维动画模块查看器中还是显示在Web浏览器中。如果设置为internal，则Simulink三维动画模块查看器是默认的查看器。如果设置为web，则带有VRML插件的Web浏览器是默认的查看器。
Editor参数选项包含了VRML编辑器可执行文件的路径。使用edit命令时，Simulink三维动画模块用所有编辑VRML文件所需要的参数来运行VRML编辑器可执行文件。运行编辑器时，Simulink三维动画模块使用编辑器参数选项值，就像在命令行中键入它一样。有两个参数需要说明，如表6-3所示。
表6-3 两个参数及其说明
| %matlabroot | 指MATLAB根目录 |
|---|---|
| %file | 指VRML文件名 |
例如，Editor参数选项可能有下面的取值形式：
'%matlabroot\bin\win32\meditor.exe %file'注意可执行文件名和VRML文件名周围的引用记号。如果该参数为空，则使用MATLAB编辑器。
HttpPort参数选项指定用于Web连接的网络端口。该端口在Web URL中给出，如下所示：
http://server.name:port_number该参数的默认值为8123。
TransportBuffer参数选项定义客户-服务器通信时信息窗口的大小。它确定客户和服务器之间一次最多能传递多少信息。
通常，参数选项的取值越大，动画运行越平稳，但是耗时越长。
该参数的默认值为5，在大多数情况下，它是最优的。应该只在动画严重失真或反应时间严重滞后的情况下才改变它的值。
VrPort参数指定Simulink三维动画模块服务器和它的客户之间进行通信的网络端口。正常情况下，该通信对于用户来说完全是不可见的。该参数的默认值为8124。