Program Listing for File ray.hxx

↰ Return to documentation for file (src/acme/ray.hxx)

/*
 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 *                                                                     *
 * The ACME project                                                    *
 *                                                                     *
 * Copyright (c) 2020, Davide Stocco and Enrico Bertolazzi.            *
 *                                                                     *
 * The ACME project and its components are supplied under the terms of *
 * the open source BSD 2-Clause License. The contents of the ACME      *
 * project and its components may not be copied or disclosed except in *
 * accordance with the terms of the BSD 2-Clause License.              *
 *                                                                     *
 * URL: https://opensource.org/licenses/BSD-2-Clause                   *
 *                                                                     *
 *    Davide Stocco                                                    *
 *    Department of Industrial Engineering                             *
 *    University of Trento                                             *
 *    e-mail: davide.stocco@unitn.it                                   *
 *                                                                     *
 *    Enrico Bertolazzi                                                *
 *    Department of Industrial Engineering                             *
 *    University of Trento                                             *
 *    e-mail: enrico.bertolazzi@unitn.it                               *
 *                                                                     *
 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
*/


#pragma once
#ifndef INCLUDE_ACME_RAY_HXX
#define INCLUDE_ACME_RAY_HXX

#include "point.hxx"

namespace acme
{

  /*\
   |
   |   _ __ __ _ _   _
   |  | '__/ _` | | | |
   |  | | | (_| | |_| |
   |  |_|  \__,_|\__, |
   |             |___/
  \*/


  class ray : public entity
  {
  private:
    point m_origin    = NAN_POINT;
    vec3  m_direction = NAN_VEC3;

  public:
    ray(ray const &) = default;

    ray(ray &&) = default;

    ray & operator=(const ray &) = default;

    ray & operator=(ray &&) = default;

    ~ray(void) override = default;

    ray(void);

    ray(
      real origin_x,
      real origin_y,
      real origin_z,
      real direction_x,
      real direction_y,
      real direction_z
    );

    ray(
      point const & origin,
      vec3  const & direction
    );

    bool
    isApprox(
      ray const & ray_in,
      real        tolerance = EPSILON
    ) const;

    point const &
    origin(void)
    const;

    vec3 const &
    direction(void)
    const;

    point &
    origin(void);

    vec3 &
    direction(void);

    void
    normalize(void);

    vec3
    toVector(void)
    const;

    vec3
    toUnitVector(void)
    const;

    void
    reverse(void);

    void
    translate(
      vec3 const & vector
    ) override;

    void
    transform(
      affine const & affine_in
    ) override;

    bool
    isInside(
      point const & point_in,
      real          tolerance = EPSILON
    ) const;

    bool
    isDegenerated(
      real tolerance = EPSILON
    ) const override;

    inline
    integer
    level(void)
      const override
    {
      return integer(4);
    }

    inline
    std::string
    type(void)
      const override
    {
      return "ray";
    }

    inline
    bool
    isNone(void)
      const override
    {
      return false;
    }

    inline
    bool
    isPoint(void)
      const override
    {
      return false;
    }

    inline
    bool
    isLine(void)
      const override
    {
      return false;
    }

    inline
    bool
    isRay(void)
      const override
    {
      return true;
    }

    inline
    bool
    isPlane(void)
      const override
    {
      return false;
    }

    inline
    bool
    isSegment(void)
      const override
    {
      return false;
    }

    inline
    bool
    isTriangle(void)
      const override
    {
      return false;
    }

    inline
    bool
    isDisk(void)
      const override
    {
      return false;
    }

    inline
    bool
    isBall(void)
      const override
    {
      return false;
    }

    inline
    bool
    isClampable(void)
      const override
    {
      return false;
    }

    inline
    bool
    isNonClampable(void)
      const override
    {
      return true;
    }

    bool
    clamp(
      vec3 & min,
      vec3 & max
    ) const override;

    bool
    clamp(
      real & min_x,
      real & min_y,
      real & min_z,
      real & max_x,
      real & max_y,
      real & max_z
    ) const override;

  }; // class ray

  static ray const & NAN_RAY   = * new ray(NAN_POINT, NAN_VEC3);
  static ray       & DUMMY_RAY = * new ray(NAN_POINT, NAN_VEC3);

} // namespace acme

#endif