createCircleGeometry.js 8.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213
  1. define(['./Matrix3-41c58dde', './Check-6ede7e26', './defaultValue-fe22d8c0', './EllipseGeometry-37014da4', './VertexFormat-030f11ff', './Math-0a2ac845', './Transforms-bc45e707', './Matrix2-e1298525', './RuntimeError-ef395448', './combine-d9581036', './ComponentDatatype-cf1fa08e', './WebGLConstants-0b1ce7ba', './EllipseGeometryLibrary-92ab6b1e', './GeometryAttribute-a466e9c7', './GeometryAttributes-ad136444', './GeometryInstance-34d9e21e', './GeometryOffsetAttribute-9ad0019c', './GeometryPipeline-dcf79306', './AttributeCompression-f9f6c717', './EncodedCartesian3-57415c8a', './IndexDatatype-2643aa47', './IntersectionTests-88c49b2e', './Plane-4c3d403b'], (function (Matrix3, Check, defaultValue, EllipseGeometry, VertexFormat, Math, Transforms, Matrix2, RuntimeError, combine, ComponentDatatype, WebGLConstants, EllipseGeometryLibrary, GeometryAttribute, GeometryAttributes, GeometryInstance, GeometryOffsetAttribute, GeometryPipeline, AttributeCompression, EncodedCartesian3, IndexDatatype, IntersectionTests, Plane) { 'use strict';
  2. /**
  3. * A description of a circle on the ellipsoid. Circle geometry can be rendered with both {@link Primitive} and {@link GroundPrimitive}.
  4. *
  5. * @alias CircleGeometry
  6. * @constructor
  7. *
  8. * @param {object} options Object with the following properties:
  9. * @param {Cartesian3} options.center The circle's center point in the fixed frame.
  10. * @param {number} options.radius The radius in meters.
  11. * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.WGS84] The ellipsoid the circle will be on.
  12. * @param {number} [options.height=0.0] The distance in meters between the circle and the ellipsoid surface.
  13. * @param {number} [options.granularity=0.02] The angular distance between points on the circle in radians.
  14. * @param {VertexFormat} [options.vertexFormat=VertexFormat.DEFAULT] The vertex attributes to be computed.
  15. * @param {number} [options.extrudedHeight=0.0] The distance in meters between the circle's extruded face and the ellipsoid surface.
  16. * @param {number} [options.stRotation=0.0] The rotation of the texture coordinates, in radians. A positive rotation is counter-clockwise.
  17. *
  18. * @exception {DeveloperError} radius must be greater than zero.
  19. * @exception {DeveloperError} granularity must be greater than zero.
  20. *
  21. * @see CircleGeometry.createGeometry
  22. * @see Packable
  23. *
  24. * @example
  25. * // Create a circle.
  26. * const circle = new Cesium.CircleGeometry({
  27. * center : Cesium.Cartesian3.fromDegrees(-75.59777, 40.03883),
  28. * radius : 100000.0
  29. * });
  30. * const geometry = Cesium.CircleGeometry.createGeometry(circle);
  31. */
  32. function CircleGeometry(options) {
  33. options = defaultValue.defaultValue(options, defaultValue.defaultValue.EMPTY_OBJECT);
  34. const radius = options.radius;
  35. //>>includeStart('debug', pragmas.debug);
  36. Check.Check.typeOf.number("radius", radius);
  37. //>>includeEnd('debug');
  38. const ellipseGeometryOptions = {
  39. center: options.center,
  40. semiMajorAxis: radius,
  41. semiMinorAxis: radius,
  42. ellipsoid: options.ellipsoid,
  43. height: options.height,
  44. extrudedHeight: options.extrudedHeight,
  45. granularity: options.granularity,
  46. vertexFormat: options.vertexFormat,
  47. stRotation: options.stRotation,
  48. shadowVolume: options.shadowVolume,
  49. };
  50. this._ellipseGeometry = new EllipseGeometry.EllipseGeometry(ellipseGeometryOptions);
  51. this._workerName = "createCircleGeometry";
  52. }
  53. /**
  54. * The number of elements used to pack the object into an array.
  55. * @type {number}
  56. */
  57. CircleGeometry.packedLength = EllipseGeometry.EllipseGeometry.packedLength;
  58. /**
  59. * Stores the provided instance into the provided array.
  60. *
  61. * @param {CircleGeometry} value The value to pack.
  62. * @param {number[]} array The array to pack into.
  63. * @param {number} [startingIndex=0] The index into the array at which to start packing the elements.
  64. *
  65. * @returns {number[]} The array that was packed into
  66. */
  67. CircleGeometry.pack = function (value, array, startingIndex) {
  68. //>>includeStart('debug', pragmas.debug);
  69. Check.Check.typeOf.object("value", value);
  70. //>>includeEnd('debug');
  71. return EllipseGeometry.EllipseGeometry.pack(value._ellipseGeometry, array, startingIndex);
  72. };
  73. const scratchEllipseGeometry = new EllipseGeometry.EllipseGeometry({
  74. center: new Matrix3.Cartesian3(),
  75. semiMajorAxis: 1.0,
  76. semiMinorAxis: 1.0,
  77. });
  78. const scratchOptions = {
  79. center: new Matrix3.Cartesian3(),
  80. radius: undefined,
  81. ellipsoid: Matrix3.Ellipsoid.clone(Matrix3.Ellipsoid.UNIT_SPHERE),
  82. height: undefined,
  83. extrudedHeight: undefined,
  84. granularity: undefined,
  85. vertexFormat: new VertexFormat.VertexFormat(),
  86. stRotation: undefined,
  87. semiMajorAxis: undefined,
  88. semiMinorAxis: undefined,
  89. shadowVolume: undefined,
  90. };
  91. /**
  92. * Retrieves an instance from a packed array.
  93. *
  94. * @param {number[]} array The packed array.
  95. * @param {number} [startingIndex=0] The starting index of the element to be unpacked.
  96. * @param {CircleGeometry} [result] The object into which to store the result.
  97. * @returns {CircleGeometry} The modified result parameter or a new CircleGeometry instance if one was not provided.
  98. */
  99. CircleGeometry.unpack = function (array, startingIndex, result) {
  100. const ellipseGeometry = EllipseGeometry.EllipseGeometry.unpack(
  101. array,
  102. startingIndex,
  103. scratchEllipseGeometry
  104. );
  105. scratchOptions.center = Matrix3.Cartesian3.clone(
  106. ellipseGeometry._center,
  107. scratchOptions.center
  108. );
  109. scratchOptions.ellipsoid = Matrix3.Ellipsoid.clone(
  110. ellipseGeometry._ellipsoid,
  111. scratchOptions.ellipsoid
  112. );
  113. scratchOptions.height = ellipseGeometry._height;
  114. scratchOptions.extrudedHeight = ellipseGeometry._extrudedHeight;
  115. scratchOptions.granularity = ellipseGeometry._granularity;
  116. scratchOptions.vertexFormat = VertexFormat.VertexFormat.clone(
  117. ellipseGeometry._vertexFormat,
  118. scratchOptions.vertexFormat
  119. );
  120. scratchOptions.stRotation = ellipseGeometry._stRotation;
  121. scratchOptions.shadowVolume = ellipseGeometry._shadowVolume;
  122. if (!defaultValue.defined(result)) {
  123. scratchOptions.radius = ellipseGeometry._semiMajorAxis;
  124. return new CircleGeometry(scratchOptions);
  125. }
  126. scratchOptions.semiMajorAxis = ellipseGeometry._semiMajorAxis;
  127. scratchOptions.semiMinorAxis = ellipseGeometry._semiMinorAxis;
  128. result._ellipseGeometry = new EllipseGeometry.EllipseGeometry(scratchOptions);
  129. return result;
  130. };
  131. /**
  132. * Computes the geometric representation of a circle on an ellipsoid, including its vertices, indices, and a bounding sphere.
  133. *
  134. * @param {CircleGeometry} circleGeometry A description of the circle.
  135. * @returns {Geometry|undefined} The computed vertices and indices.
  136. */
  137. CircleGeometry.createGeometry = function (circleGeometry) {
  138. return EllipseGeometry.EllipseGeometry.createGeometry(circleGeometry._ellipseGeometry);
  139. };
  140. /**
  141. * @private
  142. */
  143. CircleGeometry.createShadowVolume = function (
  144. circleGeometry,
  145. minHeightFunc,
  146. maxHeightFunc
  147. ) {
  148. const granularity = circleGeometry._ellipseGeometry._granularity;
  149. const ellipsoid = circleGeometry._ellipseGeometry._ellipsoid;
  150. const minHeight = minHeightFunc(granularity, ellipsoid);
  151. const maxHeight = maxHeightFunc(granularity, ellipsoid);
  152. return new CircleGeometry({
  153. center: circleGeometry._ellipseGeometry._center,
  154. radius: circleGeometry._ellipseGeometry._semiMajorAxis,
  155. ellipsoid: ellipsoid,
  156. stRotation: circleGeometry._ellipseGeometry._stRotation,
  157. granularity: granularity,
  158. extrudedHeight: minHeight,
  159. height: maxHeight,
  160. vertexFormat: VertexFormat.VertexFormat.POSITION_ONLY,
  161. shadowVolume: true,
  162. });
  163. };
  164. Object.defineProperties(CircleGeometry.prototype, {
  165. /**
  166. * @private
  167. */
  168. rectangle: {
  169. get: function () {
  170. return this._ellipseGeometry.rectangle;
  171. },
  172. },
  173. /**
  174. * For remapping texture coordinates when rendering CircleGeometries as GroundPrimitives.
  175. * @private
  176. */
  177. textureCoordinateRotationPoints: {
  178. get: function () {
  179. return this._ellipseGeometry.textureCoordinateRotationPoints;
  180. },
  181. },
  182. });
  183. function createCircleGeometry(circleGeometry, offset) {
  184. if (defaultValue.defined(offset)) {
  185. circleGeometry = CircleGeometry.unpack(circleGeometry, offset);
  186. }
  187. circleGeometry._ellipseGeometry._center = Matrix3.Cartesian3.clone(
  188. circleGeometry._ellipseGeometry._center
  189. );
  190. circleGeometry._ellipseGeometry._ellipsoid = Matrix3.Ellipsoid.clone(
  191. circleGeometry._ellipseGeometry._ellipsoid
  192. );
  193. return CircleGeometry.createGeometry(circleGeometry);
  194. }
  195. return createCircleGeometry;
  196. }));