You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
81 lines
2.4 KiB
JavaScript
81 lines
2.4 KiB
JavaScript
import Cartesian3 from "./Cartesian3.js";
|
|
import Check from "./Check.js";
|
|
import defaultValue from "./defaultValue.js";
|
|
import defined from "./defined.js";
|
|
|
|
/**
|
|
* Represents a ray that extends infinitely from the provided origin in the provided direction.
|
|
* @alias Ray
|
|
* @constructor
|
|
*
|
|
* @param {Cartesian3} [origin=Cartesian3.ZERO] The origin of the ray.
|
|
* @param {Cartesian3} [direction=Cartesian3.ZERO] The direction of the ray.
|
|
*/
|
|
function Ray(origin, direction) {
|
|
direction = Cartesian3.clone(defaultValue(direction, Cartesian3.ZERO));
|
|
if (!Cartesian3.equals(direction, Cartesian3.ZERO)) {
|
|
Cartesian3.normalize(direction, direction);
|
|
}
|
|
|
|
/**
|
|
* The origin of the ray.
|
|
* @type {Cartesian3}
|
|
* @default {@link Cartesian3.ZERO}
|
|
*/
|
|
this.origin = Cartesian3.clone(defaultValue(origin, Cartesian3.ZERO));
|
|
|
|
/**
|
|
* The direction of the ray.
|
|
* @type {Cartesian3}
|
|
*/
|
|
this.direction = direction;
|
|
}
|
|
|
|
/**
|
|
* Duplicates a Ray instance.
|
|
*
|
|
* @param {Ray} ray The ray to duplicate.
|
|
* @param {Ray} [result] The object onto which to store the result.
|
|
* @returns {Ray} The modified result parameter or a new Ray instance if one was not provided. (Returns undefined if ray is undefined)
|
|
*/
|
|
Ray.clone = function (ray, result) {
|
|
if (!defined(ray)) {
|
|
return undefined;
|
|
}
|
|
if (!defined(result)) {
|
|
return new Ray(ray.origin, ray.direction);
|
|
}
|
|
result.origin = Cartesian3.clone(ray.origin);
|
|
result.direction = Cartesian3.clone(ray.direction);
|
|
return result;
|
|
};
|
|
|
|
/**
|
|
* Computes the point along the ray given by r(t) = o + t*d,
|
|
* where o is the origin of the ray and d is the direction.
|
|
*
|
|
* @param {Ray} ray The ray.
|
|
* @param {Number} t A scalar value.
|
|
* @param {Cartesian3} [result] The object in which the result will be stored.
|
|
* @returns {Cartesian3} The modified result parameter, or a new instance if none was provided.
|
|
*
|
|
* @example
|
|
* //Get the first intersection point of a ray and an ellipsoid.
|
|
* var intersection = Cesium.IntersectionTests.rayEllipsoid(ray, ellipsoid);
|
|
* var point = Cesium.Ray.getPoint(ray, intersection.start);
|
|
*/
|
|
Ray.getPoint = function (ray, t, result) {
|
|
//>>includeStart('debug', pragmas.debug);
|
|
Check.typeOf.object("ray", ray);
|
|
Check.typeOf.number("t", t);
|
|
//>>includeEnd('debug');
|
|
|
|
if (!defined(result)) {
|
|
result = new Cartesian3();
|
|
}
|
|
|
|
result = Cartesian3.multiplyByScalar(ray.direction, t, result);
|
|
return Cartesian3.add(ray.origin, result, result);
|
|
};
|
|
export default Ray;
|