KPG1_AGFND

Selects the highest picture of a given name within the current AGI picture

Description:

This routine searches forwards through the AGI database for a picture of a given name that lies within the current picture, including the current picture itself. If one is found it becomes the new current picture. If it could not be found a bad status will be returned, and the current picture is unchanged.

Invocation

CALL KPG1_AGFND( NAME, PICID, STATUS )

Arguments

NAME = CHARACTER ∗ ( ∗ ) (Given)
The name of the picture to be searched for in the graphics database.
PICID = INTEGER (Returned)
The picture identifier of the most-recent picture named NAME.
STATUS = INTEGER (Given and Returned)
The global status.