package org.opentrafficsim.road.network;
   
   import org.djunits.value.vdouble.scalar.Length;
   import org.djutils.draw.curve.OffsetCurve2d;
   import org.djutils.draw.curve.Straight2d;
   import org.djutils.draw.function.ContinuousPiecewiseLinearFunction;
   import org.djutils.draw.line.PolyLine2d;
   import org.djutils.draw.line.Polygon2d;
   import org.djutils.draw.point.Point2d;
  import org.opentrafficsim.road.network.speed.LaneSpeedLimits;
  
  /**
   * This class is an extension (conceptually, not an actual java extension) of {@code OtsGeometryUtil}. This utility has access
   * to classes that are specific to the ots-road project, and required to define geometry of objects in this context.
   * <p>
   * Copyright (c) 2023-2026 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved. <br>
   * BSD-style license. See <a href="https://opentrafficsim.org/docs/license.html">OpenTrafficSim License</a>.
   * </p>
   * @author Alexander Verbraeck
   * @author Peter Knoppers
   * @author Wouter Schakel
   */
  public final class LaneGeometryUtil
  {
  
      /**
       * Utility class.
       */
      private LaneGeometryUtil()
      {
          //
      }
  
      /**
       * Returns the contour based on left and right edge.
       * @param leftEdge left edge, in design line direction
       * @param rightEdge right edge, in design line direction
       * @return a closed loop of both edges.
       */
      public static Polygon2d getContour(final PolyLine2d leftEdge, final PolyLine2d rightEdge)
      {
          Point2d[] points = new Point2d[leftEdge.size() + rightEdge.size()];
          System.arraycopy(leftEdge.getPointList().toArray(), 0, points, 0, leftEdge.size());
          System.arraycopy(rightEdge.reverse().getPointList().toArray(), 0, points, leftEdge.size(), rightEdge.size());
          return new Polygon2d(1e-3, points);
      }
  
      /**
       * Creates a simple straight lane. This method exists to create lanes for simple tests.
       * @param link link
       * @param id id
       * @param offset end offset
       * @param width end width
       * @param laneType lane type
       * @param speedLimits speed limits
       * @return lane
       */
      public static Lane createStraightLane(final CrossSectionLink link, final String id, final Length offset, final Length width,
              final LaneType laneType, final LaneSpeedLimits speedLimits)
      {
          return createStraightLane(link, id, offset, offset, width, width, laneType, speedLimits);
      }
  
      /**
       * Creates a simple straight lane. This method exists to create lanes for simple tests.
       * @param link link
       * @param id id
       * @param startOffset start offset
       * @param endOffset end offset
       * @param startWidth start width
       * @param endWidth end width
       * @param laneType lane type
       * @param speedLimits speed limits
       * @return lane
       */
      public static Lane createStraightLane(final CrossSectionLink link, final String id, final Length startOffset,
              final Length endOffset, final Length startWidth, final Length endWidth, final LaneType laneType,
              final LaneSpeedLimits speedLimits)
      {
          ContinuousPiecewiseLinearFunction offset = ContinuousPiecewiseLinearFunction.of(0.0, startOffset.si, 1.0, endOffset.si);
          ContinuousPiecewiseLinearFunction width = ContinuousPiecewiseLinearFunction.of(0.0, startWidth.si, 1.0, endWidth.si);
          return createStraightLane(link, id, offset, width, laneType, speedLimits);
      }
  
      /**
       * Creates a simple straight lane. This method exists to create lanes for simple tests.
       * @param link link
       * @param id id
       * @param offset offset information
       * @param width offset information
       * @param laneType lane type
       * @param speedLimits speed limits
       * @return lane
       */
      public static Lane createStraightLane(final CrossSectionLink link, final String id,
              final ContinuousPiecewiseLinearFunction offset, final ContinuousPiecewiseLinearFunction width,
              final LaneType laneType, final LaneSpeedLimits speedLimits)
      {
          OffsetCurve2d designLine = new Straight2d(link.getDesignLine().getLocationFraction(0.0), link.getLength().si);
         return new Lane(link, id, CrossSectionGeometry.of(designLine, null, offset, width), laneType, speedLimits);
     }
 
     /**
      * Creates a simple straight lane. This method exists to create lanes for simple tests.
      * @param type stripe data
      * @param id id
      * @param link link
      * @param offset end offset
      * @param width end width
      * @return lane
      */
     public static Stripe createStraightStripe(final StripeData type, final String id, final CrossSectionLink link,
             final Length offset, final Length width)
     {
         OffsetCurve2d designLine = new Straight2d(link.getDesignLine().getLocationFraction(0.0), link.getLength().si);
         ContinuousPiecewiseLinearFunction offsetFunc = ContinuousPiecewiseLinearFunction.of(0.0, offset.si, 1.0, offset.si);
         ContinuousPiecewiseLinearFunction widthFunc = ContinuousPiecewiseLinearFunction.of(0.0, width.si, 1.0, width.si);
         return new Stripe(id, type, link, CrossSectionGeometry.of(designLine, null, offsetFunc, widthFunc));
     }
 
     /**
      * Creates a simple straight shoulder. This method exists to create shoulders for simple tests.
      * @param link link
      * @param id id
      * @param startOffset start offset
      * @param endOffset end offset
      * @param startWidth start width
      * @param endWidth end width
      * @param laneType lane type
      * @return lane
      */
     public static Object createStraightShoulder(final CrossSectionLink link, final String id, final Length startOffset,
             final Length endOffset, final Length startWidth, final Length endWidth, final LaneType laneType)
     {
         OffsetCurve2d designLine = new Straight2d(link.getDesignLine().getLocationFraction(0.0), link.getLength().si);
         ContinuousPiecewiseLinearFunction offset = ContinuousPiecewiseLinearFunction.of(0.0, startOffset.si, 1.0, endOffset.si);
         ContinuousPiecewiseLinearFunction width = ContinuousPiecewiseLinearFunction.of(0.0, startWidth.si, 1.0, endWidth.si);
         return new Shoulder(link, id, CrossSectionGeometry.of(designLine, null, offset, width), laneType);
     }
 }