AGI_RCFP - Recall first picture embracing a position

Description:

Recall the first picture on the current device that has the specified name, embraces the given position 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. The position has to be given in the world coordinates of the current picture. This picture becomes the current picture. If no picture fulfills the conditions an error is returned.

Invocation:

CALL AGI_RCFP( PNAME, X, Y, PICID, STATUS )

Arguments:

PNAME = CHARACTER $*$ ( $*$ ) (Given)

Name of picture

X = REAL (Given)

X position of test point

Y = REAL (Given)

Y position of test point

PICID = INTEGER (Returned)

Picture identifier

STATUS = INTEGER (Given and Returned)

The global status