GiAbstractClipBoundary.h

Go to the documentation of this file.

 
// Copyright (C) 2002-2022, Open Design Alliance (the "Alliance"). 
// All rights reserved. 
// 
// This software and its documentation and related materials are owned by 
// the Alliance. The software may only be incorporated into application 
// programs owned by members of the Alliance, subject to a signed 
// Membership Agreement and Supplemental Software License Agreement with the
// Alliance. The structure and organization of this software are the valuable  
// trade secrets of the Alliance and its suppliers. The software is also 
// protected by copyright law and international treaty provisions. Application  
// programs incorporating this software must include the following statement 
// with their copyright notices:
//   
//   This application incorporates Open Design Alliance software pursuant to a license 
//   agreement with Open Design Alliance.
//   Open Design Alliance Copyright (C) 2002-2022 by Open Design Alliance. 
//   All rights reserved.
//
// By use of this software, its documentation or related materials, you 
// acknowledge and accept the above terms.
 
#ifndef _GI_ABSTRACT_CLIP_BOUNDARY_H_INCLUDED_
#define _GI_ABSTRACT_CLIP_BOUNDARY_H_INCLUDED_
 
#include "TD_PackPush.h"
 
#include "GiClipBoundary.h"
#include "GiSectionGeometryOutput.h"
#include "IntArray.h"
 
class OdGiAbstractClipBoundary
{
  public:
    enum BoundaryType
    {
      kNormal = 0, // Default clip boundary (not pass additional data, clip outside contour)
      kInverted,   // Inverted clip boundary (pass inverted clip array, clip inside contour)
      kExtended,   // Extended clip boundary (pass clipping contours, clip by sorted contours array)
      kComplex,    // Complex clip boundary (extended clip boundary which requires additional preprocessing)
      kPlanar,     // Planar clip boundary (clipping by set of 3d planes with ability to output geometry sections)
      kMulti       // Container for multiple clip boundaries (provides way to set multiple boundaries by single call)
    };
  public:
    ODRX_HEAP_OPERATORS();
 
    OdGiAbstractClipBoundary() { }
 
    virtual ~OdGiAbstractClipBoundary() { }
 
    virtual BoundaryType type() const { return kNormal; }
 
    virtual OdGiAbstractClipBoundary *clone() const { return new OdGiAbstractClipBoundary(); }
};
 
class OdGiInvertedClipBoundary : public OdGiAbstractClipBoundary
{
  protected:
    OdGePoint2dArray m_Points; // Array of points that defines the inverted clip boundary.
  public:
    OdGiInvertedClipBoundary() { }
 
    ~OdGiInvertedClipBoundary() { }
 
    BoundaryType type() const { return kInverted; }
 
    const OdGePoint2dArray &invertedClipBoundary() const { return m_Points; }
    void setInvertedClipBoundary(const OdGePoint2dArray &pPoints) { m_Points = pPoints; }
 
    OdGiAbstractClipBoundary *clone() const {
      OdGiInvertedClipBoundary *pNew = new OdGiInvertedClipBoundary();
      pNew->setInvertedClipBoundary(invertedClipBoundary());
      return pNew;
    }
};
 
class OdGiExtendedClipBoundary : public OdGiAbstractClipBoundary
{
  protected:
    OdIntArray       m_Counts; // Array of contour points counts.
    OdGePoint2dArray m_Points; // Array of points that defines the extended clip boundary contours.
  public:
    OdGiExtendedClipBoundary() { }
 
    ~OdGiExtendedClipBoundary() { }
 
    BoundaryType type() const { return kExtended; }
 
    const OdIntArray &clipBoundaryCounts() const { return m_Counts; }
    void setClipBoundaryCounts(const OdIntArray &pCounts) { m_Counts = pCounts; }
 
    const OdGePoint2dArray &clipBoundaryPoints() const { return m_Points; }
    void setClipBoundaryPoints(const OdGePoint2dArray &pPoints) { m_Points = pPoints; }
 
    OdGiAbstractClipBoundary *clone() const { return copyExtendedData(new OdGiExtendedClipBoundary()); }
  protected:
    OdGiAbstractClipBoundary *copyExtendedData(OdGiExtendedClipBoundary *pNew) const {
      pNew->setClipBoundaryCounts(clipBoundaryCounts());
      pNew->setClipBoundaryPoints(clipBoundaryPoints());
      return pNew;
    }
};
 
class OdGiComplexClipBoundary : public OdGiExtendedClipBoundary
{
  public:
    OdGiComplexClipBoundary() { }
 
    ~OdGiComplexClipBoundary() { }
 
    BoundaryType type() const { return kComplex; }
 
    OdGiAbstractClipBoundary *clone() const { return copyExtendedData(new OdGiComplexClipBoundary()); }
};
 
class OdGiPlanarClipBoundary : public OdGiAbstractClipBoundary
{
  public:
    struct ClipPlane
    {
      OdGePoint3d m_origin;
      OdGeVector3d m_normal;
 
      ClipPlane() {}
 
      ClipPlane(const OdGePoint3d &origin, const OdGeVector3d &normal)
        : m_origin(origin), m_normal(normal) {}
 
      ClipPlane &setOrigin(const OdGePoint3d &origin) { m_origin = origin; return *this; }
 
      const OdGePoint3d &origin() const { return m_origin; }
 
      ClipPlane &setNormal(const OdGeVector3d &normal) { m_normal = normal; return *this; }
 
      const OdGeVector3d &normal() const { return m_normal; }
    };
    typedef OdArray<ClipPlane> ClipPlaneArray;
  protected:
    ClipPlaneArray                       m_ClipPlanes;     // Array of clipping planes.
    mutable OdGiSectionGeometryOutputPtr m_pSectionOutput; // Optional geometry sections output.
    mutable OdGiCuttedGeometryOutputPtr  m_pCuttedOutput;  // Optional cutted geometry output.
  public:
    OdGiPlanarClipBoundary() { }
 
    ~OdGiPlanarClipBoundary() { }
 
    BoundaryType type() const { return kPlanar; }
 
    const ClipPlaneArray &clipPlanes() const { return m_ClipPlanes; }
    void setClipPlanes(const ClipPlaneArray &pClipPlanes) { m_ClipPlanes = pClipPlanes; }
 
    OdGiSectionGeometryOutput *sectionGeometryOutput() const { return m_pSectionOutput; }
    void setSectionGeometryOutput(OdGiSectionGeometryOutput *pSectionOutput) { m_pSectionOutput = pSectionOutput; }
 
    OdGiCuttedGeometryOutput *cuttedGeometryOutput() const { return m_pCuttedOutput; }
    void setCuttedGeometryOutput(OdGiCuttedGeometryOutput *pCuttedOutput) { m_pCuttedOutput = pCuttedOutput; }
 
    OdGiAbstractClipBoundary *clone() const {
      OdGiPlanarClipBoundary *pNew = new OdGiPlanarClipBoundary();
      pNew->setClipPlanes(clipPlanes());
      pNew->setSectionGeometryOutput(sectionGeometryOutput());
      pNew->setCuttedGeometryOutput(cuttedGeometryOutput());
      return pNew;
    }
};
 
class OdGiMultiClipBoundary : public OdGiAbstractClipBoundary
{
  public:
    typedef OdArray<OdGiAbstractClipBoundary*, OdMemoryAllocator<OdGiAbstractClipBoundary*> > AbstractClipBoundaryArray;
  protected:
    AbstractClipBoundaryArray m_ClipBoundaries; // Array of clip boundaries
  public:
    OdGiMultiClipBoundary() { }
 
    ~OdGiMultiClipBoundary() { }
 
    BoundaryType type() const { return kMulti; }
 
    const AbstractClipBoundaryArray &clipBoundaries() const { return m_ClipBoundaries; }
    void setClipBoundaries(const AbstractClipBoundaryArray &pClipBoundaries) { m_ClipBoundaries = pClipBoundaries; }
 
    OdGiAbstractClipBoundary *clone() const;
};
 
class OdGiMultiClipBoundaryClone : public OdGiMultiClipBoundary
{
  private:
    // Disable ability to set clip boundaries from ouside
    void setClipBoundaries(const AbstractClipBoundaryArray & /*pClipBoundaries*/) { ODA_FAIL(); }
  protected:
    void clearClonesArray()
    { const OdUInt32 nClones = m_ClipBoundaries.size();
      OdGiAbstractClipBoundary* const *pClone = m_ClipBoundaries.getPtr();
      for (OdUInt32 nClone = 0; nClone < nClones; nClone++)
        delete pClone[nClone];
    }
  public:
    OdGiMultiClipBoundaryClone(AbstractClipBoundaryArray &arrayOfClones)
    { OdGiMultiClipBoundary::setClipBoundaries(arrayOfClones); }
 
    ~OdGiMultiClipBoundaryClone() { clearClonesArray(); }
};
 
inline OdGiAbstractClipBoundary *OdGiMultiClipBoundary::clone() const
{ const OdUInt32 nBoundaries = m_ClipBoundaries.size();
  AbstractClipBoundaryArray absClones(nBoundaries, 1);
  absClones.resize(nBoundaries);
  OdGiAbstractClipBoundary* const *pBoundaries = m_ClipBoundaries.getPtr();
  OdGiAbstractClipBoundary **pClones = absClones.asArrayPtr();
  for (OdUInt32 nClone = 0; nClone < nBoundaries; nClone++)
  {
    if (pBoundaries[nClone])
      pClones[nClone] = pBoundaries[nClone]->clone();
    else
      pClones[nClone] = NULL;
  }
  return new OdGiMultiClipBoundaryClone(absClones);
}
 
struct OdGiClipBoundaryWithAbstractData : public OdGiClipBoundary
{
  OdGiAbstractClipBoundary *m_pAbstractData;
 
  OdGiClipBoundaryWithAbstractData() : m_pAbstractData(NULL) { }
 
  OdGiClipBoundaryWithAbstractData(const OdGiClipBoundary &pBoundary, const OdGiAbstractClipBoundary *pAbsData = NULL)
    : OdGiClipBoundary(pBoundary), m_pAbstractData(NULL)
  {
    if (pAbsData) m_pAbstractData = pAbsData->clone();
  }
 
  OdGiClipBoundaryWithAbstractData(const OdGiClipBoundaryWithAbstractData &pBoundary)
    : OdGiClipBoundary(pBoundary), m_pAbstractData(NULL)
  {
    if (pBoundary.m_pAbstractData) m_pAbstractData = pBoundary.m_pAbstractData->clone();
  }
 
  ~OdGiClipBoundaryWithAbstractData() {
    if (m_pAbstractData) delete m_pAbstractData;
  }
};
 
#include "TD_PackPop.h"
 
#endif // _GI_ABSTRACT_CLIP_BOUNDARY_H_INCLUDED_