Store a new variant Mapping for the current Frame in a FrameSet astAddVariant
" Variant" attribute for more details. It can also be used to
rename the currently selected variant Mapping. " name" , but no
new variant is added. " map" is NULL). The newly added Variant becomes the current variant on exit (this is equivalent to
setting the Variant attribute to the value supplied for " name).
An error is reported if a variant with the supplied name already exists in the current Frame.
An error is reported if the current Frame is a mirror for the variant Mappings in another Frame. This is only the case if the astMirrorVariants function has been called to make the current Frame act as a mirror.