Make the current Frame mirror the variant Mappings in
another Frame astMirrorVariants
This provides a mechanism for propagating the effects of variant Mappings around a FrameSet. If a new Frame is added to a FrameSet by connecting it to an pre-existing Frame that has two or more variant Mappings, then it may be appropriate to set the new Frame so that it mirrors the variants Mappings of the pre-existing Frame. If this is done, then it will be possible to select a specific variant Mapping using either the pre-existing Frame or the new Frame.
Mirrors can be chained. That is, if Frame B is set to be a mirror of Frame A, and Frame C is set to be a mirror of Frame B, then Frame C will act as a mirror of Frame A.
Variant Mappings cannot be added to the current Frame if it is mirroring another Frame. So calls to the astAddVariant function will cause an error to be reported if the current Frame is mirroring another Frame.
A value of AST__BASE may be given for the "
iframe"
parameter to specify the base
Frame.
Any variant Mappings explicitly added to the current Frame using astAddVariant will be ignored if the current Frame is mirroring another Frame.