1
0
mirror of https://git.dev.opencascade.org/repos/occt.git synced 2025-04-10 18:51:21 +03:00
occt/src/BRepGProp/BRepGProp_Face.hxx
kgv 8ff2e494f5 0029939: Modeling Algorithms - add NULL check to BRepGProp_Face::Load()
BRepGProp_Face::Load() has been protected against crash in case of edges without p-curves.
2018-07-13 15:03:55 +03:00

182 lines
6.2 KiB
C++

// Created on: 1993-04-14
// Created by: Isabelle GRIGNON
// Copyright (c) 1993-1999 Matra Datavision
// Copyright (c) 1999-2014 OPEN CASCADE SAS
//
// This file is part of Open CASCADE Technology software library.
//
// 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.
//
// Alternatively, this file may be used under the terms of Open CASCADE
// commercial license or contractual agreement.
#ifndef _BRepGProp_Face_HeaderFile
#define _BRepGProp_Face_HeaderFile
#include <Standard.hxx>
#include <Standard_DefineAlloc.hxx>
#include <Standard_Handle.hxx>
#include <BRepAdaptor_Surface.hxx>
#include <Geom2dAdaptor_Curve.hxx>
#include <Standard_Boolean.hxx>
#include <Standard_Integer.hxx>
#include <gp_Pnt2d.hxx>
#include <Standard_Real.hxx>
#include <TColStd_Array1OfReal.hxx>
#include <GeomAbs_IsoType.hxx>
#include <TColStd_HArray1OfReal.hxx>
class TopoDS_Face;
class gp_Pnt;
class gp_Vec;
class TopoDS_Edge;
class gp_Pnt2d;
class gp_Vec2d;
class BRepGProp_Face
{
public:
DEFINE_STANDARD_ALLOC
//! Constructor. Initializes the object with a flag IsUseSpan
//! that says if it is necessary to define spans on a face.
//! This option has an effect only for BSpline faces. Spans
//! are returned by the methods GetUKnots and GetTKnots.
BRepGProp_Face(const Standard_Boolean IsUseSpan = Standard_False);
//! Constructor. Initializes the object with the face and the
//! flag IsUseSpan that says if it is necessary to define
//! spans on a face. This option has an effect only for
//! BSpline faces. Spans are returned by the methods GetUKnots
//! and GetTKnots.
BRepGProp_Face(const TopoDS_Face& F, const Standard_Boolean IsUseSpan = Standard_False);
Standard_EXPORT void Load (const TopoDS_Face& F);
Standard_EXPORT Standard_Integer VIntegrationOrder() const;
//! Returns Standard_True if the face is not trimmed.
Standard_Boolean NaturalRestriction() const;
//! Returns the TopoDS face.
const TopoDS_Face& GetFace() const;
//! Returns the value of the boundary curve of the face.
gp_Pnt2d Value2d (const Standard_Real U) const;
Standard_EXPORT Standard_Integer SIntOrder (const Standard_Real Eps) const;
Standard_EXPORT Standard_Integer SVIntSubs() const;
Standard_EXPORT Standard_Integer SUIntSubs() const;
Standard_EXPORT void UKnots (TColStd_Array1OfReal& Knots) const;
Standard_EXPORT void VKnots (TColStd_Array1OfReal& Knots) const;
Standard_EXPORT Standard_Integer LIntOrder (const Standard_Real Eps) const;
Standard_EXPORT Standard_Integer LIntSubs() const;
Standard_EXPORT void LKnots (TColStd_Array1OfReal& Knots) const;
//! Returns the number of points required to do the
//! integration in the U parametric direction with
//! a good accuracy.
Standard_EXPORT Standard_Integer UIntegrationOrder() const;
//! Returns the parametric bounds of the Face.
Standard_EXPORT void Bounds (Standard_Real& U1, Standard_Real& U2, Standard_Real& V1, Standard_Real& V2) const;
//! Computes the point of parameter U, V on the Face <S> and
//! the normal to the face at this point.
Standard_EXPORT void Normal (const Standard_Real U, const Standard_Real V, gp_Pnt& P, gp_Vec& VNor) const;
//! Loading the boundary arc.
//! Returns FALSE if edge has no P-Curve.
Standard_EXPORT bool Load (const TopoDS_Edge& E);
//! Returns the parametric value of the start point of
//! the current arc of curve.
Standard_Real FirstParameter() const;
//! Returns the parametric value of the end point of
//! the current arc of curve.
Standard_Real LastParameter() const;
//! Returns the number of points required to do the
//! integration along the parameter of curve.
Standard_EXPORT Standard_Integer IntegrationOrder() const;
//! Returns the point of parameter U and the first derivative
//! at this point of a boundary curve.
void D12d (const Standard_Real U, gp_Pnt2d& P, gp_Vec2d& V1) const;
//! Loading the boundary arc. This arc is either a top, bottom,
//! left or right bound of a UV rectangle in which the
//! parameters of surface are defined.
//! If IsFirstParam is equal to Standard_True, the face is
//! initialized by either left of bottom bound. Otherwise it is
//! initialized by the top or right one.
//! If theIsoType is equal to GeomAbs_IsoU, the face is
//! initialized with either left or right bound. Otherwise -
//! with either top or bottom one.
Standard_EXPORT void Load (const Standard_Boolean IsFirstParam, const GeomAbs_IsoType theIsoType);
//! Returns an array of U knots of the face. The first and last
//! elements of the array will be theUMin and theUMax. The
//! middle elements will be the U Knots of the face greater
//! then theUMin and lower then theUMax in increasing order.
//! If the face is not a BSpline, the array initialized with
//! theUMin and theUMax only.
Standard_EXPORT void GetUKnots (const Standard_Real theUMin, const Standard_Real theUMax, Handle(TColStd_HArray1OfReal)& theUKnots) const;
//! Returns an array of combination of T knots of the arc and
//! V knots of the face. The first and last elements of the
//! array will be theTMin and theTMax. The middle elements will
//! be the Knots of the arc and the values of parameters of
//! arc on which the value points have V coordinates close to V
//! knots of face. All the parameter will be greater then
//! theTMin and lower then theTMax in increasing order.
//! If the face is not a BSpline, the array initialized with
//! theTMin and theTMax only.
Standard_EXPORT void GetTKnots (const Standard_Real theTMin, const Standard_Real theTMax, Handle(TColStd_HArray1OfReal)& theTKnots) const;
protected:
private:
BRepAdaptor_Surface mySurface;
Geom2dAdaptor_Curve myCurve;
Standard_Boolean mySReverse;
Standard_Boolean myIsUseSpan;
};
#include <BRepGProp_Face.lxx>
#endif // _BRepGProp_Face_HeaderFile