G4QuadrangularFacet.hh

Go to the documentation of this file.

//
// ********************************************************************
// * License and Disclaimer                                           *
// *                                                                  *
// * The  Geant4 software  is  copyright of the Copyright Holders  of *
// * the Geant4 Collaboration.  It is provided  under  the terms  and *
// * conditions of the Geant4 Software License,  included in the file *
// * LICENSE and available at  http://cern.ch/geant4/license .  These *
// * include a list of copyright holders.                             *
// *                                                                  *
// * Neither the authors of this software system, nor their employing *
// * institutes,nor the agencies providing financial support for this *
// * work  make  any representation or  warranty, express or implied, *
// * regarding  this  software system or assume any liability for its *
// * use.  Please see the license in the file  LICENSE  and URL above *
// * for the full disclaimer and the limitation of liability.         *
// *                                                                  *
// * This  code  implementation is the result of  the  scientific and *
// * technical work of the GEANT4 collaboration and of QinetiQ Ltd,   *
// * subject to DEFCON 705 IPR conditions.                            *
// * By using,  copying,  modifying or  distributing the software (or *
// * any work based  on the software)  you  agree  to acknowledge its *
// * use  in  resulting  scientific  publications,  and indicate your *
// * acceptance of all terms of the Geant4 Software license.          *
// ********************************************************************
//
// G4QuadrangularFacet
//
// Class description:
//
// The G4QuadrangularFacet class is used for the contruction of
// G4TessellatedSolid.
// It is defined by four fVertices, which shall be in the same plane and be
// supplied in anti-clockwise order looking from the outsider of the solid
// where it belongs. Its constructor:
//   
//   G4QuadrangularFacet (const G4ThreeVector& Pt0, const G4ThreeVector& vt1,
//                        const G4ThreeVector& vt2, const G4ThreeVector& vt3,
//                        G4FacetVertexType);
//
// takes 5 parameters to define the four fVertices:
//   1) G4FacetvertexType = "ABSOLUTE": in this case Pt0, vt1, vt2 and vt3
//      are the four fVertices required in anti-clockwise order when looking
//      from the outsider.
//   2) G4FacetvertexType = "RELATIVE": in this case the first vertex is Pt0,
//      the second vertex is Pt0+vt1, the third vertex is Pt0+vt2 and 
//      the fourth vertex is Pt0+vt3, in anti-clockwise order when looking 
//      from the outsider.
 
// Author: P.R.Truscott (QinetiQ Ltd, UK), 31.10.2004 - Created
//         M.Gayer (CERN), 12.10.2012 - Reviewed optimised implementation
// --------------------------------------------------------------------
#ifndef G4QUADRANGULARFACET_HH
#define G4QUADRANGULARFACET_HH
 
#include "G4VFacet.hh"
#include "G4Types.hh"
#include "G4ThreeVector.hh"
#include "G4TriangularFacet.hh"
 
/**
 * @brief G4QuadrangularFacet defines a facet with 4 vertices, used for the
 * contruction of G4TessellatedSolid. Vertices shall be in the same plane and
 * be supplied in anti-clockwise order looking from the outsider of the solid
 * where it belongs.
 */
 
class G4QuadrangularFacet : public G4VFacet
{
  public:
 
    /**
     * Constructs a facet with 4 vertices, given its parameters.
     *  @param[in] Pt0 The anchor point, first vertex.
     *  @param[in] vt1 Second vertex.
     *  @param[in] vt2 Third vertex.
     *  @param[in] vt3 Fourth vertex.
     *  @param[in] vType The positioning type for the vertices, either:
     *             "ABSOLUTE" - vertices set in anti-clockwise order
     *                          when looking from the outsider.
     *             "RELATIVE" - first vertex is Pt0, second is Pt0+vt1,
     *                          third vertex is Pt0+vt2 and fourth is Pt0+vt3,
     *                          still in anti-clockwise order.
     */
    G4QuadrangularFacet (const G4ThreeVector& Pt0, const G4ThreeVector& vt1,
                         const G4ThreeVector& vt2, const G4ThreeVector& vt3,
                               G4FacetVertexType vType);
 
    /**
     * Default Destructor.
     */
    ~G4QuadrangularFacet () override = default;
 
    /**
     * Copy constructor and assignment operator.
     */
    G4QuadrangularFacet (const G4QuadrangularFacet& right);
    G4QuadrangularFacet& operator=(const G4QuadrangularFacet& right);    
 
    /**
     * Returns a pointer to a newly allocated duplicate copy of the facet.
     */
    G4VFacet* GetClone () override;
 
    /**
     * Determines the vector between p and the closest point on the facet to p.
     */
    G4ThreeVector Distance (const G4ThreeVector& p);
 
    /**
     * Determines the closest distance between point p and the facet.
     */
    G4double Distance (const G4ThreeVector& p, G4double minDist) override;
 
    /**
     * Determines the distance to point 'p'. kInfinity is returned if either:
     * (1) outgoing is TRUE and the dot product of the normal vector to the
     * facet and the displacement vector from p to the triangle is negative.
     * (2) outgoing is FALSE and the dot product of the normal vector to the
     * facet and the displacement vector from p to the triangle is positive.
     */
    G4double Distance (const G4ThreeVector& p, G4double minDist,
                       const G4bool outgoing) override;
 
    /**
     * Calculates the furthest the quadrangle extends in fA particular
     * direction defined by the vector axis.
     */
    G4double Extent (const G4ThreeVector axis) override;
 
    /**
     * Finds the next intersection when going from 'p' in the direction of 'v'.
     * If 'outgoing' is true, only consider the face if we are going out
     * through the face; otherwise, if false, only consider the face if we are
     * going in through the face.
     *  @returns true if there is an intersection, false otherwise.
     */
    G4bool Intersect  (const G4ThreeVector& p, const G4ThreeVector& v,
                       const G4bool outgoing, G4double& distance,
                             G4double& distFromSurface,
                             G4ThreeVector& normal) override;
    /**
     * Returns the normal vector to the face.
     */
    G4ThreeVector GetSurfaceNormal () const override;
 
    /**
     * Auxiliary method for returning the surface area.
     */
    G4double GetArea () const override;
 
    /**
     * Auxiliary method to get a uniform random point on the facet.
     */
    G4ThreeVector GetPointOnFace () const override;
 
    /**
     * Returns the type ID, "G4QuadrangularFacet" of the facet.
     */
    G4GeometryType GetEntityType () const override;
 
    /**
     * Returns true if the facet is defined.
     */
    inline G4bool IsDefined () const override;
 
    /**
     * Returns the number of vertices, i.e. 4.
     */
    inline G4int GetNumberOfVertices () const override;
 
    /**
     * Returns the vertex based on the index 'i'.
     */
    inline G4ThreeVector GetVertex (G4int i) const override;
 
    /**
     * Methods to set the vertices.
     */
    inline void SetVertex (G4int i, const G4ThreeVector& val) override;
    inline void SetVertices(std::vector<G4ThreeVector>* v) override;
 
    /**
     * Returns the radius to the anchor point and centered on the circumcentre.
     */
    inline G4double GetRadius () const override;
 
    /**
     * Returns the circumcentre point of the facet.
     */
    inline G4ThreeVector GetCircumcentre () const override;
 
  private:
 
    /**
     * Private accessor/setter for the vertex index.
     */
    inline G4int GetVertexIndex (G4int i) const override;
    inline void SetVertexIndex (G4int i, G4int val) override;
 
    /**
     * Returns the allocated memory (sizeof) by the facet.
     */
    inline G4int AllocatedMemory() override;
 
  private:
 
    G4double fRadius = 0.0;
 
    G4ThreeVector fCircumcentre;
 
    G4TriangularFacet fFacet1, fFacet2;
};
 
// --------------------------------------------------------------------
// Inline Methods
// --------------------------------------------------------------------
 
#include "G4QuadrangularFacet.icc"
 
#endif