 |
PK_ATTRIB_set_vectors |
|
PK_ERROR_code_t PK_ATTRIB_set_vectors
(
--- received arguments ---
PK_ATTRIB_t attrib, --- attribute
int field_no, --- field number (>= 0)
int n_vectors, --- number of vectors (>=0)
const PK_VECTOR_t vectors[] --- vectors to set
)
This function copies 'vectors' into field number 'field_no' of the given
attribute.
Specific Errors:
PK_ERROR_bad_field_number (MILD) The attribute does not have a field
with this number
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.