org.cesiumjs.cs.core

Class Transforms

java.lang.Object

org.cesiumjs.cs.core.Transforms

@JsType(isNative=true,
        namespace="Cesium",
        name="Transforms")
public class Transforms
extends Object

Contains functions for transforming positions to various reference frames.

Author:

Serge Silaev aka iSergio

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	Transforms.LocalFrameToFixedFrame Computes a 4x4 transformation matrix from a reference frame centered at the provided origin to the provided ellipsoid's fixed reference frame.

Method Summary

Modifier and Type	Method and Description
static Matrix3	computeFixedToIcrfMatrix(JulianDate date) Computes a rotation matrix to transform a point or vector from the Earth-Fixed frame axes (ITRF) to the International Celestial Reference Frame (GCRF/ICRF) inertial frame axes at a given time.
static Matrix3	computeFixedToIcrfMatrix(JulianDate date, Matrix3 result) Computes a rotation matrix to transform a point or vector from the Earth-Fixed frame axes (ITRF) to the International Celestial Reference Frame (GCRF/ICRF) inertial frame axes at a given time.
static Matrix3	computeIcrfToFixedMatrix(JulianDate date) Computes a rotation matrix to transform a point or vector from the International Celestial Reference Frame (GCRF/ICRF) inertial frame axes to the Earth-Fixed frame axes (ITRF) at a given time.
static Matrix3	computeIcrfToFixedMatrix(JulianDate date, Matrix3 result) Computes a rotation matrix to transform a point or vector from the International Celestial Reference Frame (GCRF/ICRF) inertial frame axes to the Earth-Fixed frame axes (ITRF) at a given time.
static Matrix3	computeTemeToPseudoFixedMatrix(JulianDate date) Computes a rotation matrix to transform a point or vector from True Equator Mean Equinox (TEME) axes to the pseudo-fixed axes at a given time.
static Matrix3	computeTemeToPseudoFixedMatrix(JulianDate date, Matrix3 result) Computes a rotation matrix to transform a point or vector from True Equator Mean Equinox (TEME) axes to the pseudo-fixed axes at a given time.
static Matrix4	eastNorthUpToFixedFrame(Cartesian3 origin) Computes a 4x4 transformation matrix from a reference frame with an east-north-up axes centered at the provided origin to the provided ellipsoid's fixed reference frame.
static Matrix4	eastNorthUpToFixedFrame(Cartesian3 origin, Ellipsoid ellipsoid) Computes a 4x4 transformation matrix from a reference frame with an east-north-up axes centered at the provided origin to the provided ellipsoid's fixed reference frame.
static Matrix4	eastNorthUpToFixedFrame(Cartesian3 origin, Ellipsoid ellipsoid, Matrix4 result) Computes a 4x4 transformation matrix from a reference frame with an east-north-up axes centered at the provided origin to the provided ellipsoid's fixed reference frame.
static HeadingPitchRoll	fixedFrameToHeadingPitchRoll(Matrix4 transform) Computes heading-pitch-roll angles from a transform in a particular reference frame.
static HeadingPitchRoll	fixedFrameToHeadingPitchRoll(Matrix4 transform, Ellipsoid ellipsoid) Computes heading-pitch-roll angles from a transform in a particular reference frame.
static HeadingPitchRoll	fixedFrameToHeadingPitchRoll(Matrix4 transform, Ellipsoid ellipsoid, Transforms.LocalFrameToFixedFrame fixedFrameTransform) Computes heading-pitch-roll angles from a transform in a particular reference frame.
static HeadingPitchRoll	fixedFrameToHeadingPitchRoll(Matrix4 transform, Ellipsoid ellipsoid, Transforms.LocalFrameToFixedFrame fixedFrameTransform, HeadingPitchRoll result) Computes heading-pitch-roll angles from a transform in a particular reference frame.
static Quaternion	headingPitchRollQuaternion(Cartesian3 origin, HeadingPitchRoll headingPitchRoll) Computes a quaternion from a reference frame with axes computed from the heading-pitch-roll angles centered at the provided origin.
static Quaternion	headingPitchRollQuaternion(Cartesian3 origin, HeadingPitchRoll headingPitchRoll, Ellipsoid ellipsoid) Computes a quaternion from a reference frame with axes computed from the heading-pitch-roll angles centered at the provided origin.
static Quaternion	headingPitchRollQuaternion(Cartesian3 origin, HeadingPitchRoll headingPitchRoll, Ellipsoid ellipsoid, Quaternion result) Computes a quaternion from a reference frame with axes computed from the heading-pitch-roll angles centered at the provided origin.
static Quaternion	headingPitchRollQuaternion(Cartesian3 origin, HeadingPitchRoll headingPitchRoll, Ellipsoid ellipsoid, Transforms.LocalFrameToFixedFrame transform, Quaternion result) Computes a quaternion from a reference frame with axes computed from the heading-pitch-roll angles centered at the provided origin.
static Matrix4	headingPitchRollToFixedFrame(Cartesian3 origin, HeadingPitchRoll headingPitchRol) Computes a 4x4 transformation matrix from a reference frame with axes computed from the heading-pitch-roll angles centered at the provided origin to the provided ellipsoid's fixed reference frame.
static Matrix4	headingPitchRollToFixedFrame(Cartesian3 origin, HeadingPitchRoll headingPitchRoll, Ellipsoid ellipsoid) Computes a 4x4 transformation matrix from a reference frame with axes computed from the heading-pitch-roll angles centered at the provided origin to the provided ellipsoid's fixed reference frame.
static Matrix4	headingPitchRollToFixedFrame(Cartesian3 origin, HeadingPitchRoll headingPitchRoll, Ellipsoid ellipsoid, Transforms.LocalFrameToFixedFrame fixedFrameTransform) Computes a 4x4 transformation matrix from a reference frame with axes computed from the heading-pitch-roll angles centered at the provided origin to the provided ellipsoid's fixed reference frame.
static Matrix4	headingPitchRollToFixedFrame(Cartesian3 origin, HeadingPitchRoll headingPitchRoll, Ellipsoid ellipsoid, Transforms.LocalFrameToFixedFrame fixedFrameTransform, Matrix4 result) Computes a 4x4 transformation matrix from a reference frame with axes computed from the heading-pitch-roll angles centered at the provided origin to the provided ellipsoid's fixed reference frame.
static Transforms.LocalFrameToFixedFrame	localFrameToFixedFrameGenerator(String firstAxis, String secondAxis) Generates a function that computes a 4x4 transformation matrix from a reference frame centered at the provided origin to the provided ellipsoid's fixed reference frame.
static Matrix4	northEastDownToFixedFrame(Cartesian3 origin) Computes a 4x4 transformation matrix from a reference frame with an north-east-down axes centered at the provided origin to the provided ellipsoid's fixed reference frame.
static Matrix4	northEastDownToFixedFrame(Cartesian3 origin, Ellipsoid ellipsoid) Computes a 4x4 transformation matrix from a reference frame with an north-east-down axes centered at the provided origin to the provided ellipsoid's fixed reference frame.
static Matrix4	northEastDownToFixedFrame(Cartesian3 origin, Ellipsoid ellipsoid, Matrix4 result) Computes a 4x4 transformation matrix from a reference frame with an north-east-down axes centered at the provided origin to the provided ellipsoid's fixed reference frame.
static Matrix4	northUpEastToFixedFrame(Cartesian3 origin) Computes a 4x4 transformation matrix from a reference frame with an north-up-east axes centered at the provided origin to the provided ellipsoid's fixed reference frame.
static Matrix4	northUpEastToFixedFrame(Cartesian3 origin, Ellipsoid ellipsoid) Computes a 4x4 transformation matrix from a reference frame with an north-up-east axes centered at the provided origin to the provided ellipsoid's fixed reference frame.
static Matrix4	northUpEastToFixedFrame(Cartesian3 origin, Ellipsoid ellipsoid, Matrix4 result) Computes a 4x4 transformation matrix from a reference frame with an north-up-east axes centered at the provided origin to the provided ellipsoid's fixed reference frame.
static Matrix4	northWestUpToFixedFrame(Cartesian3 origin) Computes a 4x4 transformation matrix from a reference frame with an north-west-up axes centered at the provided origin to the provided ellipsoid's fixed reference frame.
static Matrix4	northWestUpToFixedFrame(Cartesian3 origin, Ellipsoid ellipsoid) Computes a 4x4 transformation matrix from a reference frame with an north-west-up axes centered at the provided origin to the provided ellipsoid's fixed reference frame.
static Matrix4	northWestUpToFixedFrame(Cartesian3 origin, Ellipsoid ellipsoid, Matrix4 result) Computes a 4x4 transformation matrix from a reference frame with an north-west-up axes centered at the provided origin to the provided ellipsoid's fixed reference frame.
static Cartesian2	pointToWindowCoordinates(Matrix4 modelViewProjectionMatrix, Matrix4 viewportTransformation, Cartesian3 point) Transform a point from model coordinates to window coordinates.
static Cartesian2	pointToWindowCoordinates(Matrix4 modelViewProjectionMatrix, Matrix4 viewportTransformation, Cartesian3 point, Cartesian2 result) Transform a point from model coordinates to window coordinates.
static Promise<Void,Void>	preloadIcrfFixed(TimeInterval timeInterval) Preloads the data necessary to transform between the ICRF and Fixed axes, in either direction, over a given interval.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

computeFixedToIcrfMatrix

@JsMethod
public static Matrix3 computeFixedToIcrfMatrix(JulianDate date)

Computes a rotation matrix to transform a point or vector from the Earth-Fixed frame axes (ITRF) to the International Celestial Reference Frame (GCRF/ICRF) inertial frame axes at a given time. This function may return undefined if the data necessary to do the transformation is not yet loaded.

Parameters:

date - The time at which to compute the rotation matrix.

Returns:

The rotation matrix, or undefined if the data necessary to do the transformation is not yet loaded.

See Also:

preloadIcrfFixed(org.cesiumjs.cs.core.TimeInterval)

computeFixedToIcrfMatrix

@JsMethod
public static Matrix3 computeFixedToIcrfMatrix(JulianDate date,
                                                         Matrix3 result)

Computes a rotation matrix to transform a point or vector from the Earth-Fixed frame axes (ITRF) to the International Celestial Reference Frame (GCRF/ICRF) inertial frame axes at a given time. This function may return undefined if the data necessary to do the transformation is not yet loaded.

Parameters:

date - The time at which to compute the rotation matrix.

result - The object onto which to store the result. If this parameter is not specified, a new instance is created and returned.

Returns:

The rotation matrix, or undefined if the data necessary to do the transformation is not yet loaded.

See Also:

preloadIcrfFixed(org.cesiumjs.cs.core.TimeInterval)

computeIcrfToFixedMatrix

@JsMethod
public static Matrix3 computeIcrfToFixedMatrix(JulianDate date)

Computes a rotation matrix to transform a point or vector from the International Celestial Reference Frame (GCRF/ICRF) inertial frame axes to the Earth-Fixed frame axes (ITRF) at a given time. This function may return undefined if the data necessary to do the transformation is not yet loaded.

Parameters:

date - The time at which to compute the rotation matrix.

Returns:

The rotation matrix, or undefined if the data necessary to do the transformation is not yet loaded.

See Also:

preloadIcrfFixed(org.cesiumjs.cs.core.TimeInterval)

computeIcrfToFixedMatrix

@JsMethod
public static Matrix3 computeIcrfToFixedMatrix(JulianDate date,
                                                         Matrix3 result)

Computes a rotation matrix to transform a point or vector from the International Celestial Reference Frame (GCRF/ICRF) inertial frame axes to the Earth-Fixed frame axes (ITRF) at a given time. This function may return undefined if the data necessary to do the transformation is not yet loaded.

Parameters:

date - The time at which to compute the rotation matrix.

result - The object onto which to store the result. If this parameter is not specified, a new instance is created and returned.

Returns:

The rotation matrix, or undefined if the data necessary to do the transformation is not yet loaded.

See Also:

preloadIcrfFixed(org.cesiumjs.cs.core.TimeInterval)

computeTemeToPseudoFixedMatrix

@JsMethod
public static Matrix3 computeTemeToPseudoFixedMatrix(JulianDate date)

Computes a rotation matrix to transform a point or vector from True Equator Mean Equinox (TEME) axes to the pseudo-fixed axes at a given time. This method treats the UT1 time standard as equivalent to UTC.

Parameters:

date - The time at which to compute the rotation matrix.

Returns:

The modified result parameter or a new Matrix3 instance if none was provided.

computeTemeToPseudoFixedMatrix

@JsMethod
public static Matrix3 computeTemeToPseudoFixedMatrix(JulianDate date,
                                                               Matrix3 result)

Computes a rotation matrix to transform a point or vector from True Equator Mean Equinox (TEME) axes to the pseudo-fixed axes at a given time. This method treats the UT1 time standard as equivalent to UTC.

Parameters:

date - The time at which to compute the rotation matrix.

result - The object onto which to store the result.

Returns:

The modified result parameter or a new Matrix3 instance if none was provided.

eastNorthUpToFixedFrame

@JsMethod
public static Matrix4 eastNorthUpToFixedFrame(Cartesian3 origin)

Computes a 4x4 transformation matrix from a reference frame with an east-north-up axes centered at the provided origin to the provided ellipsoid's fixed reference frame. The local axes are defined as: The x axis points in the local east direction. The y axis points in the local north direction. The z axis points in the direction of the ellipsoid surface normal which passes through the position.

Parameters:

origin - The center point of the local reference frame.

Returns:

The modified result parameter or a new Matrix4 instance if none was provided.

eastNorthUpToFixedFrame

@JsMethod
public static Matrix4 eastNorthUpToFixedFrame(Cartesian3 origin,
                                                        Ellipsoid ellipsoid)

Computes a 4x4 transformation matrix from a reference frame with an east-north-up axes centered at the provided origin to the provided ellipsoid's fixed reference frame. The local axes are defined as: The x axis points in the local east direction. The y axis points in the local north direction. The z axis points in the direction of the ellipsoid surface normal which passes through the position.

Parameters:

origin - The center point of the local reference frame.

ellipsoid - Ellipsoid.WGS84 optional The ellipsoid whose fixed frame is used in the transformation. Default: Ellipsoid.WGS84()

Returns:

The modified result parameter or a new Matrix4 instance if none was provided.

eastNorthUpToFixedFrame

@JsMethod
public static Matrix4 eastNorthUpToFixedFrame(Cartesian3 origin,
                                                        Ellipsoid ellipsoid,
                                                        Matrix4 result)

Computes a 4x4 transformation matrix from a reference frame with an east-north-up axes centered at the provided origin to the provided ellipsoid's fixed reference frame. The local axes are defined as: The x axis points in the local east direction. The y axis points in the local north direction. The z axis points in the direction of the ellipsoid surface normal which passes through the position.

Parameters:

origin - The center point of the local reference frame.

ellipsoid - Ellipsoid.WGS84 optional The ellipsoid whose fixed frame is used in the transformation. Default: Ellipsoid.WGS84()

result - The object onto which to store the result.

Returns:

The modified result parameter or a new Matrix4 instance if none was provided.

fixedFrameToHeadingPitchRoll

@JsMethod
public static HeadingPitchRoll fixedFrameToHeadingPitchRoll(Matrix4 transform)

Computes heading-pitch-roll angles from a transform in a particular reference frame. Heading is the rotation from the local north direction where a positive angle is increasing eastward. Pitch is the rotation from the local east-north plane. Positive pitch angles are above the plane. Negative pitch angles are below the plane. Roll is the first rotation applied about the local east axis.

Parameters:

transform - The transform

Returns:

The modified result parameter or a new HeadingPitchRoll instance if none was provided.

fixedFrameToHeadingPitchRoll

@JsMethod
public static HeadingPitchRoll fixedFrameToHeadingPitchRoll(Matrix4 transform,
                                                                      Ellipsoid ellipsoid)

Computes heading-pitch-roll angles from a transform in a particular reference frame. Heading is the rotation from the local north direction where a positive angle is increasing eastward. Pitch is the rotation from the local east-north plane. Positive pitch angles are above the plane. Negative pitch angles are below the plane. Roll is the first rotation applied about the local east axis.

Parameters:

transform - The transform

ellipsoid - The ellipsoid whose fixed frame is used in the transformation.

Returns:

The modified result parameter or a new HeadingPitchRoll instance if none was provided.

fixedFrameToHeadingPitchRoll

@JsMethod
public static HeadingPitchRoll fixedFrameToHeadingPitchRoll(Matrix4 transform,
                                                                      Ellipsoid ellipsoid,
                                                                      Transforms.LocalFrameToFixedFrame fixedFrameTransform)

Computes heading-pitch-roll angles from a transform in a particular reference frame. Heading is the rotation from the local north direction where a positive angle is increasing eastward. Pitch is the rotation from the local east-north plane. Positive pitch angles are above the plane. Negative pitch angles are below the plane. Roll is the first rotation applied about the local east axis.

Parameters:

transform - The transform

ellipsoid - The ellipsoid whose fixed frame is used in the transformation.

fixedFrameTransform - A 4x4 transformation matrix from a reference frame to the provided ellipsoid's fixed reference frame.

Returns:

The modified result parameter or a new HeadingPitchRoll instance if none was provided.

fixedFrameToHeadingPitchRoll

@JsMethod
public static HeadingPitchRoll fixedFrameToHeadingPitchRoll(Matrix4 transform,
                                                                      Ellipsoid ellipsoid,
                                                                      Transforms.LocalFrameToFixedFrame fixedFrameTransform,
                                                                      HeadingPitchRoll result)

Computes heading-pitch-roll angles from a transform in a particular reference frame. Heading is the rotation from the local north direction where a positive angle is increasing eastward. Pitch is the rotation from the local east-north plane. Positive pitch angles are above the plane. Negative pitch angles are below the plane. Roll is the first rotation applied about the local east axis.

Parameters:

transform - The transform

ellipsoid - The ellipsoid whose fixed frame is used in the transformation.

fixedFrameTransform - A 4x4 transformation matrix from a reference frame to the provided ellipsoid's fixed reference frame.

result - The object onto which to store the result.

Returns:

The modified result parameter or a new HeadingPitchRoll instance if none was provided.

headingPitchRollQuaternion

@JsMethod
public static Quaternion headingPitchRollQuaternion(Cartesian3 origin,
                                                              HeadingPitchRoll headingPitchRoll)

Computes a quaternion from a reference frame with axes computed from the heading-pitch-roll angles centered at the provided origin. Heading is the rotation from the local north direction where a positive angle is increasing eastward. Pitch is the rotation from the local east-north plane. Positive pitch angles are above the plane. Negative pitch angles are below the plane. Roll is the first rotation applied about the local east axis.

Parameters:

origin - The center point of the local reference frame.

headingPitchRoll - The heading, pitch, and roll.

Returns:

The modified result parameter or a new Quaternion instance if none was provided.

headingPitchRollQuaternion

@JsMethod
public static Quaternion headingPitchRollQuaternion(Cartesian3 origin,
                                                              HeadingPitchRoll headingPitchRoll,
                                                              Ellipsoid ellipsoid)

Computes a quaternion from a reference frame with axes computed from the heading-pitch-roll angles centered at the provided origin. Heading is the rotation from the local north direction where a positive angle is increasing eastward. Pitch is the rotation from the local east-north plane. Positive pitch angles are above the plane. Negative pitch angles are below the plane. Roll is the first rotation applied about the local east axis.

Parameters:

origin - The center point of the local reference frame.

headingPitchRoll - The heading, pitch, and roll.

ellipsoid - The ellipsoid whose fixed frame is used in the transformation. Default: Ellipsoid.WGS84()

Returns:

The modified result parameter or a new Quaternion instance if none was provided.

headingPitchRollQuaternion

@JsMethod
public static Quaternion headingPitchRollQuaternion(Cartesian3 origin,
                                                              HeadingPitchRoll headingPitchRoll,
                                                              Ellipsoid ellipsoid,
                                                              Quaternion result)

Computes a quaternion from a reference frame with axes computed from the heading-pitch-roll angles centered at the provided origin. Heading is the rotation from the local north direction where a positive angle is increasing eastward. Pitch is the rotation from the local east-north plane. Positive pitch angles are above the plane. Negative pitch angles are below the plane. Roll is the first rotation applied about the local east axis.

Parameters:

origin - The center point of the local reference frame.

headingPitchRoll - The heading, pitch, and roll.

ellipsoid - The ellipsoid whose fixed frame is used in the transformation. Default: Ellipsoid.WGS84()

result - The object onto which to store the result.

Returns:

The modified result parameter or a new Quaternion instance if none was provided.

headingPitchRollQuaternion

@JsMethod
public static Quaternion headingPitchRollQuaternion(Cartesian3 origin,
                                                              HeadingPitchRoll headingPitchRoll,
                                                              Ellipsoid ellipsoid,
                                                              Transforms.LocalFrameToFixedFrame transform,
                                                              Quaternion result)

Computes a quaternion from a reference frame with axes computed from the heading-pitch-roll angles centered at the provided origin. Heading is the rotation from the local north direction where a positive angle is increasing eastward. Pitch is the rotation from the local east-north plane. Positive pitch angles are above the plane. Negative pitch angles are below the plane. Roll is the first rotation applied about the local east axis.

Parameters:

origin - The center point of the local reference frame.

headingPitchRoll - The heading, pitch, and roll.

ellipsoid - The ellipsoid whose fixed frame is used in the transformation. Default: Ellipsoid.WGS84()

transform - A 4x4 transformation matrix from a reference frame to the provided ellipsoid's fixed reference frame.

result - The object onto which to store the result.

Returns:

The modified result parameter or a new Quaternion instance if none was provided.

headingPitchRollToFixedFrame

@JsMethod
public static Matrix4 headingPitchRollToFixedFrame(Cartesian3 origin,
                                                             HeadingPitchRoll headingPitchRol)

Computes a 4x4 transformation matrix from a reference frame with axes computed from the heading-pitch-roll angles centered at the provided origin to the provided ellipsoid's fixed reference frame. Heading is the rotation from the local north direction where a positive angle is increasing eastward. Pitch is the rotation from the local east-north plane. Positive pitch angles are above the plane. Negative pitch angles are below the plane. Roll is the first rotation applied about the local east axis.

Parameters:

origin - The center point of the local reference frame.

Returns:

The modified result parameter or a new Matrix4 instance if none was provided.

headingPitchRollToFixedFrame

@JsMethod
public static Matrix4 headingPitchRollToFixedFrame(Cartesian3 origin,
                                                             HeadingPitchRoll headingPitchRoll,
                                                             Ellipsoid ellipsoid)

Computes a 4x4 transformation matrix from a reference frame with axes computed from the heading-pitch-roll angles centered at the provided origin to the provided ellipsoid's fixed reference frame. Heading is the rotation from the local north direction where a positive angle is increasing eastward. Pitch is the rotation from the local east-north plane. Positive pitch angles are above the plane. Negative pitch angles are below the plane. Roll is the first rotation applied about the local east axis.

Parameters:

origin - The center point of the local reference frame.

headingPitchRoll - The heading, pitch, and roll.

ellipsoid - The ellipsoid whose fixed frame is used in the transformation. Default Ellipsoid.WGS84()

Returns:

The modified result parameter or a new Matrix4 instance if none was provided.

headingPitchRollToFixedFrame

@JsMethod
public static Matrix4 headingPitchRollToFixedFrame(Cartesian3 origin,
                                                             HeadingPitchRoll headingPitchRoll,
                                                             Ellipsoid ellipsoid,
                                                             Transforms.LocalFrameToFixedFrame fixedFrameTransform)

Computes a 4x4 transformation matrix from a reference frame with axes computed from the heading-pitch-roll angles centered at the provided origin to the provided ellipsoid's fixed reference frame. Heading is the rotation from the local north direction where a positive angle is increasing eastward. Pitch is the rotation from the local east-north plane. Positive pitch angles are above the plane. Negative pitch angles are below the plane. Roll is the first rotation applied about the local east axis.

Parameters:

origin - The center point of the local reference frame.

headingPitchRoll - The heading, pitch, and roll.

ellipsoid - The ellipsoid whose fixed frame is used in the transformation. Default Ellipsoid.WGS84()

Returns:

The modified result parameter or a new Matrix4 instance if none was provided.

headingPitchRollToFixedFrame

@JsMethod
public static Matrix4 headingPitchRollToFixedFrame(Cartesian3 origin,
                                                             HeadingPitchRoll headingPitchRoll,
                                                             Ellipsoid ellipsoid,
                                                             Transforms.LocalFrameToFixedFrame fixedFrameTransform,
                                                             Matrix4 result)

Computes a 4x4 transformation matrix from a reference frame with axes computed from the heading-pitch-roll angles centered at the provided origin to the provided ellipsoid's fixed reference frame. Heading is the rotation from the local north direction where a positive angle is increasing eastward. Pitch is the rotation from the local east-north plane. Positive pitch angles are above the plane. Negative pitch angles are below the plane. Roll is the first rotation applied about the local east axis.

Parameters:

origin - The center point of the local reference frame.

headingPitchRoll - The heading, pitch, and roll.

ellipsoid - The ellipsoid whose fixed frame is used in the transformation. Default Ellipsoid.WGS84()

result - The object onto which to store the result.

Returns:

The modified result parameter or a new Matrix4 instance if none was provided.

northEastDownToFixedFrame

@JsMethod
public static Matrix4 northEastDownToFixedFrame(Cartesian3 origin)

Computes a 4x4 transformation matrix from a reference frame with an north-east-down axes centered at the provided origin to the provided ellipsoid's fixed reference frame. The local axes are defined as: The x axis points in the local north direction. The y axis points in the local east direction. The z axis points in the opposite direction of the ellipsoid surface normal which passes through the position.

Parameters:

origin - The center point of the local reference frame.

Returns:

The modified result parameter or a new Matrix4 instance if none was provided.

northEastDownToFixedFrame

@JsMethod
public static Matrix4 northEastDownToFixedFrame(Cartesian3 origin,
                                                          Ellipsoid ellipsoid)

Computes a 4x4 transformation matrix from a reference frame with an north-east-down axes centered at the provided origin to the provided ellipsoid's fixed reference frame. The local axes are defined as: The x axis points in the local north direction. The y axis points in the local east direction. The z axis points in the opposite direction of the ellipsoid surface normal which passes through the position.

Parameters:

origin - The center point of the local reference frame.

ellipsoid - The ellipsoid whose fixed frame is used in the transformation. Default: Ellipsoid.WGS84()

Returns:

The modified result parameter or a new Matrix4 instance if none was provided.

northEastDownToFixedFrame

@JsMethod
public static Matrix4 northEastDownToFixedFrame(Cartesian3 origin,
                                                          Ellipsoid ellipsoid,
                                                          Matrix4 result)

Computes a 4x4 transformation matrix from a reference frame with an north-east-down axes centered at the provided origin to the provided ellipsoid's fixed reference frame. The local axes are defined as: The x axis points in the local north direction. The y axis points in the local east direction. The z axis points in the opposite direction of the ellipsoid surface normal which passes through the position.

Parameters:

origin - The center point of the local reference frame.

ellipsoid - The ellipsoid whose fixed frame is used in the transformation. Default: Ellipsoid.WGS84()

result - The object onto which to store the result.

Returns:

The modified result parameter or a new Matrix4 instance if none was provided.

northUpEastToFixedFrame

@JsMethod
public static Matrix4 northUpEastToFixedFrame(Cartesian3 origin)

Computes a 4x4 transformation matrix from a reference frame with an north-up-east axes centered at the provided origin to the provided ellipsoid's fixed reference frame. The local axes are defined as: The x axis points in the local north direction. The y axis points in the direction of the ellipsoid surface normal which passes through the position. The z axis points in the local east direction.

Parameters:

origin - The center point of the local reference frame.

Returns:

The modified result parameter or a new Matrix4 instance if none was provided.

northUpEastToFixedFrame

@JsMethod
public static Matrix4 northUpEastToFixedFrame(Cartesian3 origin,
                                                        Ellipsoid ellipsoid)

Computes a 4x4 transformation matrix from a reference frame with an north-up-east axes centered at the provided origin to the provided ellipsoid's fixed reference frame. The local axes are defined as: The x axis points in the local north direction. The y axis points in the direction of the ellipsoid surface normal which passes through the position. The z axis points in the local east direction.

Parameters:

origin - The center point of the local reference frame.

ellipsoid - The ellipsoid whose fixed frame is used in the transformation. Default: Ellipsoid.WGS84()

Returns:

The modified result parameter or a new Matrix4 instance if none was provided.

northUpEastToFixedFrame

@JsMethod
public static Matrix4 northUpEastToFixedFrame(Cartesian3 origin,
                                                        Ellipsoid ellipsoid,
                                                        Matrix4 result)

Computes a 4x4 transformation matrix from a reference frame with an north-up-east axes centered at the provided origin to the provided ellipsoid's fixed reference frame. The local axes are defined as: The x axis points in the local north direction. The y axis points in the direction of the ellipsoid surface normal which passes through the position. The z axis points in the local east direction.

Parameters:

origin - The center point of the local reference frame.

ellipsoid - The ellipsoid whose fixed frame is used in the transformation. Default: Ellipsoid.WGS84()

result - The object onto which to store the result.

Returns:

The modified result parameter or a new Matrix4 instance if none was provided.

northWestUpToFixedFrame

@JsMethod
public static Matrix4 northWestUpToFixedFrame(Cartesian3 origin)

Computes a 4x4 transformation matrix from a reference frame with an north-west-up axes centered at the provided origin to the provided ellipsoid's fixed reference frame. The local axes are defined as: The x axis points in the local north direction. The y axis points in the local west direction. The z axis points in the direction of the ellipsoid surface normal which passes through the position.

Parameters:

origin - The center point of the local reference frame.

Returns:

The modified result parameter or a new Matrix4 instance if none was provided.

northWestUpToFixedFrame

@JsMethod
public static Matrix4 northWestUpToFixedFrame(Cartesian3 origin,
                                                        Ellipsoid ellipsoid)

Computes a 4x4 transformation matrix from a reference frame with an north-west-up axes centered at the provided origin to the provided ellipsoid's fixed reference frame. The local axes are defined as: The x axis points in the local north direction. The y axis points in the local west direction. The z axis points in the direction of the ellipsoid surface normal which passes through the position.

Parameters:

origin - The center point of the local reference frame.

ellipsoid - The ellipsoid whose fixed frame is used in the transformation. Default: Ellipsoid.WGS84()

Returns:

The modified result parameter or a new Matrix4 instance if none was provided.

northWestUpToFixedFrame

@JsMethod
public static Matrix4 northWestUpToFixedFrame(Cartesian3 origin,
                                                        Ellipsoid ellipsoid,
                                                        Matrix4 result)

Computes a 4x4 transformation matrix from a reference frame with an north-west-up axes centered at the provided origin to the provided ellipsoid's fixed reference frame. The local axes are defined as: The x axis points in the local north direction. The y axis points in the local west direction. The z axis points in the direction of the ellipsoid surface normal which passes through the position.

Parameters:

origin - The center point of the local reference frame.

ellipsoid - The ellipsoid whose fixed frame is used in the transformation. Default: Ellipsoid.WGS84()

result - The object onto which to store the result.

Returns:

The modified result parameter or a new Matrix4 instance if none was provided.

localFrameToFixedFrameGenerator

@JsMethod
public static Transforms.LocalFrameToFixedFrame localFrameToFixedFrameGenerator(String firstAxis,
                                                                                          String secondAxis)

Generates a function that computes a 4x4 transformation matrix from a reference frame centered at the provided origin to the provided ellipsoid's fixed reference frame.

Parameters:

firstAxis - name of the first axis of the local reference frame. Must be 'east', 'north', 'up', 'west', 'south' or 'down'.

secondAxis - name of the second axis of the local reference frame. Must be 'east', 'north', 'up', 'west', 'south' or 'down'.

Returns:

The function that will computes a 4x4 transformation matrix from a reference frame, with first axis and second axis compliant with the parameters,

pointToWindowCoordinates

@JsMethod
public static Cartesian2 pointToWindowCoordinates(Matrix4 modelViewProjectionMatrix,
                                                            Matrix4 viewportTransformation,
                                                            Cartesian3 point)

Transform a point from model coordinates to window coordinates.

Parameters:

modelViewProjectionMatrix - The 4x4 model-view-projection matrix.

viewportTransformation - The 4x4 viewport transformation.

point - The point to transform.

Returns:

The modified result parameter or a new Cartesian2 instance if none was provided.

pointToWindowCoordinates

@JsMethod
public static Cartesian2 pointToWindowCoordinates(Matrix4 modelViewProjectionMatrix,
                                                            Matrix4 viewportTransformation,
                                                            Cartesian3 point,
                                                            Cartesian2 result)

Transform a point from model coordinates to window coordinates.

Parameters:

modelViewProjectionMatrix - The 4x4 model-view-projection matrix.

viewportTransformation - The 4x4 viewport transformation.

point - The point to transform.

result - The object onto which to store the result.

Returns:

The modified result parameter or a new Cartesian2 instance if none was provided.

preloadIcrfFixed

@JsMethod
public static Promise<Void,Void> preloadIcrfFixed(TimeInterval timeInterval)

Preloads the data necessary to transform between the ICRF and Fixed axes, in either direction, over a given interval. This function returns a promise that, when resolved, indicates that the preload has completed.

Parameters:

timeInterval - The interval to preload.

Returns:

A promise that, when resolved, indicates that the preload has completed and evaluation of the transformation between the fixed and ICRF axes will no longer return undefined for a time inside the interval.

See Also:

computeIcrfToFixedMatrix(org.cesiumjs.cs.core.JulianDate), computeFixedToIcrfMatrix(org.cesiumjs.cs.core.JulianDate)