Press n or j to go to the next uncovered block, b, p or k for the previous block.
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 | 1652x 1652x 1x 1651x 1651x 1651x 1651x 1651x 1651x 1651x | import Frozen from "./Frozen.js";
import defined from "./defined.js";
import DeveloperError from "./DeveloperError.js";
import Matrix4 from "./Matrix4.js";
/**
* Geometry instancing allows one {@link Geometry} object to be positions in several
* different locations and colored uniquely. For example, one {@link BoxGeometry} can
* be instanced several times, each with a different <code>modelMatrix</code> to change
* its position, rotation, and scale.
*
* @alias GeometryInstance
* @constructor
*
* @param {object} options Object with the following properties:
* @param {Geometry|GeometryFactory} options.geometry The geometry to instance.
* @param {Matrix4} [options.modelMatrix=Matrix4.IDENTITY] The model matrix that transforms to transform the geometry from model to world coordinates.
* @param {object} [options.id] A user-defined object to return when the instance is picked with {@link Scene#pick} or get/set per-instance attributes with {@link Primitive#getGeometryInstanceAttributes}.
* @param {object} [options.attributes] Per-instance attributes like a show or color attribute shown in the example below.
*
*
* @example
* // Create geometry for a box, and two instances that refer to it.
* // One instance positions the box on the bottom and colored aqua.
* // The other instance positions the box on the top and color white.
* const geometry = Cesium.BoxGeometry.fromDimensions({
* vertexFormat : Cesium.VertexFormat.POSITION_AND_NORMAL,
* dimensions : new Cesium.Cartesian3(1000000.0, 1000000.0, 500000.0)
* });
* const instanceBottom = new Cesium.GeometryInstance({
* geometry : geometry,
* modelMatrix : Cesium.Matrix4.multiplyByTranslation(Cesium.Transforms.eastNorthUpToFixedFrame(
* Cesium.Cartesian3.fromDegrees(-75.59777, 40.03883)), new Cesium.Cartesian3(0.0, 0.0, 1000000.0), new Cesium.Matrix4()),
* attributes : {
* color : Cesium.ColorGeometryInstanceAttribute.fromColor(Cesium.Color.AQUA)
* },
* id : 'bottom'
* });
* const instanceTop = new Cesium.GeometryInstance({
* geometry : geometry,
* modelMatrix : Cesium.Matrix4.multiplyByTranslation(Cesium.Transforms.eastNorthUpToFixedFrame(
* Cesium.Cartesian3.fromDegrees(-75.59777, 40.03883)), new Cesium.Cartesian3(0.0, 0.0, 3000000.0), new Cesium.Matrix4()),
* attributes : {
* color : Cesium.ColorGeometryInstanceAttribute.fromColor(Cesium.Color.AQUA)
* },
* id : 'top'
* });
*
* @see Geometry
*/
function GeometryInstance(options) {
options = options ?? Frozen.EMPTY_OBJECT;
//>>includeStart('debug', pragmas.debug);
if (!defined(options.geometry)) {
throw new DeveloperError("options.geometry is required.");
}
//>>includeEnd('debug');
/**
* The geometry being instanced.
*
* @type Geometry
*
*/
this.geometry = options.geometry;
/**
* The 4x4 transformation matrix that transforms the geometry from model to world coordinates.
* When this is the identity matrix, the geometry is drawn in world coordinates, i.e., Earth's WGS84 coordinates.
* Local reference frames can be used by providing a different transformation matrix, like that returned
* by {@link Transforms.eastNorthUpToFixedFrame}.
*
* @type Matrix4
*
* @default Matrix4.IDENTITY
*/
this.modelMatrix = Matrix4.clone(options.modelMatrix ?? Matrix4.IDENTITY);
/**
* User-defined object returned when the instance is picked or used to get/set per-instance attributes.
*
* @type {object|undefined}
*
* @default undefined
*
* @see Scene#pick
* @see Primitive#getGeometryInstanceAttributes
*/
this.id = options.id;
/**
* Used for picking primitives that wrap geometry instances.
*
* @private
*/
this.pickPrimitive = options.pickPrimitive;
/**
* Per-instance attributes like {@link ColorGeometryInstanceAttribute} or {@link ShowGeometryInstanceAttribute}.
* {@link Geometry} attributes varying per vertex; these attributes are constant for the entire instance.
*
* @type {object}
*
* @default {}
*/
this.attributes = options.attributes ?? {};
/**
* @private
*/
this.westHemisphereGeometry = undefined;
/**
* @private
*/
this.eastHemisphereGeometry = undefined;
}
export default GeometryInstance;
|