PK_ATTRIB_set_named_vectors

PK_ERROR_code_t   PK_ATTRIB_set_named_vectors
(
--- received arguments ---
PK_ATTRIB_t       attrib,           --- attribute
const char       *field_name,       --- field name
int               n_vectors,        --- number of vectors (>=0)
const PK_VECTOR_t vectors[]         --- vectors to set
)


This function copies 'vectors' into field 'field_name' of the given
attribute.


Specific Errors:
    PK_ERROR_bad_name               (MILD) The attribute does not have a field
                                           with this name
    PK_ERROR_field_of_wrong_type    (MILD) The field is not a vector field
    PK_ERROR_bad_value              (MILD) The field data is in some way
                                           invalid for the intended field.
    PK_ERROR_not_same_length        (MILD) The 'attrib' is a no-roll attribute
                                           and 'n_vectors' is not equal to the
                                           existing field length


The new data replaces any existing data stored in the field.

If 'n_vectors' is zero then this field is set to be empty.

The field should be of type vector, coordinate or direction.

See here for more information about attribute processing.

See here for more information about using named attribute fields.