FacetOptions.h

Go to the documentation of this file.

/*--------------------------------------------------------------------------------------+
|
|   Supplied under applicable software license agreement.
|
|   Copyright (c) 2018 Bentley Systems, Incorporated. All rights reserved.
|
+---------------------------------------------------------------------------------------*/
#pragma once

//#include <Bentley/RefCounted.h>
//#include <Bentley/NonCopyableClass.h>
//#include <Bentley/bvector.h>
BEGIN_BENTLEY_GEOMETRY_NAMESPACE

enum FacetParamMode
{
FACET_PARAM_01BothAxes    = 0,
FACET_PARAM_01LargerAxis  = 1,
FACET_PARAM_Distance = 2
};



typedef RefCountedPtr<IFacetOptions>  IFacetOptionsPtr;


struct IFacetOptions : public RefCountedBase
{
private:
    virtual void MakeClassAbstract() = 0;
public:
public:

GEOMDLLIMPEXP void SetChordTolerance (double chordTolerance);
GEOMDLLIMPEXP double GetChordTolerance () const;

GEOMDLLIMPEXP void SetMaxFacetWidth (double maxWidth);
GEOMDLLIMPEXP double GetMaxFacetWidth () const;

GEOMDLLIMPEXP void SetMaxEdgeLength (double maxEdgeLength);
GEOMDLLIMPEXP double GetMaxEdgeLength () const;

GEOMDLLIMPEXP void SetAngleTolerance (double normalAngleTolerance);
GEOMDLLIMPEXP double GetAngleTolerance () const;

GEOMDLLIMPEXP void SetMaxPerBezier (int maxPerBezier);
GEOMDLLIMPEXP int GetMaxPerBezier () const;

GEOMDLLIMPEXP void SetMinPerBezier (int minPerBezier);
GEOMDLLIMPEXP int GetMinPerBezier () const;

GEOMDLLIMPEXP void SetMaxPerFace (int maxPerFace);
GEOMDLLIMPEXP int GetMaxPerFace () const;

GEOMDLLIMPEXP void SetEdgeHiding (bool edgeHiding);
GEOMDLLIMPEXP bool GetEdgeHiding () const;

GEOMDLLIMPEXP void SetNormalsRequired (bool normalsRequired);
GEOMDLLIMPEXP bool GetNormalsRequired () const;

GEOMDLLIMPEXP void SetParamsRequired (bool paramsRequired);
GEOMDLLIMPEXP bool GetParamsRequired () const;

GEOMDLLIMPEXP void SetEdgeChainsRequired (bool edgeChainsRequired);
GEOMDLLIMPEXP bool GetEdgeChainsRequired () const;

GEOMDLLIMPEXP void SetSmoothTriangleFlowRequired (bool value);
GEOMDLLIMPEXP bool GetSmoothTriangleFlowRequired () const;

GEOMDLLIMPEXP void SetBSurfSmoothTriangleFlowRequired (bool value);
GEOMDLLIMPEXP bool GetBSurfSmoothTriangleFlowRequired () const;

GEOMDLLIMPEXP void SetDoSpatialLaplaceSmoothing (bool value);
GEOMDLLIMPEXP bool GetDoSpatialLaplaceSmoothing () const;

GEOMDLLIMPEXP void SetCurvatureWeightFactor (double value);
GEOMDLLIMPEXP double  GetCurvatureWeightFactor () const;

GEOMDLLIMPEXP void SetCurveParameterMapping (CurveParameterMapping curveParameterMapping);
GEOMDLLIMPEXP CurveParameterMapping GetCurveParameterMapping () const;

GEOMDLLIMPEXP void SetVertexColorsRequired (bool vertexColorsRequired);
GEOMDLLIMPEXP bool GetVertexColorsRequired () const;

GEOMDLLIMPEXP void SetSilhouetteDirection (DVec3d silhouetteDirection);
GEOMDLLIMPEXP DVec3d GetSilhouetteDirection () const;

GEOMDLLIMPEXP void SetSilhouetteOrigin (DPoint3d silhouetteOrigin);
GEOMDLLIMPEXP DPoint3d GetSilhouetteOrigin () const;

GEOMDLLIMPEXP void SetSilhouetteType (int silhouetteType);
GEOMDLLIMPEXP int GetSilhouetteType () const;

GEOMDLLIMPEXP void SetSilhouetteToleranceDivisor (double silhouetteToleranceDivisor);
GEOMDLLIMPEXP double GetSilhouetteToleranceDivisor () const;

GEOMDLLIMPEXP void SetCurvedSurfaceMaxPerFace (int curveSurfaceMaxPerFace);
GEOMDLLIMPEXP int GetCurvedSurfaceMaxPerFace () const;

GEOMDLLIMPEXP void SetCombineFacets (bool combineFacets);
GEOMDLLIMPEXP bool GetCombineFacets () const;

GEOMDLLIMPEXP void SetConvexFacetsRequired (bool convexFacetsRequired);
GEOMDLLIMPEXP bool GetConvexFacetsRequired () const;

GEOMDLLIMPEXP void SetParamMode (FacetParamMode paramMode);
GEOMDLLIMPEXP FacetParamMode GetParamMode () const;

GEOMDLLIMPEXP void SetParamDistanceScale (double paramDistanceScale);
GEOMDLLIMPEXP double GetParamDistanceScale () const;

GEOMDLLIMPEXP void SetToleranceDistanceScale (double toleranceDistanceScale);
GEOMDLLIMPEXP double GetToleranceDistanceScale () const;

GEOMDLLIMPEXP void SetIgnoreFaceMaterialAttachments (bool ignoreFaceAttachments);
GEOMDLLIMPEXP bool GetIgnoreFaceMaterialAttachments () const;


GEOMDLLIMPEXP void SetHideSmoothEdgesWhenGeneratingNormals (bool hideSmoothEdgesWhenGeneratingNormals);
GEOMDLLIMPEXP bool GetHideSmoothEdgesWhenGeneratingNormals () const;

GEOMDLLIMPEXP void SetDefaults ();

GEOMDLLIMPEXP void SetCurveDefaults ();

GEOMDLLIMPEXP IFacetOptionsPtr  Clone() const;

static GEOMDLLIMPEXP IFacetOptionsPtr New ();

static GEOMDLLIMPEXP IFacetOptionsPtr Create ();

static GEOMDLLIMPEXP IFacetOptionsPtr CreateForCurves ();

GEOMDLLIMPEXP bool BezierStrokeCount (DPoint4dCP poles, size_t order, size_t &count) const;
GEOMDLLIMPEXP bool BezierStrokeCount (bvector<DPoint4d> const &poles, size_t index0, int order, size_t &count) const;
GEOMDLLIMPEXP size_t SegmentStrokeCount (DSegment3dCR segment) const;
GEOMDLLIMPEXP size_t DistanceStrokeCount (double distance) const;
GEOMDLLIMPEXP size_t DistanceAndTurnStrokeCount (double distance, double turnRadians) const;
GEOMDLLIMPEXP size_t FullEllipseStrokeCount (DEllipse3dCR ellipse) const;
GEOMDLLIMPEXP size_t EllipseStrokeCount (DEllipse3dCR ellipse) const;
GEOMDLLIMPEXP size_t BsplineCurveStrokeCount (MSBsplineCurveCR curve) const;
GEOMDLLIMPEXP size_t LineStringStrokeCount (bvector<DPoint3d> const &points) const;

}; // IFacetOptions



struct IPolyfaceConstruction;
typedef RefCountedPtr<IPolyfaceConstruction>  IPolyfaceConstructionPtr;

typedef struct IPolyfaceConstruction *IPolyfaceConstructionP;
typedef struct IPolyfaceConstruction &IPolyfaceConstructionR;


struct  IPolyfaceConstruction : public RefCountedBase
{

private:
    virtual void MakeClassAbstract() = 0;
public:
public:

GEOMDLLIMPEXP void SetFaceIndex (size_t index);
GEOMDLLIMPEXP size_t GetFaceIndex () const;
GEOMDLLIMPEXP size_t IncrementFaceIndex ();
GEOMDLLIMPEXP FacetFaceData GetFaceData () const;
GEOMDLLIMPEXP void SetFaceData (FacetFaceDataCR data);
GEOMDLLIMPEXP void SetCurrentFaceParamDistanceRange (DRange2dCR range);

GEOMDLLIMPEXP void CollectCurrentFaceRanges ();

GEOMDLLIMPEXP void EndFace ();

GEOMDLLIMPEXP void Clear ( );

GEOMDLLIMPEXP size_t FindOrAddPoint (DPoint3dCR point);

GEOMDLLIMPEXP size_t FindOrAddNormal (DVec3dCR normal);

GEOMDLLIMPEXP size_t FindOrAddParam (DPoint2dCR param);

GEOMDLLIMPEXP size_t FindOrAddDoubleColor (RgbFactor const & color);

GEOMDLLIMPEXP size_t AddPointIndex (size_t zeroBasedIndex, bool visible);

GEOMDLLIMPEXP size_t AddNormalIndex (size_t zeroBasedIndex);

GEOMDLLIMPEXP size_t AddParamIndex (size_t zeroBasedIndex);

GEOMDLLIMPEXP size_t AddColorIndex (size_t zeroBasedIndex);

GEOMDLLIMPEXP size_t AddSignedOneBasedPointIndex (int zeroBasedIndex);

GEOMDLLIMPEXP size_t AddSignedOneBasedNormalIndex (int zeroBasedIndex);

GEOMDLLIMPEXP size_t AddSignedOneBasedParamIndex (int zeroBasedIndex);

GEOMDLLIMPEXP size_t AddSignedOneBasedColorIndex (int zeroBasedIndex);


GEOMDLLIMPEXP size_t AddFaceIndex (size_t zeroBasedIndex);

GEOMDLLIMPEXP size_t AddPointIndexTerminator ( );

GEOMDLLIMPEXP size_t AddNormalIndexTerminator ( );

GEOMDLLIMPEXP size_t AddParamIndexTerminator ( );

GEOMDLLIMPEXP size_t AddColorIndexTerminator ( );


GEOMDLLIMPEXP PolyfaceHeaderPtr GetClientMeshPtr ();

GEOMDLLIMPEXP IFacetOptionsR GetFacetOptionsR ( );

GEOMDLLIMPEXP size_t AddPointIndexTriangle (size_t index0, bool visible0, size_t index1, bool visible1, size_t index2, bool visible2);

GEOMDLLIMPEXP size_t AddNormalIndexTriangle (size_t index0, size_t index1, size_t index2);

GEOMDLLIMPEXP size_t AddParamIndexTriangle (size_t index0, size_t index1, size_t index2);

GEOMDLLIMPEXP size_t AddColorIndexTriangle (size_t index0, size_t index1, size_t index2);

GEOMDLLIMPEXP size_t AddPointIndexQuad (size_t index0, bool visible0, size_t index1, bool visible1, size_t index2, bool visible2, size_t index3, bool visible3);

GEOMDLLIMPEXP size_t AddNormalIndexQuad (size_t index0, size_t index1, size_t index2, size_t index3);

GEOMDLLIMPEXP size_t AddParamIndexQuad (size_t index0, size_t index1, size_t index2, size_t index3);

GEOMDLLIMPEXP size_t AddColorIndexQuad (size_t index0, size_t index1, size_t index2, size_t index3);

GEOMDLLIMPEXP bool AddPolyface (PolyfaceQueryCR polyface, size_t drawMethodIndex=0);


GEOMDLLIMPEXP bool NeedNormals ();
GEOMDLLIMPEXP bool NeedParams ();



GEOMDLLIMPEXP void InitializeConstructionStateAndStack ();
GEOMDLLIMPEXP void InitializeCurrentConstructionState ();


GEOMDLLIMPEXP bool GetReverseNewFacetIndexOrder () const;
GEOMDLLIMPEXP bool GetReverseNewNormals () const;


GEOMDLLIMPEXP bool GetWorldToLocal (TransformR transform) const;
GEOMDLLIMPEXP bool IsTransformed () const;
GEOMDLLIMPEXP bool GetLocalToWorld (TransformR transform) const;
GEOMDLLIMPEXP bool SetLocalToWorld (TransformCR transform);
GEOMDLLIMPEXP bool ApplyLocalToWorld (TransformCR relativeTransform);

GEOMDLLIMPEXP DPoint3d MultiplyByLocalToWorld (DPoint3dCR localPoint) const;

GEOMDLLIMPEXP DVec3d MultiplyNormalByLocalToWorld (DVec3dCR localNormal) const;

GEOMDLLIMPEXP void PushState (bool initializeCurrentState = false);
GEOMDLLIMPEXP bool PopState ();

GEOMDLLIMPEXP void SetReverseNewFacetIndexOrder (bool reverse);
GEOMDLLIMPEXP void SetReverseNewNormals (bool reverse);

GEOMDLLIMPEXP bool GetLocalToWorldNormals (RotMatrixR matrix) const;


GEOMDLLIMPEXP void ToggleIndexOrderAndNormalReversal ();

GEOMDLLIMPEXP double GetLocalToWorldScale () const;
GEOMDLLIMPEXP double GetWorldToLocalScale () const;

GEOMDLLIMPEXP void AddRuled (DEllipse3dR ellipse0, DEllipse3dR ellipse1, bool cap);
GEOMDLLIMPEXP void Add (MSBsplineSurfaceCR surface);

GEOMDLLIMPEXP void AddSmoothed (MSBsplineSurfaceCR surface);


GEOMDLLIMPEXP void AddRowMajorQuadGrid (DPoint3dCP points, DVec3dCP normals, DPoint2dCP params, size_t numPerRow, size_t numRow, bool forceTriangles = false);
GEOMDLLIMPEXP void AddTriStrip(DPoint3dCP points, DVec3dCP normals, DPoint2dCP params, size_t numPoint, bool firstTriangle012);

GEOMDLLIMPEXP void AddTubeMesh
(
MSBsplineCurveCR centerlineCurve,
double radius,
int numEdgePerSection,
int numSectionEdge
);


GEOMDLLIMPEXP void AddLinearSweep (bvector<DPoint3d> &pointA, bvector<DVec3d> &tangentA, DVec3dCR step);
GEOMDLLIMPEXP void AddLinearSweep (bvector<DPoint3d> &pointA, bvector<DVec3d> *tangentA, DVec3dCR step, bool capped);

GEOMDLLIMPEXP bool AddRuledBetweenCorrespondingCurves (bvector<CurveVectorPtr> const &contours, bool capped);
GEOMDLLIMPEXP void AddRotationalSweep (CurveVectorPtr, DPoint3dCR center, DVec3dCR axis, double totalSweep, bool capped);

GEOMDLLIMPEXP void AddRegion (CurveVectorCR region);
GEOMDLLIMPEXP bool StrokeWithDoubledPointsAtCorners(CurveVectorCR curves, bvector<DPoint3d> &points, bvector<DVec3d>&tangents, size_t &numLoop);


GEOMDLLIMPEXP bool StrokeWithDoubledPointsAtCorners(
CurveVectorCR curves,
bvector<bvector<DPoint3d> >&points,
bvector<bvector<DVec3d> >&tangents,
bvector<double> &curveLengths
);

GEOMDLLIMPEXP bool Stroke (CurveVectorCR curves, bvector<DPoint3d> &points, size_t &numLoop);
 
GEOMDLLIMPEXP bool AddTriangulation (bvector<DPoint3d> &points);

GEOMDLLIMPEXP void AddTriangulationPair (bvector<DPoint3d> &pointA, bool reverseA, bvector<DPoint3d> &pointB, bool reverseB);

GEOMDLLIMPEXP bool AddPolygon(bvector<DPoint3d> &points);

GEOMDLLIMPEXP void AddRotationalSweepLoop
(
bvector<DPoint3d> &pointA,
bvector<DVec3d> &tangentA,
DPoint3dCR center,
DVec3dCR rotationAxis,
double   totalSweepRadians,
bool     reverse,
double   nominalBaseCurveLength,
bvector<DPoint3d> *startCapPointAccumulator,
bvector<DPoint3d> *endCapPointAccumulator
);


GEOMDLLIMPEXP void AddFullDisk (DEllipse3dCR ellipse, size_t numPerQuadrant = 0);

GEOMDLLIMPEXP void AddFullDiskTriangles (DEllipse3dCR ellipse, size_t numPerQuadrant = 0);


GEOMDLLIMPEXP void AddFullSphere (DPoint3dCR center, double radius, size_t numPerQuadrantEW = 0, size_t numPerQuadrantNS = 0);

GEOMDLLIMPEXP void AddEllipsoidPatch (DPoint3dCR center,
            double radiusX,
            double radiusY,
            double radiusPole,
            size_t numEastWestEdge = 0,
            size_t numNorthSouthEdge = 0,
            double longitudeStart = 0.0,
            double longitudeSweep = msGeomConst_2pi,
            double latitudeStart = -msGeomConst_piOver2,
            double latitudeSweep = msGeomConst_pi,
            bool capped = false,
            int orientationSelect = 1
            );

GEOMDLLIMPEXP bool AddSweptNGon (size_t n, double rOuter, double z0, double z1,
    bool bottomCap,
    bool topCap
    );

GEOMDLLIMPEXP void FindOrAddPoints (bvector<DPoint3d> &point, size_t n, size_t numWrap, bvector<size_t> &index);
GEOMDLLIMPEXP void FindOrAddNormals (bvector<DVec3d> &normal, size_t n, size_t numWrap, bvector<size_t> &index);
GEOMDLLIMPEXP void FindOrAddParams (bvector<DPoint2d> &param, size_t n, size_t numWrap, bvector<size_t> &index);
GEOMDLLIMPEXP void FindOrAddPoints (DPoint3dCP points,  size_t n, bvector<size_t> &index);
GEOMDLLIMPEXP void FindOrAddNormals (DVec3dCP  normals, size_t n, bvector<size_t> &index);
GEOMDLLIMPEXP void FindOrAddParams (DPoint2dCP params,  size_t n, bvector<size_t> &index);
GEOMDLLIMPEXP void AddPointIndexFan         (size_t centerIndex, bvector<size_t> &index, size_t numChord, bool reverse);

GEOMDLLIMPEXP void AddPointIndexFan
(
size_t centerIndex,     
bvector<size_t> &index, 
size_t numChord,        
bool reverse,           
bool spokesVisible,     
bool visibleBoundary    
);


GEOMDLLIMPEXP void AddPointIndexStrip
(
bool visibleLeft,
bvector<size_t> &indexA,
bool visibleA,
bvector<size_t> &indexB,
bool visibleB,
bool visibleRight,
size_t numQuad,
bool reverse);

GEOMDLLIMPEXP void AddNormalIndexFan        (size_t centerIndex, bvector<size_t> &index, size_t numChord, bool reverse);
GEOMDLLIMPEXP void AddNormalIndexPlanarFan  (DVec3dCR vectorA, DVec3dCR vectorB, bool reverse, size_t numChord);
GEOMDLLIMPEXP void AddNormalIndexPlanarFan  (size_t normalIndex, size_t numChord);
GEOMDLLIMPEXP void AddNormalIndexPlanarStrip (size_t index, size_t numQuad);


GEOMDLLIMPEXP void AddParamIndexFan         (size_t centerIndex, bvector<size_t> &index, size_t numChord, bool reverse);
GEOMDLLIMPEXP void AddParamIndexStrip         (bvector<size_t> &indexA, bvector<size_t> &indexB, size_t numQuad, bool reverse);

GEOMDLLIMPEXP bool AddSolidPrimitive (ISolidPrimitiveCR primitive);
GEOMDLLIMPEXP bool Add (DgnConeDetailCR cone);
GEOMDLLIMPEXP bool Add (DgnSphereDetailCR sphere);
GEOMDLLIMPEXP bool Add (DgnBoxDetailCR box);
GEOMDLLIMPEXP bool Add (DgnTorusPipeDetailCR torus);
GEOMDLLIMPEXP bool Add (DgnExtrusionDetailCR extrusion);
GEOMDLLIMPEXP bool Add (DgnRotationalSweepDetailCR sweep);
GEOMDLLIMPEXP bool Add (DgnRuledSweepDetailCR sweep);

GEOMDLLIMPEXP bool RemapPseudoDistanceParams
(
bvector<DPoint2d>&params,
DRange2dR distanceRange,
DRange2dR paramRange,
double xDistanceFactor,
double yDistanceFactor,
Transform *transform
);

GEOMDLLIMPEXP bool RemapPseudoDistanceParams
(
bvector<DPoint2d>&params,
DRange2dR distanceRange,
DRange2dR paramRange,
double xDistanceFactor = 1.0,
double yDistanceFactor = 1.0
)
    {
    return RemapPseudoDistanceParams (params, distanceRange, paramRange, xDistanceFactor, yDistanceFactor, nullptr);
    }



GEOMDLLIMPEXP bool Add (PolyfaceHeaderR polyface);


GEOMDLLIMPEXP static IPolyfaceConstructionPtr Create (IFacetOptionsR options);

};

struct PolyfaceConstruction : IPolyfaceConstruction
{
private:
    virtual void MakeClassAbstract() = 0;
public:

public:
PolyfaceConstruction (IFacetOptionsR options);
};
END_BENTLEY_GEOMETRY_NAMESPACE