// Copyright (c) 1995-1999 Matra Datavision
// Copyright (c) 1999-2013 OPEN CASCADE SAS
//
-// The content of this file is subject to the Open CASCADE Technology Public
-// License Version 6.5 (the "License"). You may not use the content of this file
-// except in compliance with the License. Please obtain a copy of the License
-// at http://www.opencascade.org and read it completely before using this file.
+// This file is part of Open CASCADE Technology software library.
//
-// The Initial Developer of the Original Code is Open CASCADE S.A.S., having its
-// main offices at: 1, place des Freres Montgolfier, 78280 Guyancourt, France.
+// This library is free software; you can redistribute it and/or modify it under
+// the terms of the GNU Lesser General Public License version 2.1 as published
+// by the Free Software Foundation, with special exception defined in the file
+// OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
+// distribution for complete text of the license and disclaimer of any warranty.
//
-// The Original Code and all software distributed under the License is
-// distributed on an "AS IS" basis, without warranty of any kind, and the
-// Initial Developer hereby disclaims all such warranties, including without
-// limitation, any warranties of merchantability, fitness for a particular
-// purpose or non-infringement. Please see the License for the specific terms
-// and conditions governing the rights and limitations under the License.
-
-//! A framework to define display of angles. <br>
-//! These displays are particularly useful in viewing draft prisms. <br>
-//! The angle displayed may define an intersection <br>
-//! can be between two edges or two faces of a shape <br>
-//! or a plane. The display consists of arrows and text. <br>
+// Alternatively, this file may be used under the terms of Open CASCADE
+// commercial license or contractual agreement.
#ifndef _AIS_AngleDimension_HeaderFile
#define _AIS_AngleDimension_HeaderFile
#include <TopoDS.hxx>
#include <TopoDS_Edge.hxx>
#include <TopoDS_Face.hxx>
+#include <TopoDS_Vertex.hxx>
DEFINE_STANDARD_HANDLE (AIS_AngleDimension, AIS_Dimension)
+//! Angle dimension. Can be constructed:
+//! - on two intersected edges.
+//! - on three points or vertices.
+//! - on conical face.
+//! - between two intersected faces.
+//!
+//! In case of three points or two intersected edges the dimension plane
+//! (on which dimension presentation is built) can be computed uniquely
+//! as through three defined points can be built only one plane.
+//! Therefore, if user-defined plane differs from this one, the dimension can't be built.
+//!
+//! In cases of two planes automatic plane by default is built on point of the
+//! origin of parametric space of the first face (the basis surface) so, that
+//! the working plane and two faces intersection forms minimal angle between the faces.
+//! User can define the other point which the dimension plane should pass through
+//! using the appropriate constructor. This point can lay on the one of the faces or not.
+//! Also user can define his own plane but it should pass through the three points
+//! computed on the geometry initialization step (when the constructor or SetMeasuredGeometry() method
+//! is called).
+//!
+//! In case of the conical face the center point of the angle is the apex of the conical surface.
+//! The attachment points are points of the first and the last parameter of the basis circle of the cone.
+//!
class AIS_AngleDimension : public AIS_Dimension
{
public:
- //! Constructs angle dimension between two edges
- //! with automatic working plane computing
- //! if it is possible. In case of PI angle please
- //! set custom working plane or use constructor with 3 parameters.
- Standard_EXPORT AIS_AngleDimension (const TopoDS_Edge& theFirstEdge,
- const TopoDS_Edge& theSecondEdge);
- //! Constructs the angle display object defined by the <br>
- //! two edges and custom working plane.
- //! ATTENTION :In case if the working plane is custom and one edge is out of the
- //! working plane it tries to project this edge line on the plane.
- //! To avoid this case you can reset the working plane
- //! using <ResetWorkingPlane ()> method.
- Standard_EXPORT AIS_AngleDimension (const TopoDS_Edge& theFirstEdge,
- const TopoDS_Edge& theSecondEdge,
- const gp_Pln& thePlane);
+ //! Constructs minimum angle dimension between two linear edges (where possible).
+ //! These two edges should be intersected by each other. Otherwise the geometry is not valid.
+ //! @param theFirstEdge [in] the first edge.
+ //! @param theSecondEdge [in] the second edge.
+ Standard_EXPORT AIS_AngleDimension (const TopoDS_Edge& theFirstEdge,
+ const TopoDS_Edge& theSecondEdge);
//! Constructs the angle display object defined by three points.
- Standard_EXPORT AIS_AngleDimension (const gp_Pnt& theFirstPoint,
- const gp_Pnt& theSecondPoint,
- const gp_Pnt& theThirdPoint);
+ //! @param theFirstPoint [in] the first point (point on first angle flyout).
+ //! @param theSecondPoint [in] the center point of angle dimension.
+ //! @param theThirdPoint [in] the second point (point on second angle flyout).
+ Standard_EXPORT AIS_AngleDimension (const gp_Pnt& theFirstPoint,
+ const gp_Pnt& theSecondPoint,
+ const gp_Pnt& theThirdPoint);
- //! Angle of cone
- Standard_EXPORT AIS_AngleDimension (const TopoDS_Face& theCone);
+ //! Constructs the angle display object defined by three vertices.
+ //! @param theFirstVertex [in] the first vertex (vertex for first angle flyout).
+ //! @param theSecondVertex [in] the center vertex of angle dimension.
+ //! @param theThirdPoint [in] the second vertex (vertex for second angle flyout).
+ Standard_EXPORT AIS_AngleDimension (const TopoDS_Vertex& theFirstVertex,
+ const TopoDS_Vertex& theSecondVertex,
+ const TopoDS_Vertex& theThirdVertex);
- //! TwoPlanarFaceAngle dimension
- Standard_EXPORT AIS_AngleDimension (const TopoDS_Face& theFirstFace,
- const TopoDS_Face& theSecondFace,
- const gp_Ax1& theAxis);
+ //! Constructs angle dimension for the cone face.
+ //! @param theCone [in] the conical face.
+ Standard_EXPORT AIS_AngleDimension (const TopoDS_Face& theCone);
- //! Sets first shape
- Standard_EXPORT void SetFirstShape (const TopoDS_Shape& theShape,
- const Standard_Boolean isSingleShape = Standard_False);
+ //! Constructs angle dimension between two planar faces.
+ //! @param theFirstFace [in] the first face.
+ //! @param theSecondFace [in] the second face.
+ Standard_EXPORT AIS_AngleDimension (const TopoDS_Face& theFirstFace,
+ const TopoDS_Face& theSecondFace);
+
+ //! Constructs angle dimension between two planar faces.
+ //! @param theFirstFace [in] the first face.
+ //! @param theSecondFace [in] the second face.
+ //! @param thePoint [in] the point which the dimension plane should pass through.
+ //! This point can lay on the one of the faces or not.
+ Standard_EXPORT AIS_AngleDimension (const TopoDS_Face& theFirstFace,
+ const TopoDS_Face& theSecondFace,
+ const gp_Pnt& thePoint);
+
+public:
+
+ //! @return first point forming the angle.
+ const gp_Pnt& FirstPoint() const
+ {
+ return myFirstPoint;
+ }
+
+ //! @return second point forming the angle.
+ const gp_Pnt& SecondPoint() const
+ {
+ return mySecondPoint;
+ }
+
+ //! @return center point forming the angle.
+ const gp_Pnt& CenterPoint() const
+ {
+ return myCenterPoint;
+ }
+
+ //! @return first argument shape.
+ const TopoDS_Shape& FirstShape() const
+ {
+ return myFirstShape;
+ }
+
+ //! @return second argument shape.
+ const TopoDS_Shape& SecondShape() const
+ {
+ return mySecondShape;
+ }
+
+ //! @return third argument shape.
+ const TopoDS_Shape& ThirdShape() const
+ {
+ return myThirdShape;
+ }
+
+public:
+
+ //! Measures minimum angle dimension between two linear edges.
+ //! These two edges should be intersected by each other. Otherwise the geometry is not valid.
+ //! @param theFirstEdge [in] the first edge.
+ //! @param theSecondEdge [in] the second edge.
+ Standard_EXPORT void SetMeasuredGeometry (const TopoDS_Edge& theFirstEdge,
+ const TopoDS_Edge& theSecondEdge);
+
+ //! Measures angle defined by three points.
+ //! @param theFirstPoint [in] the first point (point on first angle flyout).
+ //! @param theSecondPoint [in] the center point of angle dimension.
+ //! @param theThirdPoint [in] the second point (point on second angle flyout).
+ Standard_EXPORT void SetMeasuredGeometry (const gp_Pnt& theFirstPoint,
+ const gp_Pnt& theSecondPoint,
+ const gp_Pnt& theThridPoint);
+
+ //! Measures angle defined by three vertices.
+ //! @param theFirstVertex [in] the first vertex (vertex for first angle flyout).
+ //! @param theSecondVertex [in] the center vertex of angle dimension.
+ //! @param theThirdPoint [in] the second vertex (vertex for second angle flyout).
+ Standard_EXPORT void SetMeasuredGeometry (const TopoDS_Vertex& theFirstVertex,
+ const TopoDS_Vertex& theSecondVertex,
+ const TopoDS_Vertex& theThirdVertex);
+
+ //! Measures angle of conical face.
+ //! @param theCone [in] the shape to measure.
+ Standard_EXPORT void SetMeasuredGeometry (const TopoDS_Face& theCone);
+
+ //! Measures angle between two planar faces.
+ //! @param theFirstFace [in] the first face.
+ //! @param theSecondFace [in] the second face..
+ Standard_EXPORT void SetMeasuredGeometry (const TopoDS_Face& theFirstFace,
+ const TopoDS_Face& theSecondFace);
+
+ //! Measures angle between two planar faces.
+ //! @param theFirstFace [in] the first face.
+ //! @param theSecondFace [in] the second face.
+ //! @param thePoint [in] the point which the dimension plane should pass through.
+ //! This point can lay on the one of the faces or not.
+ Standard_EXPORT void SetMeasuredGeometry (const TopoDS_Face& theFirstFace,
+ const TopoDS_Face& theSecondFace,
+ const gp_Pnt& thePoint);
+
+ //! @return the display units string.
+ Standard_EXPORT virtual const TCollection_AsciiString& GetDisplayUnits() const;
+
+ //! @return the model units string.
+ Standard_EXPORT virtual const TCollection_AsciiString& GetModelUnits() const;
+
+ Standard_EXPORT virtual void SetDisplayUnits (const TCollection_AsciiString& theUnits);
+
+ Standard_EXPORT virtual void SetModelUnits (const TCollection_AsciiString& theUnits);
+
+ //! Principle of horizontal text alignment settings:
+ //! - divide circle into two halves according to attachment points
+ //! - if aTextPos is between attach points -> Center + positive flyout
+ //! - if aTextPos is not between attach points but in this half -> Left or Right + positive flyout
+ //! - if aTextPos is between reflections of attach points -> Center + negative flyout
+ //! - if aTextPos is not between reflections of attach points -> Left or Right + negative flyout
+ Standard_EXPORT virtual void SetTextPosition (const gp_Pnt& theTextPos);
+
+ Standard_EXPORT virtual const gp_Pnt GetTextPosition () const;
public:
protected:
- //! Computes dimension value in display units
- Standard_EXPORT virtual void computeValue();
+ //! Initialization of fields that is common to all constructors.
+ Standard_EXPORT void Init();
- Standard_EXPORT void init();
+ //! @param theFirstAttach [in] the first attachment point.
+ //! @param theSecondAttach [in] the second attachment point.
+ //! @param theCenter [in] the center point (center point of the angle).
+ //! @return the center of the dimension arc (the main dimension line in case of angle).
+ Standard_EXPORT gp_Pnt GetCenterOnArc (const gp_Pnt& theFirstAttach,
+ const gp_Pnt& theSecondAttach,
+ const gp_Pnt& theCenter) const;
- Standard_EXPORT gp_Pnt getCenterOnArc (const gp_Pnt& theFirstAttach,
- const gp_Pnt& theSecondAttach);
+ //! Draws main dimension line (arc).
+ //! @param thePresentation [in] the dimension presentation.
+ //! @param theFirstAttach [in] the first attachment point.
+ //! @param theSecondAttach [in] the second attachment point.
+ //! @param theCenter [in] the center point (center point of the angle).
+ //! @param theRadius [in] the radius of the dimension arc.
+ //! @param theMode [in] the display mode.
+ Standard_EXPORT void DrawArc (const Handle(Prs3d_Presentation)& thePresentation,
+ const gp_Pnt& theFirstAttach,
+ const gp_Pnt& theSecondAttach,
+ const gp_Pnt& theCenter,
+ const Standard_Real theRadius,
+ const Standard_Integer theMode);
- Standard_EXPORT void drawArc (const Handle(Prs3d_Presentation)& thePresentation,
- const gp_Pnt& theFirstAttach,
- const gp_Pnt& theSecondAttach,
- const gp_Pnt& theCenter,
- const Standard_Real theRadius,
- const AIS_DimensionDisplayMode theMode);
+ //! Draws main dimension line (arc) with text.
+ //! @param thePresentation [in] the dimension presentation.
+ //! @param theFirstAttach [in] the first attachment point.
+ //! @param theSecondAttach [in] the second attachment point.
+ //! @param theCenter [in] the center point (center point of the angle).
+ //! @param theText [in] the text label string.
+ //! @param theTextWidth [in] the text label width.
+ //! @param theMode [in] the display mode.
+ //! @param theLabelPosition [in] the text label vertical and horizontal positioning option
+ //! respectively to the main dimension line.
+ Standard_EXPORT void DrawArcWithText (const Handle(Prs3d_Presentation)& thePresentation,
+ const gp_Pnt& theFirstAttach,
+ const gp_Pnt& theSecondAttach,
+ const gp_Pnt& theCenter,
+ const TCollection_ExtendedString& theText,
+ const Standard_Real theTextWidth,
+ const Standard_Integer theMode,
+ const Standard_Integer theLabelPosition);
- Standard_EXPORT void drawArcWithText (const Handle(Prs3d_Presentation)& thePresentation,
- const gp_Pnt& theFirstAttach,
- const gp_Pnt& theSecondAttach,
- const TCollection_ExtendedString& theText,
- const AIS_DimensionDisplayMode theMode,
- const Standard_Integer theLabelPosition);
+ //! Fits text alignment relatively to the dimension line;
+ //! it computes the value of label position and arrow orientation
+ //! according set in the aspect and dimension properties.
+ //! @param theHorizontalTextPos [in] the horizontal alignment for text position.
+ //! @param theLabelPosition [out] the label position, contains bits that defines
+ //! vertical and horizontal alignment. (for internal usage in count text position).
+ //! @param theIsArrowExternal [out] is the arrows external,
+ //! if arrow orientation in the dimension aspect is Prs3d_DAO_Fit, it fits arrow
+ //! orientation automatically.
+ Standard_EXPORT void FitTextAlignment (const Prs3d_DimensionTextHorizontalPosition& theHorizontalTextPos,
+ Standard_Integer& theLabelPosition,
+ Standard_Boolean& theIsArrowsExternal) const;
+
+ //! Adjusts aspect parameters according the text position:
+ //! extension size, vertical text alignment and flyout.
+ //! It changes flyout of the dimension.
+ //! @param theTextPos [in] the user defined 3d point of text position.
+ //! @param theExtensionSize [out] the adjusted extension size.
+ //! @param theAlignment [out] the horizontal label alignment.
+ Standard_EXPORT void AdjustParameters (const gp_Pnt& theTextPos,
+ Standard_Real& theExtensionSize,
+ Prs3d_DimensionTextHorizontalPosition& theAlignment);
+
+protected:
+
+ Standard_EXPORT virtual void ComputePlane();
+
+ //! Checks if the plane includes three angle points to build dimension.
+ Standard_EXPORT virtual Standard_Boolean CheckPlane (const gp_Pln& thePlane) const;
+
+ Standard_EXPORT virtual Standard_Real ComputeValue() const;
Standard_EXPORT virtual void Compute (const Handle(PrsMgr_PresentationManager3d)& thePM,
const Handle(Prs3d_Presentation)& thePresentation,
const Standard_Integer theMode = 0);
- Standard_EXPORT Standard_Boolean initConeAngle (const TopoDS_Face& theCone);
+ Standard_EXPORT virtual void ComputeFlyoutSelection (const Handle(SelectMgr_Selection)& theSelection,
+ const Handle(SelectMgr_EntityOwner)& theOwner);
- Standard_EXPORT Standard_Boolean initTwoFacesAngle();
+protected:
- Standard_EXPORT Standard_Boolean initTwoEdgesAngle();
+ //! Init angular dimension to measure angle between two linear edges.
+ //! @return TRUE if the angular dimension can be constructured
+ //! for the passed edges.
+ Standard_EXPORT Standard_Boolean InitTwoEdgesAngle (gp_Pln& theComputedPlane);
- //! Auxiliary method to get position of the angle dimension
- //! if the cone is trimmed
- //! Returns 1 if <theC> center is above of <theCMin> center;
- //! 0 if <theC> center is between <theCMin> and <theCMax> centers;
- //! -1 if <theC> center is below <theCMax> center.
- Standard_EXPORT Standard_Integer aboveInBelowCone (const gp_Circ &theCMax,
- const gp_Circ &theCMin,
- const gp_Circ &theC);
+ //! Init angular dimension to measure angle between two planar faces.
+ //! there is no user-defined poisitoning. So attach points are set
+ //! according to faces geometry (in origin of the first face basis surface).
+ //! @return TRUE if the angular dimension can be constructed
+ //! for the passed faces.
+ Standard_EXPORT Standard_Boolean InitTwoFacesAngle();
- //! Fills default plane object if it is possible to count plane automatically.
- Standard_EXPORT virtual void countDefaultPlane ();
-
- //! Fills sensitive entity for flyouts and adds it to the selection
- Standard_EXPORT virtual void computeFlyoutSelection (const Handle(SelectMgr_Selection)& theSelection,
- const Handle(AIS_DimensionOwner)& theOwner);
+ //! Init angular dimension to measure angle between two planar faces.
+ //! @param thePointOnFirstFace [in] the point which the dimension plane should pass through.
+ //! This point can lay on the one of the faces or not.
+ //! It will be projected on the first face and this point will be set
+ //! as the first point attach point.
+ //! It defines some kind of dimension positioning over the faces.
+ //! @return TRUE if the angular dimension can be constructed
+ //! for the passed faces.
+ Standard_EXPORT Standard_Boolean InitTwoFacesAngle (const gp_Pnt thePointOnFirstFace);
-protected:
+ //! Init angular dimension to measure cone face.
+ //! @return TRUE if the angular dimension can be constructed
+ //! for the passed cone.
+ Standard_EXPORT Standard_Boolean InitConeAngle();
+
+ //! Check that the points forming angle are valid.
+ //! @return TRUE if the points met the following requirements:
+ //! The (P1, Center), (P2, Center) can be built.
+ //! The angle between the vectors > Precision::Angular().
+ Standard_EXPORT Standard_Boolean IsValidPoints (const gp_Pnt& theFirstPoint,
+ const gp_Pnt& theCenterPoint,
+ const gp_Pnt& theSecondPoint) const;
- //! Shows if there is necessarily to draw extensions on angle dimension
- //! It is set to the true value if the attachment point are out of the edges.
- Standard_Boolean myIsFlyoutLines;
+private:
- //! The center of dimension arc
- gp_Pnt myCenter;
+ gp_Pnt myFirstPoint;
+ gp_Pnt mySecondPoint;
+ gp_Pnt myCenterPoint;
+ TopoDS_Shape myFirstShape;
+ TopoDS_Shape mySecondShape;
+ TopoDS_Shape myThirdShape;
};
-#endif
+#endif // _AIS_AngleDimension_HeaderFile