main.cesium.OrthographicFrustum.kt Maven / Gradle / Ivy
// Automatically generated - do not modify!
@file:Suppress(
"NON_EXTERNAL_DECLARATION_IN_INAPPROPRIATE_FILE",
)
package cesium
/**
* 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.
* ```
* var maxRadii = ellipsoid.maximumRadius;
*
* var frustum = new OrthographicFrustum();
* frustum.near = 0.01 * maxRadii;
* frustum.far = 50.0 * maxRadii;
* ```
* @see Online Documentation
*/
@JsName("\$cesium__OrthographicFrustum")
external class OrthographicFrustum {
/**
* The horizontal width of the frustum in meters.
* @see Online Documentation
*/
var width: Double
/**
* The aspect ratio of the frustum's width to it's height.
* @see Online Documentation
*/
var aspectRatio: Double
/**
* The distance of the near plane.
* @see Online Documentation
*/
var near: Double
/**
* The distance of the far plane.
* @see Online Documentation
*/
var far: Double
/**
* Gets the orthographic projection matrix computed from the view frustum.
* @see Online Documentation
*/
val projectionMatrix: Matrix4
/**
* Creates a culling volume for this frustum.
* ```
* // Check if a bounding volume intersects the frustum.
* var cullingVolume = frustum.computeCullingVolume(cameraPosition, cameraDirection, cameraUp);
* var intersect = cullingVolume.computeVisibility(boundingVolume);
* ```
* @param [position] The eye position.
* @param [direction] The view direction.
* @param [up] The up direction.
* @return A culling volume at the given position and orientation.
* @see Online Documentation
*/
fun computeCullingVolume(
position: Cartesian3,
direction: Cartesian3,
up: Cartesian3,
): CullingVolume
/**
* Returns the pixel's width and height in meters.
* ```
* // Example 1
* // Get the width and height of a pixel.
* var pixelSize = camera.frustum.getPixelDimensions(scene.drawingBufferWidth, scene.drawingBufferHeight, 0.0, scene.pixelRatio, new Cartesian2());
* ```
* @param [drawingBufferWidth] The width of the drawing buffer.
* @param [drawingBufferHeight] The height of the drawing buffer.
* @param [distance] The distance to the near plane in meters.
* @param [pixelRatio] The scaling factor from pixel space to coordinate space.
* @param [result] The object onto which to store the result.
* @return The modified result parameter or a new instance of [Cartesian2] with the pixel's width and height in the x and y properties, respectively.
* @see Online Documentation
*/
fun getPixelDimensions(
drawingBufferWidth: Double,
drawingBufferHeight: Double,
distance: Double,
pixelRatio: Double,
result: Cartesian2,
): Cartesian2
/**
* Returns a duplicate of a OrthographicFrustum instance.
* @param [result] The object onto which to store the result.
* @return The modified result parameter or a new OrthographicFrustum instance if one was not provided.
* @see Online Documentation
*/
fun clone(result: OrthographicFrustum? = definedExternally): OrthographicFrustum
/**
* Compares the provided OrthographicFrustum componentwise and returns
* `true` if they pass an absolute or relative tolerance test,
* `false` otherwise.
* @param [other] The right hand side OrthographicFrustum.
* @param [relativeEpsilon] The relative epsilon tolerance to use for equality testing.
* @param [absoluteEpsilon] The absolute epsilon tolerance to use for equality testing.
* Default value - [relativeEpsilon]
* @return `true` if this and other are within the provided epsilon, `false` otherwise.
* @see Online Documentation
*/
fun equalsEpsilon(
other: OrthographicFrustum,
relativeEpsilon: Double,
absoluteEpsilon: Double? = definedExternally,
): Boolean
companion object : Packable {
/**
* The number of elements used to pack the object into an array.
* @see Online Documentation
*/
override val packedLength: Int
/**
* Stores the provided instance into the provided array.
* @param [value] The value to pack.
* @param [array] The array to pack into.
* @param [startingIndex] The index into the array at which to start packing the elements.
* Default value - `0`
* @return The array that was packed into
* @see Online Documentation
*/
override fun pack(
value: OrthographicFrustum,
array: Array,
startingIndex: Int?,
): Array
/**
* Retrieves an instance from a packed array.
* @param [array] The packed array.
* @param [startingIndex] The starting index of the element to be unpacked.
* Default value - `0`
* @param [result] The object into which to store the result.
* @return The modified result parameter or a new OrthographicFrustum instance if one was not provided.
* @see Online Documentation
*/
override fun unpack(
array: Array,
startingIndex: Int?,
result: OrthographicFrustum?,
): OrthographicFrustum
}
}