PerspectiveFrustum

new SuperMap3D.PerspectiveFrustum()

视锥由6个平面定义。每个平面由一个Cartesian4对象表示，其中x、y和z分量定义了与平面垂直的单位矢量，w分量是平面到原点/相机位置的距离。
Example:
var frustum = new SuperMap3D.PerspectiveFrustum();
frustum.aspectRatio = canvas.clientWidth / canvas.clientHeight;
frustum.fov = SuperMap3D.Math.PI_OVER_THREE;
frustum.near = 1.0;
frustum.far = 2.0;
See:

Members

aspectRatio : Number

截锥体的宽度与高度的纵横比。
Default Value: undefined

far : Number

远平面的距离。
Default Value: 500000000.0

fov : Number

视锥角度(FOV)，以弧度为单位。如果宽度大于高度，则此角度将用作水平FOV，否则将用作垂直FOV。
Default Value: undefined

readonlyfovy : Number

获取垂直视场的角度，以弧度为单位。
Default Value: undefined

readonlyinfiniteProjectionMatrix : Matrix4

在无限远平面上从视锥台计算的透视投影矩阵。
See:

near : Number

近平面的距离。
Default Value: 1.0

readonlyprojectionMatrix : Matrix4

获取从视图截锥体计算的透视投影矩阵。
See:

xOffset : Number

在x方向上偏移截锥体。
Default Value: 0.0

yOffset : Number

在y方向上偏移截锥体。
Default Value: 0.0

Methods

clone(result) → PerspectiveFrustum

返回 PerspectiveFrustum 实例的副本。
Name Type Description
result PerspectiveFrustum optional 存储结果的对象。
Returns:
修改后的结果参数，或一个新的 PerspectiveFrustum 实例（如果没有提供）。

computeCullingVolume(position, direction, up) → CullingVolume

为这个视锥体创建一个裁剪体。
Name Type Description
position Cartesian3 视点位置。
direction Cartesian3 视线方向。
up Cartesian3 向上的方向。
Returns:
在给定位置和方向上的裁剪体。
Example:
// Check if a bounding volume intersects the frustum.
var cullingVolume = frustum.computeCullingVolume(cameraPosition, cameraDirection, cameraUp);
var intersect = cullingVolume.computeVisibility(boundingVolume);

equals(other) → Boolean

比较所提供的 PerspectiveFrustum 的分量，如果相等则返回 true，否则返回 false。
Name Type Description
other PerspectiveFrustum optional 右侧的PerspectiveFrustum。
Returns:
如果相等则为 true，否则为 false。

getPixelDimensions(drawingBufferWidth, drawingBufferHeight, distance, result) → Cartesian2

返回像素的宽度和高度，单位为米。
Name Type Description
drawingBufferWidth Number 绘制buffer的宽度。
drawingBufferHeight Number 绘制buffer的高度。
distance Number 到近平面的距离，以米为单位。
result Cartesian2 存储结果的对象。
Returns:
修改后的结果参数或 Cartesian2 的新实例，其 x 和 y 属性中分别包含像素的宽度和高度。
Throws:
Examples:
// Example 1
// Get the width and height of a pixel.
var pixelSize = camera.frustum.getPixelDimensions(scene.drawingBufferWidth, scene.drawingBufferHeight, 1.0, new SuperMap3D.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 = SuperMap3D.Cartesian3.subtract(primitive.boundingVolume.center, position, new SuperMap3D.Cartesian3());      // vector from camera to a primitive
var toCenterProj = SuperMap3D.Cartesian3.multiplyByScalar(direction, SuperMap3D.Cartesian3.dot(direction, toCenter), new SuperMap3D.Cartesian3()); // project vector onto camera direction vector
var distance = SuperMap3D.Cartesian3.magnitude(toCenterProj);
var pixelSize = camera.frustum.getPixelDimensions(scene.drawingBufferWidth, scene.drawingBufferHeight, distance, new SuperMap3D.Cartesian2());