視錐由6個平面定義。每個平面由一個
new PerspectiveOffCenterFrustum(options)
Cartesian4
對象表示,其中X、Y和Z分量定義垂直于平面的單位向量,而W分量是平面與原點/相機(jī)位置之間的距離。
Parameters:
options
(Object)
一個
Name | Description |
---|---|
options.left
Number
|
左剪裁平面距離。 |
options.right
Number
|
右裁剪平面距離。 |
options.top
Number
|
頂部剪裁平面距離。 |
options.bottom
Number
|
底部剪切平面距離。 |
options.near
Number
default 1.0
|
近削平面距離。 |
options.far
Number
default 500000000.0
|
遠(yuǎn)剪裁平面距離。 |
Example
var frustum = new bmgl.PerspectiveOffCenterFrustum({
left : -1.0,
right : 1.0,
top : 1.0,
bottom : -1.0,
near : 1.0,
far : 100.0
});
See:
Members
bottom : Number
定義底部剪切平面。
-
Default Value:
undefined
far : Number
遠(yuǎn)平面的距離。
-
Default Value:
500000000.0
(readonly) infiniteProjectionMatrix : Matrix4
獲取從具有無限遠(yuǎn)平面的視圖截錐計算的透視投影矩陣。
left : Number
定義左剪裁平面。
-
Default Value:
undefined
near : Number
近平面的距離。
-
Default Value:
1.0
(readonly) projectionMatrix : Matrix4
獲取從視圖截錐計算的透視投影矩陣。
right : Number
定義右剪切平面。
-
Default Value:
undefined
top : Number
定義頂部剪切平面。
-
Default Value:
undefined
Methods
clone(result) → {PerspectiveOffCenterFrustum}
返回透視OffCenterFrutStum實例的副本。
Parameters:
為此截錐創(chuàng)建剔除體積。
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)
繪圖緩沖區(qū)的寬度。
drawingBufferHeight
(Number)
繪圖緩沖區(qū)的高度。
distance
(Number)
到近平面的距離,單位為米。
pixelRatio
(Number)
從像素空間到坐標(biāo)空間的比例因子。
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必須大于零。