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

VRML97 域說明

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

１

［１］

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

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

SFColor 和 MFColor

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

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

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

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

SFImage

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

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

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

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

SFInt32 和 MFInt32

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

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

[17，-0xE20，-518820]

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

SFNode 和 MFNode

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

[Transform{translation 1 0 0}，

DEF PANDORA box{}，

USE PANDORA]

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

SFRotation 和 MFRotation

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

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

MFRotation 域可包含任意數(shù)量的這類旋轉(zhuǎn)值。注意：視點的旋轉(zhuǎ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 值含有雙引號括起來的UTF-8 octets字符串。任何字符（包括“#”和換行符）都可在雙引號中出現(xiàn)。為了在字符中使用雙引號，在它之前加一個反斜杠“”。為了在字符串中使用反斜杠，連續(xù)打兩個反斜杠“”。例如：

"One,Two,Three,123."

He asked, "Who is #1?""

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

SFTime 和 MFTime

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

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

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

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

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

SFVec3f 和 MFVec3f

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

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

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

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

VRML97節(jié)點 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é)點

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

察者點擊其中的一個對象時，瀏覽器便裝入在url 域中指定的文件。

description 一個提示。移動光標(biāo)到錨點對象而不點擊它時，瀏覽器顯示該提示文本。

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

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

parameter 是一下形式：

parameter["target=name_of_frame"]

url

bboxCenter

bboxSize

事件

eventIn MFNode

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

中，則忽略。

eventIn MFNode

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

則忽略。

說明

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

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

Anchor {

url children

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

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

Anchor {

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

主頁

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

Appearance 節(jié)點

Appearance {

material

texture

textureTransform

}

material

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

textureTransform 包含一個TextureTransform 節(jié)點，如果texture 域為NULL ，則textureTransform

域無效。

說明

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

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

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

在一個造型節(jié)點中指定appearance 域為

appearance Appearance{ }

結(jié)果是沒有光照，而若指定aooearance 域為

appearance Appearance{ material{ }}

光照將基于缺省材料值。

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

AudioClip 節(jié)點 AudioCkip{

description

loop

pitch

startTime

stopTime

url

}

description

loop

pitch

startTime

stopTime

url 域 對聲音的一個描述。瀏覽器可在播放聲音的同時顯示此描述或者只顯示此描述而不播放聲音。 指明是否重復(fù)播放聲音。 加快或減慢播放聲音的相乘因子（例如：2.0意味著以兩倍的速度播放），只有正值是有效的。 聲音開始播放的時間。當(dāng)聲音播放時，set_startTime事件無效。 結(jié)束播放聲音的時間。 指定需裝入的聲音文件的URL 。如果指定了多個URL ，瀏覽器按排列順序裝入第一個能獲取并處理的文件。在裝入一個高優(yōu)先權(quán)的聲音文件的同時瀏覽器可以播放一個低" " 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為從頭到尾播放聲音所需的時間。通常在瀏覽器由播放

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

eventOut SFBool

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

FALSE 。

isActive

說明

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

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

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

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

主頁

節(jié)點說明 來信

Background 節(jié)點