DG Kernel Documentation

Properties of a face (patch). It also returns properties of a smooth curve on the face. The curve can be either one of four natural edges of the face or a smooth part of a curve, which can be used as a trimming curve of the face.

To use methods related to the trimming curve the curve must be loaded with one of Load() methods. So the Load() methods are normally used to select which curve (natural edge or a smooth part of the trimming curve) is selected to be handled by this interface

Methods

NaturalRestriction

HRESULT NaturalRestriction(VARIANT_BOOL* trimmed)

Parameters

trimmed -[out,retval] The returned value. True if the face is not trimmed

HRESULT Value2d(double curveParam, KC2D* pointUV)

Parameters

curveParam - [in] Parameter along the trimming 2D curve

pointUV -[out,retval] The returned point on the curve

Remarks:

Returns point on the trimming curve inside domain rectangle of u,v parameters

HRESULT SIntOrder(double Eps, int* degreePlus)

Parameters

Eps - [in] Precision

degreePlus -[out,retval] The returned order. See remarks

Remarks:

Returns maximal degree (between u or v) plus 1 if the spline when the face is either bspline or Bezier surface.

Returns 2 if the face is plane or 3 if the face is a cylinder, cone, sphere or torus

HRESULT SUIntSubs(int* UKnotsMinus)

Parameters

UKnotsMinus -[out,retval] The returned value. See remarks

Remarks:

Returns number of U knots minus one if the spline when the face is either bspline or Bezier surface.

Returns 1 if the face is plane or 3 if the face is a cylinder, cone, sphere or torus

HRESULT SVIntSubs(int* VKnotsMinus)

Parameters

VKnotsMinus -[out,retval] The returned value. See remarks

Remarks:

Returns number of V knots minus one if the spline when the face is either bspline or Bezier surface.

Returns 1 if the face is plane or 3 if the face is a cylinder, cone, sphere or torus

HRESULT UKnots(IKO_TColStd_Array1OfReal** uKnots)

Returns the array of U knots

HRESULT VKnots(IKO_TColStd_Array1OfReal** vKnots)

Returns the array of V knots

HRESULT Bounds(double* U1, double* U2, double* V1, double* V2)

Returns the ranges of u and v parameters

HRESULT Normal(double U, double V, DIPoint* P, DIVect* VNor)

Returns the point at u and v parameters and normal vector at the point

HRESULT Load(IKO_TopoDS_Edge* edge)

Loads a smooth part of a curve as the current one to be handled by this interface. See comments on the top.

HRESULT FirstParameter(double* min)

Returns the lower limit of parameter range of trimming curve

HRESULT LastParameter(double* max)

Returns the upper limit of parameter range of trimming curve

HRESULT D12d(double param, DIPoint* P, DIVect* V1)

Returns the point at param trimming curve parameter and tangential vector at the point

HRESULT Load2(VARIANT_BOOL first, VARIANT_BOOL U)

Loads an edge or the uv rectangle as the current curve to be handled by this interface. See comments on the top.

This curve is either a top, bottom, left or right bound of a UV rectangle in which the parameters of surface are defined. If first is true, the face is initialized by either left of bottom bound. Otherwise it is initialized by the top or right one. If U is true, the face is initialized with either left or right bound. Otherwise - with either top or bottom one.