 |
PK_ATTRIB_set_named_axes |
|
PK_ERROR_code_t PK_ATTRIB_set_named_axes
(
--- received arguments ---
PK_ATTRIB_t attrib, --- attribute
const char *field_name, --- field name
int n_axes, --- number of axes (>= 0)
const PK_AXIS1_sf_t axes[] --- axes to set
)
This function copies 'axes' 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 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.
See here for more information about using named attribute fields.