OUFGSU ( surf, arrlen, key, keylen, ivals, rvals, sense, tf, ifail )
====================================================================
Outputs a Foreign Geometry (FG) surface.
Receives:
KI_tag_surface *surf --- Foreign surface.
KI_int_nchars *arrlen --- Length of input key array.
Returns:
KI_chr_key key[arrlen] --- Surface key.
--- (truncated if necessary)
KI_int_nchars *keylen --- True length of surface key.
<KI_tag_list_int> *ivals --- List of integer values.
<KI_tag_list_dbl> *rvals --- List of real values.
KI_cod_logical *sense --- Surface sense.
<KI_tag_transform> *tf --- Surface transformation.
KI_cod_error *ifail --- failure indicator
Specific errors:
KI_unsuitable_entity Not a foreign geometry surface.
Description:
This function, given a tag, outputs the data of a foreign surface.
'surf' The tag of a valid foreign surface.
'arrlen' The length of the key array being passed to this KI function.
'key' The array of characters into which the key of the surface is
copied. (If the array is not long enough to store the key, then
the key is truncated.)
'keylen' The true length of the surface key.
'ivals' Integer values supplied to the surface evaluator.
'rvals' Real values supplied to the surface evaluator.
'sense' The surface sense.
'tf' The tag of the surface transformation.
In cases where the foreign surface was created without a transform and only
identity tranforms have been subsequently applied to it, the returned
transformation tag 'tf' will be the NULTAG ( APPTRA does not modify the
transformation when identity tranformations are applied ).