这里我们将描述Cult3D的脚本特征,以及如何在网页中使用脚本与Cult3D对象的交互操作,通过交互我们可以在用户选择了正确的答案后开始一段动画,或者按用户的选择改变物体的颜色,等等。当Cult3D运行在Netscape Communicator和Microsoft Internet Explorer浏览器下时在调用方面是有区别的,这里我们都将说明。
??Netscape Navigator使用JavaScript (JS)和Cult3D插件通讯,在Windows下则是使用ActiveX 技术。事实上,无论是Netscape的插件,还是Internet Explorer的插件,Cult3D浏览器都是一个ActiveX组件。
ActiveX组件脚本语言是Microsoft Visual Basic Script (VBS)。JS和VBS在语法上有细微的差别,这就是我们为什么制作"Cult3D.js"的原因。你只要在网页内使用JS脚本就可以了,因为JS脚本可以被Internet Explorer和Netscape执行。我们推荐使用JS脚本,除非你使用的是不支持JS脚本的Internet Explorer(Windows 9x/NT)。VBS不被非Windows操作系统支持。
Cult3D事件
当条件满足的时候就触发一个事件,有下列四种事件可能发生:
1. the scene is loaded场景被引导
2. the complete object is loaded场景引导完成
3. the object is invalid or missing对象非法或者丢失
4. custom messages created by the designer通过Cult3D Designer定制的消息
当事件被触发的时候,它可以激活网页脚本,假如网页脚本没有包含激活事件句柄,该事件将被忽略。
事件: OnSceneLoaded
当有适当的信息启动场景的时候Cult3D浏览器触发该事件, 这时Textures和cursors可能还没有被引导完成。
Netscape示例:
<EMBED NAME="对象名称"PLUGINSPAGE="http://www.cult3d.com/newuser/index.html"SRC="yourobject.co"WIDTH="400" HEIGHT="300"ONSCENELOADED="(‘OnSceneLoaded被触发’)"</EMBED>
事件: OnLoadFinished
当文件下载并解压完成的时候Cult3D浏览器触发该事件。
Netscape示例:
<EMBED NAME="Cult3D"PLUGINSPAGE="http://www.cult3d.com/newuser/index.html"SRC="yourobject.co"WIDTH="400" HEIGHT="300"ONSCENELOADED='document.embeds["Cult3D"].triggerEvent("事件名称")'></EMBED>------事件: OnLoadAborted
当文件下载错误或者对象不存在时Cult3D浏览器触发该事件。
事件: OnSendMessage
当Cult3D浏览器接收到通过Cult3D Designer指定的“Send Message to Host”动作被激活或者由Java程序调用时触发该事件,返回的消息可以用 “getLastMessage()接收。
示例:Internet Explorer下使用的JavaScript代码:
<SCRIPT LANGUAGE="javascript"><!--function OnLoadFinished(){// 在这里插入需要代码}//--></SCRIPT><SCRIPT LANGUAGE=javascript FOR=Cult3D EVENT=OnLoadFinished><!--// 调用指定的方法OnLoadFinished()//--></SCRIPT><OBJECT id=Cult3Dclassid="clsid:31B7EB4E-8B4B-11D1-A789-00A0CC6651A8" width=192 height=192><PARAM NAME="SRC" VALUE="Test.co">></OBJECT>Internet Explorer下使用的VBScript代码:<SCRIPT LANGUAGE="vbscript"><!--Sub Cult3D_OnLoadFinished()‘ 在这里插入需要代码End Sub--></SCRIPT><OBJECT id=Cult3Dclassid="clsid:31B7EB4E-8B4B-11D1-A789-00A0CC6651A8" width=192 height=192><PARAM NAME="SRC" VALUE="Test.co"></OBJECT>
尽管Microsoft Internet Explorer支持VBScript脚本,但为了方便期间我们仍然推荐使用JavaScript脚本。Netscape Communicator下使用的JavaScript代码:
<SCRIPT LANGUAGE=”javascript”><!--function OnLoadFinished(){// 在这里插入需要代码}//--></SCRIPT><EMBED NAME=Cult3DPLUGINSPAGE="http://www.cult3d.com/newuser/index.html"SRC="Test.co"WIDTH="192" HEIGHT="192"ONLOADFINISHED="OnLoadFinished()"></EMBED> JavaScript 方法
在网页上可以通过以下的方法控制Cult3d object对象
Netscape:object.setAntiAliasing(mode)object.getAntiAliasing()Internet Explorer:object.AntiAliasing
该方法使网页可以设置Cult3D物体的抗锯齿模式,当使用软件渲染时抗锯齿属性可以被改变,它有三种不同的值:
0 ? 自动模式,可以通过设定“ANTIALIASINGDELAY”时间值来指定发生的时间间隔;但场景中有物体移动时,抗锯齿属性将被禁止,以保证场景演示速度。
1 ? disable禁止
2 ? enable答应
参看“ANTIALIASING” 参数。
Netscape:object.setAntiAliasingDelay(delay)object.getAntiAliasingDelay()Internet Explorer:object.AntiAliasingDelay
该属性使网页通过设定“ANTIALIASINGDELAY”时间值来指定自动抗锯齿发生的时间间隔,抗锯齿延迟仅仅当使用软件渲染时可以被改变,请参看“ANTIALIASINGDELAY”。
Netscape:object.triggerEvent(name)Internet Explorer:object.TriggerEvent(name)
该方法触发一个命名的目标事件,并返回一个布尔值,当Cult3D发现该目标事件时返回为真(True)。
Netscape示例:
var Cult3D = document.embeds[“Cult”];var triggered = Cult3D.triggerEvent(“MoveClock”);if (!triggered)alert("Event没有找到!");-Netscape:object.getVersion()Internet Explorer:object.Version该方法返回Cult3D浏览器版本号。Netscape示例:var Cult3D = document.embeds["Cult"];var CultVersion = Cult3D.getVersion();window.alert("Cult3D version " + CultVersion)Netscape:object.getLastMessage()Internet Explorer:object.LastMessage
该方法接收到通过Cult3D Designer指定的“Send Message to Host”动作激活时发送的最新消息。假如消息为空,它也将被设置为空。
Netscape:object.getFrame()Internet Explorer:object.Frame
该方法返回Cult3D对象的当前帧数,随着渲染时间,它是逐渐变大的。
Netscape:object.setFocus()Internet Explorer:object.Focus
该方法设置Cult3D对象的键盘焦点,可以不通过用户单击Cult3D对象,手动将当前网页的键盘焦点设置到Cult3D对象上。该方法对Internet Explorer可以强制性的每时每刻使用户都可以使用键盘与Cult3D对象交互,该方法Netscape不适用,因为Netscape自动将键盘焦点都设置到嵌入的Cult3D对象上了。假如你不使用该属性,用户使用键盘操作Cult3D对象时可能没有反应。
Netscape:object.getActionStatus(name)Internet Explorer:object.GetActionStatus(name)
该方法返回指定事件的动作状态,它的返回值:
-1 ? 事件名称没有找到
0 ? 事件没有执行
1 ? 事件已经执行
Netscape示例:
var Cult3D = document.embeds["Cult"];var status = Cult3D.getActionStatus("OpenDoor");if (status == -1)alert("Event没有找到!");else if (status == 1)Cult3D.triggerEvent("CloseDoor");elseCult3D.triggerEvent("OpenDoor");Netscape:object.triggerAction(name,action)Internet Explorer:object.TriggerAction(name,action)
该方法发送带参数的消息给Cult3D Java事件,不同于不带参数的“triggerEvent”方法。该动作参数必须是字符串,假如Cult3D发现该Java事件,其返回值为真。
Netscape示例:
var Cult3D = document.embeds["Cult"]; var triggered = Cult3D.triggerAction("SetClock", "" + new Date().getTime());if (!triggered) alert("Event没有找到!");Netscape example使用JavaScript 代码示例: <HTML><HEAD><TITLE>Netscape example</TITLE><SCRIPT LANGUAGE="JavaScript"><!--function OnLoad() {document.frm.txt.value = "物体引导!";document.embeds[“Cult3D”].triggerEvent(“Start”);}function OnAbort() {document.frm.txt.value = "文件非法或丢失!";}function OnScene() {document.frm.txt.value = "正在引导,请等待...";}//--></SCRIPT><BODY><EMBED NAME=Cult3DPLUGINSPAGE="http://www.cult3d.com/newuser/index.html"SRC="Test.co"WIDTH="400" HEIGHT="300"ONSCENELOADED="OnScene()"ONLOADABORTED="OnAbort()"ONLOADFINISHED="OnLoad()"></EMBED><FORM ID=frm NAME=frm>Result: <INPUT NAME=txt TYPE="TEXT" SIZE=30></FORM></BODY></HTML>