Cartesian3 - Cesium Documentation

new Cartesian3

A 3D Cartesian point.

Parameters:

Name	Type	Argument	Description
`x`	Number	<optional>	The X component.
`y`	Number	<optional>	The Y component.
`z`	Number	<optional>	The Z component.

See:

Source:

sian3.js

Members

x :Number

The X component.

Default Value:

y :Number

The Y component.

Default Value:

z :Number

The Z component.

Default Value:

<static> fromArray

Creates a Cartesian3 from three consecutive elements in an array.

Example

// Create a Cartesian3 with (1.0, 2.0, 3.0)
var v = [1.0, 2.0, 3.0];
var p = Cesium.Cartesian3.fromArray(v);

// Create a Cartesian3 with (1.0, 2.0, 3.0) using an offset into an array
var v2 = [0.0, 0.0, 1.0, 2.0, 3.0];
var p2 = Cesium.Cartesian3.fromArray(v2, 2);

<static> packedLength :Number

The number of elements used to pack the object into an array.

<static> UNIT_X

An immutable Cartesian3 instance initialized to (1.0, 0.0, 0.0).

<static> UNIT_Y

An immutable Cartesian3 instance initialized to (0.0, 1.0, 0.0).

<static> UNIT_Z

An immutable Cartesian3 instance initialized to (0.0, 0.0, 1.0).

<static> ZERO

An immutable Cartesian3 instance initialized to (0.0, 0.0, 0.0).

Methods

clone

Duplicates this Cartesian3 instance.

Parameters:

Name	Type	Argument	Description
`result`	Cartesian3	<optional>	The object onto which to store the result.

Returns:

Cartesian3 The modified result parameter or a new Cartesian3 instance if one was not provided.

equals

Compares this Cartesian against the provided Cartesian componentwise and returns true if they are equal, false otherwise.

Parameters:

Name	Type	Argument	Description
`right`	Cartesian3	<optional>	The right hand side Cartesian.

Returns:

Boolean true if they are equal, false otherwise.

equalsEpsilon

Compares this Cartesian against the provided Cartesian componentwise and returns true if they are within the provided epsilon, false otherwise.

Parameters:

Name	Type	Argument	Description
`right`	Cartesian3	<optional>	The right hand side Cartesian.
`epsilon`	Number		The epsilon to use for equality testing.

Returns:

Boolean true if they are within the provided epsilon, false otherwise.

toString

Creates a string representing this Cartesian in the format '(x, y, z)'.

Returns:

String A string representing this Cartesian in the format '(x, y, z)'.

<static> abs

Computes the absolute value of the provided Cartesian.

Parameters:

Name	Type	Argument	Description
`cartesian`	Cartesian3		The Cartesian whose absolute value is to be computed.
`result`	Cartesian3	<optional>	The object onto which to store the result.

Returns:

Cartesian3 The modified result parameter or a new Cartesian3 instance if one was not provided.

<static> add

Computes the componentwise sum of two Cartesians.

Parameters:

Name	Type	Argument	Description
`left`	Cartesian3		The first Cartesian.
`right`	Cartesian3		The second Cartesian.
`result`	Cartesian3	<optional>	The object onto which to store the result.

Returns:

Cartesian3 The modified result parameter or a new Cartesian3 instance if one was not provided.

<static> angleBetween

Returns the angle, in radians, between the provided Cartesians.

Parameters:

Name	Type	Description
`left`	Cartesian3	The first Cartesian.
`right`	Cartesian3	The second Cartesian.

Returns:

Number The angle between the Cartesians.

<static> clone

Duplicates a Cartesian3 instance.

Parameters:

Name	Type	Argument	Description
`cartesian`	Cartesian3		The Cartesian to duplicate.
`result`	Cartesian3	<optional>	The object onto which to store the result.

Returns:

Cartesian3 The modified result parameter or a new Cartesian3 instance if one was not provided. (Returns undefined if cartesian is undefined)

<static> cross

Computes the cross (outer) product of two Cartesians.

Parameters:

Name	Type	Argument	Description
`left`	Cartesian3		The first Cartesian.
`right`	Cartesian3		The second Cartesian.
`result`	Cartesian3	<optional>	The object onto which to store the result.

Returns:

Cartesian3 The cross product.

<static> distance

Computes the distance between two points

Parameters:

Name	Type	Description
`left`	Cartesian3	The first point to compute the distance from.
`right`	Cartesian3	The second point to compute the distance to.

Returns:

Number The distance between two points.

Example

// Returns 1.0
var d = Cesium.Cartesian3.distance(new Cesium.Cartesian3(1.0, 0.0, 0.0), new Cesium.Cartesian3(2.0, 0.0, 0.0));

<static> divideByScalar

Divides the provided Cartesian componentwise by the provided scalar.

Parameters:

Name	Type	Argument	Description
`cartesian`	Cartesian3		The Cartesian to be divided.
`scalar`	Number		The scalar to divide by.
`result`	Cartesian3	<optional>	The object onto which to store the result.

Returns:

Cartesian3 The modified result parameter or a new Cartesian3 instance if one was not provided.

<static> dot

Computes the dot (scalar) product of two Cartesians.

Parameters:

Name	Type	Description
`left`	Cartesian3	The first Cartesian.
`right`	Cartesian3	The second Cartesian.

Returns:

Number The dot product.

<static> equals

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

Parameters:

Name	Type	Argument	Description
`left`	Cartesian3	<optional>	The first Cartesian.
`right`	Cartesian3	<optional>	The second Cartesian.

Returns:

Boolean true if left and right are equal, false otherwise.

<static> equalsEpsilon

Compares the provided Cartesians componentwise and returns true if they are within the provided epsilon, false otherwise.

Parameters:

Name	Type	Argument	Description
`left`	Cartesian3	<optional>	The first Cartesian.
`right`	Cartesian3	<optional>	The second Cartesian.
`epsilon`	Number		The epsilon to use for equality testing.

Returns:

Boolean true if left and right are within the provided epsilon, false otherwise.

<static> fromCartesian4

Creates a Cartesian3 instance from an existing Cartesian4. This simply takes the x, y, and z properties of the Cartesian4 and drops w.

Parameters:

Name	Type	Argument	Description
`cartesian`	Cartesian4		The Cartesian4 instance to create a Cartesian3 instance from.
`result`	Cartesian3	<optional>	The object onto which to store the result.

Returns:

Cartesian3 The modified result parameter or a new Cartesian3 instance if one was not provided.

<static> fromElements

Creates a Cartesian3 instance from x, y and z coordinates.

Parameters:

Name	Type	Argument	Description
`x`	Number		The x coordinate.
`y`	Number		The y coordinate.
`z`	Number		The z coordinate.
`result`	Cartesian3	<optional>	The object onto which to store the result.

Returns:

Cartesian3 The modified result parameter or a new Cartesian3 instance if one was not provided.

<static> fromSpherical

Converts the provided Spherical into Cartesian3 coordinates.

Parameters:

Name	Type	Argument	Description
`spherical`	Spherical		The Spherical to be converted to Cartesian3.
`result`	Cartesian3	<optional>	The object onto which to store the result.

Returns:

Cartesian3 The modified result parameter or a new Cartesian3 instance if one was not provided.

<static> getMaximumByComponent

Compares two Cartesians and computes a Cartesian which contains the maximum components of the supplied Cartesians.

Parameters:

Name	Type	Argument	Description
`first`	Cartesian3		A cartesian to compare.
`second`	Cartesian3		A cartesian to compare.
`result`	Cartesian3	<optional>	The object into which to store the result.

Returns:

Cartesian3 A cartesian with the maximum components.

<static> getMaximumComponent

Computes the value of the maximum component for the supplied Cartesian.

Parameters:

Name	Type	Description
`The`	Cartesian3	cartesian to use.

Returns:

Number The value of the maximum component.

<static> getMinimumByComponent

Compares two Cartesians and computes a Cartesian which contains the minimum components of the supplied Cartesians.

Parameters:

Name	Type	Argument	Description
`first`	Cartesian3		A cartesian to compare.
`second`	Cartesian3		A cartesian to compare.
`result`	Cartesian3	<optional>	The object into which to store the result.

Returns:

Cartesian3 A cartesian with the minimum components.

<static> getMinimumComponent

Computes the value of the minimum component for the supplied Cartesian.

Parameters:

Name	Type	Description
`The`	Cartesian3	cartesian to use.

Returns:

Number The value of the minimum component.

<static> lerp

Computes the linear interpolation or extrapolation at t using the provided cartesians.

Parameters:

Name	Type	Argument	Description
`start`			The value corresponding to t at 0.0.
`end`			The value corresponding to t at 1.0.
`t`			The point along t at which to interpolate.
`result`	Cartesian3	<optional>	The object onto which to store the result.

Returns:

Cartesian3 The modified result parameter or a new Cartesian3 instance if one was not provided.

<static> magnitude

Computes the Cartesian's magnitude (length).

Parameters:

Name	Type	Description
`cartesian`	Cartesian3	The Cartesian instance whose magnitude is to be computed.

Returns:

Number The magnitude.

<static> magnitudeSquared

Computes the provided Cartesian's squared magnitude.

Parameters:

Name	Type	Description
`cartesian`	Cartesian3	The Cartesian instance whose squared magnitude is to be computed.

Returns:

Number The squared magnitude.

<static> mostOrthogonalAxis

Returns the axis that is most orthogonal to the provided Cartesian.

Parameters:

Name	Type	Argument	Description
`cartesian`	Cartesian3		The Cartesian on which to find the most orthogonal axis.
`result`	Cartesian3	<optional>	The object onto which to store the result.

Returns:

Cartesian3 The most orthogonal axis.

<static> multiplyByScalar

Multiplies the provided Cartesian componentwise by the provided scalar.

Parameters:

Name	Type	Argument	Description
`cartesian`	Cartesian3		The Cartesian to be scaled.
`scalar`	Number		The scalar to multiply with.
`result`	Cartesian3	<optional>	The object onto which to store the result.

Returns:

Cartesian3 The modified result parameter or a new Cartesian3 instance if one was not provided.

<static> multiplyComponents

Computes the componentwise product of two Cartesians.

Parameters:

Name	Type	Argument	Description
`left`	Cartesian3		The first Cartesian.
`right`	Cartesian3		The second Cartesian.
`result`	Cartesian3	<optional>	The object onto which to store the result.

Returns:

Cartesian3 The modified result parameter or a new Cartesian3 instance if one was not provided.

<static> negate

Negates the provided Cartesian.

Parameters:

Name	Type	Argument	Description
`cartesian`	Cartesian3		The Cartesian to be negated.
`result`	Cartesian3	<optional>	The object onto which to store the result.

Returns:

Cartesian3 The modified result parameter or a new Cartesian3 instance if one was not provided.

<static> normalize

Computes the normalized form of the supplied Cartesian.

Parameters:

Name	Type	Argument	Description
`cartesian`	Cartesian3		The Cartesian to be normalized.
`result`	Cartesian3	<optional>	The object onto which to store the result.

Returns:

Cartesian3 The modified result parameter or a new Cartesian3 instance if one was not provided.

<static> pack

Stores the provided instance into the provided array.

Parameters:

Name	Type	Argument	Default	Description
`value`	Cartesian3			The value to pack.
`array`	Array			The array to pack into.
`startingIndex`	Number	<optional>	0	The index into the array at which to start packing the elements.

<static> subtract

Computes the componentwise difference of two Cartesians.

Parameters:

Name	Type	Argument	Description
`left`	Cartesian3		The first Cartesian.
`right`	Cartesian3		The second Cartesian.
`result`	Cartesian3	<optional>	The object onto which to store the result.

Returns:

Cartesian3 The modified result parameter or a new Cartesian3 instance if one was not provided.

<static> unpack

Retrieves an instance from a packed array.

Parameters:

Name	Type	Argument	Default	Description
`array`	Array			The packed array.
`startingIndex`	Number	<optional>	0	The starting index of the element to be unpacked.
`result`	Cartesian3	<optional>		The object into which to store the result.