#pragma region CPL License
/*
Nuclex Native Framework
Copyright (C) 2002-2015 Nuclex Development Labs

This library is free software; you can redistribute it and/or
modify it under the terms of the IBM Common Public License as
published by the IBM Corporation; either version 1.0 of the
License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
IBM Common Public License for more details.

You should have received a copy of the IBM Common Public
License along with this library
*/
#pragma endregion // CPL License

#ifndef NUCLEX_GEOMETRY_LINES_LINE2_H
#define NUCLEX_GEOMETRY_LINES_LINE2_H

#include "Nuclex/Geometry/Config.h"
#include "Nuclex/Geometry/Point2.h"
#include "Nuclex/Geometry/Vector2.h"

namespace Nuclex { namespace Geometry { namespace Lines {

  // ------------------------------------------------------------------------------------------- //

  /// <summary>2D line defined by an offset point and a direction</summary>
  template <typename TScalar>
  struct Line2 {
  
    /// <summary>Constructs an uninitialized line</summary>
    public: Line2() {}

    /// <summary>Initializes a line from a line segment</summary>
    public: static Line2 FromSegment(const Point2<TScalar> &start, const Point2<TScalar> &end) {
      return Line2(start, Vector2<TScalar>::Normalize(end - start));
    }

    /// <summary>Initializes a line using the specified coordinates</summary>
    /// <param name="origin">Offset point at which the line starts</param>
    /// <param name="direction">Direction into which the ray extends</param>
    public: Line2(const Point2<TScalar> &origin, const Vector2<TScalar> &direction) :
      Origin(origin), Direction(direction) {}

    /// <summary>Offsets the entire line by the specified amount</summary>
    /// <param name="offsetX">Amount the line will be offset on the X axis</param>
    /// <param name="offsetY">Amount the line will be offset on the Y axis</param>
    public: void ShiftBy(TScalar offsetX, TScalar offsetY) {
      this->Origin.X += offsetX;
      this->Origin.Y += offsetY;
    }

    /// <summary>Offsets the entire line by the specified amount</summary>
    /// <param name="offset">Amount the line will be offset</param>
    public: void ShiftBy(const Vector2<TScalar> &offset) {
      this->Origin += offset;
    }

    /// <summary>Coordinates at which the line begins</summary>
    /// <remarks>
    ///   Theoretically, the distance of the line from the coordinate system's center
    ///   would suffice, but this would complicate many calculations (as you need to
    ///   find the line's orthogonal direction first) and eliminate relative intersection
    ///   intervals which can otherwise be made use of by ray and line segment tests.
    /// </remarks>
    public: Point2<TScalar> Origin;
    /// <summary>Direction into which the line entends</summary>
    public: Vector2<TScalar> Direction;

  };

  // ------------------------------------------------------------------------------------------- //

}}} // namespace Nuclex::Geometry::Lines

#endif // NUCLEX_GEOMETRY_LINES_LINE2_H