VRML97 域說明VRML97 中有兩類常見的域，一類只包含單值（所謂單值，可以是一個(gè)單獨(dú)的數(shù)，也可以是定義一個(gè)向量或顏色的幾個(gè)數(shù)，甚至可以是定義一幅圖像的一組數(shù)）另外一類包含多個(gè)單值。單值類型的域

VRML97 域說明

VRML97 中有兩類常見的域，一類只包含單值（所謂單值，可以是一個(gè)單獨(dú)的數(shù)，也可以是定義一個(gè)向量或顏色的幾個(gè)數(shù)，甚至可以是定義一幅圖像的一組數(shù)）另外一類包含多個(gè)單值。單值類型的域，名稱以“SF”開始；多值類型的域，名稱以“MF”開始。在VRML 文件中，表示多值域的方法是：一系列用逗號(hào)和空格間隔開的單值，整個(gè)用方括號(hào)括起來。如果一個(gè)多值域，不包含任何值，則只標(biāo)出方括號(hào)（“[]”），其中不填任何數(shù)。如果一個(gè)多值域，恰好只包含一個(gè)數(shù)，可以不寫括號(hào)，直接寫該值。例如，可以表示一個(gè)多值域，其中只包含一個(gè)單獨(dú)的整數(shù)１，下列兩種方式均屬有效：

１

［１］

本說明依次介紹兩種域的值。單值類型的域按英文字母的順序給出；多值域按相應(yīng)的單值域配合列出。事件的類型與域的類型是完全一致的。每一個(gè)事件類型都具有一個(gè)相關(guān)的初始值，在類型描述中有所規(guī)定。當(dāng)腳本試圖讀取一個(gè)尚未發(fā)送的輸出事件的數(shù)值時(shí)，該初始值被返回。 SFBool

一個(gè)SFBool 域只含有一個(gè)Bool 值。TRUE 和FALSE （不帶引號(hào)也不帶任何標(biāo)點(diǎn)符號(hào)）是SFBool 域僅有的兩個(gè)有效值。SFBool 輸出事件的初始值是FALSE 。注意：一般的程序設(shè)計(jì)重用１和０表示True 和False 值，在VRML 中不允許。

SFColor 和 MFColor

SFColor 域是只有一個(gè)顏色值的單值域。SFColor 值和RGB 值一樣，由一組三個(gè)浮點(diǎn)數(shù)組成。每個(gè)數(shù)都是從0.0--1.0，極值包括在內(nèi)，分別表示構(gòu)成顏色的紅綠藍(lán)三個(gè)分量。MFColor 域是一個(gè)多值域，包含任意數(shù)量的RGB 顏色值。例如：

[ 1.0 0.0 0.0，0 1 0，0 0 1] 表示三種顏色紅綠藍(lán)的組成。

SFColor 域的輸出事件的初始值是（0，0，0）。而MFColor 域的輸出事件的初始值是[]。 SFFloat 和 MFFloat

一個(gè)SFFloat 域含有一個(gè)ANSI C格式的單精度浮點(diǎn)數(shù)。一個(gè)MFFloat 域含有零個(gè)或多個(gè)ANSI C格式的單精度浮點(diǎn)數(shù)。即允許空白，不賦任何值。SFFloat 域輸出事件的初始值為0.0。MFFloat 域輸出事件的初始值為[]。

SFImage

一個(gè)SFImage 域含有非壓縮的二維彩色圖像或灰度圖像。一個(gè)SFImage 域，首先列出三個(gè)整數(shù)值，前兩個(gè)表示圖片的寬度和高度，第三個(gè)整數(shù)表示構(gòu)成圖像格式的元素個(gè)數(shù)（1--4），隨后，按（寬度ｘ高度）的格式列出一組16進(jìn)制數(shù)，數(shù)與數(shù)之間以空格分隔，每一個(gè)16進(jìn)制數(shù)表示圖像中一個(gè)單獨(dú)的像素。圖像格式的元素個(gè)數(shù)表示這張圖像是灰度圖還是彩色圖，以及是否包括透明像素或半透明像素。單元素圖像中的每一個(gè)像素用一個(gè)16進(jìn)制的字節(jié)表示，所表示的是一個(gè)像素的亮度。例如：0XFF 表示最高亮度（白色），而0X00表示最低亮度（黑色）。雙元素圖像用兩個(gè)字節(jié)表示一個(gè)像素。第一個(gè)字節(jié)表示亮度，第二個(gè)字節(jié)表示透明度。表示透明度時(shí)，字節(jié)為0xFF 表示完全透明，而0x00表示不透明。所以0x40C0表示1/4亮度（暗灰）和3/4透明度。三元素圖像的每個(gè)像素有三個(gè)字節(jié)表示，每個(gè)字節(jié)表示像素顏色中紅綠藍(lán)分量（所以0xFF0000表示紅色）。四元素圖像是在紅綠藍(lán)三色的值之外再加一個(gè)表示透明度的字節(jié)（所以0x0000FF80表示辦透明的藍(lán)色）。和雙元素圖像一樣，透明度字節(jié)為0xFF 表示完全透明，而0x00表示完全不透明。為了提高可讀性，最好把所有的16進(jìn)制字節(jié)都寫全，包括前導(dǎo)0。然而，寫出每個(gè)字節(jié)有時(shí)是不必要的。例如可以把一個(gè)三元素圖像的藍(lán)色像速寫成0xFF 而不是0x0000FF 。像素的排列規(guī)定從左到右、從底到頂?shù)捻樞颉５谝粋€(gè)16進(jìn)制數(shù)描述一個(gè)圖像最左下角的像素，最后一個(gè)則描述右上角的像素。例：

1 2 1 0XFF 0X00 一個(gè)像素寬，兩個(gè)像素高的灰度圖像，底部像素是白的，頂部像素是黑的。 2 4 3 0XFF0000 0X00FF00 0 0 0 0 0XFFFFFF 0XFFFF00 兩個(gè)像素寬，四個(gè)像素高的RBG 圖像，左下角像素是紅色，右下角像素是綠色，中間兩行是黑色，左上角像素是白色，右上角像素是黃色。

在任何腳本節(jié)點(diǎn)或原型內(nèi)都可以使用這種類型的域，但是，使用的具體地點(diǎn)只能在PiexlTexture （像素紋理）節(jié)點(diǎn)。

SFImage 域的輸出事件的初始值為（0，0，0）。

SFInt32 和 MFInt32

一個(gè)SFInt32域含有一個(gè)32位整數(shù)。一個(gè)SFInt32值是由一個(gè)十進(jìn)制或十六進(jìn)制（以O(shè)X 開頭）格式的整數(shù)構(gòu)成。

一個(gè) MFInt32域是多值域, 由任意數(shù)量的以逗號(hào)或空格分隔的整數(shù)組成。例如：

[17，-0xE20，-518820]

SFInt32域的輸出事件的初始值為0，MFInt32域的輸出事件的初始值為[]。

SFNode 和 MFNode

一個(gè)SFNode 域含有一個(gè)單節(jié)點(diǎn)，必須按標(biāo)準(zhǔn)節(jié)點(diǎn)句法寫成。一個(gè)MFNode 域包含任意數(shù)量的節(jié)點(diǎn)。例：

[Transform{translation 1 0 0}，

DEF PANDORA box{}，

USE PANDORA]

一個(gè)SFNode 允許包含一個(gè)關(guān)鍵字NULL ，此時(shí)，表示它不包含任何節(jié)點(diǎn)。注意：一個(gè)組或一個(gè)變換的children 域也就是列出一組節(jié)點(diǎn)的MFNode 域。把SFNode 域放入一個(gè)腳本節(jié)點(diǎn)，就使節(jié)點(diǎn)的腳本可以直接存取列在SFNode 域的節(jié)點(diǎn)，而不需要一個(gè)ROUTE 語句。SFNode 域的輸出事件的初始值為NULL ，MFNode 域的輸出事件的初始值為[]。

SFRotation 和 MFRotation

SFRotation 域規(guī)定一個(gè)繞任意軸的任意角度的旋轉(zhuǎn)。SFRotation 值含有四個(gè)浮點(diǎn)數(shù)，各數(shù)之間以空格分隔。前三個(gè)數(shù)表示旋轉(zhuǎn)軸（從原點(diǎn)到給定點(diǎn)的向量）；第四個(gè)數(shù)表示圍繞上述軸旋轉(zhuǎn)多少弧度。例：

繞y 軸旋轉(zhuǎn)180度; 表示為 0 1 0 3.1416

MFRotation 域可包含任意數(shù)量的這類旋轉(zhuǎn)值。注意：視點(diǎn)的旋轉(zhuǎn)是從缺省的視點(diǎn)方向開始的，該方向是從（0，0，10）沿-z 軸觀察。SFRotation 域的輸出事件的初始值為（0 0 1 0），MFRotation 域的輸出事件的初始值為[]。

SFString 和 MFString

SFString 域包含一串字符，各字符遵照UTF-8字符編碼標(biāo)準(zhǔn)（ASCII 是UTF-8的子集，可以由于SFString 域）SFString 值含有雙引號(hào)括起來的UTF-8 octets字符串。任何字符（包括“#”和換行符）都可在雙引號(hào)中出現(xiàn)。為了在字符中使用雙引號(hào)，在它之前加一個(gè)反斜杠“”。為了在字符串中使用反斜杠，連續(xù)打兩個(gè)反斜杠“”。例如：

"One,Two,Three,123."

He asked, "Who is #1?""

MFString 域含有零個(gè)或多個(gè)單值，每個(gè)單值都和SFString 值的格式一樣。SFString 域的輸出事件的初始值為“”，MFString 域的輸出事件的初始值為[]。

SFTime 和 MFTime

SFTime 域含有一個(gè)單獨(dú)的時(shí)間值。每個(gè)時(shí)間值是一個(gè)ANSI C 格式的雙精度浮點(diǎn)數(shù)，表示的是從1970年1月1日（GMT ，格林威治平均時(shí)）子夜開始計(jì)時(shí)，延續(xù)當(dāng)前時(shí)間的秒數(shù)。MFTime 域包含任意數(shù)量的時(shí)間值。SFTime 域的輸出事件的初始值為-1，MFTime 域的輸出事件的初始值為[]。 SFVec2f 和 MFVec2f

SFVec2f 域定義了一個(gè)二維向量。SFVec2f 的值是兩個(gè)由空格分隔的浮點(diǎn)數(shù)。

MFVec2f 域是多值域，包含任意數(shù)量的二維向量值。例如：

[0 0，1.2 3.4，98.6 -4e1]

SFVec2f 域的輸出事件的初始值為(0 0），MFVec2f 域的輸出事件的初始值為[]。

SFVec3f 和 MFVec3f

SFVec3f 域定義了一個(gè)三維空間的向量。一個(gè)SFVec3f 值包含三個(gè)浮點(diǎn)數(shù)，數(shù)與數(shù)之間以空格分隔。該值表示從原點(diǎn)到所給定點(diǎn)的向量。

MFVec3f 域包含任意數(shù)量的三維向量值。例如：

[0 0 0，1.2 3.4 5.6，98.6 -461 451]

SFVec3f 域的輸出事件的初始值為(0 0 0），MFVec3f 域的輸出事件的初始值為[]。

VRML97節(jié)點(diǎn) Anchor Appearance AudioClip Background Billboard Box Collision Color ColorInterpolator Cone Coordinate CoordinateInterpolator Cylinder CylinderSensor DirectionalLight ElevationGrid Extrusion Fog FontStyle Group ImageTexture IndexedFaceSet IndexedLineSet Inline

LOD Material MovieTexture NavigationInfo Normal NormalInterpolator OrientationInterpolator PixelTexture PlaneSensor PointLight PointSet PositionInterpolator ProximitySensor ScalarInterpolator Script Shape Sound Sphere SphereSensor SpotLight Switch Text TextureCoordinate TextureTransform TimeSensor TouchSensor Transform Viewpoint VisibilitySensor WorldInfo

VRML97 域說明

原文鏈接 http://extend.hk.hi.cn/~gnohiew/

Anchor 節(jié)點(diǎn)

Anchor{

[ ]

" "

[ ]

" "

0 0 0

-1 -1 -1 # expose field MFNode # expose field SFString # expose field MFString # expose field MFString # SFVec3f # SFVec3f children description parameter url bboxCenter bboxSize

}

域

children

察者點(diǎn)擊其中的一個(gè)對(duì)象時(shí)，瀏覽器便裝入在url 域中指定的文件。

description 一個(gè)提示。移動(dòng)光標(biāo)到錨點(diǎn)對(duì)象而不點(diǎn)擊它時(shí)，瀏覽器顯示該提示文本。

為VRML 和HTML 瀏覽器附加的信息。是一個(gè)形如“關(guān)鍵詞=值”的字符串。例如，有

些瀏覽器允許在HTML 文擋中指定一個(gè)頁面框架作為鏈接作用對(duì)象，parameter 域?qū)?/p>

parameter 是一下形式：

parameter["target=name_of_frame"]

url

bboxCenter

bboxSize

事件

eventIn MFNode

addChildren 在Anchor 節(jié)點(diǎn)的子節(jié)點(diǎn)序列中加入指定的節(jié)點(diǎn)。如果指定子節(jié)點(diǎn)已經(jīng)在子節(jié)點(diǎn)序列

中，則忽略。

eventIn MFNode

removeChildren 制定需裝入的文件的URL 。如果指定多個(gè)URL ，按優(yōu)先級(jí)順序進(jìn)行排列，瀏覽器裝入從URL 序列中發(fā)現(xiàn)的第一個(gè)文件。 包圍Anchor 中子節(jié)點(diǎn)對(duì)象的包圍盒的中心。 包圍Anchor 中子節(jié)點(diǎn)對(duì)象的包圍盒在x 、y 、z 方向上的尺寸。 指定場(chǎng)景中錨點(diǎn)對(duì)象。它包含指向其他文件（在url 域中指定）的超級(jí)鏈接。當(dāng)觀在Anchor 節(jié)點(diǎn)的子節(jié)點(diǎn)序列中刪除指定的節(jié)點(diǎn)。如果指定子節(jié)點(diǎn)不在子節(jié)點(diǎn)序列中，

則忽略。

說明

當(dāng)用戶選擇Anchor 節(jié)點(diǎn)中的任一子節(jié)點(diǎn)對(duì)象時(shí)，可將Anchor 節(jié)點(diǎn)中URL 域中指定的文件從網(wǎng)上取來。如果這文件是VRML 世界，則裝入和顯示它，并取代包含本Anchor 節(jié)點(diǎn)的世界。如果取得的文件是其它類型的文檔，由瀏覽起來決定如何處理這些數(shù)據(jù)。

Anchor 節(jié)點(diǎn)可用于將瀏覽者帶入虛擬世界中的一個(gè)特定觀察位置，在指定URL 時(shí)要以“#viewpointName”結(jié)尾，“#viewpointName”是以DEF 定義的視點(diǎn)名。例如：

Anchor {

url children

} ["tju.wrl#bridgeView"] [Box{ }]

定義了一個(gè)Anchor 節(jié)點(diǎn)。當(dāng)選中Box 時(shí)，瀏覽者將被置于“tju”世界中的名叫“bridgeView”的視點(diǎn)處。如果沒有指定鏈接的世界，則以當(dāng)前世界作為目的場(chǎng)景。例如：

Anchor {

url children } "#AtTheTop" [Sphere{ }]

主頁

當(dāng)Sphere 被選中時(shí)，瀏覽者將處于當(dāng)前世界的“AtTheTop”視點(diǎn)處。 節(jié)點(diǎn)說明 來信

Appearance 節(jié)點(diǎn)

Appearance {

material

texture

textureTransform

}

material

texture 域 包含一個(gè)Material 節(jié)點(diǎn)。 包含一個(gè)ImageTexture 、MovieTexture 或者PixelTexture 節(jié)點(diǎn)。 NULL NULL NULL # exposed field SFNode # exposed field SFNode # exposed field SFNode

textureTransform 包含一個(gè)TextureTransform 節(jié)點(diǎn)，如果texture 域?yàn)镹ULL ，則textureTransform

域無效。

說明

Appearance 節(jié)點(diǎn)僅在Shape 節(jié)點(diǎn)中的appearance 域中出現(xiàn)。該節(jié)點(diǎn)中所有域值均可為NULL 。然而，一旦某個(gè)域

包含非零節(jié)點(diǎn)，則被包含節(jié)點(diǎn)必須包含一個(gè)上述相應(yīng)類型的節(jié)點(diǎn)。

如果material 域是NULL ，與Appearance 相關(guān)的幾何形體是不亮的，也就是說在繪制這個(gè)幾何形體時(shí)忽略所有光照。但是，如果material 域包含一個(gè)缺省得材料節(jié)點(diǎn)，那么這個(gè)幾何形體用缺省的材料節(jié)點(diǎn)的值照亮。也即，

在一個(gè)造型節(jié)點(diǎn)中指定appearance 域?yàn)?/p>

appearance Appearance{ }

結(jié)果是沒有光照，而若指定aooearance 域?yàn)?/p>

appearance Appearance{ material{ }}

光照將基于缺省材料值。

主頁 節(jié)點(diǎn)說明 來信

AudioClip 節(jié)點(diǎn) AudioCkip{

description

loop

pitch

startTime

stopTime

url

}

description

loop

pitch

startTime

stopTime

url 域 對(duì)聲音的一個(gè)描述。瀏覽器可在播放聲音的同時(shí)顯示此描述或者只顯示此描述而不播放聲音。 指明是否重復(fù)播放聲音。 加快或減慢播放聲音的相乘因子（例如：2.0意味著以兩倍的速度播放），只有正值是有效的。 聲音開始播放的時(shí)間。當(dāng)聲音播放時(shí)，set_startTime事件無效。 結(jié)束播放聲音的時(shí)間。 指定需裝入的聲音文件的URL 。如果指定了多個(gè)URL ，瀏覽器按排列順序裝入第一個(gè)能獲取并處理的文件。在裝入一個(gè)高優(yōu)先權(quán)的聲音文件的同時(shí)瀏覽器可以播放一個(gè)低" " FALSE 1.0 0 0 [ ] # exposed field SFString # exposed field SFBool # exposed field SFFloat # exposed field SFTime # exposed field SFTime # exposed field MFString

優(yōu)先權(quán)的文件。

事件

duration_changed eventOut SFTime 如果設(shè)定pitch 為1.0則1.0為從頭到尾播放聲音所需的時(shí)間。通常在瀏覽器由播放

一段聲音轉(zhuǎn)為播放另一段聲音時(shí)輸出此值。

eventOut SFBool

表明聲音是否正在播放。當(dāng)一段聲音開始播放時(shí)，此值被設(shè)為TRUE ，停止時(shí)設(shè)為

FALSE 。

isActive

說明

AudioClip 節(jié)點(diǎn)提供有關(guān)從哪里可獲得一個(gè)預(yù)先錄制好的聲音文件和如何播放它的信息。AudioClip 節(jié)點(diǎn)僅能出

現(xiàn)于聲音節(jié)點(diǎn)的source 域中。

聲音文件理論上可以使用任何數(shù)據(jù)格式，但是為了具有最大的兼容性，至少提供一個(gè)PCM 格式的WAVE 文件的URL 。 如果loop 域設(shè)為TRUE ，聲音一直循環(huán)播放直到stopTime 停止；如果loop 設(shè)為FALSE ，聲音一次播放到文件末

尾或者達(dá)到stopTime 。聲音播放的長短由聲音文件決定，而非由VRML 文件指定。

主頁

節(jié)點(diǎn)說明 來信

Background 節(jié)點(diǎn)