Triangle3D.h

Go to the documentation of this file.

/**
 *  \file IMP/algebra/Triangle3D.h
 *  \brief Represent a triangle in 3D
 *
 *  Copyright 2007-2026 IMP Inventors. All rights reserved.
 */

#ifndef IMPALGEBRA_TRIANGLE_3D_H
#define IMPALGEBRA_TRIANGLE_3D_H

#include "Vector3D.h"
#include "Transformation3D.h"
#include "ReferenceFrame3D.h"
#include <IMP/GeometricPrimitiveD.h>
#include <iostream>
#include <cereal/access.hpp>
#include "constants.h"

IMPALGEBRA_BEGIN_NAMESPACE

//! Represent a triangle in 3D
/** \geometry */
class IMPALGEBRAEXPORT Triangle3D : public GeometricPrimitiveD<3> {
 public:
  Triangle3D() {}
  //! The passed points must not be colinear
  Triangle3D(const Vector3D &p1, const Vector3D &p2, const Vector3D &p3);
  //! Get the start=0/end=1 point of the segment
  const Vector3D &get_point(unsigned int i) const {
    IMP_USAGE_CHECK(i < 3, "invalid point index");
    return p_[i];
  }
  IMP_SHOWABLE_INLINE(Triangle3D, out << "(" << p_[0] << ", " << p_[1] << ", "
                                      << p_[2] << ")");
  Floats get_edge_lengths() const;

private:
  Vector3D p_[3];

  friend class cereal::access;

  template<class Archive> void serialize(Archive &ar) {
    ar(p_[0], p_[1], p_[2]);
  }
};

IMP_VALUES(Triangle3D, Triangle3Ds);

//! Return the largest triangle defined by 3 points from the input
/** \see Triangle3D */
IMPALGEBRAEXPORT Triangle3D get_largest_triangle(const Vector3Ds &points);

//! Return a transformation between two triangles
IMPALGEBRAEXPORT Transformation3D
    get_transformation_from_first_triangle_to_second(Triangle3D first_tri,
                                                     Triangle3D second_tri);
//! Return true if the three points are co-linear
IMPALGEBRAEXPORT bool get_are_colinear(const Vector3D &p1, const Vector3D &p2,
                                       const Vector3D &p3);

IMPALGEBRA_END_NAMESPACE

#endif /* IMPALGEBRA_TRIANGLE_3D_H */