1 // Copyright (C) 2014-2015 EDF-R&D
2 // This library is free software; you can redistribute it and/or
3 // modify it under the terms of the GNU Lesser General Public
4 // License as published by the Free Software Foundation; either
5 // version 2.1 of the License, or (at your option) any later version.
7 // This library is distributed in the hope that it will be useful,
8 // but WITHOUT ANY WARRANTY; without even the implied warranty of
9 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
10 // Lesser General Public License for more details.
12 // You should have received a copy of the GNU Lesser General Public
13 // License along with this library; if not, write to the Free Software
14 // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
16 // See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
19 #ifndef HYDROData_Stream_HeaderFile
20 #define HYDROData_Stream_HeaderFile
22 #include "HYDROData_NaturalObject.h"
24 #include <TopoDS_Face.hxx>
25 #include <TopoDS_Edge.hxx>
26 #include <TopoDS_Wire.hxx>
28 #include <Geom_BSplineCurve.hxx>
31 DEFINE_STANDARD_HANDLE(HYDROData_Stream, HYDROData_NaturalObject)
33 class Handle(HYDROData_PolylineXY);
34 class Handle(HYDROData_Polyline3D);
35 class Handle(HYDROData_Profile);
36 class HYDROData_IProfilesInterpolator;
37 class TColStd_Array1OfReal;
38 class Handle(TopTools_HArray1OfShape);
39 class Handle_HYDROData_DTM;
40 class TopTools_ListOfShape;
43 /**\class HYDROData_Stream
47 class HYDROData_Stream : public HYDROData_NaturalObject
55 TopoDS_Wire myLeftBank; // 3d curve of the left bank
56 TopoDS_Wire myRightBank; // 3d curve of the right bank
57 TopoDS_Wire myInlet; // first (inlet) 2d profile
58 TopoDS_Wire myOutlet; // last (inlet) 2d profile
63 * Enumeration of tags corresponding to the persistent object parameters.
67 DataTag_First = HYDROData_NaturalObject::DataTag_First + 100, ///< first tag, to reserve
68 DataTag_HydraulicAxis, ///< reference hydraulic axis
69 DataTag_Profile, ///< reference profiles
70 DataTag_ParamsArray, ///< parameters array
71 DataTag_BottomPolyline ///< reference bottom polyline
76 DEFINE_STANDARD_RTTI(HYDROData_Stream);
81 * Creates the presentations(2D and 3D) by given hydraulic axis and profiles.
83 HYDRODATA_EXPORT static bool CreatePresentations( const Handle_HYDROData_DTM& theDTM,
84 PrsDefinition& thePrs );
87 * Creates the presentations(2D and 3D) by given first points, last points and profiles.
88 * If 2D profiles is null - they will not used in the presentation.
90 HYDRODATA_EXPORT static void CreatePresentationsIntern( const Handle_HYDROData_DTM& theDTM,
91 PrsDefinition& thePrs );
93 HYDRODATA_EXPORT static void CreatePresentations( const Handle(TColgp_HArray1OfPnt) theArrayOfFPnt,
94 const Handle(TColgp_HArray1OfPnt) theArrayOfLPnt,
95 const Handle(TopTools_HArray1OfShape) theArrOfProfiles,
96 PrsDefinition& thePrs );
101 * Returns the kind of this object. Must be redefined in all objects of known type.
103 HYDRODATA_EXPORT virtual const ObjectKind GetKind() const {return KIND_STREAM;}
106 * Dump object to Python script representation.
108 HYDRODATA_EXPORT virtual QStringList DumpToPython( const QString& thePyScriptPath,
109 MapOfTreatedObjects& theTreatedObjects ) const;
112 * Returns the list of all reference objects of this object.
114 HYDRODATA_EXPORT virtual HYDROData_SequenceOfObjects GetAllReferenceObjects() const;
117 * Update the profiles order and shape presentations of stream.
118 * Call this method whenever you made changes for stream data.
120 HYDRODATA_EXPORT virtual void Update();
123 * Checks that object has 2D presentation. Reimlemented to retun true.
125 HYDRODATA_EXPORT virtual bool IsHas2dPrs() const;
128 * Update the shape presentations of stream.
130 HYDRODATA_EXPORT void UpdatePrs( const Handle_HYDROData_DTM& );
135 HYDRODATA_EXPORT virtual void CopyTo( const Handle(HYDROData_Entity)& theDestination,
136 bool isGenerateNewName ) const;
140 * Returns default filling color for new stream.
142 HYDRODATA_EXPORT virtual QColor DefaultFillingColor() const;
145 * Returns default border color for new stream.
147 HYDRODATA_EXPORT virtual QColor DefaultBorderColor() const;
150 * Returns true if given polyline can be used as stream axis.
152 HYDRODATA_EXPORT static bool IsValidAsAxis( const Handle(HYDROData_PolylineXY)& theAxis );
155 // Public methods to work with Stream presentation
158 * Returns the left edge of the stream.
160 HYDRODATA_EXPORT virtual TopoDS_Shape GetLeftShape() const;
163 * Returns the right edge of the stream.
165 HYDRODATA_EXPORT virtual TopoDS_Shape GetRightShape() const;
168 * Returns the inlet edge of the stream.
170 HYDRODATA_EXPORT virtual TopoDS_Shape GetInletShape() const;
173 * Returns the outlet edge of the stream.
175 HYDRODATA_EXPORT virtual TopoDS_Shape GetOutletShape() const;
179 // Public methods to work with Stream data fields
182 * Sets reference hydraulic axis object for stream.
184 HYDRODATA_EXPORT virtual bool SetHydraulicAxis( const Handle(HYDROData_PolylineXY)& theAxis );
187 * Returns reference hydraulic axis object of stream.
189 HYDRODATA_EXPORT virtual Handle(HYDROData_PolylineXY) GetHydraulicAxis() const;
192 * Remove reference hydraulic axis object from stream.
194 HYDRODATA_EXPORT virtual void RemoveHydraulicAxis();
197 * Returns true if profile has the intersection with the given hydraulic axis.
198 * Returns the parameter of inresection point on axis if axis is presented by one curve,
199 * if axis presented by set of edges the <outPar> returns a common length of segments till the intersection point.
201 HYDRODATA_EXPORT static bool HasIntersection( const Handle(HYDROData_PolylineXY)& theHydAxis,
202 const Handle(HYDROData_Profile)& theProfile,
203 const TopoDS_Face& thePlane,
204 Standard_Real& theOutPar );
207 * Returns true if profile has the intersection with reference hydraulic axis.
208 * Returns the parameter of inresection point on axis if axis is presented by one curve,
209 * if axis presented by set of edges the <outPar> returns a common length of segments till the intersection point.
211 HYDRODATA_EXPORT virtual bool HasIntersection( const Handle(HYDROData_Profile)& theProfile,
212 const TopoDS_Face& thePlane,
213 Standard_Real& theOutPar ) const;
216 * Builds a planar face
218 HYDRODATA_EXPORT static bool BuildFace( const Handle(HYDROData_PolylineXY)& theHydAxis,
219 TopoDS_Face& thePlane );
222 * Add new one reference profile object for stream.
224 HYDRODATA_EXPORT virtual bool AddProfile( const Handle(HYDROData_Profile)& theProfile );
227 * Add new one reference profile object for stream.
229 HYDRODATA_EXPORT virtual bool SetProfiles( const HYDROData_SequenceOfObjects& theProfiles,
230 const bool& theIsToOrder = true );
233 * Returns all reference profile objects of stream.
235 HYDRODATA_EXPORT virtual HYDROData_SequenceOfObjects GetProfiles() const;
238 * Removes reference profile object from stream.
240 HYDRODATA_EXPORT virtual bool RemoveProfile( const Handle(HYDROData_Profile)& theProfile );
243 * Removes all reference profile objects from stream.
245 HYDRODATA_EXPORT virtual void RemoveProfiles();
248 * Generates bottom polyline for stream or update the existing bottom polyline.
249 * \return true in case of success
251 HYDRODATA_EXPORT virtual bool GenerateBottomPolyline();
254 * Returns reference bottom polyline object of stream.
256 HYDRODATA_EXPORT virtual Handle(HYDROData_Polyline3D) GetBottomPolyline() const;
259 * Sets reference bottom polyline object for stream.
260 * \param theBottom the polyline 3D
261 * \return true in case of success
263 HYDRODATA_EXPORT virtual bool SetBottomPolyline( const Handle(HYDROData_Polyline3D)& theBottom );
266 * Add interpolated profiles into the stream.
267 * \param theInterpolator the interpolator
268 * \return true in case of success
270 HYDRODATA_EXPORT virtual bool Interpolate( HYDROData_IProfilesInterpolator* theInterpolator );
273 HYDRODATA_EXPORT double GetDDZ() const;
274 HYDRODATA_EXPORT void SetDDZ( double theDDZ );
276 HYDRODATA_EXPORT double GetSpatialStep() const;
277 HYDRODATA_EXPORT void SetSpatialStep( double theSpatialStep );
282 * Insert one profile in to the stream profiles order.
284 void insertProfileInToOrder( const Handle(HYDROData_Profile)& theProfile,
285 const int theBeforeIndex = -1 );
288 * Fully recompute the order of all profiles in accordance with reference hydraulic axis.
289 * If hydraulic axis is not set all profiles will be removed from order.
291 void updateProfilesOrder();
294 * Returns the type of child altitude object.
295 * Reimplemented to create stream altitude object.
297 HYDRODATA_EXPORT virtual ObjectKind getAltitudeObjectType() const;
300 * Builds b-spline using interpolation algorithm.
302 static Handle(Geom_BSplineCurve) buildInterpolationCurve(
303 const Handle(TColgp_HArray1OfPnt)& theArrayOfPnt );
307 void setParametersArray( const TColStd_Array1OfReal& theArray );
309 TColStd_Array1OfReal* getParametersArray() const;
311 void removeParametersArray();
313 int insertParameter( const Standard_Real& theParam );
315 void removeParameter( const int& theIndex );
317 Handle_HYDROData_DTM DTM() const;
321 friend class HYDROData_Iterator;
322 friend class test_HYDROData_Stream;
325 * Creates new object in the internal data structure. Use higher level objects
326 * to create objects with real content.
328 HYDRODATA_EXPORT HYDROData_Stream();
331 * Destructs properties of the object and object itself, removes it from the document.
333 virtual HYDRODATA_EXPORT ~HYDROData_Stream();