PICLIST - Lists the pictures in the graphics database for a device

Description:

This application produces a summary of the contents of the graphics database  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.

Usage:

piclist [name] [logfile] [device] picnum=?

Parameters:

DEVICE = DEVICE (Read)

The graphics workstation. [The current graphics device]

LOGFILE = FILENAME (Write)

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)

Only 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)

The reference number of the picture to be made the current picture when the application exits. PICNUM="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.

Examples:

piclist

This reports all the pictures in the graphics database for the current graphics device.

piclist device=ps_l

This reports all the pictures in the graphics database for the ps_l device.

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 datapic.dat.

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 listed.

piclist picnum=last

This makes the last picture in the graphics database for the current graphics device the current picture. The pictures are not listed.

Related Applications :

KAPPA: PICBASE, PICDATA, PICEMPTY, PICENTIRE, PICFRAME, PICIN, PICLAST, PICSEL, PICVIS.

Timing :

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.