triangle.h

Go to the documentation of this file.

/* Author(s) :    Francois Mauger <mauger@lpccaen.in2p3.fr>
 * Creation date: 2015-02-18
 * Last modified: 2015-02-18
 *
 * License:
 *
 * Description:
 *
 *   A triangle in 3D space
 *
 * History:
 *
 */

#ifndef GEOMTOOLS_TRIANGLE_H
#define GEOMTOOLS_TRIANGLE_H 1

// Standard library:
#include <string>

// This project:
#include <geomtools/i_shape_2d.h>
#include <geomtools/i_polygon.h>

namespace geomtools {

  class triangle : public i_shape_2d,
                   public i_polygon
  {

  public:

    static const std::string & triangle_label();

    bool is_valid() const;

    virtual double get_perimeter(uint32_t flags_ = ALL_PIECES) const;

    virtual double get_surface(uint32_t flags_ = ALL_PIECES) const;

    static bool check_alignement(const geomtools::vector_3d & v0_,
                                 const geomtools::vector_3d & v1_,
                                 const geomtools::vector_3d & v2_,
                                 double tolerance_ = 0.0);

    void set_vertexes(const vector_3d & p0_, const vector_3d & p1_, const vector_3d & p2_);

    void set_vertexes_ext(const vector_3d & p0_, const vector_3d & p1_, const vector_3d & p2_);

    bool has_vertex_0_ext() const;

    bool has_vertex_1_ext() const;

    bool has_vertex_2_ext() const;

    const vector_3d & get_vertex_0() const;

    const vector_3d & get_vertex_1() const;

    const vector_3d & get_vertex_2() const;

    const vector_3d & get_vertex(int) const;

    triangle();

    triangle(const vector_3d & p0_, const vector_3d & p1_, const vector_3d & p2_);

    virtual ~triangle();

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

    void reset();

    virtual std::string get_shape_name() const;

    virtual bool is_on_surface(const vector_3d &,
                               double tolerance_ = GEOMTOOLS_PROPER_TOLERANCE) const;

    virtual vector_3d get_normal_on_surface(const vector_3d & position_,
                                            bool check_ = false,
                                            double skin_ = GEOMTOOLS_PROPER_TOLERANCE) const;

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

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

    void compute_proper_frame(vector_3d & u0_, vector_3d & u1_, vector_3d & u2_) const;

    bool compute_proper_frame_coordinates(const vector_3d & position_, double & xp_, double & yp_, double & zp_) const;


    enum triangle_wires_rendering_option_type {
      WR_TRIANGLE_NO_FIRST_EDGE     = (WR_BASE_LAST << 1),             
      WR_TRIANGLE_NO_SECOND_EDGE    = (WR_BASE_LAST << 2),             
      WR_TRIANGLE_NO_THIRD_EDGE     = (WR_BASE_LAST << 3),             
      WR_TRIANGLE_NO_EXTERNAL_EDGES = (WR_TRIANGLE_NO_FIRST_EDGE
                                       | WR_TRIANGLE_NO_SECOND_EDGE
                                       | WR_TRIANGLE_NO_THIRD_EDGE
                                       ),                              
      WR_TRIANGLE_LAST              = (WR_TRIANGLE_NO_THIRD_EDGE),     
      WR_TRIANGLE_MASK              = (WR_TRIANGLE_NO_FIRST_EDGE
                                       | WR_TRIANGLE_NO_SECOND_EDGE
                                       | WR_TRIANGLE_NO_THIRD_EDGE
                                       )                               
    };

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

    virtual unsigned int compute_vertexes(vertex_col_type & vertexes_) const;

  protected:

    void _set_defaults();

  private:

    const vector_3d * _vertex_0_ext_; 
    const vector_3d * _vertex_1_ext_; 
    const vector_3d * _vertex_2_ext_; 
    vector_3d _vertex_0_; 
    vector_3d _vertex_1_; 
    vector_3d _vertex_2_; 

    // Registration interface :
    GEOMTOOLS_OBJECT_3D_REGISTRATION_INTERFACE(triangle)

  };

} // end of namespace geomtools

#endif // GEOMTOOLS_TRIANGLE_H

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