AGI_RCF

Recall first picture of specified name

Description:

Recall the first picture on the current device that has the specified name and lies within the bounds of the current picture. The name string has leading blanks removed and is converted to upper case before being compared. An empty name string (just spaces) results in a search for a picture of any name. This picture becomes the current picture. If no picture fulfills the conditions an error is returned.

Invocation

CALL AGI_RCF( PNAME, PICID, STATUS )

Arguments

PNAME = CHARACTER ( ) (Given)
Name of picture
PICID = INTEGER (Returned)
Picture identifier
STATUS = INTEGER (Given and Returned)
The global status