#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_VOLUMES_GENERATORS_CYLINDER3GENERATOR_H
#define NUCLEX_GEOMETRY_VOLUMES_GENERATORS_CYLINDER3GENERATOR_H

#include "Nuclex/Geometry/Config.h"
#include "Nuclex/Geometry/Volumes/Box3.h"
#include "Nuclex/Geometry/Volumes/Sphere3.h"
#include "Nuclex/Geometry/Volumes/Cylinder3.h"

namespace Nuclex { namespace Geometry { namespace Volumes { namespace Generators {

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

  /// <summary>Point and volume generation methods for 3D cylinders</summary>
  template <typename TScalar>
  class Cylinder3Generator {

    /// <summary>Generates a random point within a cylinder</summary>
    /// <param name="cylinder">Cylinder in which a random point will be generated</param>
    /// <param name="random">Random number generator that will be used</param>
    /// <returns>A random point inside the cylinder</returns>
    public: template <typename TRandomNumberEngine> Point3<TScalar>
    static GetRandomPointInside(const Cylinder3<TScalar> &cylinder, TRandomNumberEngine &random) {

    }

    /// <summary>Generates a random point on the hull of a cylinder</summary>
    /// <param name="cylinder">Cylinder on which a random point will be generated</param>
    /// <param name="random">Random number generator that will be used</param>
    /// <returns>A random point on the hull of the cylinder</returns>
    public: template <typename TRandomNumberEngine> Point3<TScalar>
    static GetRandomPointOnHull(const Cylinder3<TScalar> &cylinder, TRandomNumberEngine &random) {
    }

    /// <summary>Returns the closest point to another point within the cylinder</summary>
    /// <param name="cylinder">Cylinder within which the closest point will be determined</param>
    /// <param name="point">Point to which the closest point will be determined</param>
    /// <returns>The closest point within the cylinder to the provided point</returns>
    public: static Point3<TScalar> GetClosestPointInside(
      const Cylinder3<TScalar> &cylinder, const Point3<TScalar> &point
    ) {
    }

    /// <summary>Returns the closest point to another point on the cylinder's hull</summary>
    /// <param name="cylinder">Cylinder on whose hull the closest point will be determined</param>
    /// <param name="point">Point to which the closest point will be determined</param>
    /// <returns>The closest point on the cylinder's hull to the provided point</returns>
    public: static Point3<TScalar> GetClosestPointOnHull(
      const Cylinder3<TScalar> &cylinder, const Point3<TScalar> &point
    ) {
    }

    /// <summary>Calculates the bounding box of the specified cylinder</summary>
    /// <param name="cylinder">Cylinder of which the bounding box will be calculated</param>
    /// <returns>The bounding box of the specified cylinder</returns>
    public: static Box3<TScalar> GetBoundingBox(const Cylinder3<TScalar> &cylinder) {
      return Box3<TScalar>::FromMinAndMax(
        cylinder.Center.X - cylinder.Radius,
        cylinder.Center.Y - cylinder.Radius,
        cylinder.Center.Z - cylinder.Height,
        cylinder.Center.X + cylinder.Radius,
        cylinder.Center.Y + cylinder.Radius,
        cylinder.Center.Z + cylinder.Height
      );
    }

    /// <summary>Calculates the bounding sphere of the specified cylinder</summary>
    /// <param name="cylinder">Cylinder of which the bounding sphere will be calculated</param>
    /// <returns>The bounding sphere of the specified cylinder</returns>
    public: static Box3<TScalar> GetBoundingSphere(const Cylinder3<TScalar> &cylinder) {
      TScalar radius = Math<TScalar>::SquareRoot(
        (cylinder.Height * cylinder.Height) + (cylinder.Radius * cylinder.Radius)
      );
      return Sphere3<TScalar>(cylinder.Center, radius);
    }

  };

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

}}}} // namespace Nuclex::Geometry::Volumes::Generators

#endif // NUCLEX_GEOMETRY_VOLUMES_GENERATORS_CYLINDER3GENERATOR_H