astAddVariant

Store a new variant Mapping for the current Frame in a FrameSet

Description:

This function allows a new variant Mapping to be stored with the current Frame in a FrameSet. See the " Variant" attribute for more details. It can also be used to rename the currently selected variant Mapping.

Synopsis

void astAddVariant( AstFrameSet this, AstMapping map, const char name )

Parameters:

this
Pointer to the FrameSet.
map
Pointer to a Mapping which describes how to convert coordinates from the current Frame to the new variant of the current Frame. If NULL is supplied, then the name associated with the currently selected variant of the current Frame is set to the value supplied for " name" , but no new variant is added.
name
The name to associate with the new variant Mapping (or the currently selected variant Mapping if " map" is NULL).

Notes: