right_circular_conical_frustrum.h

Go to the documentation of this file.

/* Author(s) :    Francois Mauger <mauger@lpccaen.in2p3.fr>
 * Creation date: 2015-03-15
 * Last modified: 2015-03-15
 *
 * License:
 *
 * Description:
 *
 *   Right circular conical frustrum
 *
 */

#ifndef GEOMTOOLS_RIGHT_CIRCULAR_CONICAL_FRUSTRUM_H
#define GEOMTOOLS_RIGHT_CIRCULAR_CONICAL_FRUSTRUM_H 1

// This project:
#include <geomtools/cone.h>
#include <geomtools/i_shape_3d.h>
#include <geomtools/i_stackable.h>
#include <geomtools/angular_range.h>

namespace geomtools {

  // Class forward declarations:
  class disk;
  class triangle;
  class quadrangle;
  class right_circular_conical_nappe;

  class right_circular_conical_frustrum : public i_shape_3d,
                                          public i_stackable
  {
  public:

    enum faces_mask_type {
      FACE_NONE       = face_identifier::FACE_BITS_NONE,
      FACE_OUTER_SIDE = datatools::bit_mask::bit00,
      FACE_BOTTOM     = datatools::bit_mask::bit01,
      FACE_TOP        = datatools::bit_mask::bit02,
      FACE_INNER_SIDE = datatools::bit_mask::bit03,
      FACE_START_ANGLE = datatools::bit_mask::bit04,
      FACE_STOP_ANGLE = datatools::bit_mask::bit05,
      FACE_ALL        = (FACE_OUTER_SIDE
                         | FACE_BOTTOM
                         | FACE_TOP
                         | FACE_INNER_SIDE
                         | FACE_START_ANGLE
                         | FACE_STOP_ANGLE)
    };

    enum volumes_mask_type {
      VOLUME_NONE   = 0,
      VOLUME_BULK   = datatools::bit_mask::bit00,
      VOLUME_CAVITY = datatools::bit_mask::bit01
    };

    static const std::string & rccf_label();

    virtual std::string get_shape_name() const;

    bool is_valid() const;

    double get_xmin () const;

    double get_xmax () const;

    double get_ymin () const;

    double get_ymax () const;

    double get_zmin () const;

    double get_zmax () const;

    void set_z(double);

    double get_z() const;

    bool has_top_face() const;

    bool has_bottom_face() const;

    bool has_inner_face() const;

    bool has_inner_bottom_radius() const;

    void set_inner_bottom_radius(double);

    double get_inner_bottom_radius() const;

    void set_outer_bottom_radius(double);

    double get_outer_bottom_radius() const;

    bool has_inner_top_radius() const;

    void set_inner_top_radius(double);

    double get_inner_top_radius() const;

    void set_outer_top_radius(double);

    double get_outer_top_radius() const;

    const angular_range & get_angle_domain() const;

    bool has_partial_angle() const;

    bool has_start_angle() const;

    void set_start_angle(double);

    double get_start_angle() const;

    bool has_delta_angle() const;

    void set_delta_angle(double);

    double get_delta_angle() const;

    right_circular_conical_frustrum();

    right_circular_conical_frustrum(double inner_bottom_radius_,
                                    double outer_bottom_radius_,
                                    double inner_top_radius_,
                                    double outer_top_radius_,
                                    double z_);

    right_circular_conical_frustrum(double inner_bottom_radius_,
                                    double outer_bottom_radius_,
                                    double inner_top_radius_,
                                    double outer_top_radius_,
                                    double z_,
                                    double start_angle_,
                                    double delta_angle_);

    virtual ~right_circular_conical_frustrum();

    virtual void tree_dump (std::ostream & out_         = std::clog,
                            const std::string & title_  = "",
                            const std::string & indent_ = "",
                            bool inherit_          = false) const;

    void compute_inner_face(right_circular_conical_nappe & in_) const;

    void compute_outer_face(right_circular_conical_nappe & on_) const;

    void compute_top_face(disk & top_disk_, placement &) const;

    void compute_bottom_face(disk & bottom_disk_, placement &) const;

    enum ssaf_type {
      SSAF_INVALID              = 0, 
      SSAF_QUADRANGLE           = 1, 
      SSAF_TRIANGLE_BOTTOM_BASE = 2, 
      SSAF_TRIANGLE_TOP_BASE    = 3  
    };

    void compute_start_stop_angle_face(quadrangle & qface_, triangle & tface_) const;

    ssaf_type get_start_stop_angle_face_type() const;

    bool start_stop_angle_face_is_triangle_bottom() const;

    bool start_stop_angle_face_is_triangle_top() const;

    bool start_stop_angle_face_is_triangle() const;

    bool start_stop_angle_face_is_quadrangle() const;

    void compute_start_angle_face(quadrangle & qface_, triangle & tface_, placement &) const;

    void compute_stop_angle_face(quadrangle & qface_, triangle & tface_, placement &) const;

    virtual unsigned int compute_faces(face_info_collection_type &) const;

    virtual double get_surface(uint32_t mask_ = FACE_ALL) const;

    virtual double get_volume(uint32_t flags_ = VOLUME_BULK) const;

    virtual bool is_inside (const vector_3d &,
                            double skin_ = GEOMTOOLS_PROPER_TOLERANCE) const;

    virtual bool is_outside (const vector_3d &,
                             double skin_ = GEOMTOOLS_PROPER_TOLERANCE) const;

    virtual face_identifier on_surface(const vector_3d &,
                                       const face_identifier & a_surface_mask = face_identifier::face_bits_any(),
                                       double a_skin = GEOMTOOLS_PROPER_TOLERANCE) const;

    virtual vector_3d get_normal_on_surface (const vector_3d & position_,
                                             const face_identifier & ) const;

    virtual bool find_intercept(const vector_3d & from_,
                                const vector_3d & direction_,
                                face_intercept_info & intercept_,
                                double skin_ = GEOMTOOLS_PROPER_TOLERANCE) const;

    virtual void initialize(const datatools::properties &, const handle_dict_type * = 0);

    virtual void reset();

    enum rccf_wires_rendering_option_type {
      WR_RCCF_NO_BOTTOM_FACE      = (WR_BASE_LAST << 1),           
      WR_RCCF_NO_TOP_FACE         = (WR_BASE_LAST << 2),           
      WR_RCCF_NO_INNER_FACE       = (WR_BASE_LAST << 3),           
      WR_RCCF_NO_OUTER_FACE       = (WR_BASE_LAST << 4),           
      WR_RCCF_NO_START_ANGLE_FACE = (WR_BASE_LAST << 5),           
      WR_RCCF_NO_STOP_ANGLE_FACE  = (WR_BASE_LAST << 6),           
      WR_RCCF_LAST                = (WR_RCCF_NO_STOP_ANGLE_FACE),  
      WR_RCCF_MASK                = (WR_RCCF_NO_BOTTOM_FACE
                                     | WR_RCCF_NO_TOP_FACE
                                     | WR_RCCF_NO_INNER_FACE
                                     | WR_RCCF_NO_OUTER_FACE
                                     | WR_RCCF_NO_START_ANGLE_FACE
                                     | WR_RCCF_NO_STOP_ANGLE_FACE) 
    };

    virtual void generate_wires_self(wires_type & wires_,
                                     uint32_t options_ = 0) const;

  protected:

    void _set_defaults();

    virtual void _build_bounding_data();

  private:

    double _inner_bottom_radius_; 
    double _outer_bottom_radius_; 
    double _inner_top_radius_;    
    double _outer_top_radius_;    
    double _z_;                   
    angular_range _angle_domain_; 

    // Registration interface :
    GEOMTOOLS_OBJECT_3D_REGISTRATION_INTERFACE(right_circular_conical_frustrum)

  };

  typedef right_circular_conical_frustrum conical_frustrum;

} // end of namespace geomtools

#endif // GEOMTOOLS_RIGHT_CIRCULAR_CONICAL_FRUSTRUM_H

/*
** Local Variables: --
** mode: c++ --
** c-file-style: "gnu" --
** tab-width: 2 --
** End: --
*/