PerspectiveOffCenterFrustum

視錐由6個(gè)平面定義。每個(gè)平面由一個(gè)Cartesian4對(duì)象表示，其中X、Y和Z分量定義垂直于平面的單位向量，而W分量是平面與原點(diǎn)/相機(jī)位置之間的距離。

new PerspectiveOffCenterFrustum(options)

Parameters:

options (Object) 一個(gè)

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`	遠(yuǎn)剪裁平面距離。

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:

PerspectiveFrustum

Members

bottom : Number

定義底部剪切平面。

Default Value: undefined

far : Number

遠(yuǎn)平面的距離。

Default Value: 500000000.0

(readonly) infiniteProjectionMatrix : Matrix4

獲取從具有無(wú)限遠(yuǎn)平面的視圖截錐計(jì)算的透視投影矩陣。

See:

PerspectiveOffCenterFrustum#projectionMatrix

left : Number

定義左剪裁平面。

Default Value: undefined

near : Number

近平面的距離。

Default Value: 1.0

(readonly) projectionMatrix : Matrix4

獲取從視圖截錐計(jì)算的透視投影矩陣。

See:

PerspectiveOffCenterFrustum#infiniteProjectionMatrix

right : Number

定義右剪切平面。

Default Value: undefined

top : Number

定義頂部剪切平面。

Default Value: undefined

Methods

clone(result) → {PerspectiveOffCenterFrustum}

返回透視OffCenterFrutStum實(shí)例的副本。

Parameters:

result (PerspectiveOffCenterFrustum) 存儲(chǔ)結(jié)果的對(duì)象。

computeCullingVolume(position, direction, up) → {CullingVolume}

為此截錐創(chuàng)建剔除體積。

Parameters:

position (Cartesian3) 眼睛的位置。

direction (Cartesian3) 視圖方向。

up (Cartesian3) 向上方向。

Example

// Check if a bounding volume intersects the frustum.
var cullingVolume = frustum.computeCullingVolume(cameraPosition, cameraDirection, cameraUp);
var intersect = cullingVolume.computeVisibility(boundingVolume);

equals(other) → {Boolean}

比較提供的透視圖的中心截錐組件，如果相等則返回true，否則返回false。

Parameters:

other (PerspectiveOffCenterFrustum) 中心截錐的右側(cè)透視圖。

equalsEpsilon(other, relativeEpsilon, absoluteEpsilon) → {Boolean}

比較提供的透視圖的中心截錐組件，如果通過絕對(duì)或相對(duì)公差測(cè)試，則返回true，否則返回false。

Parameters:

other (PerspectiveOffCenterFrustum) 中心截錐的右側(cè)透視圖。

relativeEpsilon (Number) 用于等同性測(cè)試的相對(duì)epsilon公差。

absoluteEpsilon (Number) (default relativeEpsilon) 用于等同性測(cè)試的絕對(duì)epsilon公差。

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

返回像素的寬度和高度（以米為單位）。

Parameters:

drawingBufferWidth (Number) 繪圖緩沖區(qū)的寬度。

drawingBufferHeight (Number) 繪圖緩沖區(qū)的高度。

distance (Number) 到近平面的距離，單位為米。

pixelRatio (Number) 從像素空間到坐標(biāo)空間的比例因子。

result (Cartesian2) 存儲(chǔ)結(jié)果的對(duì)象。

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必須大于零。