Cesium API - OrthographicOffCenterFrustum 中文文档

本文介绍下Cesium中 OrthographicOffCenterFrustum API的详细使用说明。

new Cesium.OrthographicOffCenterFrustum(options)

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

Name Type Description

options

Object

optional 具有以下属性的对象：

Name	Type	Default	Description
`left`	Number		optional 左侧裁剪平面距离。
`right`	Number		optional 右侧裁剪平面距离。
`top`	Number		optional 上方裁剪平面距离。
`bottom`	Number		optional 下方裁剪平面距离。
`near`	Number	`1.0`	optional 接近裁剪平面的距离。
`far`	Number	`500000000.0`	optional 远离裁剪平面的距离。

示例：

var maxRadii = ellipsoid.maximumRadius;
var frustum = new Cesium.OrthographicOffCenterFrustum();
frustum.right = maxRadii * Cesium.Math.PI;
frustum.left = -c.frustum.right;
frustum.top = c.frustum.right * (canvas.clientHeight / canvas.clientWidth);
frustum.bottom = -c.frustum.top;
frustum.near = 0.01 * maxRadii;
frustum.far = 50.0 * maxRadii;

成员变量

bottom : Number

Core/OrthographicOffCenterFrustum.js 72

下方裁剪平面

Default Value: undefined

far : Number

Core/OrthographicOffCenterFrustum.js 88

远平面的距离。

Default Value: 500000000.0;

left : Number

Core/OrthographicOffCenterFrustum.js 48

左侧裁剪平面

Default Value: undefined

near : Number

Core/OrthographicOffCenterFrustum.js 80

近平面的距离。

Default Value: 1.0

readonlyprojectionMatrix : Matrix4

Core/OrthographicOffCenterFrustum.js 137

获取从视锥计算出的正交投影矩阵。

right : Number

Core/OrthographicOffCenterFrustum.js 56

右侧裁剪平面

Default Value: undefined

top : Number

Core/OrthographicOffCenterFrustum.js 64

上方裁剪平面

Default Value: undefined

内置方法

clone(result) → PerspectiveOffCenterFrustum

Core/OrthographicOffCenterFrustum.js 351

返回一个OrthographicOffCenterFrustum实例的副本。

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

返回值：

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

computeCullingVolume(position, direction, up) → CullingVolume

Core/OrthographicOffCenterFrustum.js 176

创建此截锥体的剔除体（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/OrthographicOffCenterFrustum.js 380

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

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

返回值：

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

equalsEpsilon(other, relativeEpsilon, absoluteEpsilon) → Boolean

Core/OrthographicOffCenterFrustum.js 399

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

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

返回值：

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

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

Core/OrthographicOffCenterFrustum.js 302

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

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());