视锥体由 6 个平面定义。
每个平面都由一个
Cartesian4
对象表示,其中 x、y 和 z 分量
定义垂直于平面的单位向量,w 分量是
从原点/相机位置开始的平面。
Name | Type | Description | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options |
object |
optional
对象,具有以下属性:
|
Example:
const maxRadii = ellipsoid.maximumRadius;
const frustum = new Cesium.OrthographicFrustum();
frustum.near = 0.01 * maxRadii;
frustum.far = 50.0 * maxRadii;
Members
用于将对象打包到数组中的元素数量。
视锥体的宽度与高度的纵横比。
-
Default Value:
undefined
远平面的距离。
-
Default Value:
500000000.0;
近平面的距离。
-
Default Value:
1.0
readonly projectionMatrix : Matrix4
获取从视图视锥体计算的正交投影矩阵。
视锥体的水平宽度(以米为单位)。
-
Default Value:
undefined
Methods
将提供的实例存储到提供的数组中。
Name | Type | Default | Description |
---|---|---|---|
value |
OrthographicFrustum | 要打包的值。 | |
array |
Array.<number> | 要装入的数组。 | |
startingIndex |
number |
0
|
optional 开始打包元素的数组的索引。 |
Returns:
被装入的数组
static Cesium.OrthographicFrustum.unpack(array, startingIndex, result) → OrthographicFrustum
从打包数组中检索实例。
Name | Type | Default | Description |
---|---|---|---|
array |
Array.<number> | 打包数组。 | |
startingIndex |
number |
0
|
optional 要解压缩的元素的起始索引。 |
result |
OrthographicFrustum | optional 要在其中存储结果的对象。 |
Returns:
修改后的结果参数 或者一个新的 OrthographicFrustum 实例(如果未提供)。
clone(result) → OrthographicFrustum
返回 OrthographicFrustum 实例的副本。
Name | Type | Description |
---|---|---|
result |
OrthographicFrustum | optional 要在其上存储结果的对象。 |
Returns:
修改后的结果参数或者一个新的 OrthographicFrustum 实例(如果未提供)。
computeCullingVolume(position, direction, up) → CullingVolume
为此视锥体创建剔除体积。
Name | Type | Description |
---|---|---|
position |
Cartesian3 | 眼睛位置。 |
direction |
Cartesian3 | 视图方向。 |
up |
Cartesian3 | 向上方向。 |
Returns:
给定位置和方向的剔除体积。
Example:
// Check if a bounding volume intersects the frustum.
const cullingVolume = frustum.computeCullingVolume(cameraPosition, cameraDirection, cameraUp);
const intersect = cullingVolume.computeVisibility(boundingVolume);
按组件比较提供的 OrthographicFrustum 并返回
true
,否则为false
。
Name | Type | Description |
---|---|---|
other |
OrthographicFrustum | optional 右边 OrthographicFrustum. |
Returns:
true
,否则为false
。
按组件比较提供的 OrthographicFrustum 并返回
true
如果它们通过了绝对或相对耐受性测试,
否则 false
。
Name | Type | Default | Description |
---|---|---|---|
other |
OrthographicFrustum | 右边 OrthographicFrustum. | |
relativeEpsilon |
number | 用于相等性检验的相对容差。 | |
absoluteEpsilon |
number |
relativeEpsilon
|
optional 用于相等性检验的绝对公差。 |
Returns:
如果 this 和其他在提供的 epsilon 内,则为
true
,否则false
。
getPixelDimensions(drawingBufferWidth, drawingBufferHeight, distance, pixelRatio, result) → Cartesian2
返回像素的宽度和高度(以米为单位)。
Name | Type | Description |
---|---|---|
drawingBufferWidth |
number | 绘图缓冲区的宽度。 |
drawingBufferHeight |
number | 绘图缓冲区的高度。 |
distance |
number | 到近平面的距离,以米为单位。 |
pixelRatio |
number | 从像素空间到坐标空间的缩放因子。 |
result |
Cartesian2 | 要在其上存储结果的对象。 |
Returns:
修改后的结果参数 或
Cartesian2
的新实例,像素的宽度和高度分别位于 x 和 y 属性中。
Throws:
-
DeveloperError : drawingBufferWidth must be greater than zero.
-
DeveloperError : drawingBufferHeight must be greater than zero.
-
DeveloperError : pixelRatio must be greater than zero.
Example:
// Example 1
// Get the width and height of a pixel.
const pixelSize = camera.frustum.getPixelDimensions(scene.drawingBufferWidth, scene.drawingBufferHeight, 0.0, scene.pixelRatio, new Cesium.Cartesian2());