初始提交: UE5.3项目基础框架

Plugins/CesiumForUnreal/Source/ThirdParty/include/CesiumGeospatial/SimplePlanarEllipsoidCurve.h

@@ -0,0 +1,102 @@
+#pragma once
+
+#include "Library.h"
+
+#include <CesiumGeospatial/Ellipsoid.h>
+
+#include <glm/vec3.hpp>
+
+#include <optional>
+
+namespace CesiumGeospatial {
+
+/**
+ * @brief Produces points on an ellipse that lies on a plane that intersects the
+ * center of the earth and each of the input coordinates. The height above the
+ * surface at each point along the curve will be a linear interpolation between
+ * the source and destination heights.
+ */
+class CESIUMGEOSPATIAL_API SimplePlanarEllipsoidCurve final {
+public:
+  /**
+   * @brief Creates a new instance of {@link SimplePlanarEllipsoidCurve} from a
+   * source and destination specified in Earth-Centered, Earth-Fixed
+   * coordinates.
+   *
+   * @param ellipsoid The ellipsoid that the source and destination positions
+   * are relative to.
+   * @param sourceEcef The position that the path will begin at in ECEF
+   * coordinates.
+   * @param destinationEcef The position that the path will end at in ECEF
+   * coordinates.
+   *
+   * @returns An optional type containing a {@link SimplePlanarEllipsoidCurve}
+   * object representing the generated path, if possible. If it wasn't possible
+   * to scale the input coordinates to geodetic surface coordinates on a WGS84
+   * ellipsoid, this will return `std::nullopt` instead.
+   */
+  static std::optional<SimplePlanarEllipsoidCurve>
+  fromEarthCenteredEarthFixedCoordinates(
+      const Ellipsoid& ellipsoid,
+      const glm::dvec3& sourceEcef,
+      const glm::dvec3& destinationEcef);
+
+  /**
+   * @brief Creates a new instance of {@link SimplePlanarEllipsoidCurve} from a
+   * source and destination specified in cartographic coordinates (Longitude,
+   * Latitude, and Height).
+   *
+   * @param ellipsoid The ellipsoid that these cartographic coordinates are
+   * from.
+   * @param source The position that the path will begin at in Longitude,
+   * Latitude, and Height.
+   * @param destination The position that the path will end at in Longitude,
+   * Latitude, and Height.
+   *
+   * @returns An optional type containing a {@link SimplePlanarEllipsoidCurve}
+   * object representing the generated path, if possible. If it wasn't possible
+   * to scale the input coordinates to geodetic surface coordinates on a WGS84
+   * ellipsoid, this will return std::nullopt instead.
+   */
+  static std::optional<SimplePlanarEllipsoidCurve> fromLongitudeLatitudeHeight(
+      const Ellipsoid& ellipsoid,
+      const Cartographic& source,
+      const Cartographic& destination);
+
+  /**
+   * @brief Samples the curve at the given percentage of its length.
+   *
+   * @param percentage The percentage of the curve's length to sample at,
+   * where 0 is the beginning and 1 is the end. This value will be clamped to
+   * the range [0..1].
+   * @param additionalHeight The height above the earth at this position will be
+   * calculated by interpolating between the height at the beginning and end of
+   * the curve based on the value of \p percentage. This parameter specifies an
+   * additional offset to add to the height.
+   *
+   * @returns The position of the given point on this curve in Earth-Centered
+   * Earth-Fixed coordinates.
+   */
+  glm::dvec3
+  getPosition(double percentage, double additionalHeight = 0.0) const;
+
+private:
+  SimplePlanarEllipsoidCurve(
+      const Ellipsoid& ellipsoid,
+      const glm::dvec3& scaledSourceEcef,
+      const glm::dvec3& scaledDestinationEcef,
+      const glm::dvec3& originalSourceEcef,
+      const glm::dvec3& originalDestinationEcef);
+
+  double _totalAngle;
+  double _sourceHeight;
+  double _destinationHeight;
+
+  Ellipsoid _ellipsoid;
+  glm::dvec3 _sourceDirection;
+  glm::dvec3 _rotationAxis;
+  glm::dvec3 _sourceEcef;
+  glm::dvec3 _destinationEcef;
+};
+
+} // namespace CesiumGeospatial