VRML响应键盘事件——KeySensor/KbdSenSor扩展节点

KeySensor、KbdSensor是在vrml97标准之外扩展的节点，目前已经正式收入到X3D的标准当中，主要用于响应用户键盘按键操作，来对你的程序进行任意的控制。BS/Blaxxun浏览器对应的是KeySensor节点，Contvrml浏览器（插件）对应的是KbdSensor.

 

以KeySensor为例，首先来看一个例子，按下A键，发出声音：

#VRML V2.0 utf8 #添加外部扩展声明 EXTERNPROTO KeySensor [ eventIn SFBool eventsProcessed exposedField SFBool enabled eventOut SFBool isActive eventOut SFInt32 keyPress eventOut SFInt32 keyRelease eventOut SFInt32 actionKeyPress eventOut SFInt32 actionKeyRelease eventOut SFBool shiftKey_changed eventOut SFBool controlKey_changed eventOut SFBool altKey_changed eventOut SFString character ] ["urn:inet:bitmanagement.de:node:KeySensor"] #节点实例，可写在任意位置 DEF key KeySensor {enabled TRUE Group { children [ DEF ts TimeSensor { loop TRUE cycleInterval 3.333 }, # Middle C (C4) DEF C4 Transform { children [ DEF WhiteKey Shape { appearance Appearance { material Material { } } geometry Box { size 0.23 0.1 1.5 } }, Sound { source DEF PitchC4 AudioClip { url "tone1.wav" pitch 1.0 } } ] }, ] } #节点脚本 DEF keyscript Script { eventIn SFInt32 keynum eventOut SFTime C4 eventOut SFTime stop url "javascript: function keynum(value,time) { #当按下'A'键时响应 if(value==65) { C4=time; stop=C4+0.2; } } " } #建立KeySensor事件出口和脚本事件入口的连接 ROUTE key.keyPress TO keyscript.keynum ROUTE keyscript.C4 TO PitchC4.startTime ROUTE keyscript.stop TO PitchC4.stopTime

 

 

KeySensor不断的检测用户的键盘输入，一旦有字符键按下，KeySensor便获得这个字符的UTF-8编码值，将之转换为10进制整数，通过事件出口keyPress发送出来，通过路由传递到脚本节点keyscript的事件入口keynum，这个事件入口一旦接收到值，脚本节点就会执行这个事件入口的同名函数function keynum(value）。

 

域 描述，以KeySensor为例，KbdSensor类似：

 

eventsProcessed	如果设置为TRUE，浏览器的默认键盘动作将不被执行，这个标志位事件告知浏览器所有的事件将被keySensor节点处理。
enabled	设置允许使用这个传感器的标志
keyPress	这个事件出口在键盘上的任意字符按键被按下的时候发生，它的值是用户按下的键所代表的UTF-8字符的十进制整型数值
keyRelease	这个事件出口在键盘上的任意字符按键被释放的时候发生，它的值是用户释放的键所代表的UTF-8字符的十进制整型数值
actionKeyPress	当任意“非字符”键被按下时产生，它的值请对应参考下表
actionKeyRelease	当任意“非字符”键被释放时产生，它的值请对应参考下表
shiftKey_changed	shift键状态改变时发送，按下为TRUE，释放为FALSE
controlKey_changed	ctrl键状态改变时发送，按下为TRUE，释放为FALSE
altKey_changed	alt键状态改变时发送，按下为TRUE，释放为FALSE
isActive	活动标志，当有事件发生时为TRUE
character	在用户按下任意字符键时发送出这个字符键所代表的字符

 

ActionKey编码，KbdSensor与其不同，可用print()函数测试；

 

Key	Value
Home	1000
End	1001
PageUp	1002
PageDown	1003
Up	1004
Down	1005
Left	1006
Right	1007
F1-F12	1008-1019

 

 

用KbdKensor类似，注意键盘值和KeySensor的不一样，帮助文档在http://www.parallelgraphics.com/developer/products/cortona/extensions/keyboard/

#VRML V2.0 utf8 EXTERNPROTO KbdSensor [ exposedField SFBool enabled #TRUE exposedField SFBool isActive #FALSE eventOut SFInt32 keyDown eventOut SFInt32 keyUp ] [ "urn:ParaGraph:KbdSensor" "http://www.parallelgraphics.com/vrml/proto/Cortona/extensions.wrl#KbdSensor" ] DEF key KbdSensor {enabled TRUE isActive TRUE } Group { children [ DEF ts TimeSensor { loop TRUE cycleInterval 3.333 }, # Middle C (C4) DEF C4 Transform { children [ DEF WhiteKey Shape { appearance Appearance { material Material { } } geometry Box { size 0.23 0.1 1.5 } }, Sound { source DEF PitchC4 AudioClip { url "tone1.wav" pitch 1.0 } } ] }, ] } DEF keyscript Script { eventIn SFInt32 keynum eventOut SFTime C4 eventOut SFTime stop url "javascript: function keynum(value,time) { if(value==65601) { C4=time; stop=C4+0.2; } } " } ROUTE key.keyDown TO keyscript.keynum ROUTE keyscript.C4 TO PitchC4.startTime ROUTE keyscript.stop TO PitchC4.stopTime