 |
PK_ATTRIB_set_axes |
|
PK_ERROR_code_t PK_ATTRIB_set_axes
(
--- received arguments ---
PK_ATTRIB_t attrib, --- attribute
int field_no, --- field number (>= 0)
int n_axes, --- number of axes (>= 0)
const PK_AXIS1_sf_t axes[] --- axes to set
)
This function copies 'axes' 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 an axis 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_axes' is not equal to the
existing field length
The new data replaces any existing data stored in the field.
If 'n_axes' is zero then this field is set to be empty.
See here for more information about attribute processing.