next up previous 200
Next: AGI_SELP - Select the given picture as the current one
Up: Routine Specifications
Previous: AGI_RCS - Recall succeeding picture of specified name


AGI_RCSP - Recall succeeding picture embracing a position

Description:
Recall the picture succeeding the given one on the current device that has the specified name, embraces the given position and lies within the bounds of the current picture. The search is started at the picture identified by the PSTART argument. 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 in the workstation structure fulfills the conditions an error is returned.

Invocation:
CALL AGI_RCSP( PNAME, PSTART, X, Y, PICID, STATUS )

Arguments:

PNAME = CHARACTER $*$ ( $*$ ) (Given)
Name of picture
PSTART = INTEGER (Given)
Identifier of picture starting the search
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



next up previous 200
Next: AGI_SELP - Select the given picture as the current one
Up: Routine Specifications
Previous: AGI_RCS - Recall succeeding picture of specified name

AGI --- Applications Graphics Interface Library
Starlink User Note 48
Nicholas Eaton
Brian McIlwrath
30 January 2002
E-mail:ussc@star.rl.ac.uk

Copyright © 2009 Science and Technology Facilities Council