This command
creates a two-dimensional grid of equally sized new FRAME pictures in the
graphics
database. The array of pictures do not have to abut, but abutting is the default. The
new pictures are formed within either the current or BASE picture, and they adopt the
world co-ordinate system of that enclosing picture. On completion, the bottom-left
picture in the array becomes the current picture.
For easy reference in later processing the pictures have integer labels. The
numbering starts at a defined value, usually one, and increments by one for
each new picture starting from the bottom-left corner and moving from left to
right to the end of the line. This is repeated in each line until the top-right
picture.
This command is a synonym for picdef array 1.0 prefix="".
CURRENT = _LOGICAL (Read)
TRUE if the new pictures are to lie within
the current picture, otherwise the new pictures can lie anywhere within the BASE
picture. In other words, when CURRENT is TRUE the current picture is the reference
picture, and when it is FALSE the BASE is the reference picture. [FALSE]
DEVICE =
DEVICE (Read)
The graphics device. [Current graphics device]
FILL = _REAL
(Read)
The linear filling factor for the array. In other words the fractional
size (applied to both co-ordinates) of the new picture within each of the XPIC
YPIC
abutted sections of the picture being sub-divided. Each new picture is located
centrally within the section. A filling factor of 1.0 means that the pictures in the
array abut. Smaller factors permit a gap between the pictures. For example, FILL=0.9
would give a gap between the created pictures of 10 per cent of the height and width of
each picture, with exterior borders of 5 per cent. FILL must lie between 0.1 and
1.0. [1.0]
LABELNO = _INTEGER (Read)
The number used to form the label
for the first (bottom-left) picture. It cannot be negative. [1]
OUTLINE
= _LOGICAL (Read)
If TRUE, a box that delimits the new picture is drawn.
[TRUE]
XPIC = _INTEGER (Read)
The number of new pictures to be formed
horizontally in the BASE picture. The total number of new pictures is XPIC
YPIC. The value must lie in the range 1–20. The suggested default is
2.
YPIC = _INTEGER (Read)
The number of new pictures to be formed
vertically in the BASE picture. The total number of new pictures is XPIC
YPIC.
The value must lie in the range 1–20. The suggested default is the value of Parameter
XPIC.