Class: OrthographicOffCenterFrustum

OrthographicOffCenterFrustum

new OrthographicOffCenterFrustum(options)

The viewing frustum is defined by 6 planes. Each plane is represented by a Cartesian4 object, where the x, y, and z components define the unit vector normal to the plane, and the w component is the distance of the plane from the origin/camera position.

Name Type Description
options Object 可选

An object with the following properties:

Name Type Default Description
left Number 可选

The left clipping plane distance.
right Number 可选

The right clipping plane distance.
top Number 可选

The top clipping plane distance.
bottom Number 可选

The bottom clipping plane distance.
near Number 1.0 可选

The near clipping plane distance.
far Number 500000000.0 可选

The far clipping plane distance.
Example
var maxRadii = ellipsoid.maximumRadius;

var frustum = new SuperMap3D.OrthographicOffCenterFrustum();
frustum.right = maxRadii * SuperMap3D.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;

Members

bottomNumber

The bottom clipping plane.

Default Value:
undefined

farNumber

The distance of the far plane.

Default Value:
500000000.0;

leftNumber

The left clipping plane.

Default Value:
undefined

nearNumber

The distance of the near plane.

Default Value:
1.0

readonly projectionMatrixMatrix4

Gets the orthographic projection matrix computed from the view frustum.

The right clipping plane.

Default Value:
undefined

topNumber

The top clipping plane.

Default Value:
undefined

Methods

clone(result){OrthographicOffCenterFrustum}

Returns a duplicate of a OrthographicOffCenterFrustum instance.

Name Type Description
result OrthographicOffCenterFrustum 可选

The object onto which to store the result.
Returns:
Type Description
OrthographicOffCenterFrustum The modified result parameter or a new OrthographicOffCenterFrustum instance if one was not provided.

computeCullingVolume(position, direction, up){CullingVolume}

Creates a culling volume for this frustum.

Name Type Description
position Cartesian3

The eye position.
direction Cartesian3

The view direction.
up Cartesian3

The up direction.
Returns:
Type Description
CullingVolume A culling volume at the given position and orientation.
Example
// Check if a bounding volume intersects the frustum.
var cullingVolume = frustum.computeCullingVolume(cameraPosition, cameraDirection, cameraUp);
var intersect = cullingVolume.computeVisibility(boundingVolume);

equals(other){Boolean}

Compares the provided OrthographicOffCenterFrustum componentwise and returns true if they are equal, false otherwise.

Name Type Description
other OrthographicOffCenterFrustum 可选

The right hand side OrthographicOffCenterFrustum.
Returns:
Type Description
Boolean true if they are equal, false otherwise.

equalsEpsilon(other, relativeEpsilon, absoluteEpsilon){Boolean}

Compares the provided OrthographicOffCenterFrustum componentwise and returns true if they pass an absolute or relative tolerance test, false otherwise.

Name Type Default Description
other OrthographicOffCenterFrustum

The right hand side OrthographicOffCenterFrustum.
relativeEpsilon Number

The relative epsilon tolerance to use for equality testing.
absoluteEpsilon Number relativeEpsilon 可选

The absolute epsilon tolerance to use for equality testing.
Returns:
Type Description
Boolean true if this and other are within the provided epsilon, false otherwise.

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

Returns the pixel's width and height in meters.

Name Type Description
drawingBufferWidth Number

The width of the drawing buffer.
drawingBufferHeight Number

The height of the drawing buffer.
distance Number

The distance to the near plane in meters.
pixelRatio Number

The scaling factor from pixel space to coordinate space.
result Cartesian2

The object onto which to store the result.
Throws:

  • drawingBufferWidth must be greater than zero.

    Type
    DeveloperError

  • drawingBufferHeight must be greater than zero.

    Type
    DeveloperError

  • pixelRatio must be greater than zero.

    Type
    DeveloperError
Returns:
Type Description
Cartesian2 The modified result parameter or a new instance of Cartesian2 with the pixel's width and height in the x and y properties, respectively.
Example
// Example 1
// Get the width and height of a pixel.
var pixelSize = camera.frustum.getPixelDimensions(scene.drawingBufferWidth, scene.drawingBufferHeight, 0.0, scene.pixelRatio, new SuperMap3D.Cartesian2());