This application allows you to select a new current picture in the graphics database
using the cursor. Each time a position is selected (usually by pressing a button on the
mouse), details of the topmost picture in the AGI database which encompasses that
position are displayed, together with the cursor position (in millimetres from the
bottom -left corner of the graphics device). On exit the last picture selected becomes
the current picture.
piccur [device] [name]
DEVICE = DEVICE
The graphics workstation.
[The current graphics device]
Only pictures of this name are to be selected. For instance,
if you want to select a DATA picture which is covered by a transparent FRAME
picture, then you could specify NAME=
"DATA". A null (
!) or blank string means that
pictures of all names may be selected.
SINGLE = _LOGICAL (Read)
then the user can supply only one position using the cursor, where-upon the
application immediately exits, leaving the selected picture as the current picture.
FALSE is supplied, then the user can supply multiple positions. Once all
positions have been supplied, a button is pressed to indicate that no more
positions are required.
piccur This selects a picture on
the current graphics device by use of the cursor. The picture containing the
last-selected point becomes the current picture.
piccur name=data This is
like the previous example, but only DATA pictures can be selected.