Function IEvaluate( _
   ByVal UParam As Double, _
   ByVal VParam As Double, _
   ByVal NumUDeriv As Integer, _
   ByVal NumVDeriv As Integer _
) As Double

Dim instance As ISurface
Dim UParam As Double
Dim VParam As Double
Dim NumUDeriv As Integer
Dim NumVDeriv As Integer
Dim value As Double
 
value = instance.IEvaluate(UParam, VParam, NumUDeriv, NumVDeriv)

double IEvaluate( 
   double UParam,
   double VParam,
   int NumUDeriv,
   int NumVDeriv
)

double IEvaluate( 
&   double UParam,
&   double VParam,
&   int NumUDeriv,
&   int NumVDeriv
) 

Parameters

UParam

Value of u parameter

VParam

Value of v parameter

NumUDeriv

Number of u derivatives required

NumVDeriv

Number of v derivatives required

This method returns the evaluated point, normal, and derivatives with respect to u and v up to order NumUDerivs and NumVDerivs, respectively. If NumUDerivs and NumVDerivs are 0, then no derivatives are returned.

For more information on the valid u and v parameters of the surface, see ISurface::Parameterization or ISurface::IParameterization. Also, use IFace2::FaceInSurfaceSense to check to see if the normal of the face is in the same direction or in the opposite direction of the surface normal.

The evaluation returns the following array of (3 *((( NumUDerivs +1) * (NumVDerivs + 1)) + 1 )) doubles:

[ evaluatedPoint[3], evaluatedDerivatives[xx], evaluatedNormal[3] ]

where:

evaluatedPoint[3] = point representing the evaluated X,Y,Z point in meters

evaluatedDerivatives[xx] = array of vectors representing the derivatives

where the nth derivative wrt u (i <= NumUDerivs)

and the nth derivative wrt v (j <= NumVDerivs)

would be vector number ( i + (NumUDerivs + 1) * j ) - 1 in the evaluatedDerivatives array.

If NumUDerivs and NumVDerivs are 0, then no derivatives are returned.

evaluatedNormal[3] = a vector representing the evaluated normal

The following table describes the number of derivatives that can be requested based on the surface type. If you request more derivatives than allowed, then this method returns all data as zeros. To determine the surface type, see ISurface::Identity.

where:

• a - All surface types

• b - All surface types except blend surfaces

• c - All surface types except blend surfaces and offset surfaces

• d - All surface types except blend surfaces but offset surfaces will only return 0th, 1st, and 2nd derivatives (the uncalculated 3rd and 4th derivatives are returned as 0 vectors).

For example, if you specified 2 derivatives in both u and v, then an array containing 10 vectors is returned. The returned data is in model space coordinates.  

[P(u,v)               P(u,v)/du           P(u,v)/dudu]

[P(u,v)/dv           P(u,v)/dudv        P(u,v)/dududv]

[P(u,v)/dvdv        P(u,v)/dudvdv     P(u,v)/dududvdv]

[N(u,v)]

where:

• du the partial derivative in the u direction

• dv the partial derivative in the v direction

• N(u,v) the normal vector

• Each P() represents a model space point or vector depending on the entry in the array

If you request 2 derivatives for u and 1 for v, then an array containing 7 vectors is returned:

[P(u,v)               P(u,v)/du           P(u,v)/dudu]

[P(u,v)/dv           P(u,v)/dudv        P(u,v)/dududv]

[N(u,v)]

If u = 1 and v = 2, then:

[P(u,v)               P(u,v)/du]

[P(u,v)/dv           P(u,v)/dudv]

[P(u,v)/dvdv        P(u,v)/dudvdv]

[N(u,v)]