|
Action:
|
Evaluates the position and an arbitrary number of derivatives of the surface.
|
|
|
Prototype:
|
int bs3_surface_evaluate (
|
|
|
SPApar_pos const& uv,
|
// given parameter
|
|
|
|
|
// position
|
|
|
bs3_surface sur,
|
// given surface
|
|
|
SPAposition& pos,
|
// returned position
|
|
|
SPAvector** deriv
|
// returned derivatives
|
|
|
|
= NULL,
|
// array of pointers to
|
|
|
|
|
// arrays of vectors,each
|
|
|
|
|
// such array containing
|
|
|
|
|
// one more vector than
|
|
|
|
|
// the order of the
|
|
|
|
|
// derivative
|
|
|
int nderiv
|
// returned number of
|
|
|
|
= 0,
|
// derivatives
|
|
|
|
|
// to be evaluated, equal
|
|
|
|
|
// to the length of the
|
|
|
|
|
// deriv array
|
|
|
int uindex
|
// returned senses at u
|
|
|
|
= 0,
|
// discontinuities
|
|
|
int vindex
|
// returned senses at v
|
|
|
|
= 0
|
// discontinuities
|
|
|
);
|
|
|
Includes:
|
#include "kernel/acis.hxx"
|
|
#include "baseutil/vector/param.hxx"
|
|
#include "baseutil/vector/position.hxx"
|
|
#include "baseutil/vector/vector.hxx"
|
|
#include "kernel/spline/bs3_srf/bs3surf.hxx"
|
|
#include "kernel/spline/bs3_srf/sp3srtn.hxx"
|
|
|
Description:
|
Evaluates the position and an arbitrary number of derivatives of the surface, with control over the handedness of the evaluation if the derivatives are discontinuous.
|
|
|
deriv specifies an array of pointers to arrays, containing at least nderiv values, though any or all may NULL. If not NULL, entry n (representing the (n+1)th derivative) must point to an array of at least n+1 vectors.
|
|
|
uindex specifies the sense of evaluation at a u discontinuity: negative means evaluate to the left, positive means evaluate to the right, and 0 means "don't care."
|
|
|
vindex specifies the sense of evaluation at a v discontinuity: negative means evaluate below, positive means evaluate above, and 0 means "don't care."
|
|
|
Errors:
|
Returns -1 if input surface is null, or nderiv < 0.
|
|
|
Limitations:
|
There is a limit on the number of evaluated derivatives, as returned by bs3_surface_accurate_derivs; any further derivatives requested are set to 0.
|
|
|
Library:
|
kernel
|
|
|
Filename:
|
kern/kernel/spline/bs3_srf/sp3srtn.hxx
|
|
|
Effect:
|
Read-only
|