File indexing completed on 2024-12-01 04:28:05

 /*
     SPDX-FileCopyrightText: 2011 Till Theato <root@ttill.de>
     SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-KDE-Accepted-GPL
 */
 
 #pragma once
 
 #include <QPointF>
 
 /** @class BPoint
  *  @brief Represents a point in a cubic Bézier spline.
  */
 class BPoint
 {
 public:
     enum class PointType { H1 = 0, P = 1, H2 = 2 };
     /** @brief Sets the point to -1, -1 to mark it as unusable (until point + handles have proper values) */
     BPoint();
     /** @brief Sets up according to the params. Linking detecting is done using autoSetLinked(). */
     BPoint(const QPointF &handle1, const QPointF &point, const QPointF &handle2);
 
     bool operator==(const BPoint &point) const;
     /** @brief Returns h1 if i = 0, p if i = 1, h2 if i = 2. */
     QPointF &operator[](int i);
     /** @brief Returns h1 if i = 0, p if i = 1, h2 if i = 2. */
     const QPointF &operator[](int i) const;
 
     /** @brief Sets p to @param point.
      * @param updateHandles (default = true) Whether to make sure the handles keep their position relative to p. */
     void setP(const QPointF &point, bool updateHandles = true);
 
     /** @brief Sets h1 to @param handle1.
      *
      * If handlesLinked is true h2 is updated. */
     void setH1(const QPointF &handle1);
 
     /** @brief Sets h2 to @param handle2.
      * If handlesLinked is true h1 is updated. */
     void setH2(const QPointF &handle2);
 
     /** @brief Sets handlesLinked to true if the handles are in a linked state (line through h1, p, h2) otherwise to false. */
     void autoSetLinked();
 
     /** @brief Toggles the link of the handles to @param linked*/
     void setHandlesLinked(bool linked);
 
     /** handle 1 */
     QPointF h1;
     /** point */
     QPointF p;
     /** handle 2 */
     QPointF h2;
     /** handles are linked to achieve a natural locking spline => PH1 = -r*PH2 ; a line can be drawn through h1, p, h2 */
     bool handlesLinked{true};
 };