KPG1_ASSTY

Checks for synonyms and colour names in AST attribute settings

Description:

This routine splits the supplied AST attribute setting string up into a name and a value, replacing synonyms for AST attribute names or qualifiers with the corresponding AST names and qualifiers, and replacing colour names within the attribute value with corresponding PGPLOT colour indices. Synonyms for AST attribute names or qualifiers are set up using KPG1_ASPSY.

Matching of attribute names and attribute qualifiers are performed separately. The names are matched first. An attempt to match any supplied attribute qualifier against a synonym is only made if the attribute names match, or if the synonym does not contain an attribute name. Synonyms may specify minimum abbreviations for attribute qualifiers by including an asterisk within the qualifier string. The asterisk marks the end of the minimum abbreviation.

Invocation

CALL KPG1_ASSTY( SETTNG, IQUAL, NAME, VALUE, NQUAL, STATUS )

Arguments

SETTNG = CHARACTER ∗ ( ∗ ) (Given)
The text to be checked, potetially containing synonyms and colour names.
IQUAL = INTEGER (Given)
If the attribute name includes one or more qualifiers (e.g. " colour(ticks,border)" ), then the returned name includes the qualifier with index IQUAL (starting at one). The IQUAL value is ignored if the attribute name contains no qualifiers.
NAME = CHARACTER ∗ ( ∗ ) (Returned)
The corresponding AST attribute name (including at most one qualifier, as selected by IQUAL).
VALUE = CHARACTER ∗ ( ∗ ) (Returned)
The corresponding AST attribute value.
NQUAL = INTEGER (Returned)
The number of qualifers included in the attribute name within the supplied SETTNG string. May be zero.
STATUS = INTEGER (Given and Returned)
The global status.