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 |
optional
An object with the following properties:
|
Example:
var maxRadii = ellipsoid.maximumRadius;
var frustum = new Cesium.OrthographicFrustum();
frustum.near = 0.01 * maxRadii;
frustum.far = 50.0 * maxRadii;
Members
-
The number of elements used to pack the object into an array.
-
The aspect ratio of the frustum's width to it's height.
-
Default Value:
undefined
-
The distance of the far plane.
-
Default Value:
500000000.0;
-
The distance of the near plane.
-
Default Value:
1.0
-
readonlyprojectionMatrix : Matrix4
-
Gets the orthographic projection matrix computed from the view frustum.
-
The horizontal width of the frustum in meters.
-
Default Value:
undefined
Methods
-
Stores the provided instance into the provided array.
Name Type Default Description value
OrthographicFrustum The value to pack. array
Array.<Number> The array to pack into. startingIndex
Number 0
optional The index into the array at which to start packing the elements. Returns:
The array that was packed into -
staticCesium.OrthographicFrustum.unpack(array, startingIndex, result) → OrthographicFrustum
-
Retrieves an instance from a packed array.
Name Type Default Description array
Array.<Number> The packed array. startingIndex
Number 0
optional The starting index of the element to be unpacked. result
OrthographicFrustum optional The object into which to store the result. Returns:
The modified result parameter or a new OrthographicFrustum instance if one was not provided. -
clone(result) → OrthographicFrustum
-
Returns a duplicate of a OrthographicFrustum instance.
Name Type Description result
OrthographicFrustum optional The object onto which to store the result. Returns:
The modified result parameter or a new OrthographicFrustum 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:
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);
-
Compares the provided OrthographicFrustum componentwise and returns
true
if they are equal,false
otherwise.Name Type Description other
OrthographicFrustum optional The right hand side OrthographicFrustum. Returns:
true
if they are equal,false
otherwise. -
getPixelDimensions(drawingBufferWidth, drawingBufferHeight, distance, 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. result
Cartesian2 The object onto which to store the result. Returns:
The modified result parameter or a new instance ofCartesian2
with the pixel's width and height in the x and y properties, respectively.Throws:
-
DeveloperError : drawingBufferWidth must be greater than zero.
-
DeveloperError : drawingBufferHeight must be greater than zero.
Example:
// Example 1 // Get the width and height of a pixel. var pixelSize = camera.frustum.getPixelDimensions(scene.drawingBufferWidth, scene.drawingBufferHeight, 0.0, new Cesium.Cartesian2());
-