Cesium API - PerspectiveFrustum 中文文档

new Cesium.PerspectiveFrustum(options)

透视视锥由6个平面构成。每个平面由一个Cartesian4对象表示，其中x、y和z分量定义了垂直于该平面的单位向量， w分量是该平面到原点/相机位置的距离。

Name Type Description

options

Object

optional 具有以下属性的对象：

Name	Type	Default	Description
`fov`	Number		optional 视场的角度(FOV)，单位为弧度。
`aspectRatio`	Number		optional 视锥的宽高比。
`near`	Number	`1.0`	optional 近平面的距离。
`far`	Number	`500000000.0`	optional 远平面的距离。
`xOffset`	Number	`0.0`	optional x方向上的偏移量。
`yOffset`	Number	`0.0`	optional y方向上的偏移量。

示例：

var frustum = new Cesium.PerspectiveFrustum({
    fov : Cesium.Math.PI_OVER_THREE,
    aspectRatio : canvas.clientWidth / canvas.clientHeight
    near : 1.0,
    far : 1000.0
});

参考：

PerspectiveOffCenterFrustum

成员变量

staticCesium.PerspectiveFrustum.packedLength : Number

Core/PerspectiveFrustum.js 99

用于将对象打包成数组的元素数。

aspectRatio : Number

Core/PerspectiveFrustum.js 59

视锥的宽高比。

Default Value: undefined

far : Number

Core/PerspectiveFrustum.js 75

远平面的距离。

Default Value: 500000000.0

fov : Number

Core/PerspectiveFrustum.js 48

视场的角度(FOV)，单位为弧度。如果宽度大于高度，则使用此角度作为水平FOV，否则为垂直FOV。

Default Value: undefined

readonlyfovy : Number

Core/PerspectiveFrustum.js 244

获取垂直视场的角度，单位为弧度。

Default Value: undefined

readonlyinfiniteProjectionMatrix : Matrix4

Core/PerspectiveFrustum.js 230

获取从具有无限远平面的视锥计算出的透视图投影矩阵。

参考：

PerspectiveFrustum#projectionMatrix

near : Number

Core/PerspectiveFrustum.js 67

近平面的距离。

Default Value: 1.0

readonlyprojectionMatrix : Matrix4

Core/PerspectiveFrustum.js 215

获取从视锥体计算出的透视投影矩阵。

参考：

PerspectiveFrustum#infiniteProjectionMatrix

xOffset : Number

Core/PerspectiveFrustum.js 83

x方向上的偏移量。

Default Value: 0.0

yOffset : Number

Core/PerspectiveFrustum.js 91

y方向上的偏移量。

Default Value: 0.0

内置方法

staticCesium.PerspectiveFrustum.pack(value, array, startingIndex) → Array.<Number>

Core/PerspectiveFrustum.js 110

将提供的实例存储到提供的数组中。

Name	Type	Default	Description
`value`	PerspectiveFrustum		要包装的值。
`array`	Array.<Number>		要被包装到的数组。
`startingIndex`	Number	`0`	optional 开始包装元素的数组索引。

返回值：

被包装到的数组。

staticCesium.PerspectiveFrustum.unpack(array, startingIndex, result) → PerspectiveFrustum

Core/PerspectiveFrustum.js 136

从已包装的数组中检索实例。

Name	Type	Default	Description
`array`	Array.<Number>		包装的数组。
`startingIndex`	Number	`0`	optional 要解包的元素的起始索引。
`result`	PerspectiveFrustum		optional 存储结果的对象。

返回值：

修改后的结果参数或新的PerspectiveFrustum实例（如果没有提供）。

clone(result) → PerspectiveFrustum

Core/PerspectiveFrustum.js 340

返回一个PerspectiveFrustum实例的副本。

Name	Type	Description
`result`	PerspectiveFrustum	optional 存储结果的对象。

返回值：

已修改的结果参数，如果没有提供则创建新的PerspectiveFrustum实例。

computeCullingVolume(position, direction, up) → CullingVolume

Core/PerspectiveFrustum.js 289

创建此截锥体的剔除体（culling volume）。

Name	Type	Description
`position`	Cartesian3	眼睛的位置。
`direction`	Cartesian3	视图方向。
`up`	Cartesian3	向上的方向。

返回值：

在给定的位置和方向上的剔除体（culling volume）。

示例：

// 检查包围盒是否与截锥体相交。
var cullingVolume = frustum.computeCullingVolume(cameraPosition, cameraDirection, cameraUp);
var intersect = cullingVolume.computeVisibility(boundingVolume);

equals(other) → Boolean

Core/PerspectiveFrustum.js 367

与提供的PerspectiveFrustum分量比较，如果它们相等，则返回true，否则返回false。

Name	Type	Description
`other`	PerspectiveFrustum	optional 要进行比较的PerspectiveFrustum。

返回值：

如果它们相等，则为true，否则false。

equalsEpsilon(other, relativeEpsilon, absoluteEpsilon) → Boolean

Core/PerspectiveFrustum.js 389

与提供的PerspectiveFrustum分量比较，如果它们通过了绝对或相对公差测试，则返回true，否则返回false。

Name	Type	Default	Description
`other`	PerspectiveFrustum		要进行比较的PerspectiveFrustum。
`relativeEpsilon`	Number		用于等式检验的相对epsilon公差。
`absoluteEpsilon`	Number	`relativeEpsilon`	optional 用于等式检验的绝对epsilon公差。

返回值：

如果两个都在规定的epsilon范围内，则为true；否则false。

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

Core/PerspectiveFrustum.js 322

返回像素的宽度和高度（以米为单位）。

Name	Type	Description
`drawingBufferWidth`	Number	绘图缓冲区的宽度。
`drawingBufferHeight`	Number	绘图缓冲区的高度。
`distance`	Number	到近平面的距离（以米为单位）。
`pixelRatio`	Number	从像素空间到坐标空间的比例因子（scaling factor）。
`result`	Cartesian2	存储结果的对象。

返回值：

修改后的结果参数，或Cartesian2的新实例，其中x和y属性中分别为像素的宽度和高度。

异常情况：

DeveloperError : drawingBufferWidth 必须大于0。
DeveloperError : drawingBufferHeight 必须大于0。
DeveloperError : pixelRatio 必须大于0。

示例：

// 例1，获取一个像素的宽度和高度。
var pixelSize = camera.frustum.getPixelDimensions(scene.drawingBufferWidth, scene.drawingBufferHeight, 1.0, scene.pixelRatio, new Cesium.Cartesian2());

// 例2，获取一个像素的宽度和高度，如果附近的平面被设置为'distance'。
// 例如，获取布告牌上图像的像素大小。
var position = camera.position;
var direction = camera.direction;
var toCenter = Cesium.Cartesian3.subtract(primitive.boundingVolume.center, position, new Cesium.Cartesian3());      // vector from camera to a primitive
var toCenterProj = Cesium.Cartesian3.multiplyByScalar(direction, Cesium.Cartesian3.dot(direction, toCenter), new Cesium.Cartesian3()); // project vector onto camera direction vector
var distance = Cesium.Cartesian3.magnitude(toCenterProj);
var pixelSize = camera.frustum.getPixelDimensions(scene.drawingBufferWidth, scene.drawingBufferHeight, distance, scene.pixelRatio, new Cesium.Cartesian2());