視錐由6個平面定義。每個平面由一個
new PerspectiveFrustum(options)
Cartesian4對象表示，其中X、Y和Z分量定義垂直于平面的單位向量，而W分量是平面與原點/相機位置之間的距離。
Parameters:
options
(Object)
一個
| Name | Description |
|---|---|
options.fov
Number
|
視場的角度（FOV），以弧度表示。 |
options.aspectRatio
Number
|
截錐的寬度和高度的縱橫比。 |
options.near
Number
default 1.0
|
近平面的距離。 |
options.far
Number
default 500000000.0
|
遠平面的距離。 |
options.xOffset
Number
default 0.0
|
X方向的偏移量。 |
options.yOffset
Number
default 0.0
|
Y方向的偏移。 |
Members
(static) packedLength : Number
用于將對象打包到數組中的元素數。
aspectRatio : Number
截錐的寬度和高度的縱橫比。
-
Default Value:
undefined
far : Number
遠平面的距離。
-
Default Value:
500000000.0
fov : Number
視場的角度（FOV），以弧度表示。如果寬度大于高度，此角度將用作水平視野，否則將用作垂直視野。
-
Default Value:
undefined
(readonly) fovy : Number
獲取垂直視野的角度（以弧度為單位）。
-
Default Value:
undefined
(readonly) infiniteProjectionMatrix : Matrix4
從具有無限遠平面的視錐計算出的透視投影矩陣。
near : Number
近平面的距離。
-
Default Value:
1.0
(readonly) projectionMatrix : Matrix4
獲取從視圖截錐計算的透視投影矩陣。
xOffset : Number
沿X方向偏移截錐。
-
Default Value:
0.0
yOffset : Number
沿Y方向偏移截錐。
-
Default Value:
0.0
Methods
(static) pack(value, array, startingIndex) → {Array.<Number>}
將提供的實例存儲到提供的數組中。
Parameters:
array
(Array.<Number>)
要打包的數組。
startingIndex
(Number)
(default 0)
數組中開始打包元素的索引。
從壓縮數組中檢索實例。
Parameters:
array
(Array.<Number>)
壓縮數組。
startingIndex
(Number)
(default 0)
要解包的元素的起始索引。
返回透視截錐實例的副本。
Parameters:
為此截錐創建剔除體積。
Parameters:
Example
// Check if a bounding volume intersects the frustum.
var cullingVolume = frustum.computeCullingVolume(cameraPosition, cameraDirection, cameraUp);
var intersect = cullingVolume.computeVisibility(boundingVolume);
比較所提供的透視截錐組件，如果相等則返回
true，否則返回false。
Parameters:
比較提供的透視截錐組件，如果通過絕對或相對公差測試，則返回
true，否則返回false。
Parameters:
relativeEpsilon
(Number)
用于等同性測試的相對epsilon公差。
absoluteEpsilon
(Number)
(default relativeEpsilon)
用于等同性測試的絕對epsilon公差。
返回像素的寬度和高度（以米為單位）。
Parameters:
drawingBufferWidth
(Number)
繪圖緩沖區的寬度。
drawingBufferHeight
(Number)
繪圖緩沖區的高度。
distance
(Number)
到近平面的距離，單位為米。
pixelRatio
(Number)
從像素空間到坐標空間的比例因子。
Examples
// Example 1
// Get the width and height of a pixel.
var pixelSize = camera.frustum.getPixelDimensions(scene.drawingBufferWidth, scene.drawingBufferHeight, 1.0, scene.pixelRatio, new bmgl.Cartesian2());// Example 2
// Get the width and height of a pixel if the near plane was set to 'distance'.
// For example, get the size of a pixel of an image on a billboard.
var position = camera.position;
var direction = camera.direction;
var toCenter = bmgl.Cartesian3.subtract(primitive.boundingVolume.center, position, new bmgl.Cartesian3()); // vector from camera to a primitive
var toCenterProj = bmgl.Cartesian3.multiplyByScalar(direction, bmgl.Cartesian3.dot(direction, toCenter), new bmgl.Cartesian3()); // project vector onto camera direction vector
var distance = bmgl.Cartesian3.magnitude(toCenterProj);
var pixelSize = camera.frustum.getPixelDimensions(scene.drawingBufferWidth, scene.drawingBufferHeight, distance, scene.pixelRatio, new bmgl.Cartesian2());Throws
-
DeveloperError : DrawingBufferWidth必須大于零。
-
DeveloperError : DrawingBufferHeight必須大于零。
-
DeveloperError : PixelRatio必須大于零。