Action:
|
Evaluates the tangent gvector of an edge or a curve at the specified parameter.
|
|
Filename:
|
kern/kern_scm/crv_scm.cxx
|
|
Syntax:
|
(curve:eval-tan edge-or-curve parameter)
|
|
Arg Types:
|
edge-or-curve
|
curve | edge
|
|
parameter
|
real
|
|
Returns:
|
gvector
|
|
Errors:
|
EDGE with no
CURVE
|
|
Description:
|
The parameterization of all curves is normalized to lie in the interval 0 to 1, therefore, evaluating at
parameter=0 indicates the start point of the curve.
|
|
|
edge-or-curve specifies an edge or a curve.
|
|
|
parameter specifies the position on the curve to evaluate. If the specified parameter lies outside the range 0 to 1, this extension returns an implicit gvector. A spline can only reliably be evaluated for parametric values from 0 to 1; if
parameter is outside of this range for a spline edge, the returned gvector is meaningless.
|
|
Example:
|
; curve:eval-tan
|
|
; Create a circular edge.
|
|
(define edge1
|
|
|
(edge:circular
|
|
|
(position 0 0 0) 38 0 100))
|
|
;; edge1
|
|
; Evaluate the tangent at a specific parameter.
|
|
(curve:eval-tan edge1 0.23)
|
|
;; #[gvector -0.390731128489274 0.92050485345244 0]
|