This application produces a summary of the contents of the graphics
for a graphics device, and/or permits a picture specified by its order in the
list to be made the new current picture. The list may either be reported or written to
a text file.
The headed list has one line per picture. Each line comprises a reference number; the
picture’s name, comment (up to 24 characters), and label; and a flag to indicate
whether or not there is a reference data object associated with the picture. A
"C" in the first column indicates that the picture that was current when this
application was invoked. In the text file, because there is more room, the name of
the reference object is given (up to 64 characters) instead of the reference
flag. Pictures are listed in chronological order of their creation.
piclist [name] [logfile] [device] picnum=?
DEVICE = DEVICE
The graphics workstation.
[The current graphics device
The name of the text file in which the list of pictures
will be made. A null string (
!) means the list will be reported to you. The
suggested default is the current value.
NAME = LITERAL (Read)
pictures of this name are to be selected. A null string (
!) or blanks means that
pictures of all names may be selected.
PICNUM = LITERAL (Read)
reference number of the picture to be made the current picture when the application
"Last" selects the last picture in the database. Parameter PICNUM
is not accessed if the list is written to the text file. A null (
!) or any
other error causes the current picture on entry to be current again on exit.
The suggested default is null.
piclist This reports all the
pictures in the graphics database for the current graphics device.
device=ps_l This reports all the pictures in the graphics database for the ps_l
piclist data This reports all the DATA pictures in the graphics
database for the current graphics device.
piclist data logfile=datapic.dat
This lists all the DATA pictures in the graphics database for the current
graphics device into the text file
piclist frame picnum=5
This selects the fifth most ancient FRAME picture (in the graphics database
for the current graphics device) as the current picture. The pictures are not
piclist picnum=last This makes the last picture in the graphics
database for the current graphics device the current picture. The pictures are not
The execution time is
approximately proportional to the number of pictures in the database for the
chosen graphics device. Selecting only a subset by name is slightly faster.