视锥由6个平面定义。每个平面由一个
new PerspectiveOffCenterFrustum(options)
Cartesian4
对象表示,其中X、Y和Z分量定义垂直于平面的单位向量,而W分量是平面与原点/相机位置之间的距离。
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
|
远剪裁平面距离。 |
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
远平面的距离。
-
Default Value:
500000000.0
(readonly) infiniteProjectionMatrix : Matrix4
获取从具有无限远平面的视图截锥计算的透视投影矩阵。
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:
为此截锥创建剔除体积。
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必须大于零。