Model

基于glTF（WebGL，Op??enGL ES和OpenGL的運(yùn)行時(shí)資源格式）的3D模型。

bigemap-gl包括對(duì)幾何圖形和材質(zhì)，glTF動(dòng)畫(huà)和glTF蒙皮的支持。另外，單個(gè)glTF節(jié)點(diǎn)可以用Scene#pick拾取，可以用Model#getNode動(dòng)畫(huà)。目前不支持glTF相機(jī)和燈光。

用Model.fromGltf創(chuàng)建了一個(gè)外部glTF資源。 glTF JSON也可以在運(yùn)行時(shí)創(chuàng)建，并傳遞給此構(gòu)造函數(shù)。無(wú)論哪種情況，當(dāng)模型準(zhǔn)備渲染時(shí)，即下載外部二進(jìn)制文件，圖像和著色器文件并創(chuàng)建WebGL資源時(shí)，Model#readyPromise都會(huì)解析。

bigemap-gl支持帶有以下擴(kuò)展名的glTF資源：

KHR_binary_glTF (glTF 1.0)
KHR_materials_common (glTF 1.0)
WEB3D_quantized_attributes (glTF 1.0)
AGI_articulations
KHR_blend (draft)
KHR_draco_mesh_compression
KHR_materials_pbrSpecularGlossiness
KHR_materials_unlit
KHR_techniques_webgl
KHR_texture_transform

對(duì)于高精度渲染，bigemap-gl支持?jǐn)U展，它引入了BMGL_RTC_MODELVIEW參數(shù)語(yǔ)義，該語(yǔ)義表示節(jié)點(diǎn)在WGS84坐標(biāo)中相對(duì)于當(dāng)?shù)匮y(tǒng)。

new Model(options)

Parameters:

options (Object)

Name	Description
options.gltf `(Object \| ArrayBuffer \| Uint8Array)`	gltf json對(duì)象或二進(jìn)制gltf緩沖區(qū)。
options.basePath `(Resource \| String)` default `''`	gltf json中的路徑相對(duì)于的基本路徑。
options.show `Boolean` default `true`	確定是否顯示模型基元。
options.modelMatrix `Matrix4` default `Matrix4.IDENTITY`	將模型從模型轉(zhuǎn)換為世界坐標(biāo)的4x4轉(zhuǎn)換矩陣。
options.scale `Number` default `1.0`	應(yīng)用于此模型的統(tǒng)一比例。
options.minimumPixelSize `Number` default `0.0`	模型的近似最小像素大小，與縮放無(wú)關(guān)。
options.maximumScale `Number`	模型的最大比例大小。最小像素化的上限。
options.id `Object`	使用`Scene#pick`選取模型時(shí)要返回的用戶定義對(duì)象。
options.allowPicking `Boolean` default `true`	當(dāng)`true`時(shí)，每個(gè)GLTF網(wǎng)格和基本體都可以用`Scene#pick`拾取。
options.incrementallyLoadTextures `Boolean` default `true`	確定加載模型后紋理是否可以繼續(xù)流入。
options.asynchronous `Boolean` default `true`	確定在加載完所有GLTF文件后，模型WebGL資源創(chuàng)建是否將分布在多個(gè)幀或塊上，直到完成。
options.clampAnimations `Boolean` default `true`	確定模型的動(dòng)畫(huà)是否應(yīng)在未指定關(guān)鍵幀的幀上保持姿勢(shì)。
options.shadows `ShadowMode` default `ShadowMode.ENABLED`	確定模型是投射還是接收來(lái)自每個(gè)光源的陰影。
options.debugShowBoundingVolume `Boolean` default `false`	僅用于調(diào)試。為模型中的每個(gè)繪制命令繪制邊界球體。
options.debugWireframe `Boolean` default `false`	僅用于調(diào)試。在線框中繪制模型。
options.heightReference `HeightReference` default `HeightReference.NONE`	確定模型相對(duì)于地形的繪制方式。
options.scene `Scene`	對(duì)于使用高度引用屬性的模型，必須傳入。
options.distanceDisplayCondition `DistanceDisplayCondition`	指定將顯示此模型的相機(jī)距離的條件。
options.color `Color` default `Color.WHITE`	與模型的渲染顏色混合的顏色。
options.colorBlendMode `ColorBlendMode` default `ColorBlendMode.HIGHLIGHT`	定義顏色與模型的混合方式。
options.colorBlendAmount `Number` default `0.5`	當(dāng)`colorBlendMode`為`MIX`時(shí)用于確定顏色強(qiáng)度的值。值為0.0將生成模型的渲染顏色，值為1.0將生成純色，兩者之間的任何值都將導(dǎo)致二者的混合。
options.silhouetteColor `Color` default `Color.RED`	輪廓顏色。如果超過(guò)256個(gè)模型啟用了輪廓，重疊的模型很可能會(huì)有較小的瑕疵。
options.silhouetteSize `Number` default `0.0`	輪廓的像素大小。
options.clippingPlanes `ClippingPlaneCollection`	`ClippingPlaneCollection`用于選擇性地禁用渲染模型。
options.dequantizeInShader `Boolean` default `true`	確定是否在GPU上對(duì)Draco編碼的模型進(jìn)行量化。這減少了編碼模型的總內(nèi)存使用量。
options.imageBasedLightingFactor `Cartesian2` default `Cartesian2(1.0, 1.0)`	從地球、天空、大氣和星空盒縮放基于漫反射和鏡面反射的圖像照明。
options.lightColor `Cartesian3`	用來(lái)給模型加陰影的陽(yáng)光的顏色和強(qiáng)度。
options.luminanceAtZenith `Number` default `0.2`	太陽(yáng)在天頂?shù)牧炼龋瑔挝粸榍Э藸T光每平方米，用于此模型的程序環(huán)境地圖。
options.sphericalHarmonicCoefficients `Array.<Cartesian3>`	三階球面諧波系數(shù)用于圖像光的漫反射顏色。
options.specularEnvironmentMaps `String`	KTX文件的一個(gè)URL，其中包含鏡面照明和卷積鏡面mipmap的立方體映射。
options.credit `(Credit \| String)`	數(shù)據(jù)源的信用，顯示在畫(huà)布上。

See:

Model.fromGltf

Members

activeAnimations : ModelAnimationCollection

當(dāng)前正在播放的GLTF動(dòng)畫(huà)。

(readonly) allowPicking : Boolean

當(dāng)true時(shí)，每個(gè)GLTF網(wǎng)格和基本體都可以使用Scene#pick拾取。當(dāng)false時(shí)，保存GPU內(nèi)存。

Default Value: true

(readonly) asynchronous : Boolean

確定在加載完所有GLTF文件后，模型WebGL資源創(chuàng)建是否將分布在多個(gè)幀或塊上，直到完成。

Default Value: true

(readonly) basePath : String

gltf json中的路徑相對(duì)于的基本路徑。當(dāng)二進(jìn)制文件、圖像和明暗器文件與.gltf在同一目錄中時(shí)，基路徑與包含.gltf文件的路徑減去.gltf文件的路徑相同。如果是''，則使用應(yīng)用程序的基本路徑。

Default Value: ''

(readonly) boundingSphere : BoundingSphere

模型在其局部坐標(biāo)系中的邊界球。這不考慮GLTF動(dòng)畫(huà)和外觀，也不考慮Model#minimumPixelSize。

Default Value: undefined

Example:

// Center in WGS84 coordinates
var center = bmgl.Matrix4.multiplyByPoint(model.modelMatrix, model.boundingSphere.center, new bmgl.Cartesian3());

clampAnimations : Boolean

確定模型的動(dòng)畫(huà)是否應(yīng)在未指定關(guān)鍵幀的幀上保持姿勢(shì)。

clippingPlanes : ClippingPlaneCollection

ClippingPlaneCollection用于選擇性地禁用渲染模型。

color : Color

與模型的渲染顏色混合的顏色。

Default Value: Color.WHITE

colorBlendAmount : Number

當(dāng)colorBlendMode為MIX時(shí)用于確定顏色強(qiáng)度的值。值為0.0將生成模型的渲染顏色，值為1.0將生成純色，兩者之間的任何值都將導(dǎo)致二者的混合。

Default Value: 0.5

colorBlendMode : ColorBlendMode

定義顏色與模型的混合方式。

Default Value: ColorBlendMode.HIGHLIGHT

credit : Credit

獲取將為模型顯示的學(xué)分

debugShowBoundingVolume : Boolean

此屬性僅用于調(diào)試；它既不用于生產(chǎn)，也不進(jìn)行優(yōu)化。

為模型中的每個(gè)繪制命令繪制邊界球體。gltf原語(yǔ)對(duì)應(yīng)于一個(gè)draw命令。一個(gè)gltf網(wǎng)格有一個(gè)基元數(shù)組，通常是長(zhǎng)度為1的。

Default Value: false

debugWireframe : Boolean

此屬性僅用于調(diào)試；它既不用于生產(chǎn)，也不進(jìn)行優(yōu)化。

在線框中繪制模型。

Default Value: false

distanceDisplayCondition : DistanceDisplayCondition

獲取或設(shè)置條件，該條件指定此模型將顯示在距相機(jī)的距離處。

Default Value: undefined

(readonly) gltf : Object

gltf json的對(duì)象，包括提供給該模型的json中省略了默認(rèn)值的屬性。

Default Value: undefined

heightReference : HeightReference

返回模型的高度引用

Default Value: HeightReference.NONE

id : Object

選擇模型時(shí)返回用戶定義的對(duì)象。

Default Value: undefined

See:

Scene#pick

imageBasedLightingFactor : Cartesian2

Bigemap GL增加了來(lái)自地球、天空、大氣和星空盒的照明。該笛卡爾坐標(biāo)用于將這些源的最終漫反射和鏡面照明貢獻(xiàn)縮放為最終顏色。值為0.0將禁用這些光源。

Default Value: Cartesian2(1.0, 1.0)

(readonly) incrementallyLoadTextures : Boolean

確定加載模型后紋理是否可以繼續(xù)流入。

Default Value: true

lightColor : Cartesian3

用來(lái)給模型加陰影的陽(yáng)光的顏色和強(qiáng)度。

例如，通過(guò)設(shè)置model.imageBasedLightingFactor = new bmgl.Cartesian2(0.0, 0.0)禁用其他光源將使模型更暗。在這里，增加光源的強(qiáng)度將使模型更亮。

Default Value: undefined

luminanceAtZenith : Number

太陽(yáng)在天頂?shù)牧炼龋瑔挝粸榍Э藸T光每平方米，用于此模型的程序環(huán)境地圖。未定義Model#specularEnvironmentMaps和Model#sphericalHarmonicCoefficients時(shí)使用。

Default Value: 0.2

maximumScale : Number

模型的最大比例大小。這可以用來(lái)給Model#minimumPixelSize設(shè)定一個(gè)上限，確保模型永遠(yuǎn)不會(huì)是不合理的規(guī)模。

minimumPixelSize : Number

模型的近似最小像素大小，與縮放無(wú)關(guān)。這可以用來(lái)確保模型即使在查看器縮小時(shí)也可見(jiàn)。當(dāng)0.0時(shí)，不強(qiáng)制使用最小尺寸。

Default Value: 0.0

modelMatrix : Matrix4

將模型從模型轉(zhuǎn)換為世界坐標(biāo)的4x4轉(zhuǎn)換矩陣。當(dāng)這是一個(gè)單位矩陣時(shí)，模型是以世界坐標(biāo)繪制的，即地球的wgs84坐標(biāo)。本地參考幀可以通過(guò)提供不同的轉(zhuǎn)換矩陣來(lái)使用，如Transforms.eastNorthUpToFixedFrame返回的轉(zhuǎn)換矩陣。

Default Value: Matrix4.IDENTITY

Example:

var origin = bmgl.Cartesian3.fromDegrees(-95.0, 40.0, 200000.0);
m.modelMatrix = bmgl.Transforms.eastNorthUpToFixedFrame(origin);

(readonly) pendingTextureLoads : Number

返回掛起的紋理加載數(shù)。

(readonly) ready : Boolean

當(dāng)true時(shí)，此模型已準(zhǔn)備好渲染，即下載了外部二進(jìn)制文件、圖像和明暗器文件，并創(chuàng)建了WebGL資源。這將設(shè)置為true在Model#readyPromise解決之前。

Default Value: false

(readonly) readyPromise : Promise.<Model>

獲取此模型準(zhǔn)備好呈現(xiàn)時(shí)（即下載外部二進(jìn)制文件、圖像和明暗器文件并創(chuàng)建WebGL資源時(shí)）將解決的承諾。

此承諾在模型呈現(xiàn)的第一幀之前在幀的末尾解決。

See:

Model#ready

Example:

// Play all animations at half-speed when the model is ready to render
bmgl.when(model.readyPromise).then(function(model) {
  model.activeAnimations.addAll({
    multiplier : 0.5
  });
}).otherwise(function(error){
  window.alert(error);
});

scale : Number

在Model#modelMatrix之前應(yīng)用于此模型的統(tǒng)一比例。大于1.0的值增加模型的大小；小于1.0的值減少。

Default Value: 1.0

shadows : ShadowMode

確定模型是投射還是接收來(lái)自每個(gè)光源的陰影。

Default Value: ShadowMode.ENABLED

show : Boolean

確定是否顯示模型基元。

Default Value: true

silhouetteColor : Color

輪廓顏色。

Default Value: Color.RED

silhouetteSize : Number

輪廓的像素大小。

Default Value: 0.0

specularEnvironmentMaps : String

KTX文件的一個(gè)URL，其中包含鏡面照明和卷積鏡面mipmap的立方體映射。

See:

Model#sphericalHarmonicCoefficients

sphericalHarmonicCoefficients : Array.<Cartesian3>

三階球面諧波系數(shù)用于圖像光的漫反射顏色。當(dāng)undefined時(shí)，使用根據(jù)大氣顏色計(jì)算的漫反射輻照度。

有九個(gè)Cartesian3系數(shù)。系數(shù)的順序?yàn)椋篖₀₀，L_1-1，L₁₀，L₁₁，L_2-2，L_2-1，L₂₀，L₂₁，L{22

，這些值可以通過(guò)使用的cmgen工具預(yù)處理環(huán)境地圖獲得。這還將生成一個(gè)可以提供給 Model#specularEnvironmentMaps的KTX文件。

Methods

(static) fromGltf(options) → {Model}

從glTF資源創(chuàng)建模型。當(dāng)模型準(zhǔn)備渲染時(shí)，即下載外部二進(jìn)制文件，圖像和著色器文件并創(chuàng)建WebGL資源時(shí)，解析Model#readyPromise。

模型可以是擴(kuò)展名為.gltf的傳統(tǒng)glTF資源，也可以是擴(kuò)展名為.glb的Binary glTF。

bigemap-gl支持具有以下擴(kuò)展名的glTF資源：

KHR_binary_glTF (glTF 1.0)
KHR_materials_common (glTF 1.0)
WEB3D_quantized_attributes (glTF 1.0)
AGI_articulations
KHR_blend (draft)
KHR_draco_mesh_compression
KHR_materials_pbrSpecularGlossiness
KHR_materials_unlit
KHR_techniques_webgl
KHR_texture_transform

對(duì)于高精度渲染，bigemap-gl支持，它引入了BMGL_RTC_MODELVIEW參數(shù)語(yǔ)義，該語(yǔ)義表示節(jié)點(diǎn)在WGS84坐標(biāo)中相對(duì)于本地坐標(biāo)轉(zhuǎn)換起源。

Parameters:

options (Object)

Name	Description
options.url `(Resource \| String)`	.gltf文件的URL。
options.basePath `(Resource \| String)`	gltf json中的路徑相對(duì)于的基本路徑。
options.show `Boolean` default `true`	確定是否顯示模型基元。
options.modelMatrix `Matrix4` default `Matrix4.IDENTITY`	將模型從模型轉(zhuǎn)換為世界坐標(biāo)的4x4轉(zhuǎn)換矩陣。
options.scale `Number` default `1.0`	應(yīng)用于此模型的統(tǒng)一比例。
options.minimumPixelSize `Number` default `0.0`	模型的近似最小像素大小，與縮放無(wú)關(guān)。
options.maximumScale `Number`	模型的最大比例。
options.id `Object`	使用`Scene#pick`選取模型時(shí)要返回的用戶定義對(duì)象。
options.allowPicking `Boolean` default `true`	當(dāng)`true`時(shí)，每個(gè)GLTF網(wǎng)格和基本體都可以用`Scene#pick`拾取。
options.incrementallyLoadTextures `Boolean` default `true`	確定加載模型后紋理是否可以繼續(xù)流入。
options.asynchronous `Boolean` default `true`	確定在加載完所有GLTF文件后，模型WebGL資源創(chuàng)建是否將分布在多個(gè)幀或塊上，直到完成。
options.clampAnimations `Boolean` default `true`	確定模型的動(dòng)畫(huà)是否應(yīng)在未指定關(guān)鍵幀的幀上保持姿勢(shì)。
options.shadows `ShadowMode` default `ShadowMode.ENABLED`	確定模型是投射還是接收來(lái)自每個(gè)光源的陰影。
options.debugShowBoundingVolume `Boolean` default `false`	僅用于調(diào)試。為模型中的每個(gè)繪制命令繪制邊界球體。
options.debugWireframe `Boolean` default `false`	僅用于調(diào)試。在線框中繪制模型。
options.heightReference `HeightReference` default `HeightReference.NONE`	確定模型相對(duì)于地形的繪制方式。
options.scene `Scene`	對(duì)于使用高度引用屬性的模型，必須傳入。
options.distanceDisplayCondition `DistanceDisplayCondition`	指定將顯示此模型的相機(jī)距離的條件。
options.color `Color` default `Color.WHITE`	與模型的渲染顏色混合的顏色。
options.colorBlendMode `ColorBlendMode` default `ColorBlendMode.HIGHLIGHT`	定義顏色與模型的混合方式。
options.colorBlendAmount `Number` default `0.5`	當(dāng)`colorBlendMode`為`MIX`時(shí)用于確定顏色強(qiáng)度的值。值為0.0將生成模型的渲染顏色，值為1.0將生成純色，兩者之間的任何值都將導(dǎo)致二者的混合。
options.silhouetteColor `Color` default `Color.RED`	輪廓顏色。如果超過(guò)256個(gè)模型啟用了輪廓，重疊的模型很可能會(huì)有較小的瑕疵。
options.silhouetteSize `Number` default `0.0`	輪廓的像素大小。
options.clippingPlanes `ClippingPlaneCollection`	`ClippingPlaneCollection`用于選擇性地禁用渲染模型。
options.dequantizeInShader `Boolean` default `true`	確定是否在GPU上對(duì)Draco編碼的模型進(jìn)行量化。這減少了編碼模型的總內(nèi)存使用量。
options.credit `(Credit \| String)`	模型的學(xué)分，顯示在畫(huà)布上。

Examples

// Example 1. Create a model from a glTF asset
var model = scene.primitives.add(bmgl.Model.fromGltf({
  url : './duck/duck.gltf'
}));

// Example 2. Create model and provide all properties and events
var origin = bmgl.Cartesian3.fromDegrees(-95.0, 40.0, 200000.0);
var modelMatrix = bmgl.Transforms.eastNorthUpToFixedFrame(origin);

var model = scene.primitives.add(bmgl.Model.fromGltf({
  url : './duck/duck.gltf',
  show : true,                     // default
  modelMatrix : modelMatrix,
  scale : 2.0,                     // double size
  minimumPixelSize : 128,          // never smaller than 128 pixels
  maximumScale: 20000,             // never larger than 20000 * model size (overrides minimumPixelSize)
  allowPicking : false,            // not pickable
  debugShowBoundingVolume : false, // default
  debugWireframe : false
}));

model.readyPromise.then(function(model) {
  // Play all animations when the model is ready to render
  model.activeAnimations.addAll();
});

(static) silhouetteSupported(scene) → {Boolean}

確定是否支持輪廓。

Parameters:

scene (Scene) 現(xiàn)場(chǎng)。

applyArticulations()

將任何修改的連接階段應(yīng)用于參與任何連接的每個(gè)節(jié)點(diǎn)的矩陣。請(qǐng)注意，這將覆蓋參與節(jié)點(diǎn)上的任何節(jié)點(diǎn)轉(zhuǎn)換。

Throws

DeveloperError : 模型未加載。使用model.readyPromise或等待model.ready為true。

destroy()

銷毀此對(duì)象持有的WebGL資源。銷毀對(duì)象允許確定地釋放WebGL資源，而不是依賴?yán)占鱽?lái)銷毀此對(duì)象。

一旦對(duì)象被破壞，就不應(yīng)使用它；調(diào)用除isDestroyed以外的任何函數(shù)都將導(dǎo)致DeveloperError異常。因此，將返回值（undefined）賦給對(duì)象，如示例中所述。

Example

model = model && model.destroy();

Throws

DeveloperError : 此對(duì)象已被銷毀，即調(diào)用destroy（）。

See:

Model#isDestroyed

getMaterial(name) → {ModelMaterial}

返回具有給定name屬性的GLTF材質(zhì)。

Parameters:

name (String) 物料的GLTF名稱。

Throws

DeveloperError : 模型未加載。使用model.readyPromise或等待model.ready為true。

getMesh(name) → {ModelMesh}

返回具有給定name屬性的gltf網(wǎng)格。

Parameters:

name (String) 網(wǎng)格的gltf名稱。

Throws

DeveloperError : 模型未加載。使用model.readyPromise或等待model.ready為true。

getNode(name) → {ModelNode}

返回具有給定name屬性的GLTF節(jié)點(diǎn)。這用于修改GLTF動(dòng)畫(huà)之外的動(dòng)畫(huà)節(jié)點(diǎn)的轉(zhuǎn)換。

Parameters:

name (String) 節(jié)點(diǎn)的GLTF名稱。

Example

// Apply non-uniform scale to node LOD3sp
var node = model.getNode('LOD3sp');
node.matrix = bmgl.Matrix4.fromScale(new bmgl.Cartesian3(5.0, 1.0, 1.0), node.matrix);

Throws

DeveloperError : 模型未加載。使用model.readyPromise或等待model.ready為true。

isDestroyed() → {Boolean}

如果此對(duì)象被破壞，則返回true；否則返回false。

如果此對(duì)象被破壞，則不應(yīng)使用它；調(diào)用除isDestroyed以外的任何函數(shù)將導(dǎo)致DeveloperError異常。

See:

Model#destroy

setArticulationStage(articulationStageKey, value)

設(shè)置關(guān)節(jié)階段的當(dāng)前值。設(shè)置一個(gè)或多個(gè)階段值后，調(diào)用model.applyArticulations（）以重新計(jì)算節(jié)點(diǎn)矩陣。

Parameters:

articulationStageKey (String) 發(fā)音的名稱、空格和舞臺(tái)的名稱。

value (Number) 這個(gè)階段的發(fā)音的數(shù)值。

Throws

DeveloperError : 模型未加載。使用model.readyPromise或等待model.ready為true。

See:

Model#applyArticulations

update()

當(dāng)Viewer或BMWidget渲染場(chǎng)景以獲取渲染此原語(yǔ)所需的繪制命令時(shí)調(diào)用。

不要直接調(diào)用此函數(shù)。這只是為了列出渲染場(chǎng)景時(shí)可能傳播的異常：

Throws

RuntimeError : 未能加載外部引用。

亚洲动漫在线观看-亚洲动漫第一页-亚洲丁香婷婷-亚洲丶国产丶欧美一区二区三区-亚洲第一综合网站-亚洲第一永久色

Parameters:

See:

Members

activeAnimations : ModelAnimationCollection

(readonly) allowPicking : Boolean

(readonly) asynchronous : Boolean

(readonly) basePath : String

(readonly) boundingSphere : BoundingSphere

Example:

clampAnimations : Boolean

clippingPlanes : ClippingPlaneCollection

color : Color

colorBlendAmount : Number

colorBlendMode : ColorBlendMode

credit : Credit

debugShowBoundingVolume : Boolean

debugWireframe : Boolean

distanceDisplayCondition : DistanceDisplayCondition

(readonly) gltf : Object

heightReference : HeightReference

id : Object

See:

imageBasedLightingFactor : Cartesian2

(readonly) incrementallyLoadTextures : Boolean

lightColor : Cartesian3

luminanceAtZenith : Number

maximumScale : Number

minimumPixelSize : Number

modelMatrix : Matrix4

Example:

(readonly) pendingTextureLoads : Number

(readonly) ready : Boolean

(readonly) readyPromise : Promise.<Model>

See:

Example:

scale : Number

shadows : ShadowMode

show : Boolean

silhouetteColor : Color

silhouetteSize : Number

specularEnvironmentMaps : String

See:

sphericalHarmonicCoefficients : Array.<Cartesian3>

Methods

Parameters:

Examples

Parameters:

Throws

Example

Throws

See:

Parameters:

Throws

Parameters:

Throws

Parameters:

Example

Throws

See:

Parameters:

Throws

See:

Throws